# rtron

**Repository Path**: cgyy/rtron

## Basic Information

- **Project Name**: rtron
- **Description**: 导入https://github.com/tum-gis/rtron
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-22
- **Last Updated**: 2021-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center"><a href="https://rtron.io" target="_blank" rel="noopener noreferrer"><img width="500" src="rtron-documentation/src/orchid/resources/assets/images/logo.png" alt="rtron logo"></a></p>

<p align="center">
    <em>a road space model transformer for OpenDRIVE, CityGML and beyond</em>
    <br />
    <a href="https://rtron.io">View Demos</a>
    ·
    <a href="https://github.com/tum-gis/rtron/issues">Report Bug</a>
    ·
    <a href="https://github.com/tum-gis/rtron/issues">Request Feature</a>
</p>

<p align="center">
    <a href="https://github.com/tum-gis/rtron/releases" title="Latest Release"><img src="https://img.shields.io/github/v/release/tum-gis/rtron?style=for-the-badge"></a>
    <a href="https://github.com/tum-gis/rtron/actions" title="Build Status"><img src="https://img.shields.io/github/workflow/status/tum-gis/rtron/CI?style=for-the-badge"></a>
    <a href="https://github.com/tum-gis/rtron/issues" title="Open Issues"><img src="https://img.shields.io/github/issues/tum-gis/rtron?style=for-the-badge&logo=Github"></a>
    <a title="Language"><img src="https://img.shields.io/github/languages/top/tum-gis/rtron.svg?style=for-the-badge&logo=Kotlin&logoColor=white"></a>
    <a href="./LICENSE" title="License"><img src="https://img.shields.io/github/license/tum-gis/rtron.svg?style=for-the-badge&logo=Apache"></a>
</p>

![rtron preview](rtron-documentation/src/orchid/resources/assets/images/rtron-preview.png)

r:trån reads road network models in [OpenDRIVE](https://www.asam.net/standards/detail/opendrive) and transforms them to the virtual 3D city model standard [CityGML](https://www.opengeospatial.org/standards/citygml).

This enables you to

* [inspect](https://rtron.io/demos/model-inspection) your spatio-semantic road space models
* conduct further [model transformations](https://rtron.io/demos/model-transformations) with tools like [FME](https://www.safe.com/fme/)
* perform geospatial analyses on the [3D City Database](https://rtron.io/demos/3dcitydb)
* deploy [virtual globes](https://rtron.io/demos/web-map)
* load your models into a [desktop GIS](https://rtron.io/demos/desktop-gis)
* [compare and validate](https://rtron.io/demos/model-validation) your models with models from other data sources

## :rocket: Usage

In order to use r:trån you need JDK 11 or later.
Download the executable jar at the [releases section](https://github.com/tum-gis/rtron/releases) and let it run:

![running rtron](rtron-documentation/src/orchid/resources/assets/images/rtron-run.gif)

Configure your transformation by placing a script named ``configuration.kts`` into the directory of your OpenDRIVE datasets:

```kotlin
import io.rtron.main.project.configuration.configure

configure {

    opendrive2roadspaces {
        attributesPrefix = "opendrive_"
        crsEpsg = 32632
    }

    roadspaces2citygml {
        discretizationStepSize = 0.5
    }
}
```

r:trån can [recursively](https://rtron.io/wiki/configuration) iterate over OpenDRIVE datasets contained in the input directory.

## :construction_worker: Building

Clone the repo and let gradle build it:

```bash
./gradlew shadowJar # build the uber-jar

cd rtron-cli/build/libs
java -jar rtron-*.jar
```

You're good to go :muscle:

## :hammer_and_wrench: Contributing

r:trån was developed so that everyone can benefit from spatio-semantic road space models.
Therefore, bug fixes, issue reports and contributions are greatly appreciated.

## :mortar_board: Research

If you are interested in the concepts and a first application of r:trån, have a look at our [recent paper](https://doi.org/10.3390/su12093799).
Based on the consistent models now available in OpenDRIVE and CityGML, we generate several target formats for setting up a distributed environment simulation.

```plain
@article{SchwabBeilKolbe2020,
  title = {Spatio-Semantic Road Space Modeling for Vehicle{\textendash}Pedestrian Simulation to Test Automated Driving Systems},
  author = {Benedikt Schwab and Christof Beil and Thomas H. Kolbe},
  journal = {Sustainability},
  year = {2020},
  month = may,
  volume = {12},
  number = {9},
  pages = {3799},
  publisher = {MDPI},
  doi = {10.3390/su12093799},
  url = {https://doi.org/10.3390/su12093799}
}
```

Moreover, these papers may also be of interest:

* [Detailed Streetspace Modelling for Multiple Applications: Discussions on the Proposed CityGML 3.0 Transportation Model](https://doi.org/https://doi.org/10.3390/ijgi9100603)
* [Requirement Analysis of 3D Road Space Models for Automated Driving](https://doi.org/10.5194/isprs-annals-IV-4-W8-99-2019)
* [CityGML and the streets of New York - A proposal for detailed street space modelling](https://doi.org/10.5194/isprs-annals-IV-4-W5-9-2017)

## :memo: License

r:trån is distributed under the Apache License 2.0. See [LICENSE](LICENSE) for more information.

## :handshake: Thanks

* [AUDI AG](https://github.com/audi) for providing an awesome work environment within [SAVe:](https://save-in.digital)
* Prof. [Thomas H. Kolbe](https://www.lrg.tum.de/en/gis/our-team/staff/prof-thomas-h-kolbe/), [Bruno Willenborg](https://www.lrg.tum.de/en/gis/our-team/staff/bruno-willenborg/) and [Christof Beil](https://www.lrg.tum.de/en/gis/our-team/staff/christof-beil/) for support and feedback
* [Claus Nagel](https://github.com/clausnagel) for [citygml4j](https://github.com/citygml4j/citygml4j)
* [JetBrains](https://github.com/JetBrains) for Kotlin and their top-notch IDEs