Embedded Files
System Requirements
System Requirements
SERPM8 requires Windows-Based operating system (Windows 7 or later)
- Memory - 128GB
- Processors - 16 or more cores recommended
- Storage - ~20GB per scenario with no iterations archived
- Required software
- Cube 6.4.5 with Cluster
- NOTE: SERPM 8 does NOT work with the standard Cube 6.4.4, Citilabs has a DLL update which was included with version 6.4.5
- Microsoft Visual Studio 2010 C++ 64 bit redistributable
- R (3.5.1 suggested) - version with necessary packages is available as a zip folder with the model distribution
- Cube 6.4.5 with Cluster
- Recommended software for configuration and analysis
- Notepad++ (or similar text editor)
- RStudio
- Microsoft Excel
- ArcGIS / Shapefile viewer
Installation
Installation
First install Cube and R on the system
Download the redistributable here (allows programs compiled by Microsoft Visual Studio to run on your system). Run this executable to install. NOTE: if a newer version is found on the machine, it is not necessary to install this particular version (i.e. they are backwards compatible).
Installing R
Installing R
Option 1: extend existing installation
If you already have R installed, the necessary packages can be checked and installed by running the following:
- for (pckg in c("stringr", "data.table", "xlsx", "reshape2", "bindrcpp", "dplyr", "plyr", "tidyr", "ggplot2", "zoo", "openxlsx", "readr", "sp", "rgdal", "bit64", "maptools", "rgeos")) { if(!require(pckg)) install.packages(pckg) }
- If the reports are not generated after a model run, try running the Programs\Reports\SERPM8_RSummary_Control.R file in RStudio and monitor for errors
Option 2: install R using zipped distribution
The zipped distribution contains R 3.5.1 and all necessary packages. To install, unzip this folder onto the model system. If you already have R installed, it may be best to install in the Program Files\R folder.
Note: if you are using the zipped distribution and R Studio, you may need to set the R version (Tools->Global Options)
Installing SERPM8
Installing SERPM8
SERPM8 is a simple installation process (unzipping folder). A few notes for installing:
First: before unzipping, make sure to check that the zip folder does not have a 'block' from Windows security (select file properties and look at the General tab)
Next: unzip SERPM8_XX.zip folder to the run location (does not need to be on the C: drive, but should be on a fast drive - i.e., no external hard drives)
- Do not install the model to a path with special characters (e.g. '@') or with spaces in the names. This causes issues with the calls out to other programs (Java & R).
- See the Folder Structure page for more information about the organization of the folders and files within the zip.
Configuring SERPM8 for first use
Configuring SERPM8 for first use
First, set the number of threads to be available to the Java processes:
First, set the number of threads to be available to the Java processes:
- Open the SERPM8_LRTP\Programs\ABM\config\jppf-gui.properties file in a text editor (e.g. Notepad)
- Go to line 124 of the file and locate the statement: jppf.local.execution.threads = 20
- Update this value as needed for your system
- Determine the number of cores you have: https://support.microsoft.com/en-us/help/4026757/windows-10-find-out-how-many-cores-your-processor-has
- SERPM8 will run best with a value at ~80% of the number of cores in your computer (e.g. 20 is good for a 24 core system)
- It is not recommended to set this to 100% of the system cores
Next, open the SERPM8 catalog file in Cube - it may prompt a change in folder locations, select OK to update paths
Next, open the SERPM8 catalog file in Cube - it may prompt a change in folder locations, select OK to update paths
There are two catalog keys that must be configured for the specific system. These can be configured by updating the value of the key through the scenario manager, or by updating the key default value (which will then be propagated to all new scenarios).
Option 1: Update Key Default (advanced users)
- Open the scenario key list
- Update the default values of the following keys with paths on your system:
- voyager - set to path to Voyager.exe
- r_script_path - set to path to 3.5.1 R.exe
Option 2: Update Key Values
- Open the Scenario Manager
- Select Next until you see the System Configuration page
- Update the following keys with paths on your system:
- 64 bit Cube Voyager Executable
- Path to RScript Executable
- NOTE: If the path does not match your system, these keys will need to be updated for ALL scenarios defined in the catalog.
You may also wish to change the max number of threads to take full advantage of your workstation processors. This can be set to the same value that was used for the Java processes.
- NOTE: do not exceed the number of cores on your system
Additional settings if running SERPM 8 / SERPM 7 on multiple computers within the same network
Additional settings if running SERPM 8 / SERPM 7 on multiple computers within the same network
If SERPM will be run simultaneously on multiple computers in the same network, it is necessary to set each installation to use a unique jppf discovery port. This prevents the systems from sending tasks to other household managers. The discovery port is set here:
- Programs\ABM\config\jppf-gui.properties - line 146: jppf.discovery.port = XXXXX
- Simply change the port value to be different from the driver1.jppf.server.port value on each system (off by one is sufficient)
Input File Generation
Input File Generation
Generate Seed Skims
Generate Seed Skims
The SERPM catalog is distributed without Seed Skims to reduce the size of the zip file. The seed skims can be generated using the Seed Skim Generation application group under Utilities in the catalog.
This utility creates the seed skim files specified in the scenario manager, and thus must be run once for the 2015 and 2015 networks. Use the Run Application - Run Current Group Only option (see run screen below) to generate the seed skims. When complete, the skim files (*.MAT files) will be present in the Inputs\Highway\seed_net_skm2015\ and Inputs\Highway\seed_net_skm2045\ folders.
Google Sites
Report abuse