Package: osc-generator
DescriptionOSC-Generator is a collection of Python tools to generateASAM OpenSCENARIOfiles from vehicle data and anASAM OpenDRIVEfile.Scope of ApplicationCurrently, OpenSCENARIO V1.0 and OpenDRIVE V1.4 are supported.
Intersections may currently cause trouble but will be supported in a future release.
All features are tested in Python 3.7 on Windows 10.InstallationPyPIOSC-Generator can be installed using pippip install osc-generatorTestingAdditional dependencies for testing are required.Required Python packages can be installed via pip:pip install -r requirements_dev.txtFor testing, an ASAM OpenDRIVE file is needed. The file '2017-04-04_Testfeld_A9_Nord_offset.xodr' fromherecan be used by downloading a copy to thetests/test_datafolder. This file uses ASAM OpenDRIVE V1.4 format.Run pytest in thetestsfolder or a parent folder thereof.When everything is set up correctly, all tests should run successfully without raising any warnings.UsageClass: OSC-Generator provides a Python class which can be used to generate a scenario in the OpenSCENARIO format from trajectories and an OpenDRIVE file. The file example.py contains runnable example code for usage of this class.CLI:OSC-Generator can use arguments provided via Python's commandline interface. For information on how to use this feature, see the output of the help function:python osc_generator.py -hWhen installed via pip, OSC-Generator can directly be called in the console:osc_generator -hOpen Simulation Interface (OSI) Format InputIn order to use OSI format (.osi) input trajectory files with the OSC-Generator, the following steps are required:install the Open Simulation Interface (OSI):follow the installation instructions:https://github.com/OpenSimulationInterface/open-simulation-interfacecopy the file 'OSITrace.py':from "$PATH_TO_OSI_DIRECTORY\open-simulation-interface\format"to "$PATH_TO_OSC-GENERATOR_DIRECTORY\OSC-Generator\osc_generator\tools\OSI"run testsUsage of this feature functions as described above.if OSI is not installed, the OSC-Generator can still be used with .csv input trajectory files.CitationAn associatedpaperdescribes the original use case for which the OSC-Generator was created.
When using this software, please cite the following:@software{OSC-Generator,
author = {{Montanari, Francesco}, {Akkaya, Yigit Ali}, {BoÃŸmann, Nils}, {Sichermann, JÃ¶rg}, {MÃ¼ller, Marcel}, {Aigner, Axel Jeronimo}, {D'Sa, Dave}},
license = {Apache-2.0},
title = {{OSC-Generator}},
url = {https://github.com/EFS-OpenSource/OSC-Generator},
version = {0.2.0}
}AcknowledgmentThis work is supported by the German Federal Ministry for Digital and Transport (BMDV) within theAutomated and Connected Drivingfunding program under grant No. 01MM20012F (SAVeNoW).@copyright 2022 e:fs TechHub GmbH and Audi AG. All rights reserved.https://www.efs-techhub.com/https://www.audi.com/de/company.html@license Apache v2.0Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.