Skip to content

Installation

READ THIS BEFORE YOU INSTALL AND USE THE SOFTWARE

License

This software is licensed under the GNU General Public License Version 3 (GNU GPL-3.0).

A full copy of the license is included in the code repository as LICENSE file and can also be viewed online: LICENSE file on Github.

Please respect this license!

Disclaimer

Although OTAnalytics has been widely used in many transportation-related projects, it is still under active development. Features and functionality may change at any time. Particularly the user interface and the data formats should not be considered stable.

This software is provided "as is," without any express or implied warranties or liabilities. Use is at your own risk. Neither the authors nor contributors assume any responsibility for damages resulting from the use of this software. For more details, refer to Sections 15 and 16 of the GNU GPL-3.0.

Hardware requirements

OTAnalytics runs on most modern desktop pcs and laptops (e.g. with an i5 processor and 8 GB of RAM).

Please note:

  • More RAM allows you to load more tracks of road users simultaneously.
  • A faster processor will improve the runtime of the analyses and make the user interface more responsive.

Install Python 3.11

If not done yet, visit www.python.org/downloads/ and install Python 3.11.x for your platform.

Please make sure to include at least the following boxes:

  • Add Python to PATH
  • pip
  • tcl/tk
  • Add python to environment variables
  • Precompile standard library
  • GUI applications
  • UNIX command-line tools
  • Shell profile updater
  • Install or upgrade pip

Install OTAnalytics

Visit OTAnalytics latest releases on GitHub, scroll down to the list of assets and download the correct "otanalytics" .zip file for your platform.

Unzip the file to a location of your choice (preferably local).

Open a terminal window (or command prompt), navigate to the unzipped folder and run the install script as follows:

.\install.cmd

sh ./install.sh

Wait until the installation of dependencies is complete - this could take some time.

Run OTAnalytics

If you left the terminal window, open it and navigate to the unzipped folder, again. Run the start script as follows:

.\start_gui.cmd

sh ./start_gui.sh

What else?

If you encounter problems, have questions or like to request features, please open an issue on GitHub.

We welcome code contributions (e.g. fixing bugs or adding features) by the community. If you consider contributing, please check the contribute section of this documentation first.

If you like to receive professional support, please have a look at our services or contact us for more information.