Getting Started

Main Page > Technical Documentation > Getting Started

File Structure

The file structure for a SwashSim simulation project consists of the following:
 * A project file (*.ssim): This file contains project settings, such as simulation duration and random numbers seeds, and file paths to supporting parameter and data files.
 * A network data file (*.nwf): This file contains the information pertaining to the physical definition of the network (links, nodes, etc.).
 * A signal data file (*.xml): This file contains the signal phasing and timing information for all signal controllers present in the network.

All of these files are in an XML (eXtensible Markup Language) format. XML is a simple text-based format. Thus, these files can be opened outside of the SwashSim program in any text editor application and manually viewed and edited, if desired. After you have installed the program, double-click on the SwashSim icon on your desktop or within the ‘Start’ menu. Alternatively, you can navigate to the installation folder and double-click on ‘SwashSim.exe’ to start the program.

Starting/Opening Project From the start screen, select either ‘New Project’ or ‘Open Project’. If you select ‘New Project’, you will then need to select the desired facility type, and then click the ‘OK’ button (see Figure below). Alternatively, you can double-click on a facility type with the left mouse button and the main input screen will then be loaded. If you select ‘Open Project’, you will be presented with a dialog for selecting a project file (see Figure below).

Saving a Project To save your project input values to a file, select ‘Save’ from the ‘File’ menu. In addition to saving the roadway, traffic, and simulation settings, a reference to the signal timing settings file will be saved, if applicable. The name of the saved file will be displayed in the upper-right corner of the main inputs screen (see Figure below). If the full filename is not visible in the textbox, you can click in this box with your mouse and navigate to the right with the keyboard ‘right arrow’ key or ‘End’ key. The default file extension is “.ssim”.



Since file paths are included in the saved file, if you move your project file from one location on disk to another location, you may have difficulty loading the project from the new location. In this case, you can load the project file into any text editing program and manually revise the file path information. The relevant entries in the *.ssim file will be similar to those shown below.

G:\My Documents\SwashSim\Projects\Signal Int 2\SignalExample2.ssim DataFiles_ModelParms\DriverParms.xml DataFiles_ModelParms\LaneChangeParameters.xml DataFiles_ModelParms\VehicleMovementParms.xml G:\My Documents\SwashSim\Projects\Signal Int 2\Six Timing Stages.xml G:\My Documents\SwashSim\Projects\Signal Int 2