Definition Files

Definition File Contents

File Name	Purpose	Format
run_parameters.json	Contains parameters that define key attributes of the model run and relationships to other model runs.	JSON
model_parameters.json	Contains global parameters for a particular model configuration that may be used by multiple modules.	JSON
deflators.csv	Defines the annual deflator values, such as the consumer price index, that are used to convert currency values between different years for currency denomination.	CSV
geo.csv	Describes all of the geographic relationships for the model and the names of geographic entities in a CSV formatted text file.	CSV
units.csv	Describes the default units to be used for storing complex data types in the model. This file should NOT be modified by the user.	CSV

Go To Top

Model Run Parameters

`run_parameters.json`

A more detailed description of the file can be found here. The results of a model run are stored in a directory with the name specified by DatastoreName. This name should be changed when running different scenarios. For example, when running the base scenario, the output directory name can be set to BaseScenario by specifying "DatastoreName": "BaseScenario" in the file. The format of this file is as follows:

{ 

    "Model": "VERSPM Test", 

    "Scenario": "Test", 

    "Description": "Test of VERSPM", 

    "Region": "San Diego", 

    "BaseYear": "2016", 

    "Years": ["2016", "2035"], 

    "DatastoreName": "Datastore", 

    "DatastoreType": "RD", 

    "Seed": 1 

}

Go To Top

`model_parameters.json`

A more detailed description of the file and its structure can be found here. The format of this file is as follows:

[ 

  {"NAME": "ValueOfTime",  

   "VALUE": "18",  

   "TYPE": "double",  

   "UNITS": "base cost year dollars per hour" 

  } 

]

Go To Top

`deflators.csv`

This file does not need to be modified if the input dataset uses dollar values for any of the years contained in this file. The format of the file is as follows:

Year	Value
2010	100
2011	103.033
2012	104.68
2013	106.051
2014	108.018
2015	109.766
2016	111.924
2017	115.297
2018	119.181
2019	121.987
2020	123.272

Go To Top

`units.csv`

This file should NOT be modified by the user. The format of the file is as follows:

Type	Units
currency	USD
distance	MI
area	SQMI
mass	KG
volume	GAL
time	DAY
energy	GGE
people	PRSN
vehicles	VEH
trips	TRIP
households	HH
employment	JOB
activity	HHJOB

Go To Top

`geo.csv`

A more detailed description of this file and its structure, as used by SDRSPM, can be found here.

Column Name	Description
Azone	19 cities in San Diego County
Bzone	SANDAG TAZ version 13
Czone	Not Applicable (NA)
Marea	the union of core Urban area and area with 2016 transit service

Azone, Bzone, and Marea should remain consistent with the input data. The format of the file is as follows:

Azone	Bzone	Czone	Marea
12	13	NA	SD-Urban-TransitService
19	14	NA	None
19	15	NA	SD-Urban-TransitService
19	16	NA	SD-Urban-TransitService
19	17	NA	None
19	18	NA	None
…	…	…	…