Getting Started

Preliminaries

r:trån requires JDK 11 or later versions.

If you are on Windows, install it with choco by running:

choco install openjdk11

If you are on a Debian-based Linux, install the JDK by running:

sudo apt install openjdk-11-jre

If you are on macOS, install it with homebrew by running:

brew tap AdoptOpenJDK/openjdk
brew cask install adoptopenjdk11

Usage

Download the executable jar at the releases section or build it yourself:

git clone https://github.com/tum-gis/rtron.git
cd rtron

./gradlew shadowJar # build the uber-jar
cd rtron-cli/build/libs

Let it run:

java -jar rtron-*.jar
    Usage: rtron [OPTIONS] INPUTPATH OUTPUTPATH
    
      r:trån transforms road networks described in OpenDRIVE into the virtual 3D
      city model standard CityGML.
    
    Options:
      --version       Show the version and exit
      --no-recursive  Do not search recursively for input files in given
                      input directory
      --concurrent    Enable concurrent processing during the
                      transformation of a model (experimental)
      -c, --clean     Clean output directory by deleting its
                      current content before starting
      -h, --help      Show this message and exit
    
    Arguments:
      INPUTPATH   Path to the directory containing OpenDRIVE datasets
      OUTPUTPATH  Path to the output directory into which the
                  transformed CityGML models are written

Batch Processing

Assuming there are multiple OpenDRIVE datasets contained in the input path, for example like this:

tree ./opendrive-datasets
  ./opendrive-datasets
  ├── asam.net
  │   ├── Ex_Line-Spiral-Arc.xodr
  │   └── UC_ParamPoly3.xodr
  └── opendrive.org
      └── CrossingComplex8Course.xodr

r:trån then recursively iterates over all models and generates the respective CityGML datasets. The directory structure is preserved and report logs are added:

java -jar rtron-*.jar ./opendrive-datasets ./citygml-datasets

tree ./citygml-datasets
  ./citygml-datasets
  ├── asam.net
  │   ├── Ex_Line-Spiral-Arc
  │   │   ├── Ex_Line-Spiral-Arc.gml
  │   │   └── report.log
  │   └── UC_ParamPoly3
  │       ├── report.log
  │       └── UC_ParamPoly3.gml
  ├── general.log
  └── opendrive.org
      └── CrossingComplex8Course
          ├── CrossingComplex8Course.gml
          └── report.log