Skip to content

Tutorials

Jump to bottom
Zishan Fu edited this page Feb 8, 2020 · 10 revisions

This tutorial works for Linux and macOS system. For Windows users, please refer to the additional instruction at the bottom.

There are three ways to launch GeoSparkSim application, interface, commands, and manuscript.

Interface

java -cp target/GeoSparkSim-1.0-SNAPSHOT-jar-with-dependencies.jar com.zishanfu.geosparksim.GeoSparkSim -o

  • Select an area
    1. Drag the red box to locate an area.
    2. Use the mouse to zoom in/out.
    3. Drag the top-left or bottom-right red square to change red box shape.
  • Enter the number of vehicles in simulation.
  • Enter the simulation steps.
  • Enter the time per steps(second). For example, 600 steps and 1 second per step means 10 minutes simulation.
  • Select the vehicle generation method in the dropdown list, Data-space oriented approach(DSO) or Network-based approach(NB). Data generation Referencelink.
  • Enter the output path to save the results.
  • Click run simulation to start.
  • The text area will keep track of the simulation process.
  • When the simulation finished, click on show visualization and it will open traffic visualization panel.

Commands

GeoSparkSim provides option fields with scripts that user can launch simulation by demand. Commands The script is an example to simulate 10000 vehicles, 600 steps and 1 second per steps.

java -cp target/GeoSparkSim-1.0-SNAPSHOT-jar-with-depenies.jar com.zishanfu.geosparksim.GeoSparkSim -c -n 10000 -s 600 -t 1 -f /your/results/path/

Manuscript

GeoSparkSim provides manuscript option to define simulation parameters and launch application.

Development

Download Eclipse or Intellij IDE and install Java and Scala packages. Download GeoSparkSim and import it as a Maven project.

Eclipse

Click on run as Maven build. Enter clean install to build the application. Click on run as Run Configurations and enter -o in program arguments to get start with GeoSparkSim user interface.

IntelliJ

Build the project and click on run configurations. Enter main class entry com.zishanfu.geosparksim.GeoSparkSim with -o argument to get start.

Windows

  1. For Windows users, if you have issues to install GeoSparkSim, please use the Linux subsystem.
  • Run "PowerShell" as administrator.
  • Run the command Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.
  • Restart your computer.
  • Install Ubuntu 18.04 LTS from the Microsoft Store.
  • Launch Ubuntu system and wait for installation.
  • Create your UNIX username and password. This could be different from or the same as your current Windows username and password.
  1. Install VcXsrv Server on your Windows System to launch the UI.
  2. In your Linux Subsystem add the following to .bashrc file found at ~/.bashrc
  • export DISPLAY="localhost:0".
  • This will make it so that this command is automatically executed whenever the Linux Subsystem is started.

Clone this wiki locally