Metadata-Version: 2.4
Name: sumolib
Version: 1.26.0.post71
Summary: Python helper modules to read networks, parse output data and do other useful stuff related to the traffic simulation Eclipse SUMO
Project-URL: Homepage, https://sumo.dlr.de/
Project-URL: Documentation, https://sumo.dlr.de/docs/
Project-URL: Repository, https://github.com/eclipse-sumo/sumo
Project-URL: Issues, https://github.com/eclipse-sumo/sumo/issues
Project-URL: Changelog, https://sumo.dlr.de/docs/ChangeLog
Project-URL: Download, https://sumo.dlr.de/download
Author-email: DLR and contributors <sumo@dlr.de>
License-Expression: EPL-2.0 OR GPL-2.0-or-later
License-File: AUTHORS
License-File: LICENSE
License-File: NOTICE.md
Keywords: simulation,sumo,traci,traffic
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Description-Content-Type: text/markdown

# sumolib

sumolib is a set of python modules for working with SUMO networks, simulation output and other simulation artifacts.

## Installation

Install sumolib by simply executing:
```pip install sumolib```

A [daily version](https://test.pypi.org/project/sumolib/) is also available in TestPyPI:
```pip install -i https://test.pypi.org/simple/ sumolib```

## Getting Started

To use sumolib in your Python code, import the `sumolib` module. The following code snippet shows a basic example
of how to load a network file and retrieve the coordinate of a node:

```python
import sumolib

# Parse the network
net = sumolib.net.readNet("myNet.net.xml")

# Retrieve the coordinate of a node based on its ID
print(net.getNode("myNodeID").getCoord())
```

## Documentation

The sumolib documentation is available online at
[https://sumo.dlr.de/docs/Tools/Sumolib.html](https://sumo.dlr.de/docs/Tools/Sumolib.html). For a list of available
functions take a look at the [pydoc generated documentation](http://sumo.dlr.de/pydoc/sumolib.html)
or simply browse the [source code here](https://github.com/eclipse-sumo/sumo/tree/main/tools/sumolib).


## Contributing

If you find a bug in sumolib or have a suggestion for a new feature, please report it on the SUMO issue tracker at
[https://github.com/eclipse-sumo/sumo/issues](https://github.com/eclipse-sumo/sumo/issues).
If you would like to contribute code to sumolib, please submit a pull request to the SUMO repository at
[https://github.com/eclipse-sumo/sumo](https://github.com/eclipse-sumo/sumo).

## License

sumolib is released under the Eclipse Public License 2.0 (EPL-2.0).
