{"id":24756196,"url":"https://github.com/commonroad/commonroad-openscenario-converter","last_synced_at":"2025-03-23T06:44:47.257Z","repository":{"id":273799188,"uuid":"905351562","full_name":"CommonRoad/commonroad-openscenario-converter","owner":"CommonRoad","description":"Automatic Traffic Scenario Conversion between OpenSCENARIO and CommonRoad.","archived":false,"fork":false,"pushed_at":"2025-01-23T02:18:19.000Z","size":6024,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-01-23T03:22:43.525Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CommonRoad.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-18T16:43:56.000Z","updated_at":"2025-01-23T02:18:22.000Z","dependencies_parsed_at":"2025-01-23T03:22:49.899Z","dependency_job_id":"0c6ed197-a7f2-45f4-80de-f103650ab5b3","html_url":"https://github.com/CommonRoad/commonroad-openscenario-converter","commit_stats":null,"previous_names":["commonroad/commonroad-openscenario-converter"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommonRoad%2Fcommonroad-openscenario-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommonRoad%2Fcommonroad-openscenario-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommonRoad%2Fcommonroad-openscenario-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommonRoad%2Fcommonroad-openscenario-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CommonRoad","download_url":"https://codeload.github.com/CommonRoad/commonroad-openscenario-converter/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245066523,"owners_count":20555404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-28T13:39:50.342Z","updated_at":"2025-03-23T06:44:47.233Z","avatar_url":"https://github.com/CommonRoad.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CommonROAD-OpenSCENARIO Converter\n![image info](https://gitlab.lrz.de/tum-cps/commonroad-openscenario-converter/-/raw/master/docs/figures/converter-banner.png)\n\nAutomatic Traffic Scenario Conversion between [OpenSCENARIO](https://www.asam.net/standards/detail/openscenario/)\nand [CommonRoad](commonroad.in.tum.de/). Currently, only the conversion from **O**pen**SC**ENARIO to **C**ommon**R**OAD (osc2cr) is developed.\u003cbr\u003e\n[![Linux](https://img.shields.io/badge/os-linux?\u0026logo=Linux\u0026logoColor=white\u0026labelColor=gray)](https://pypi.python.org/pypi/commonroad-openscenario-converter/)\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/commonroad-openscenario-converter.svg)](https://pypi.python.org/pypi/commonroad-openscenario-converter/)\n[![PyPI license](https://img.shields.io/pypi/l/commonroad-openscenario-converter.svg)](https://pypi.python.org/pypi/commonroad-openscenario-converter/)\n[![PyPI version fury.io](https://badge.fury.io/py/commonroad-openscenario-converter.svg)](https://pypi.python.org/pypi/commonroad-openscenario-converter/)\u003cbr\u003e\n[![PyPI download month](https://img.shields.io/pypi/dm/commonroad-openscenario-converter.svg?style=plastic\u0026label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-openscenario-converter/) \n[![PyPI download week](https://img.shields.io/pypi/dw/commonroad-openscenario-converter.svg?style=plastic\u0026label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-openscenario-converter/)\u003cbr\u003e\n\n### Using the Converter\nThe recommended way of installation if you only want to use the OpenSCENARIO-CommonROAD Converter\n(i.e., you do not want to work with the code directly) is to use the PyPI package:\n```bash\npip install commonroad-openscenario-converter\n```\n### Development\nFor developing purposes, we recommend using [Anaconda](https://www.anaconda.com/) to manage your environment so that\neven if you mess something up, you can always have a safe and clean restart. \nA guide for managing python environments with Anaconda can be found [here](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html).\n\n- First, clone the repository. \n- After installing Anaconda, create a new environment with (\u003e=3.9) and enter it:\n``` bash\n$ conda create -n commonroad-py39 python=3.9 -y\n$ conda activate commonroad-py39\nor\n$ source activate commonroad-py39\n```\n- Then, install the dependencies with:\n\n```sh\n$ cd \u003cpath-to-this-repo\u003e\n$ pip install .\n$ conda develop .\n```\n\n- To test the installition, run unittest:\n```bash\n$ cd tests\n$ python -m unittest -v\n```\n\n### Open Simulation Interface (OSI) and UDP Driver\nIf you want to use the [esmini](https://github.com/esmini/esmini) UDPDriverController in combination with OSI for including\nexternal driver models or vehicle simulators, you need to install OSI manually, \nsee [here](https://github.com/OpenSimulationInterface/open-simulation-interface).\n\n### Contributors (in alphabetical order by last name)\n- Yuanfei Lin\n- Michael Ratzel\n\n### Documentation\n\nThe documentation of our toolbox is available on our website: https://cps.pages.gitlab.lrz.de/commonroad/commonroad-openscenario-converter/.\n\nIn order to generate the documentation via Sphinx locally, run the following commands in the root directory:\n\n```bash\n$ pip install -r ./docs/requirements_doc.txt\n$ cd docs/sphinx\n$ make html\n```\nThe documentation can then be launched by browsing ``./docs/sphinx/build/html/index.html/``.\n### Acknowledgments\nWe would like to extend our heartfelt gratitude to the team behind [esmini](https://github.com/esmini/esmini) for \ntheir remarkable effort in developing the simulation tool. Specifically, we would like to express our sincere \nappreciation to [Emil Knabe](https://www.linkedin.com/in/emil-knabe-216a1a11/?originalSubdomain=se)\nfor his invaluable contribution in reviewing and accepting the proposed changes to the esmini interface, \nand to [Sebastian Maierhofer](https://www.ce.cit.tum.de/air/people/sebastian-maierhofer-msc/)\nfor maintaining the converter from OpenDRIVE to lanelets.\nWe gratefully acknowledge partial financial support by the German Federal Ministry for Digital and Transport (BMDV) \nwithin the project _Cooperative Autonomous Driving with Safety Guarantees_\n([KoSi](https://www.ce.cit.tum.de/air/research/kosi/)).\n\n### Citation\nIf you use `commonroad-openscenario-converter` for academic work, we highly encourage you to cite our [paper](https://mediatum.ub.tum.de/doc/1716501/1716501.pdf):\n```text\n@inproceedings{Lin2023Osc2Cr,\n\tauthor = {Yuanfei Lin, Michael Ratzel, and Matthias Althoff},\n\ttitle = {Automatic Traffic Scenario Conversion from {OpenSCENARIO} to {CommonRoad}},\n\tbooktitle = {Proc. of the IEEE Int. Conf. on Intell. Transp. Syst.},\n\tyear = {2023},\n\tpages= {},\n}\n```\nIf you use this project's code in industry, we'd love to hear from you as well; \nfeel free to reach out to [Yuanfei Lin](mailto:yuanfei.lin@tum.de) directly.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommonroad%2Fcommonroad-openscenario-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommonroad%2Fcommonroad-openscenario-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommonroad%2Fcommonroad-openscenario-converter/lists"}