Skip to main content

What's this?

Fast and lightweight file parsers for Eclipse SUMO(traffic simulator) output.

The SUMO outputs are huge in size and hard to handle.

SUMO team provides scripts to convert from xml into CSV, however, the procedure is troublesome (downloading XSD, executing python script...)

Also, machine learning users take care of matrix data format.

This package provides an easy-to-call python interface to obtain matrix form from SUMO xml files.

Contributions

  • easy-to-call python interfaces to obtain matrix form from SUMO xml files
  • easy-to-call python interfaces to visualize SUMO simulations

Gallery

You can generate a traffic animation by fcd output xml.

Example of animation

You can visualize where a detector locates in a network.

Visualization example of detector position

You can visualize a transition of vehicle by vehrout.xml.

Visualization example of traffic route

Install

pip install sumo-output-parsers

Some submodules are not ready to use by default for which we avoid errors relating Proproj or Cartopy.

If you'd like to depict car flows or detector positions, install with

pip install "sumo-output-parsers[full]"

Sample

See sample.py and visualization_example.ipynb

Test

pytest tests/

If your package-dependency is complete including packages for visualization, then pytest tests/ --visualization

For developers

Build with poetry.

Install Guide

When you encounter any dependency issues, I recommend to use conda. cartopy and proj cause the dependency issue frequently. Conda helps you to install the compiled binaries. See Proj documentation.

License

@misc{sumo-output-parsers,
  author = {Kensuke Mitsuzawa},
  title = {sumo_output_parsers},
  year = {2021},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{}},
}

Metadata

Release files for sumo-output-parsers 0.61

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sumo-output-parsers 0.61
File Size Uploaded Provenance
sumo_output_parsers-0.61.tar.gz 18.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for sumo-output-parsers 0.61
File Interpreter ABI Platform
sumo_output_parsers-0.61-py3-none-any.whl Python 3 none any Details

Total release size: 42.3 kB

Release files / sumo_output_parsers-0.61.tar.gz

Download URL sumo_output_parsers-0.61.tar.gz
Size 18.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a8eceb8c8258e2a9778360c605d9a7a872dba89e84937d7585204ba395a8b1ed
BLAKE2b-256 checksum
How to use checksums
3c4df7a81562310b98f451465883b2b4c1f7b3df494724d61df285448b85fcd7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.8.8 Linux/5.4.0-92-generic

Release files / sumo_output_parsers-0.61-py3-none-any.whl

Download URL sumo_output_parsers-0.61-py3-none-any.whl
Size 24.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bd908a96fcb14074516645968c2209b5d330bab43870583673598a3da83996fd
BLAKE2b-256 checksum
How to use checksums
b028c445de391796e5d107d480a9c9774819d5a9bfdd440a5b56fa6e31d52331
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.8.8 Linux/5.4.0-92-generic

Security for sumo-output-parsers 0.61

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page