[toc] Required Files

• RunCOR.EXE
• TSISINTF.DLL

[toc] Background

TSIS offers a powerful graphical environment for running CORSIM and evaluating the outputs.  Oftentimes, especially in research, it is desirable to execute CORSIM directly from the command line.

For example, during analysis of signalized intersections, a researcher may need to compute means and standard deviations of  cycle-by-cycle intersection delays and throughputs from 30 replications.  A replication is a single simulation run with using a different set of seed numbers.  Because of reporting limitations in CORSIM, this cycle-by-cycle outputs are not immediately available from existing reports.   However, these values may be obtained by postprocessing the individual vehicle trajectory files (.TSD files) produced by TSIS.  While TSIS does offer a "scripting" feature to perform consectutive CORSIM simulations, the scripting feature requires that all 30 TSD files be retained until the entire batch run was complete.  If each TSD file is 70MB is size, this would require 2.1GB of free disk space to complete the evaluation.  It would make much more sense to postprocess the TSD file after each replication, then delete it before the next replication begins.

An executor program has been created to satisfy this need for a command line version of CORSIM.  The executor uses the same CORSIM.DLL file distributed with TSIS.  The executor simply provides the necessary support files and DLLs to allow the CORSIM.DLL to operate from the command line.

Three files are required to run CORSIM from the command line: RunCOR.EXE, TSISINTF.DLL, and CORSIM.DLL.  The CORSIM.DLL file is the same file that is distributed with the Windows version of TSIS.  The RunCOR.EXE and TSISINTF.DLL files are available from this site.  The TSISINTF.DLL file available from this site is DIFFERENT from the TSISINTF.DLL file distributed with TSIS.  This file has been "reverse engineered" in such a way to make CORSIM.DLL "think" that it is running under TSIS, when in fact it is running from the command line.  All interim messages produced by CORSIM are printed to the standard output device (usually the screen.)

The following sections provide instructions for obtaining and running the command line version of CORSIM.  However, these procedures require that you already own TSIS/CORSIM.  The CORSIM.DLL file (i.e., the actual CORSIM module) is NOT available from this site.  Contact McTrans for TSIS ordering information.

[toc] Download Instructions

1. Create a destination folder on your computer,
2. Download the required files (below) to the destination folder on your computer,
3. Copy CORSIM.DLL from the TSIS program folders on your computer into the destination folder used above,
4. Copy the desired CORSIM input file into the destination folder, then
5. Run RunCOR.EXE

NOTE:  the TSISINTF.DLL available from this site is DIFFERENT from the TSISINTF.DLL file shipped with TSIS.  Do NOT overwrite the original TSIS version of TSISINTF.DLL.  If overwritten, TSIS and CORSIM will not work.  Keep these files separate!

[toc] Command Syntax

The syntax of the CORSIM.EXE is shown below:

RUNCOR <input_file> <output_file>

where <input_file> is the name of the input TRF data file and <output_file> is the name of the desired output file.

NOTE: the <input_file> and <output_file> names MUST be longer than 12 characters.  For example:  "BASE.TRF" is an invalid file name, while "D:\PROJECTS\BASE.TRF" is valid.  CORSIM contains a bug that requires the file names be at least 12 characters in length.  The workaround is to use full file pathname specifications:  just add the drive and subdirectory to the file name when using the command line version.

NOTE: RunCOR.EXE, TSISINTF.DLL, and CORSIM.DLL must all be in the same folder!

[ Back to Table of Contents ]