Technical Reference

This page summarizes the detailed specifications of the modules, classes, and their functions in UXsim. This is highly technical; for the basic introduction, please see the getting started page and mechanism page first.

Classes (essential)

These classes are essential for UXsim. World is the simulation environment and accessed by users directly. Node, Link, and Vehicle objects should be added to a World object by World.addNode, World.addLink, World.adddemand methods, and access to them is provided by World. Thus, for basic usage, users do not need to access them directly. RouteChoice is for vehicles’ route choice behaviors, and basically it is not required to be directly accessed by users. Analyzer is for analysis of simulation results and it is basically accessible as World.analyzer.

uxsim.World

World (i.e., simulation environment).

uxsim.Node

Node in a network.

uxsim.Link

Link in a network.

uxsim.Vehicle

Vehicle or platoon in a network.

uxsim.RouteChoice

Class for computing shortest path for all vehicles.

uxsim.analyzer.Analyzer

Class for analyzing and visualizing a simulation result.

Classes (support)

These classes are not necessary for the basic usage of UXsim, but useful for specific or advanced analyses.

uxsim.Route

Class for a route that store concective links.

uxsim.TaxiHandler.TripRequest

A class representing a trip request (or travelers, passengers, cargo, etc.)

uxsim.TaxiHandler.TaxiHandler

A base class for handling the assignment of trip requests to taxis (or ridesourcing, ridehailing, ridesharing, robot-taxi, shared mobility, whatever).

uxsim.TaxiHandler.TaxiHandler_nearest

A taxi handler that assigns trip requests to nearest taxis (based on Euclidean distance).

uxsim.OSMImporter.OSMImporter

OpenStreetMap importer using OSMnx.

uxsim.ResultGUIViewer.ResultGUIViewer

Interactive viewer for UXsim simulation results using PyQt5.

Modules

These are the module and sub-module of UXsim. For basic usage, only uxsim is required to imported. analyzer, utils, and scenario_reader_writer are automatically imported along with uxsim, and access to them is provided by classes in uxsim. analyzer is for analysis of simulation results and it is basically accessible via World.analyzer. For utils and scenario_reader_writer, users will not use them directly. The other sub-modules may be useful for specific or advanced analyses.

uxsim.uxsim

UXsim: Macroscopic/mesoscopic traffic flow simulator in a network.

uxsim.utils

General utilities for UXsim.

uxsim.analyzer

Analyzer for a UXsim simulation result.

uxsim.scenario_reader_writer

Scenario reader and writer using toml.

uxsim.ResultGUIViewer.ResultGUIViewer

Interactive viewer for UXsim simulation results using PyQt5.

uxsim.TaxiHandler.TaxiHandler

A base class for handling the assignment of trip requests to taxis (or ridesourcing, ridehailing, ridesharing, robot-taxi, shared mobility, whatever).

uxsim.Utilities.Utilities

Submodule for general utilities.