From e804e59e6b938a85bb946a46c781a093a63d3c1c Mon Sep 17 00:00:00 2001
From: bhargavasana <bhargavasana@users.noreply.github.com>
Date: Thu, 14 Nov 2024 19:10:46 +0000
Subject: [PATCH] deploy: 0beb10dca0ef3bc6965a9e82f9f26f408f4fe6e7

---
 design/demand/external.html                   | 119 ++++++++++++++++--
 .../external_external_county_cordons.png      | Bin 0 -> 181723 bytes
 search/search_index.json                      |   2 +-
 sitemap.xml                                   |  60 ++++-----
 sitemap.xml.gz                                | Bin 486 -> 487 bytes
 5 files changed, 139 insertions(+), 42 deletions(-)
 create mode 100644 images/design/external_external_county_cordons.png

diff --git a/design/demand/external.html b/design/demand/external.html
index 76916c868..c6ff90202 100644
--- a/design/demand/external.html
+++ b/design/demand/external.html
@@ -697,15 +697,42 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#external-internal-model" class="md-nav__link">
-    External Internal Model
+  <a href="#external-model-estimation-of-trip-counts-by-type" class="md-nav__link">
+    External Model Estimation of Trip Counts by Type
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#external-external-model" class="md-nav__link">
-    External External Model
+  <a href="#external-model-design-overview" class="md-nav__link">
+    External Model Design Overview
+  </a>
+  
+    <nav class="md-nav" aria-label="External Model Design Overview">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#external-internal-destination-choice-model" class="md-nav__link">
+    External-Internal Destination Choice Model
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#external-internal-toll-choice-model" class="md-nav__link">
+    External-Internal Toll Choice Model
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#sources" class="md-nav__link">
+    Sources
   </a>
   
 </li>
@@ -1388,15 +1415,42 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#external-internal-model" class="md-nav__link">
-    External Internal Model
+  <a href="#external-model-estimation-of-trip-counts-by-type" class="md-nav__link">
+    External Model Estimation of Trip Counts by Type
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#external-model-design-overview" class="md-nav__link">
+    External Model Design Overview
+  </a>
+  
+    <nav class="md-nav" aria-label="External Model Design Overview">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#external-internal-destination-choice-model" class="md-nav__link">
+    External-Internal Destination Choice Model
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#external-internal-toll-choice-model" class="md-nav__link">
+    External-Internal Toll Choice Model
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
         <li class="md-nav__item">
-  <a href="#external-external-model" class="md-nav__link">
-    External External Model
+  <a href="#sources" class="md-nav__link">
+    Sources
   </a>
   
 </li>
@@ -1420,9 +1474,52 @@
 
 
 <h1 id="external-models">External Models<a class="headerlink" href="#external-models" title="Permanent link"> ¶</a></h1>
-<p>Details aggregate external models.</p>
-<h2 id="external-internal-model">External Internal Model<a class="headerlink" href="#external-internal-model" title="Permanent link"> ¶</a></h2>
-<h2 id="external-external-model">External External Model<a class="headerlink" href="#external-external-model" title="Permanent link"> ¶</a></h2>
+<p>The external aggregate travel models predict characteristics of US-SD and SD-US/MX travel behavior for all non-commercial, non-visitor vehicle trips and selected transit trips. Note that non-commercial MX-SD trips are forecast in the crossborder model, and non-commercial SD-US and SD-MX trips are forecast in the resident model.</p>
+<p><img alt="" src="../../images/design/external_external_county_cordons.png" /></p>
+<h2 id="external-model-estimation-of-trip-counts-by-type">External Model Estimation of Trip Counts by Type<a class="headerlink" href="#external-model-estimation-of-trip-counts-by-type" title="Permanent link"> ¶</a></h2>
+<p>The total count of trips by production and attraction location was estimated in a series of steps:</p>
+<ol>
+<li>The number of crossborder trips made by Mexican residents to attractions in San Diego was previously determined.</li>
+<li>The trips in the resident travel survey were expanded to estimate the total number of trips made by San Diego residents to attractions in Mexico.</li>
+<li>To derive an estimate of the number of US-MX trips, the number of MX-SD (1) and SD-MX (2) trips was subtracted from the total number of border-crossings.<ul>
+<li>The distribution of US-MX trips among external stations on the US-side of San Diego County will be assumed to be proportional to the total volume at each external station, regardless of the point of entry at the Mexican border.</li>
+</ul>
+</li>
+<li>The number of US-MX trips was then subtracted from the total number of trips in the SCAG cordon survey to arrive at an estimate of the combined total of US-US, US-SD, and SD-US trips with routes through San Diego County.</li>
+<li>Finally, the actual amounts of US-US, US-SD, and SD-US trips at each external station were estimated from the remaining trips (4) according to their proportions in the successfully geocoded responses in the SCAG cordon survey.</li>
+</ol>
+<h2 id="external-model-design-overview">External Model Design Overview<a class="headerlink" href="#external-model-design-overview" title="Permanent link"> ¶</a></h2>
+<p>The behavioral characteristics of the different types of external trip were derived from the various data sources available as follows:</p>
+<ul>
+<li>US-US trips: a fixed external station OD trip matrix was estimated from the SCAG cordon survey.<ul>
+<li><em>/src/main/emme/toolbox/model/external_external.py</em></li>
+</ul>
+</li>
+<li>US-MX trips: a fixed external station OD trip matrix was estimated from the SCAG cordon survey, Customs and Border Protection vehicle counts, and Mexican resident border-crossing survey as described in the previous section.<ul>
+<li><em>/src/main/emme/toolbox/model/external_external.py</em></li>
+</ul>
+</li>
+<li>US-SD trips: rates of vehicle trips per household for each external county were developed from the SCAG cordon survey, and the trips were distributed to locations in San Diego County according to a destination choice model estimated from the interregional survey.<ul>
+<li>Intermediate stops and transit trips are not modeled in this segment due to the small contribution of these events to the total demand in the segment.</li>
+<li><em>/src/main/emme/toolbox/model/external_internal.py</em></li>
+</ul>
+</li>
+</ul>
+<h3 id="external-internal-destination-choice-model">External-Internal Destination Choice Model<a class="headerlink" href="#external-internal-destination-choice-model" title="Permanent link"> ¶</a></h3>
+<p>The external-internal destination choice model distributes the EI trips to destinations within San Diego County. The EI destination choice model explanatory variables are:</p>
+<ul>
+<li>Distance</li>
+<li>The size of each sampled MGRA</li>
+</ul>
+<p>Diurnal and vehicle occupancy factors are then applied to the total daily trip tables to distribute the trips among shared ride modes and different times of day.</p>
+<h3 id="external-internal-toll-choice-model">External-Internal Toll Choice Model<a class="headerlink" href="#external-internal-toll-choice-model" title="Permanent link"> ¶</a></h3>
+<p>The trips are then split among toll and non-toll paths according to a simplified toll choice model. The toll choice model included the following explanatory variables:</p>
+<ul>
+<li>In-vehicle-time</li>
+<li>Toll cost</li>
+</ul>
+<h2 id="sources">Sources<a class="headerlink" href="#sources" title="Permanent link"> ¶</a></h2>
+<p>information primarily taken from this SANDAG document: <a href="https://www.sandag.org/-/media/SANDAG/Documents/PDF/data-and-research/applied-research-and-performance-monitoring/surveys/appendix-t-SANDAG-travel-demand-model-documentation.pdf">link to pdf</a></p>
 
 
 
diff --git a/images/design/external_external_county_cordons.png b/images/design/external_external_county_cordons.png
new file mode 100644
index 0000000000000000000000000000000000000000..419af6a3d7742741ce2030166a2db2c2196c692c
GIT binary patch
literal 181723
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
SY()itdMU`M%9cx;1pgn`!H$;z

literal 0
HcmV?d00001

diff --git a/search/search_index.json b/search/search_index.json
index 7156f6708..7dd16bb51 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"SANDAG ABM3","text":"<p>Welcome to the SANDAG Activity-Based Travel Model documentation site!</p>"},{"location":"index.html#introduction","title":"Introduction","text":"<p>This website describes the travel demand modeling system developed by the San Diego Association of Governments (SANDAG). SANDAG plans for many complex mobility issues facing the San Diego region, including development of the Regional Plan. Transportation models are complex analysis tools used to provide transportation planners and policymakers with information to help allocate scarce resources fairly and equitably. As we plan for the future, models are used to forecast potential future scenarios of where people will live and how they will travel. They are the principal tool used for alternatives analysis.  </p> <p>The SANDAG transportation model is an activity-based model (ABM). It simulates individual and household transportation decisions that make up their daily travel. This includes all trips people make on a daily basis, such as to work, school, shopping, healthcare, and recreation. An ABM provides a controlled, analytical platform so that different inputs and alternatives can be evaluated to predict whether, when, and how this travel occurs. SANDAG ABM accounts for a variety of different weekday travel markets in the region, including San Diego region resident travel, travel by Mexico residents and other travelers crossing San Diego County\u2019s borders, visitor travel, airport passengers at both the San Diego International Airport and the Cross Border Xpress bridge to the Tijuana International Airport, and commercial travel. </p> <p>The most recent version of the SANDAG ABM is referred to as \u201cABM3\u201d, and was developed for use in the 2025 Regional Plan. ABM3 is a significant enhancement from ABM2+ which was used for the 2021 Regional Plan. All of the passenger demand models in ABM2+ were converted from CT-RAMP to ActivitySim, including resident travel, cross-border travel, visitor travel, and airport travel. The internal-external travel component is now fully integrated with the resident model. The model was also enhanced to improve the representation of household and person-based mobility, vehicle fleet ownership, transit, shared and private micro-mobility, and micro-transit. Many of the model components were re-estimated using household survey data collected in 2022, and all model components were re-calibrated to base-year 2023 conditions. A new disaggregate commercial vehicle model was developed based upon a 2020 commercial vehicle survey, and implemented in ActivitySim.</p> <p>This website includes a description of the model system, how to set up and run the models, and a description of model inputs and outputs. Some aspects of the site are a work-in-progress, so we recommend that you check in often, and share your thoughts on ways to improve the site with SANDAG Transportation Modeling staff. Thank you!</p>"},{"location":"cvm.html","title":"Commercial Vehicle Model","text":""},{"location":"cvm.html#design","title":"Design","text":""},{"location":"cvm.html#inputs","title":"Inputs","text":""},{"location":"cvm.html#outputs","title":"Outputs","text":""},{"location":"faq.html","title":"FAQs","text":""},{"location":"faq.html#how-many-abm-versions-does-sandag-maintain","title":"How many ABM versions does SANDAG maintain?","text":"<p>There are four released ABM versions - ABM1, ABM2, ABM2+, and ABM3.</p>"},{"location":"faq.html#who-uses-the-sandag-abm-and-what-for","title":"Who uses the SANDAG ABM and what for?","text":"<p>The SANDAG ABM is used by SANDAG and many other public and private entities in the San Diego region. These entities include the City of San Diego and other local jurisdictions, Caltrans District 11, San Diego Metropolitan Transit System, North County Transit District, and private developers. Typical ABM applications include analysis for regional planning, air quality conformity, corridor studies, and land use development impact studies.</p>"},{"location":"faq.html#what-model-components-does-the-sandag-abm-have","title":"What model components does the SANDAG ABM have?","text":"<p>The SANDAG ABM is a suite of models covering various travel demand markets in the San Diego region. The microsimulation model components include a San Diego resident model, a commercial vehicle model, a Mexican resident crossborder model, a visitor model, a San Diego International Airport ground access model, a Cross-Border Express model serving Tijuana International Airport, and a special event model. The aggregate model components include an external heavy truck model and external trip models.</p>"},{"location":"faq.html#what-is-the-base-year-of-the-sandag-abm","title":"What is the base year of the SANDAG ABM?","text":"<p>ABM2 has a base year of 2022. ABM1 base year was 2012 and both ABM2 and ABM2+ have a base year of 2016.</p>"},{"location":"inputs.html","title":"ABM3 Model Inputs","text":"<p>The main inputs to ABM3 include the transportation network, land-use data, synthetic population data, parameters files, and model specifications. Outputs include a set of files that describe travel decisions made by all travel markets considered by the model (residents, overnight visitors, airport ground access trips, commercial vehicles and trucks, Mexico residents traveling in San Diego County, and travel made by all other non-residents into and through San Diego County).</p>"},{"location":"inputs.html#file-types","title":"File Types","text":"<p>There are several file types used for model inputs and outputs. They are denoted by their extension, as listed in the table below.</p> Extension Format .log, .txt Text files created during a model run containing logging results. .yaml Text files used for setting properties that control ActivitySim or some other process. .csv Comma-separated value files used to store model parameters, input or output data. .omx Open matrix format files used to store input or output trip tables or skims .h5 HDF5 files, used to store pipeline for restarting ActivitySim .shp (along with other files - .cpg, .dbf, .prj, .shx) ArcGIS shapefiles and associated files .html Hypertext markup language files, open in web browser .png Portable network graphics file, open in web browser, Microsoft photos, or third-party graphics editor"},{"location":"inputs.html#model-inputs","title":"Model Inputs","text":"<p>The table below contains brief descriptions of the input files required to execute the SANDAG ABM3.</p> File Name Purpose File Type Prepared By Land Use mgra_based_input{SCENARIO_YEAR}.csv Land use forecast of the size and structure of the region\u2019s economy and corresponding demographic forecast CSV Land Use Modelers, Transportation Modelers, and GIS activity_code_indcen_acs.csv PECAS activity code categories mapping to Census industry codes; This is used for military occupation mapping. CSV Land Use Modelers pecas_occ_occsoc_acs.csv PECAS activity code categories mapping to Census industry codes CSV Lande Use Modelers mobilityHubMGRA.csv CSV Transportation Modelers Synthetic Population households.csv Synthetic households CSV Transportation Modelers persons.csv Synthetic persons CSV Transportation Modelers Network: Highway (to be updated with TNED) hwycov.e00 Highway network nodes from GIS ESRI input exchange Transportation Modelers hwycov.e00 Highway network links from GIS ESRI input exchange Transportation Modelers turns.csv Highway network turns file CSV Transportation Modelers LINKTYPETURNS.dbf Highway network link type turns table DBF Transportation Modelers LINKTYPETURNSCST.DBF DBF Transportation Modelers vehicle_class_toll_factors.csv Relative toll values by six vehicle classes by Facility name. Used to identify \u201cfree for HOV\u201d type managed lane facilities. CSV Transportation Modelers off_peak_toll_factors.csv Relative toll values for the three off-peak times-of-day (EA, MD, EV) by Facility name. Multiplied together with the values from vehicle_class_toll_factors.csv to get the final toll. CSV Transportation Modelers vehicle_class_availability.csv The availability / unavailability of six vehicle classes for five times-of-day by facility name. CSV Transportation Modelers Network: Transit (To be updated with TNED) trcov.e00 Transit network arc data from GIS ESRI input exchange Transportation Modelers trcov.e00 Transit network node data from GIS ESRI input exchange Transportation Modelers trlink.csv Transit route with a list of links file CSV Transportation Modelers trrt.csv Transit route attribute file CSV Transportation Modelers trstop.csv Transit stop attribute file TCSV Transportation Modelers mode5tod.csv Transit mode parameters table CSV Transportation Modelers timexfer_XX.csv Transit timed transfers table between COASTER and feeder buses; XX is the TOD (EA, AM, MD, PM, and EV) CSV Transportation Modelers special_fares.txt Fares to coaster Text File Transportation Modelers Network: Active Transportation SANDAG_Bike_Net.dbf Bike network links DBF GIS SANDAG_Bike_Node.dbf Bike network nodes DBF GIS bikeTazLogsum.csv (not saved in inputs, instead, run at the beginning of a model run) Bike TAZ logsum CSV Transportation Modelers bikeMgraLogsum.csv (not saved in inputs, instead, run at the beginning of a model run) Bike MGRA logsum CSV Transportation Modelers walkMgraEquivMinutes.csv (not saved in inputs, instead, run at the beginning of a model run) Walk, in minutes, between MGRAs CSV Visitor Model (Derived from visitor survey) visitor_businessFrequency.csv Visitor model tour frequency distribution for business travelers CSV Transportation Modelers visitor_personalFrequency.csv Visitor model tour frequency distribution for personal travelers CSV Transportation Modelers visitor_partySize.csv Visitor model party size distribution CSV Transportation Modelers visitor_autoAvailable.csv Visitor model auto availability distribution CSV Transportation Modelers visitor_income.csv Visitor model income distribution CSV Transportation Modelers visitor_tourTOD.csv Visitor model tour time-of-day distribution CSV Transportation Modelers visitor_stopFrequency.csv Visitor model stop frequency distribution CSV Transportation Modelers visitor_stopPurpose.csv Visitor model stop purpose distribution CSV Transportation Modelers visitor_outboundStopDuration.csv Visitor model time-of-day offsets for outbound stops CSV Transportation Modelers visitor_inboundStopDuration.csv Visitor model time-of-day offsets for inbound stops CSV Transportation Modelers Airport Model (Derived from airport survey) airport_purpose.csv Airport model tour purpose frequency table CSV Transportation Modelers airport_party.csv Airport model party type frequency table CSV Transportation Modelers airport_nights.csv Airport model trip duration frequency table CSV Transportation Modelers airport_income.csv Airport model trip income distribution table CSV Transportation Modelers airport_departure.csv Airport model time-of-day distribution for departing trips CSV Transportation Modelers airport_arrival.csv Airport model time-of-day distribution for arriving trips CSV Transportation Modelers Cross-Border Model (Derived from cross-border survey) crossBorder_tourPurpose_control.csv CSV crossBorder_tourPurpose_nonSENTRI.csv Cross Border Model tour purpose distribution for Non-SENTRI tours CSV Transportation Modelers crossBorder_tourPurpose_SENTRI.csv Cross Border Model tour purpose distribution for SENTRI tours CSV Transportation Modelers crossBorder_tourEntryAndReturn.csv Cross Border Model tour entry and return time-of-day distribution CSV Transportation Modelers crossBorder_supercolonia.csv Cross Border Model distance from Colonias to border crossing locations CSV Transportation Modelers crossBorder_pointOfEntryWaitTime.csv Cross Border Model wait times at border crossing locations table CSV GIS - Pat L vtsql crossBorder_stopFrequency.csv Cross Border Model stop frequency data CSV Transportation Modelers crossBorder_stopPurpose.csv Cross Border Model stop purpose distribution CSV Transportation Modelers crossBorder_outboundStopDuration.csv Cross Border Model time-of-day offsets for outbound stops CSV Transportation Modelers crossBorder_inboundStopDuration.csv Cross Border Model time-of-day offsets for inbound stops CSV Transportation Modelers External Models (Derived from SCAG survey) externalExternalTripsByYear.csv  (raw inputs have these by year)  External origin-destination station trip matrix CSV Transportation Modelers externalInternalControlTotalsByYear.csv  (raw inputs have these by year)  External Internal station control totals read by GISDK CSV Transportation Modelers internalExternal_tourTOD.csv Internal-External Model tour time-of-day frequency distribution CSV Transportation Modelers Commercial Vehicle Model (TO BE UPDATED) tazcentroids_cvm.csv Zone centroid coordinates in state plane feet and albers CSV Transportation Modelers commVehFF.csv Commercial Vehicle Model friction factors CSV Transportation Modelers OE.csv Commercial vehicle model parameters file for off-peak early (OE) period CSV Transportation Modelers AM.csv Commercial vehicle model parameters file for AM period CSV Transportation Modelers MD.csv Commercial vehicle model parameters file for mid-day (MD) period CSV Transportation Modelers PM.csv Commercial vehicle model parameters file for PM period CSV Transportation Modelers OL.csv Commercial vehicle model parameters file for off-peak late (OL) period CSV Transportation Modelers FA.csv Commercial vehicle model parameters file for fleet allocator (FA) industry CSV Transportation Modelers GO.csv Commercial vehicle model parameters file for government/ office (GO) industry CSV Transportation Modelers IN.csv Commercial vehicle model parameters file for industrial (IN) industry CSV Transportation Modelers FA.csv Commercial vehicle model parameters file for fleet allocator (FA) industry CSV Transportation Modelers RE.csv Commercial vehicle model parameters file for retail (RE) industry CSV Transportation Modeler SV.csv Commercial vehicle model parameters file for service (SV) industry CSV Transportation Modelers TH.csv Commercial vehicle model parameters file transport and handling (TH) industry CSV Transportation Modelers WH.csv Commercial vehicle model parameters file wholesale (WH) industry CSV Transportation Modelers Truck Model TruckTripRates.csv Truck model data: Truck trip rates CSV Transportation Modelers regionalEItrips.csv Truck model data: Truck external to internal data CSV Transportation Modelers regionalIEtrips.csv Truck model data: Truck internal to external data CSV Transportation Modelers regionalEEtrips.csv Truck model data: Truck external to external data CSV Transportation Modelers specialGenerators.csv Truck model data: Truck special generator data CSV Transportation Modelers Other parametersByYears.csv Parameters by scenario years. Includes AOC, aiport enplanements, cross-border tours, cross-border sentri share. CSV Transportation Modelers filesByYears.csv File names by scenario years. CSV Transportation Modelers trip_XX.omx Warm start trip table; XX is the TOD (EA, AM, MD, PM, and EV) OMX Transportation Modelers zone.term TAZ terminal times Space Delimited Text File Transportation Modelers <p><code>MGRA_BASED_INPUT&lt;&lt;SCENARIO_YEAR&gt;&gt;.CSV</code></p> Column name Description mgra MGRANumber taz TAZ Number luz_id pop total population hhp total household population (exclude gq pop) hs housing structures hs_sf single family structures hs_mf multi family structures hs_mh mobile homes hh total number of households hh_sf number of households - single family hh_mf number of households - multi family hh_mh number of mobile homes hhs household size gq_civ GQ civilian gq_mil GQ military i1 Number of households with income less than \\(15,000 (\\)2010) i2 Number of households with income \\(15,000-\\)29,999 ($2010) i3 Number of households with income \\(30,000-\\)44,999 ($2010) i4 Number of households with income \\(45,000-\\)59,999 ($2010) i5 Number of households with income \\(60,000-\\)74,999 ($2010) i6 Number of households with income \\(75,000-\\)99,999 ($2010) i7 Number of households with income \\(100,000-\\)124,999 ($2010) i8 Number of households with income \\(125,000-\\)149,999 ($2010) i9 Number of households with income \\(150,000-\\)199,999 ($2010) i10 Number of households with income \\(200,000 or more (\\)2010) emp_gov Government employment emp_mil military employment emp_ag_min Agriculture and mining employment emp_bus_svcs Professional and Business Services employment emp_fin_res_mgm Financial and resource management employment emp_educ Education services employment emp_hlth Health services employment emp_ret Retail services employment emp_trn_wrh Transportation and Warehousing employment emp_con Construction employment emp_utl Utilities office support employment emp_mnf Manufacturing employment emp_whl Wholesale employment emp_ent Entertainment services employment emp_accm Hotel and accomodation services emp_food Food services employment emp_oth Other employment emp_non_ws_wfh Non-wage and salary work from home employments emp_non_ws_oth Non-wage and salary other employments emp_total Total employment pseudomsa Pseudo MSA - 1: Downtown 2: Central 3: North City 4: South Suburban 5: East Suburban 6: North County West 7: North County East 8: East County zip09 2009 Zip Code enrollgradekto8 Grade School K-8 enrollment enrollgrade9to12 Grade School 9-12 enrollment collegeenroll Major College enrollment othercollegeenroll Other College enrollment hotelroomtotal Total number of hotel rooms parkactive Acres of Active Park openspaceparkpreserve Acres of Open Park or Preserve beachactive Acres of Active Beach district27 milestocoast Distance (miles) to the nearest coast acres Total acres in the mgra (used in CTM) land_acres Acres of land in the mgra (used in CTM) effective_acres Effective acres in the mgra (used in CTM) truckregiontype exp_hourly Expected hourly prking cost exp_daily Expected daily prking cost exp_monthly Expected monthly prking cost parking_type MGRA parking type parking_spaces MGRA estimated parking spaces ech_dist Elementary school district hch_dist High school district remoteAVParking Remote AV parking available at MGRA: 0 = Not available, 1 = Available refueling_stations Number of refueling stations at MGRA MicroAccessTime Micro-mobility access time (mins) microtransit microtransit access time (mins) nev Neighborhood Electric Vehicle access time (mins) totint Total intersections duden Dwelling unit density empden Employment density popden Population density retempden Retail employment density totintbin Total intersection bin empdenbin Employment density bin dudenbin Dwelling unit density bin PopEmpDenPerMi Population and employment density per mile <p></p>"},{"location":"inputs.html#activity-mapping-to-industry-codes","title":"Activity Mapping to Industry Codes","text":""},{"location":"inputs.html#activity_code_indcen_acscsv","title":"<code>ACTIVITY_CODE_INDCEN_ACS.CSV</code>","text":"Column Name Description indcen Industry code defined in PECAS: They are about 270 industry categories grouped by 6-digit NAICS code (North American Industrial Classification System) activity_code Activity code defined in PECAS. They are about 30 types of activities grouped by the industry categories:1 = Agriculture3 = Construction Non-Building office support (including mining)5 = Utilities office support9 = Manufacturing office support10 = Wholesale and Warehousing11 = Transportation Activity12 = Retail Activity13 = Professional and Business Services14 = Professional and Business Services (Building Maintenance)16 = Private Education Post-Secondary (Post K-12) and Other17 = Health Services18 = Personal Services Office Based19 = Amusement Services20 = Hotels and Motels21 = Restaurants and Bars22 = Personal Services Retail Based23 = Religious Activity24 = Private Households25 = State and Local Government Enterprises Activity27 = Federal Non-Military Activity28 = Federal Military Activity30 = State and Local Government Non-Education Activity office support31 = Public Education"},{"location":"inputs.html#pecas-soc-defined-occupational-codes","title":"PECAS SOC - Defined Occupational Codes","text":""},{"location":"inputs.html#pecas_occ_occsoc_acscsv","title":"<code>PECAS_OCC_OCCSOC_ACS.CSV</code>","text":"Column Name Description occsoc5 Detailed occupation codes defined by the Standard Occupational Classification (SOC) system commodity_id              Commodity code defined in PECAS. The detailed SOC occupations are grouped into 6 types of laborers, which are included as part of commodity:              51 = Services Labor             52 = Work at Home Labor             53 = Sales and Office Labor             54 = Natural Resources Construction and Maintenance Labor             55 = Production Transportation and Material Moving Labor             56 = Military Labor"},{"location":"inputs.html#listing-of-external-zones-attributes","title":"Listing of External Zones Attributes","text":""},{"location":"inputs.html#externalzonesxls","title":"<code>EXTERNALZONES.XLS</code>","text":"Column Name Description Internal Cordon LUZ Internal Cordon Land use zone External LUZ External land use zone Cordon Point Cordon Point description Destination Approximation Name of approximate city destination Miles to be Added to Cordon Point Miles to be added to cordon point Travel Time Travel time to external zone Border Delay Border delay time Minutes to be Added to Cordon Point Minutes to be added to cordon point MPH Average miles per hour based on miles and minutes to be added to cordon point"},{"location":"inputs.html#population-synthesizer-household-data","title":"Population Synthesizer Household Data","text":""},{"location":"inputs.html#householdscsv","title":"<code>HOUSEHOLDS.CSV</code>","text":"Column Name Description hhid Unique Household ID household_serial_no Household serial number taz TAZ of household mgra MGRA of household hinccat1 Household income category:1 = &lt;$30k2 = $30-60k3 = $60-100k4 = $100-150k5 = $150k+ hinc Household income num_workers Number of workers in household veh Number of vehicles in household persons Number of persons in household hht Household/family type:0 = Not in universe (vacant or GQ)1 = Family household: married-couple2 = Family household: male householder, no wife present3 = Family household: female householder, no husband present4 = Nonfamily household: male householder, living alone5 = Nonfamily household: male householder, not living alone6 = Nonfamily household: female householder, living alone7 = Nonfamily household: female householder, not living alone bldgsz Building size - Number of Units in Structure &amp; Quality:1 = Mobile home or trailer2 = One-family house detached3 = One-family house attached8 = 20-49 Apartments9 = 50 or more apartments unittype Household unit type:0 = Non-GQ Household1 = GQ Household version Synthetic population run version. Presently set to 0. poverty Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"inputs.html#population-synthesizer-person-data","title":"Population Synthesizer Person Data","text":""},{"location":"inputs.html#personscsv","title":"<code>PERSONS.CSV</code>","text":"Column Name Description hhid Household ID perid Person ID Household_serial_no Household serial number pnum Person Number age Age of person sex Gender of person1 = Male2 = Female military Military status of person:0 = N/A Less than 17 Years Old1 = Yes, Now on Active Duty pemploy Employment status of person:1 = Employed Full-Time2 = Employed Part-Time3 = Unemployed or Not in Labor Force4 = Less than 16 Years Old pstudent Student status of person:1 = Pre K-122 = College Undergrad+Grad and Prof. School3 = Not Attending School ptype Person type:1 = Full-time Worker2 = Part-time Worker3 = College Student4 = Non-working Adult5 = Non-working Senior6 = Driving Age Student7 = Non-driving Student8 = Pre-school educ Educational attainment:1 = No schooling completed9 = High school graduate13 = Bachelor\u2019s degree grade School grade of person:0 = N/A (not attending school)2 = K to grade 85 = Grade 9 to grade 126 = College undergraduate occen5 Occupation:0 = Not in universe (Under 16 years or LAST-WRK = 2)1..997 = Legal census occupation code occsoc5 Detailed occupation codes defined by the Bureau of Labor Statistics"},{"location":"inputs.html#highway-network-vehicle-class-toll-factors-file","title":"Highway Network Vehicle Class Toll Factors File","text":""},{"location":"inputs.html#vehicle_class_toll_factorscsv","title":"<code>vehicle_class_toll_factors.csv</code>","text":"<p>Required file. Used to specify the relative toll values by six vehicle classes by Facility name, scenario year and time of day. Can be used, for example, to identify \u201cfree for HOV\u201d type managed lane facilties. Used by the Import network Modeller tool.</p> <p>Example:</p> Facility_name Year Time_of_Day DA_Factor S2_Factor S3_Factor TRK_L_Factor TRK_M_Factor TRK_H_Factor I-15 2016 EA 1.0 0.0 0.0 1.0 1.03 2.33 SR-125 2016 ALL 1.0 1.0 1.0 1.0 1.03 2.33 I-5 2035 ALL 1.0 1.0 0.0 1.0 1.03 2.33 <p>The toll values for each class on each link are calculated by multiplying the input toll value from hwycov.e00 (ITOLLA, ITOLLP, ITOLLO) by this factor, matched by the Facility name (together with the toll factors from off_peak_toll_factors.csv in converting ITOLLO to the off-peak times-of-day). </p> <p>The network links are matched to a record in this file based on the NM, FXNM or TXNM values (in that order). A simple substring matching is used, so the record with Facility_name \u201cI-15\u201d matches any link with name \u201cI-15 SB\u201d, \u201cI-15 NB\u201d, \u201cI-15/DEL LAGO DAR NB\u201d etc. The records should not be overlapping: if there are two records which match a given link it will be an arbitrary choice as to which one is used.</p> <p>Note that if a link does not match to a record in this file, the default factors (specified in the table below) will be applied to said link. It is OK if there are records for which there are no link tolls.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields Year Scenario year Time_of_Day              Time of day period:             EA = Early morning (3am - 5:59am)             AM = AM peak (6am to 8:59am)             MD = Mid-day (9am to 3:29pm)             PM = PM peak (3:30pm to 6:59pm)             EV = Evening (7pm to 2:59am)             ALL = All time of day periods          DA_Factor Positive toll factor for Drive Alone (SOV) vehicle classes. The default value is 1.0 S2_Factor Positive toll factor for Shared 2 person (HOV2) vehicle classes. The default value is 1.0 S3_Factor Positive toll factor for Shared 3+ person (HOV3) vehicle classes. The default value is 1.0 TRK_L_Factor Positive toll factor for Light Truck (TRKL) vehicle classes. The default value is 1.0 TRK_M_Factor Positive toll factor for Medium Truck (TRKM) vehicle classes. The default value is 1.03 TRK_H_Factor Positive toll factor for Heavy Truck (TRKH) vehicle classes. The default value is 2.03 <p></p>"},{"location":"inputs.html#highway-network-off-peak-toll-factors-file","title":"Highway Network Off-Peak Toll Factors File","text":""},{"location":"inputs.html#off_peak_toll_factorscsv","title":"<code>off_peak_toll_factors.csv</code>","text":"<p>Optional file. Used to specify different tolls in the off-peak time-of-day scenarios based on the single link ITOLLO field, together with the tolls by vehicle class from vehicle_class_toll_factors.csv. Used by the Import network Modeller tool.</p> <p>Example: <pre><code>Facility_name, OP_EA_factor, OP_MD_factor, OP_EV_factor\nI-15,                  0.75,          1.0,         0.75\nSR-125,                1.0 ,          1.0,         1.0\nSR-52,                 0.8 ,          1.0,         0.8\n</code></pre></p> <p>See note re: network link matching under vehicle_class_toll_factors.csv. Note that all facilities need not be specified, links not matched will use a factor of 1.0.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields OP_EA_FACTOR Positive toll factor for Early AM period tolls OP_MD_FACTOR Positive toll factor for Midday period tolls OP_EV_FACTOR Positive toll factor for Evening period tolls <p></p>"},{"location":"inputs.html#highway-network-vehicle-class-toll-factors-file_1","title":"Highway Network Vehicle Class Toll Factors File","text":""},{"location":"inputs.html#vehicle_class_availabilitycsv","title":"<code>vehicle_class_availability.csv</code>","text":"<p>Optional file. Specifies the availability / unavailability of six vehicle classes for five times-of-day by Facility name. This will override any mode / vehicle class availability specified directly on the network (hwycov.e00), via ITRUCK and IHOV fields. Used in the generation of time-of-day Emme scenarios in the Master run Modeller tool.</p> <p>Example:</p> Facility_name vehicle_class EA_Avail AM_Avail MD_Avail PM_Avail EV_Avail I-15 DA 1 1 1 1 1 I-15 S2 1 1 1 1 1 I-15 S3 1 0 1 0 1 I-15 TRK_L 1 1 1 1 1 I-15 TRK_M 1 0 0 0 1 I-15 TRK_H 1 0 0 0 1 <p>See note re: network link matching under vehicle_class_toll_factors.csv. Note that all facilities need not be specified, links not matched will use the availability as indicated by the link fields in hwycov.e00.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields Vehicle_class Name of the vehicle class, one of DA, S2, S3, TRK_L, TRK_M, or TRK_H EA_Avail For this facility and vehicle class, is available for Early AM period (0 or 1) AM_Avail For this facility and vehicle class, is available for AM Peak period (0 or 1) MD_Avail For this facility and vehicle class, is available for Midday period (0 or 1) PM_Avail For this facility and vehicle class, is available for PM Peak period (0 or 1) EV_Avail For this facility and vehicle class, is available for Evening period (0 or 1)"},{"location":"inputs.html#special_farestxt","title":"<code>special_fares.txt</code>","text":"<pre><code>boarding_cost:\n   base: \n       - {line: \"398104\", cost: 3.63}\n       - {line: \"398204\", cost: 3.63}\n   stop_increment:\n       - {line: \"398104\", stop: \"SORRENTO VALLEY\", cost: 0.46}\n       - {line: \"398204\", stop: \"SORRENTO VALLEY\", cost: 0.46}\nin_vehicle_cost: \n   - {line: \"398104\", from: \"SOLANA BEACH\", cost: 0.45}\n   - {line: \"398104\", from: \"SORRENTO VALLEY\", cost: 0.45}\n   - {line: \"398204\", from: \"OLD TOWN\",  cost: 0.45}\n   - {line: \"398204\", from: \"SORRENTO VALLEY\", cost: 0.45}\nday_pass: 4.54\nregional_pass: 10.90\n</code></pre>"},{"location":"inputs.html#transit-binary-stop-table","title":"Transit Binary Stop Table","text":""},{"location":"inputs.html#trstopcsv","title":"<code>TRSTOP.CSV</code>","text":"Column Name Description Stop_id Unique stop ID Route_id Sequential route number Link_id Link id associated with route Pass_count Number of times the route passes this stop. Most of value is one, some value is 2 Milepost Stop mile post Longitude Stop Longitude Latitude Stop Latitude NearNode Node number that stop is nearest to FareZone Zones defined in Fare System StopName Name of Stop MODE_NAME              Line haul mode name:             Transfer             Center City Walk             Walk Access             Commuter Rail             Light Rail             Regional BRT (Yellow)             Regional BRT (Red)             Limited Express             Express             Local          MODE_ID              Mode ID             1 = Transfer             2 = Center City Walk             3 = Walk Access             4 = Commuter Rail             5 = Light Rail             6 = Regional BRT (Yellow)             7 = Regional BRT (Red)             8 = Limited Express             9 = Express             10 = Local          PREMODE              Premium Transit mode             0 = No             1 = Yes          EXPBSMODE              Express bus mode             0 = No             1 = Yes          LOCMODE              Local bus mode             0 = No             1 = Yes          OP_TRNTIME              Off peak transcad matrix used by mode:             *oploctime             *oppretime          AM_TRNTIME              AM peak transcad matrix used by mode:             *amloctime             *ampretime          PM_TRNTIME              PM peak transcad matrix used by mode:             *pmloctime             *pmpretime          MODE_ACCES Mode of access (1) MODE_EGRES Mode of egress (1) WT_IVTPK Weight for peak in-vehicle time: 1, 1.5, or 1.8 WT_FWTPK Weight for peak first wait time: 1, 1.5 WT_XWTPK Weight for peak transfer wait time: 1, 3 WT_FAREPK Weight for peak fare: 0.46, 0.60, 0.63, 0.67, 1 WT_IVTOP Weight for off-peak in-vehicle time: 1, 1.5, or 1.6 WT_FWTOP Weight for off-peak first wait time: 1, 1.5 WT_XWTOP Weight for off-peak transfer wait time: 1, 3 WT_FAREOP Weight for off-peak fare: 0.23, 0.51, 0.52, 0.54, 0.58, 1 FARE Transit fare: $0, $1.25, $1.50, $2.50, $3.00, $3.50 DWELLTIME Dwell time: 0, 0.3, 0.5 FARETYPE              Fare Type:             1 = Bus             2 = Rail          FAREFIELD              Fare Field:             coaster fare             lightrail fare          CRMODE Boolean if Commuter rail available LRMODE Boolean if light rail available XFERPENTM Transfer Penalty time: 5 minutes WTXFERTM Transfer Wait time: 1 minute TRNTIME_EA Early AM transit time impedance TRNTIME_AM AM transit time impedance TRNTIME_MD Midday transit time impedance TRNTIME_PM PM transit time impedance TRNTIME_EV Evening transit time impedance"},{"location":"inputs.html#transit-timed-transfers-between-coaster-and-feeder-buses","title":"Transit Timed Transfers Between COASTER and Feeder Buses","text":""},{"location":"inputs.html#timexfer_xxcsv","title":"<code>TIMEXFER_XX.CSV</code>","text":"Column Name Description FROM_LINE From Route Number TO_LINE To Route Number WAIT_TIME Wait time in minutes"},{"location":"inputs.html#transit-stop-table","title":"Transit Stop Table","text":""},{"location":"inputs.html#trstopcsv_1","title":"<code>TRSTOP.CSV</code>","text":"Column Name Description Stop_id Unique stop ID Route_id Sequential route number Link_id Link id associated with route Pass_count Number of times the route passes this stop. Most of value is one, some value is 2 Milepost Stop mile post Longitude Stop Longitude Latitude Stop Latitude NearNode Node number that stop is nearest to FareZone Zones defined in Fare System StopName Name of Stop MODE_NAME Line haul mode name:TransferCenter City WalkWalk AccessCommuter RailLight RailRegional BRT (Yellow)Regional BRT (Red)Limited ExpressExpressLocal MODE_ID Mode ID1 = Transfer2 = Center City Walk3 = Walk Access4 = Commuter Rail5 = Light Rail6 = Regional BRT (Yellow)7 = Regional BRT (Red)8 = Limited Express9 = Express10 = Local PREMODE Premium Transit mode0 = No1 = Yes EXPBSMODE Express bus mode0 = No1 = Yes LOCMODE Local bus mode0 = No1 = Yes OP_TRNTIME Off peak transcad matrix used by mode:oploctimeoppretime AM_TRNTIME AM peak transcad matrix used by mode:amloctimeampretime PM_TRNTIME PM peak transcad matrix used by mode:pmloctimepmpretime MODE_ACCES Mode of access (1) MODE_EGRES Mode of egress (1) WT_IVTPK Weight for peak in-vehicle time: 1, 1.5, or 1.8 WT_FWTPK Weight for peak first wait time: 1, 1.5 WT_XWTPK Weight for peak transfer wait time: 1, 3 WT_FAREPK Weight for peak fare: 0.46, 0.60, 0.63, 0.67, 1 WT_IVTOP Weight for off-peak in-vehicle time: 1, 1.5, or 1.6 WT_FWTOP Weight for off-peak first wait time: 1, 1.5 WT_XWTOP Weight for off-peak transfer wait time: 1, 3 WT_FAREOP Weight for off-peak fare: 0.23, 0.51, 0.52, 0.54, 0.58, 1 FARE Transit fare: $0, $1.25, $1.50, $2.50, $3.00, $3.50 DWELLTIME Dwell time: 0, 0.3, 0.5 FARETYPE Fare Type:1 = Bus2 = Rail FAREFIELD Fare Field:coaster farelightrail fare CRMODE Boolean if Commuter rail available LRMODE Boolean if light rail available XFERPENTM Transfer Penalty time: 5 minutes WTXFERTM Transfer Wait time: 1 minute TRNTIME_EA Early AM transit time impedance TRNTIME_AM AM transit time impedance TRNTIME_MD Midday transit time impedance TRNTIME_PM PM transit time impedance TRNTIME_EV Evening transit time impedance"},{"location":"inputs.html#transit-link-file","title":"Transit Link File","text":""},{"location":"inputs.html#trlinkcsv","title":"<code>TRLINK.CSV</code>","text":"Column Name Description Route_id: Sequential route number Link_id Link id associated with route Direction + or -"},{"location":"inputs.html#bike-network-link-field-list","title":"Bike Network Link Field List","text":""},{"location":"inputs.html#sandag_bike_netdbf","title":"<code>SANDAG_BIKE_NET.DBF</code>","text":"Column Name Description ROADSEGID Road Segment ID RD20FULL Road/Street Name A Foreign key of first node B Foreign key of second node A_LEVEL Level of first node B_LEVEL Level of second node Distance Arc length of link (ft) AB_Gain Cumulative non-negative increase in elevation from A to B nodes (ft) BA_Gain Cumulative non-negative increase in elevation from B to A nodes (ft) ABBikeClas Type of Bike Classification in AB direction where:1 = Multi-Use Path2 = Bike Lane3 = Bike Route BABikeClas Type of Bike Classification in BA direction where:1 = Multi-Use Path2 = Bike Lane3 = Bike Route AB_Lanes Number of Lanes in AB direction BA_Lanes Number of Lanes in BA direction Func_Class Type of Road Functional Class where:1 = Freeway to Freeway Ramp2 = Light (2-lane) Collector Street3 = Rural Collector Road4 = Major Road/4-lane Major Road5 = Rural Light Collector/Local Road6 = Prime Arterial7 = Private Street8 = Recreational Parkway9 = Rural Mountain RoadA = AlleyB = Class I Bicycle PathC = Collector/4-lane Collector StreetD = Two-lane Major StreetE = ExpresswayF = FreewayL = Local Street/Cul-de-sacM = Military Street within BaseP = Paper StreetQ = UndocumentedR = Freeway/Expressway On/Off RampS = Six-lane Major StreetT = TransitwayU = Unpaved RoadW = Pedestrian Way/Bikeway Bike2Sep Separated Bike Lane Flag where:0 = No1 = Yes Bike3Blvd Bike Boulevard Lane Flag where:0 = No1 = Yes SPEED Road Speed A_Elev A Node Elevation B_Elev B Node Elevation ProjectID Project ID in the regional bike network Year Year built/opened to the public Scenicldx Scenic index represents the closeness to the ocean and parks Path Null Shape_Leng length of the link (ft)"},{"location":"inputs.html#bike-network-node-field-list","title":"Bike Network Node Field List","text":""},{"location":"inputs.html#sandag_bike_nodedbf","title":"<code>SANDAG_BIKE_NODE.DBF</code>","text":"Column Name Description NodeLev_ID Node Unique Identifier MGRA MGRA ID for Centroids TAZ TAZ ID for Centroids TAP TAP ID XCOORD X Coordinate of Node in NAD 1983 State Plane California Region VI FIPS: 0406 (ft) YCOORD Y Coordinate of Node in NAD 1983 State Plane California Region VI FIPS: 0406(ft) ZCOORD Elevation (ft) Signal              Traffic Signal Presence where:             0 = Absence             1 = Presence"},{"location":"inputs.html#zone-terminal-time","title":"Zone Terminal Time","text":""},{"location":"inputs.html#zoneterm","title":"<code>ZONE.TERM</code>","text":"Column Name Description Zone TAZ number Terminal time Terminal time (3, 4, 5, 7, 10 minutes)"},{"location":"inputs.html#bike-taz-logsum","title":"Bike TAZ Logsum","text":""},{"location":"inputs.html#biketazlogsumcsv","title":"<code>BIKETAZLOGSUM.CSV</code>","text":"Column Name Description i Origin TAZ j Destination TAZ Logsum Logsum - a measure of the closeness of the origin and the destination of the trip time Time (In minutes)"},{"location":"inputs.html#bike-mgra-logsum","title":"Bike MGRA Logsum","text":""},{"location":"inputs.html#bikemgralogsumcsv","title":"<code>BIKEMGRALOGSUM.CSV</code>","text":"Column Name Description i Origin of MGRA j Destination of MGRA Logsum Logsum - a measure of the closeness of the origin and the destination of the trip time Time (in minutes)"},{"location":"inputs.html#walk-mgra-equivalent-minutes","title":"Walk MGRA Equivalent Minutes","text":""},{"location":"inputs.html#walkmgraequivminutescsv","title":"<code>WALKMGRAEQUIVMINUTES.CSV</code>","text":"Column Name Description i Origin (MGRA) j Destination (MGRA) percieved Percieved time to walk actual Actual time to walk (minutes) gain Gain in elevation"},{"location":"inputs.html#airport-trip-purpose-distribution","title":"Airport Trip Purpose Distribution","text":""},{"location":"inputs.html#airport_purposesancsv-and-airport_purposecbxcsv","title":"<code>AIRPORT_PURPOSE.SAN.CSV AND AIRPORT_PURPOSE.CBX.CSV</code>","text":"Column Name Description Purpose              Trip Purpose:             0 = Resident Business             1 = Resident Personal             2 = Visitor Business             3 = Visitor Personal             4 = External          Percent Distribution of Trips in trip purpose"},{"location":"inputs.html#airport-party-size-by-purpose-distribution","title":"Airport Party Size by Purpose Distribution","text":""},{"location":"inputs.html#airport_partysancsv-and-airport_partycbxcsv","title":"<code>AIRPORT_PARTY.SAN.CSV AND AIRPORT_PARTY.CBX.CSV</code>","text":"Column Name Description Party Party size (0 through 5+) purp0_perc Distribution for Resident Business purpose purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-number-of-nights-by-purpose-distribution","title":"Airport Number of Nights by Purpose Distribution","text":""},{"location":"inputs.html#airport_nightssancsv-and-airport_nightscbxcsv","title":"<code>AIRPORT_NIGHTS.SAN.CSV AND AIRPORT_NIGHTS.CBX.CSV</code>","text":"Column Name Description Nights Number of Nights stayed (0 through 14+) purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-income-by-purpose-distribution","title":"Airport Income by Purpose Distribution","text":""},{"location":"inputs.html#airport_incomesancsv-and-airport_incomecbxcsv","title":"<code>AIRPORT_INCOME.SAN.CSV AND AIRPORT_INCOME.CBX.CSV</code>","text":"Column Name Description Income group              Household income:             0 = Less than $25K             1 = $25K \u2013 $50K             2 = $50K \u2013 $75K             3 = $75K \u2013 $100K             4 = $100K \u2013 $125K             5 = $125K \u2013 $150K             6 = $150K \u2013 $200K             7 = $200K plus          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-departure-time-by-purpose-distribution","title":"Airport Departure Time by Purpose Distribution","text":""},{"location":"inputs.html#airport_departuresancsv-and-airport_departurecbxcsv","title":"<code>AIRPORT_DEPARTURE.SAN.CSV</code> and <code>AIRPORT_DEPARTURE.CBX.CSV</code>","text":"Column Name Description Period              Departure Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-arrival-time-by-purpose-distribution","title":"Airport Arrival Time by Purpose Distribution","text":""},{"location":"inputs.html#airport_arrivalsancsv-and-airport_arrivalcbxcsv","title":"<code>AIRPORT_ARRIVAL.SAN.CSV</code> and <code>AIRPORT_ARRIVAL.CBX.CSV</code>","text":"Column Name Description Period              Arrival Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#cross-border-model-tour-entry-and-return-distribution","title":"Cross Border Model Tour Entry and Return Distribution","text":""},{"location":"inputs.html#crossborder_tourentryandreturncsv","title":"<code>CROSSBORDER_TOURENTRYANDRETURN.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          EntryPeriod              Entry Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Return Period              Return Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Percent Distribution of tours in entry and return period time slots"},{"location":"inputs.html#cross-border-model-supercolonia","title":"Cross Border Model Supercolonia","text":""},{"location":"inputs.html#crossborder_supercoloniacsv","title":"<code>CROSSBORDER_SUPERCOLONIA.CSV</code>","text":"Column Name Description Supercolonia_ID Super colonia ID Population Population of the super colonia Distance_poe0 Distance from colonia to point of entry 0 (San Ysidro) Distance_poe1 Distance from colonia to point of entry 1 (Otay Mesa) Distance_poe2 Distance from colonia to point of entry 2 (Tecate)"},{"location":"inputs.html#cross-border-model-point-of-entry-wait-time","title":"Cross Border Model Point of Entry Wait Time","text":""},{"location":"inputs.html#crossborder_pointofentrywaittimecsv","title":"<code>CROSSBORDER_POINTOFENTRYWAITTIME.CSV</code>","text":"Column Name Description poe              Point of Entry number:             0 = San Ysidro             1 = Otay Mesa             2 = Tecate             3 = Otay Mesa East             4 = Jacumba          StartHour Start Hour (1 through 12) EndHour End Hour (1 through 12) StartPeriod              Start Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          EndPeriod              End Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          StandardWait Standard wait time SENTRIWait SENTRI users wait time PedestrianWait Pedestrian wait time"},{"location":"inputs.html#cross-border-model-stop-frequency","title":"Cross Border Model Stop Frequency","text":""},{"location":"inputs.html#crossborder_stopfrequencycsv","title":"<code>CROSSBORDER_STOPFREQUENCY.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          DurationLo Lower bound of tour duration (0, 4, or 8) DurationHi Upper bound of tour duration (4, 8, or 24) Outbound Number of stops on the outbound (0, 1, 2, 3+) Inbound Number of stops on the inbound (0, 1, 2, 3+) Percent Distribution of tours by purpose, duration, number of outbound/inbound stops"},{"location":"inputs.html#cross-border-model-stop-purpose-distribution","title":"Cross Border Model Stop Purpose Distribution","text":""},{"location":"inputs.html#crossborder_stoppurposecsv","title":"<code>CROSSBORDER_STOPPURPOSE.CSV</code>","text":"Column Name Description TourPurp              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          Inbound Boolean for whether stop is inbound (0=No, 1=Yes) StopNum Stop number on tour (1, 2, or 3) Multiple Boolean for whether there are multiple stops on tour (0=No, 1=Yes) StopPurp0 Distribution of Work stops StopPurp1 Distribution of School stops StopPurp2 Distribution of Cargo stops StopPurp3 Distribution of Shopping stops StopPurp4 Distribution of Visiting stops StopPurp5 Distribution of Other stops"},{"location":"inputs.html#cross-border-model-outbound-stop-duration-distribution","title":"Cross Border Model Outbound Stop Duration Distribution","text":""},{"location":"inputs.html#crossborder_outboundstopdurationcsv","title":"<code>CROSSBORDER_OUTBOUNDSTOPDURATION.CSV</code>","text":"Column Name Description RemainingLow              Lower bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          RemainingHigh              Upper bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Stop Stop number on tour (1, 2, or 3) 0 Probability that stop departure is in same period as last outbound trip 1 Probability that stop departure is in last outbound trip period + 1 2 Probability that stop departure is in last outbound trip period + 2 3 Probability that stop departure is in last outbound trip period + 3 4 Probability that stop departure is in last outbound trip period + 4 5 Probability that stop departure is in last outbound trip period + 5 6 Probability that stop departure is in last outbound trip period + 6 7 Probability that stop departure is in last outbound trip period + 7 8 Probability that stop departure is in last outbound trip period + 8 9 Probability that stop departure is in last outbound trip period + 9 10 Probability that stop departure is in last outbound trip period + 10 11 Probability that stop departure is in last outbound trip period + 11"},{"location":"inputs.html#cross-border-model-inbound-stop-duration-distribution","title":"Cross Border Model Inbound Stop Duration Distribution","text":""},{"location":"inputs.html#crossborder_inboundstopdurationcsv","title":"<code>CROSSBORDER_INBOUNDSTOPDURATION.CSV</code>","text":"Column Name Description RemainingLow              Lower bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          RemainingHigh              Upper bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Stop Stop number on tour (1, 2, or 3) 0 Probability that stop departure period is same as tour arrival period -1 Probability that stop departure period is tour arrival period - 1 -2 Probability that stop departure period is tour arrival period \u2013 2 -3 Probability that stop departure period is tour arrival period \u2013 3 -4 Probability that stop departure period is tour arrival period \u2013 4 -5 Probability that stop departure period is tour arrival period \u2013 5 -6 Probability that stop departure period is tour arrival period \u2013 6 -7 Probability that stop departure period is tour arrival period - 7"},{"location":"inputs.html#externalexternaltripsbyyearcsv","title":"<code>EXTERNALEXTERNALTRIPSByYEAR.CSV</code>","text":"Column Name Description originTAZ External origin TAZ destinationTAZ External destination TAZ Trips Number of trips between external TAZs"},{"location":"inputs.html#external-internal-control-totals","title":"External Internal Control Totals","text":""},{"location":"inputs.html#externalinternalcontroltotalsbyyearcsv","title":"<code>EXTERNALINTERNALCONTROLTOTALSByYEAR.CSV</code>","text":"Column Name Description Taz External TAZ station Work Number of work vehicle trips Nonwork Number of non-work vehicle trips"},{"location":"inputs.html#internal-external-tours-time-of-day-distribution","title":"Internal External Tours Time of Day Distribution","text":""},{"location":"inputs.html#internalexternal_tourtodcsv","title":"<code>INTERNALEXTERNAL_TOURTOD.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = All Purposes          EntryPeriod              Entry Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          ReturnPeriod              Return Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Percent Distribution of tours by entry and return periods"},{"location":"inputs.html#parameters-by-scenario-years","title":"Parameters by Scenario Years","text":""},{"location":"inputs.html#parametersbyyearscsv","title":"<code>PARAMETERSBYYEARS.CSV</code>","text":"Column Name Description year Scenario build year aoc.fuel Auto operating fuel cost aoc.maintenance Auto operating maitenance cost airport.SAN.enplanements San Diego International Airport enplanements airport.SAN.connecting San Diego International Airport connecting passengers airport.SAN.airportMgra MGRA San Diego International Airport is located in airport.CBX.enplanements Cross Border Express Terminal (Tijuana International Airport) enplanements airport.CBX.connecting Cross Border Express Terminal (Tijuana International Airport) connecting passengers airport.CBX.airportMgra MGRA Cross Border Express Terminal is located in crossBorder.tours Number of cross border tours crossBorders.sentriShare Share of cross border tours that are SENTRI taxi.baseFare Initial taxi fare taxi.costPerMile Taxi cost per mile taxi.cosPerMinute Taxi cost per minute TNC.single.baseFare Initial TNC fare for single ride TNC.single.costPerMile TNC cost per mile for single ride TNC.single.costPerMinute TNC cost per minute for single ride TNC.single.costMinimum TNC minimum cost for single ride TNC.shared.baseFare Initial TNC fare for shared ride TNC.shared.costPerMile TNC cost per mile for shared ride TNC.shared.costPerMinute TNC cost per minute for shared ride TNC.shared.costMinimum TNC minimum cost for shared ride Mobility.AV.RemoteParkingCostPerHour Remote parking cost per hour for autonomous vehicles active.micromobility.variableCost Variable cost for micromobility active.micromobility.fixedCost Fixed cost for micromobility active.microtransit.fixedCost Fixed cost for microtransit Mobility.AV.Share The share of vehicles assumed to be autonomous vehicles in the vehicle fleet smartSignal.factor.LC smartSignal.factor.MA smartSignal.factor.PA atdm.factor"},{"location":"inputs.html#files-by-scenario-years","title":"Files by Scenario Years","text":""},{"location":"inputs.html#filesbyyearscsv","title":"<code>FILESBYYEARS.CSV</code>","text":"Column Name Description year Scenario build year crossborder.dc.soa.alts.file Crossborder model destination choice alternatives file crossBorder.dc.uec.file Crossborder model destination choice UEC file uwsl.dc.uec.file Tour destination choice UEC file nmdc.uec.file Non-mandatory tour destination choice UEC file crossBorder.tour.mc.uec.file Crossborder model tour mode choice UEC file visualizer.reference.path Path to reference scenario for SANDAG ABM visualizer"},{"location":"inputs.html#mgras-at-mobility-hubs","title":"MGRAs at Mobility Hubs","text":""},{"location":"inputs.html#mobilityhubmgracsv","title":"<code>MOBILITYHUBMGRA.CSV</code>","text":"Column Name Decription MGRA MGRA ID MoHubName Mobility Hub name MoHubType              Mobility Hub type:             Suburban             Coastal             Gateway             Major Employment Center             Urban          <p>Go To Top</p>"},{"location":"outputs.html","title":"Model Outputs","text":"<p>Model outputs are stored in the .\\outputs directory. The contents of the directory are listed in the table below.</p>"},{"location":"outputs.html#output-directory-output","title":"Output Directory (.\\output)","text":"Directory\\File Name Description airport.CBX (directory)     Outputs for Cross-Border Express Airport Ground Access Model     airport.SAN (directory)     Outputs for San Diego International Airport Ground Access Model     assignment (directory)     Assignment outputs     crossborder (directory)     Crossborder Travel Model outputs     cvm (directory)     Commercial Vehicle Model outputs     parking (directory)     Parking model outputs     resident (directory)     Resident model outputs     skims (directory)     Skim outputs     visitor (directory)     Visitor Model outputs     bikeMgraLogsum.csv     Bike logsum file for close-together MGRAs     bikeTazLogsum.csv     Bike logsum file for TAZs     datalake_metadata.yaml     Metadata file for datalake reporting system     derivedBikeEdges.csv     Derived bike network edge file     derivedBikeNodes.csv     Derived bike network node file     derivedBikeTraversals.csv     Derived bike network traversals file     microMgraEquivMinutes.csv     Equivalent minutes for using micromobility between close-together MGRAs (not used)     runtime_summary.csv     Summary of model runtime     temp_tazdata_cvm.csv     TAZ data for commercial vehicle model     transponderModelAccessibilities.csv     Transponder model accessibilities (not used)     trip_(period).omx     Trips for each time period, for assignment     walkMgraEquivMinutes.csv     Equivalent minutes for walking between close-together MGRAs"},{"location":"outputs.html#skims-skims","title":"Skims (.\\skims)","text":"<p>This directory contains auto, transit, and non-motorized level-of-service matrices, also known as skims. Each file is a collection of origin destination tables of times and costs, at the TAZ level.</p> File     Description     dest_pmsa.omx     A matrix containing pseudo - metropolitan statistical area code for each destination TAZ     dest_poi.omx     A matrix containing point of interest code for each destination TAZ (currently zeros)     dest_poi.omx.csv     A csv file containing point of interest code for each destination TAZ (currently zeros)     impm(truck type)(toll type)_(period)_(matrixtype).txt     Truck impedance matrix for truck type (ld = Light duty, lhd = light heavy duty, mhd = medium heavy duty, hhd = heavy heavy duty), toll type (n = non-toll, t = toll) and matrixtype (DU = utility, dist = distance, time = time)     maz_maz_bike.csv     Bike logsums between close together MGRAs     maz_maz_walk.csv     Walk times between close together MGRAs     maz_stop_walk.csv     Walk times between MGRAs and transit stops     taz_pmsa_xwalk.csv     Crosswalk file between pseudo-metropolitan statistical areas and TAZs     traffic_skims_(period).omx Auto skims by period (EA, AM, MD, PM, EV)     transit_skims_(period).omx Transit skims by period (EA, AM, MD, PM, EV)     <p></p>"},{"location":"outputs.html#auto-skims-by-period","title":"Auto skims by period","text":"<p><code>TRAFFIC_SKIMS_&lt;time period&gt;.OMX</code></p> Table Name     Description     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TIME     Travel time for evaluation of volume-delay functions     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_DIST     Travel distance     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_REL     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TOLLCOST     Total toll cost (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TOLLDIST     Total distance on toll facilities (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_MLCOST     Total cost for managed lane facilities (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_HOVDIST     Distance on HOV facilities (only for HOV traffic classes)     *traffic class = SOV_TR, SOV_NT, HOV2, HOV3, TRK     vot = L (low), M (medium), and H (high)     <p></p>"},{"location":"outputs.html#transit-skims-by-period","title":"Transit skims by period","text":"<p><code>TRANSIT_SKIMS_&lt;time_period&gt;.OMX</code></p> Table Name     Description     &lt;time_period&gt;_&lt;transit_class&gt;_GENCOST     Total generalized cost which includes perception factors from assignment     &lt;time_period&gt;_&lt;transit_class&gt;_FIRSTWAIT     actual wait time at initial boarding point     &lt;time_period&gt;_&lt;transit_class&gt;_XFERWAIT     actual wait time at all transfer boarding points     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALWAIT     total actual wait time     &lt;time_period&gt;_&lt;transit_class&gt;_FARE     fare paid     &lt;time_period&gt;_&lt;transit_class&gt;_XFERS     number of transfers     &lt;time_period&gt;_&lt;transit_class&gt;_ACCWALK     access actual walk time prior to initial boarding     &lt;time_period&gt;_&lt;transit_class&gt;_EGRWALK     egress actual walk time after final alighting     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALWALK     total actual walk time     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALIVTT     Total actual in-vehicle travel time     &lt;time_period&gt;_&lt;transit_class&gt;_DWELLTIME     Total dwell time at stops     &lt;time_period&gt;_&lt;transit_class&gt;_BUSIVTT     actual in-vehicle travel time on local bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_LRTIVTT     actual in-vehicle travel time on LRT mode     &lt;time_period&gt;_&lt;transit_class&gt; _CMRIVTT     actual in-vehicle travel time on commuter rail mode     &lt;time_period&gt;_&lt;transit_class&gt; _EXPIVTT     actual in-vehicle travel time on express bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_LTDEXPIVTT     actual in-vehicle travel time on premium bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_BRTIVTT     actual in-vehicle travel time on  BRT mode     *time period = EA, AM, MD, PM, EV     transit_class = LOC, PRM, MIX"},{"location":"outputs.html#activitysim-log-files","title":"ActivitySim log files","text":"<p>ActivitySim writes out various log files when it runs; these have standard names for each model component. Therefore we list them separately, but copies of these files may be in each model\u2019s output directory depending upon the settings used to run ActivitySim for that model component.</p> File  Description activitysim.log     ActivitySim log file for model     breadcrumbs.yaml     Breadcrumbs provides a record of steps that have been run for use when resuming a model run     final_checkpoints.csv     ActivitySim checkpoint file      final_pipeline.h5     ActivitySim pipeline file     mem.csv     ActivitySim memory use log file     mem_mp_households.csv     Memory logs for ActivitySim model steps running with the same num_processes (all except accessibility, initialize, and summarize)     mem_mp_initialize.csv     Memory logs for ActivitySim model step initialize     mem_mp_summarize.csv     Memory logs for ActivitySim model step summarize     mp_households_(processnumber)-activitysim.log     ActivitySim log file for processnumber. This logfile is created if model is run in multiprocess mode     mp_households_(processnumber)-mem.csv     Memory log file for processnumber     mp_households_apportion-activitysim.log     ActivitySim log file for apportioning data between multiple processes     mp_households_coalesce-activitysim.log     ActivitySIm logfile for coalesing output from multiple processes into one     mp_initialize-activitysim.log     ActivitySim log file for the initialization steps     mp_initialize-mem.csv     Memory logs for ActivitySim model step summarize (similar to mp_initialize-mem.csv)     mp_setup_skims-activitysim.log     ActivitySim logfile for reading in skims     mp_summarize-activitysim.log     ActivitySim log file for summarizing model output (omx and csv trip table)     mp_summarize-mem.csv     Memory logs for ActivitySim model step summarize (similar to mem_mp_initialize.csv)     mp_tasks_log.txt     Log files of multiprocessed steps     omnibus_mem.csv     Memory log file of all model steps (similar to mem.csv)     run_list.txt     List of models that have been run     timing_log.csv     Model run time by steps"},{"location":"outputs.html#airport-model-outputs-airportcbx-airportsan","title":"Airport model outputs (.\\airport.CBX, .\\airport.SAN)","text":"<p>There are two subdirectories containing outputs for each of the two airport models. airport.CBX contains output for the Cross-Border Express model, and airport.SAN contains output for the San Diego International Airport model. Each directory has identical files so we provide one generic output table below.</p> Filename Description final_(airport)accessibility.csv     Accessibility file for airport (cbx, san) (not used, created by default)     [final_(airport)households.csv](#### Airport Model household file (final_(airport)households.csv))     Household file for airport (cbx, san)     final_(airport)land_use.csv     Land-use file for airport (cbx, san)     [final_(airport)persons.csv](#### Airport Model person file (final_(airport)persons.csv))     Persons file for airport (cbx, san)     [final_(airport)tours.csv](#### Airport Model tour file (final_(airport)tours.csv))     Tour file for airport (cbx, san)     [final_(airport)trips.csv](#### Airport Model trip file (final_(airport)trips.csv))     Trip file for airport (cbx, san)     model_metadata.yaml     Datalake metadata file     autoairporttrips.(airport)_(period).omx     Auto trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     tranairporttrips.(airport)_(period).omx     Transit trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     nmotairporttrips.(airport)_(period).omx     Non-motorized trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#airport-model-household-file-final_airporthouseholdscsv","title":"Airport Model household file (final_(airport)households.csv)","text":"Field     Description     home_zone_id     Airport MGRA     sample_rate     Sample rate     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#airport-model-person-file-final_airportpersonscsv","title":"Airport Model person file (final_(airport)persons.csv)","text":"Field     Description     household_id     Household ID     person_id     Person ID"},{"location":"outputs.html#airport-model-tour-file-final_airporttourscsv","title":"Airport Model tour file (final_(airport)tours.csv)","text":"Field     Description     tour_id     Tour ID     purpose_id     ID for tour type: <p> 1 = resident business <p> 2 = resident personal <p> 3= visitor business <p> 4 = visitor personal <p> 5 = external     party_size     Number of persons in airport travel party     nights     Number of nights away     income     Income group 0-7,  -99 if employee     direction     Direction of trip. String. outbound: airport to non-airport, inbound: non-airport to airport     household_id     Household ID     person_id     Person ID     tour_category     Tour category. String \"non_mandatory\"     tour_type     Type of tour. String. \"Emp\": Employee, \"ext\": External, \"res_busn\": Resident business where n is the ID for the income bracket (1&lt;25K, 2: between 25K &amp; 50K, 3: between 50K &amp; 75K, 4: between 75K &amp; 100K, 5: between 100K &amp; 125K, 6: between 125K &amp; 150K, 7: between 150K &amp; 200K, 8: 200k+ <p> , \"res_pern\": Resident personal where n is the ID for the income bracket as defined above, \"vis_bus\": Visitor business, \"vis_per\": Visitor personal       origin     Origin MGRA     destination     Destination MGRA     number_of_participants     Same as party_size     outbound     TRUE if outbound, else FALSE     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     destination_logsum     Logsum from destination choice model     stop_frequency     out_0in, 0out_in     primary_purpose     \"busn\", \"emp\", \"extn\", \"pern\""},{"location":"outputs.html#airport-model-trip-file-final_airporttripscsv","title":"Airport Model trip file (final_(airport)trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Primary purpose of trip: \"busn\": Business, where n is..., \"emp\": Employee, \"extn\": External, where n is..., \"pern\": Personal, where n is...     trip_num     1     outbound     TRUE if outbound, else FALSE     trip_count     1     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     mode_choice_logsum     Mode choice logsum for trip     vot     Value of time in dollars per hour ($2023)     arrival_mode     Arrival mode from airport trip mode choice model     cost_parking     Cost of parking ($2023)     cost_fare_drive     Ridehail/Taxi fare on a trip     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Ridehail/Taxi wait times for a trip     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     party     Party size     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Trip distance     add_driver     TRUE if trip requires a driver based on airport mode (for example, TNC, or pickup), else FALSE     weight_trip     1     weight_person_trip     weight_trip * tour_participants     cost_operating_drive     Auto operating cost ($2023)     inbound     TRUE if trip is from (origin) airport to (destination) non-airport zone, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     Sum of all costs a trip might incur (auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#arrival-mode-table-for-airport-models","title":"Arrival Mode Table for Airport Models","text":"Field     Description     Curb_LOCn     Pickup/Dropoff curbside (n=1,5, with 1 = terminal, and 2,5 = other locations)     TAXI_LOCn Taxi to airport (n =1,2 with 1= terminal mgra and 2=other)     RIDEHAIL_LOCn Ridehail to airport (n =1,2 with 1= terminal mgra and 2=other)     PARK_LOCn Parking lot (n=1,5, with 1 = terminal mgra and 2,5= other locations)     PARK_ESCORT     Parking escort     SHUTTLEVAN     Shuttle Vehicle     RENTAL     Rental car     HOTEL_COURTESY     Hotel transportation     WALK     Walk     WALK_LOC, WALK_PRM, WALK_MIX     Walk transit modes     KNR_LOC, KNR_PRM, KNR_MIX     KNR transit modes     TNC_LOC, TNC_PRM, TNC_MIX     TNC transit modes"},{"location":"outputs.html#assignment-model-trip-tables-assignment","title":"Assignment model trip tables (.\\assignment)","text":"<p>This directory contains trip tables from auto and transit assignments.</p>"},{"location":"outputs.html#demand-matrices","title":"Demand Matrices","text":"File  Description autoairportTrips.(airport)_(period_(vot).omx     Auto trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autocrossborderTrips_(period)_(vot).omx     Auto trip table for cross border model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autoTrips_(period)_(vot).omx     Auto trip table for resident model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autovisitorTrips_(period)_(vot).omx     Auto trip table for visitor model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     emptyAVTrips.omx     Empty private autonomous vehicle trips      householdAVTrips.csv     All private autonomous vehicle trips     TNCTrips.csv     All TNC trips     TNCVehicleTrips_(period).omx     TNC vehicle trip table by period (EA, AM, MD, PM, EV)     TranairportTrips.(airport)_(period).omx     Transit trip tables for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     TrancrossborderTrips_(period).omx     Transit trip tables for cross-border model by period (EA, AM, MD, PM, EV)     TranTrips_(period).omx     Transit trip tables for resident model by period (EA, AM, MD, PM, EV)     TranvisitorTrips_(period).omx     Transit trip tables for visitor model by period (EA, AM, MD, PM, EV)     TripMatrices.csv     Disaggregate commercial vehicle trips"},{"location":"outputs.html#airport-model-auto-demand-matrices","title":"Airport Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#airport-model-transit-demand-matrices","title":"Airport Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#airport-model-non-motorized-demand-matrices","title":"Airport Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-auto-demand-matrices","title":"Crossborder Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-transit-demand-matrices","title":"Crossborder Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-non-motorized-demand-matrices","title":"Crossborder Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-auto-demand-matrices","title":"Visitor Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-transit-demand-matrices","title":"Visitor Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-non-motorized-demand-matrices","title":"Visitor Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#tnc-vehicle-trip-demand-table","title":"TNC Vehicle trip demand table","text":"Column Name     Description     trip_ID     Trip ID     vehicle_ID     Vehicle ID     originTaz     Origin TAZ     destinationTaz     Destination TAZ     originMgra     Origin MGRA     destinationMgra     Destination MGRA     totalPassengers     Number of passengers in the vehicle     startPeriod     Trip starting period     endPeriod     Trip ending period     pickupIdsAtOrigin     Trip id of the pick-up at origin.     CR-RAMP:     \u2003\u2003Individual trips:     \u2003\u2003\"I_\" + personId + \"_\" + purpAbb + \"_\" + tourid + \"_\" + inbound + \"_\" + stopid     \u2003\u2003\u2003where purpAbb is the first 3 letters of the tour_purp field     \u2003\u2003Joint trips:     \u2003\u2003\"J_\" + hhid + \"_\" + purpAbb + \"_\" + tourid + \"_\" + inbound + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Visitor trips:     \u2003\u2003partySize == 1: \"V_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"V_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Cross-border trips:     \u2003\u2003partySize == 1: \"M_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"M_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     CBX airport trips:     \u2003\u2003partySize == 1: \"CBX_\" + tourid + \"_\" + stopid     \u2003\u2003partySize&gt;1: \"CBX_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     SAN airport trips:     \u2003\u2003partySize == 1: \"SAN_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"SAN_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Internal-External trips:     \u2003\u2003\"IE_\" + tourid + \"_\" + inbound     dropoffIdsAtOrigin     Trip id of the drop-off at origin. See pickupIdsAtOrigin for trip id of the trip.     pickupIdsAtDestination     Trip id of the pick-up at destination. See pickupIdsAtOrigin for trip id of the trip.     dropoffIdsAtDestination     Trip id of the drop-off at destination. See pickupIdsAtOrigin for trip id of the trip.     originPurpose     Trip origin purpose     destinationPurpose     Trip destination purpose"},{"location":"outputs.html#household-autonomous-vehicle-trip-data","title":"Household autonomous vehicle trip data","text":"Column Name     Description     hh_id     Household id     veh_id     Vehicle id     vehicleTrip_id     Vehicle trip id     orig_mgra     Trip origin MGRA     dest_gra     Trip destination MGRA     period     Period:     1 = Before 5:00AM     2 = 5:00AM-5:30AM     3 through 39 is every half hour time slots     40 = After 12:00AM     occupants     Number of occupants in the vehicle     originIsHome     Is origin home     0 = No     1 = Yes     destinationIsHome     Is destination home     0 = No     1 = Yes     originIsRemoteParking     Is origin remote parking     0 = No     1 = Yes     destinationIsRemoteParking     Is destination remote parking     0 = No     1 = Yes     parkingChoiceAtDestination     Parking choice at destination:     0 = Not constrained to remote parking     1 = Park at destination     2 = Remote parking     3 = Park at home     person_id     Person id     person_num     Person number     tour_id     Tour id     stop_id     Stop id     inbound     Is trip inbound     1 = Yes     0 = No     tour_purpose     Tour purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     orig_purpose     Origin trip purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     Work related     dest_purpose     Destination trip purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     Work related     trip_orig_mgra     Trip origin MGRA     trip_dest_mgra     Trip destination MGRA     stop_period     Stop period:     1 = Before 5:00AM     2 = 5:00AM-5:30AM     3 through 39 is every half hour time slots     40 = After 12:00AM     periodsUntilNextTrip     trip_mode     Trip mode:     0 = Empty vehicle trip     1 = Drive Alone     2 = Shared Ride 2     3 = Shared Ride 3"},{"location":"outputs.html#tnc-vehicle-trip-matrix","title":"TNC vehicle trip matrix","text":"Table Name     Description     TNC_&lt;&gt;_0     TNC trips for &lt;&gt; with 0 passenger     TNC_&lt;&gt;_1     TNC trips for &lt;&gt; with 1 passenger     TNC_&lt;&gt;_2     TNC trips for &lt;&gt; with 2 passengers     TNC_&lt;&gt;_3     TNC trips for &lt;&gt; with 3 or more passengers"},{"location":"outputs.html#empty-autonomous-vehicle-trips-data","title":"Empty Autonomous vehicle trips data","text":"Table Name     Description     EmptyAV_EA     Empty AV trips for EA period     EmptyAV_AM     Empty AV trips for AM period     EmptyAV_MD     Empty AV trips for MD period     EmptyAV_PM     Empty AV trips for PM period     EmptyAV_EV     Empty AV trips for EV period"},{"location":"outputs.html#crossborder-model-outputs-crossborder","title":"Crossborder model outputs (.\\crossborder)","text":"<p>This directory contains outputs from the Crossborder model, which represents all travel made by Mexico residents in San Diego County.</p> File      Description     final_accessibility.csv     Accessibility file for Crossborder Model (not used, created by default)     [final_households.csv](#### Crossborder Model household file (final_households.csv))     Household file for Crossborder Model      final_land_use.csv     Land-use file for Crossborder Model      [final_persons.csv](#### Crossborder Model person file (final_persons.csv))     Persons file for Crossborder Model      [final_tours.csv](#### Crossborder Model tour file (final_tours.csv))     Tour file for Crossborder Model      [final_trips.csv](#### Crossborder Model trip file (final_trips.csv))     Tour file for Crossborder Model      model_metadata.yaml     Model run meta data for use in Datalake storage and reporting     nmCrossborderTrips_AM.omx     Non-motorized trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     autoCrossborderTrips_AM.omx     Auto trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     tranCrossborderTrips_AM.omx     Transit trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     othrCrossborderTrips_AM.omx     Other trip table for Crossborder Model by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#crossborder-model-household-file-final_householdscsv","title":"Crossborder Model household file (final_households.csv)","text":"Field     Description     sample_rate     Sample Rate     num_persons     Number of persons in travel party     origin     Origin MGRA (Border crossing station)     home_zone_id     Home MGRA (Border crossing station)     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#crossborder-model-person-file-final_personscsv","title":"Crossborder Model person file (final_persons.csv)","text":"Field     Description     household_id     Household ID     work_time_factor     Travel time sensitivity factor for work tours     non_work_time_factor     Travel time sensitivity factor for non-work tours (Sampled in person preprocessor)     origin     Origin MGRA (Border crossing station)     home_zone_id     Home MGRA (Border crossing station)     person_id     Person ID"},{"location":"outputs.html#crossborder-model-tour-file-final_tourscsv","title":"Crossborder Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     pass_type     Type of border crossing pass. String. \"no_pass\": Does not own a pass, \"sentri\": SENTRI pass, or \"ready\": READY pass     tour_type     Tour purpose. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     purpose_id     Tour purpose ID. 0: work, 1: school, 2: shop, 3: visit, 4: other     tour_category     Tour category. String. Mandatory: Work or school, Non-Mandatory: Shop, visit, other     number_of_participants     Number of participants in tour     household_id     Household ID     person_id     Person ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     origin     Tour origin (Border Crossing) MGRA     destination     Tour primary destination MGRA     tour_od_logsum     Tour origin-crossing-destination logsum     poe_id     Number of border crossing station     tour_mode     Tour mode     mode_choice_logsum     Tour mode choice logsum     stop_frequency     Number of stops on tour by direction. String. xout_yin where x is number of stops in the outbound direction and y is the number of stops in the inbound direction     primary_purpose     will drop"},{"location":"outputs.html#crossborder-model-trip-file-final_tripscsv","title":"Crossborder Model trip file (final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Purpose at primary destination. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     trip_num     Sequential number of trip on half-tour from 1 to 4     outbound     TRUE if outbound, else FALSE     trip_count     number of trips per tour. Will drop     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     purpose     Purpose at trip destination. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     trip_mode_choice_logsum     Mode choice logsum for trip     parking_cost     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     tnc_single_wait_time     Wait time for single pay TNC     tnc_shared_wait_time     Wait time for shared\\pooled TNC     taxi_wait_time     Wait time for taxi     cost_parking     Cost of parking ($2023)     cost_fare_drive     Taxi/TNC fare (including Taxi/TNC cost of transit access/egress) ($2023)     distance_walk     Distance walked in miles (including access/egress walk distances of a transit mode)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Wait times for Taxi/TNC/NEV modes     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Total distance traveled on a trip     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weight defined as the ratio of the number of participants on a trip to sample rate of the model run     inbound     TRUE if trip is in outbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     Sum of all costs a trip might incur (auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     True if Neighborhood Electric Vehicle is available at origin     nev_dest     True if Neighborhood Electric Vehicle is available at destination     nev_available     TRUE if Neighborhood Electric Vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#crossborder-model-tour-mode-definitions","title":"Crossborder Model Tour Mode Definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk"},{"location":"outputs.html#commercial-vehicle-model-cvm","title":"Commercial Vehicle Model (.\\cvm)","text":"<p>//TODO</p> <p>Update with CVM results once model is updated</p>"},{"location":"outputs.html#parking-cost-calculations-parking","title":"Parking cost calculations (.\\parking)","text":"<p>This directory contains intermediate files and final expected parking costs calculated from input parking supply data and walk distances between MGRAs.</p> File      Description     aggregated_street_data.csv     Street length and intersections aggregated to MGRA level, used to estimate free on-street parking spaces     cache (directory)     Directory containing intermediate calculations for expected parking costs     distances.csv     MGRA-MGRA distances used for expected parking cost calculations     districts.csv     Calculated parking districts at MGRA level used for expected parking cost calculations     final_parking_data.csv     Expected hourly, daily, and monthly parking costs, total spaces, and parking district at the MGRA level for use in travel models     plots     Directory containing plots of the parking model results     shapefiles     Directory containing shapefiles for parking model calculations"},{"location":"outputs.html#resident-model-outputs-resident","title":"Resident model outputs (.\\resident)","text":"<p>This directory contains San Diego resident travel model outputs.</p> File      Description     cdap_joint_spec_(persons).csv     Model specification file for coordinated daily activity pattern model joint tour alternative for (persons)-way interaction terms     cdap_spec_(persons).csv     Model specification file for coordinated daily activity pattern model for (persons)-way interaction terms.     data_dict.csv     Data dictionary for resident model, csv format     data_dict.txt     Data dictionary for resident model, text format     final_accessibility.csv     Resident model aggregate accessibility file      final_disaggregate_accessibility.csv     Resident model disaggregate accessibility file at MGRA level     [final_households.csv](#### Resident Model household file (final_households.csv))     Resident model household file     [final_joint_tour_participants.csv](#### Resident Model joint tour participants file (final_joint_tour_participants.csv))     Resident model joint tour participants file     final_land_use.csv     Resident model land-use file     [final_persons.csv](#### Resident Model vehicle file (final_vehicles.csv))     Resident model persons file     final_proto_disaggregate_accessibility.csv     Resident model disaggregate accessibility file at person level     [final_tours.csv](#### Resident Model tour file (final_tours.csv))     Resident model tour file     [final_trips.csv](#### Resident Model trips file (final_trips.csv))     Resident model trip file     [final_vehicles.csv](#### Resident Model vehicle table (final_vehicles.csv))     Resident model vehicle file     log (directory)     Directory for resident model logging output     model_metadata.yaml     Resident model Datalake metadata file     autoTrips_[tod]_[vot].omx     Residential Auto Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV) and three value of time bins (vot = low, med, high)     tranTrips_[tod].omx     Residential Transit Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV)     nmotTrips_[tod].omx     Residential Non-motorized Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV)     skim_usage.txt     Skim usage file     trace (directory)     Directory for resident model trace output"},{"location":"outputs.html#resident-model-household-file-final_householdscsv","title":"Resident Model household file (final_households.csv)","text":"Field     Description     home_zone_id     Household MGRA - same as mgra     income     Household income in dollars ($2023)     hhsize     Number of persons in household     HHT     Household dwelling unit type. 0: N/A (GQ/vacant), 1: Married couple household, 2: Other family household: Male householder no spouse present, 3: Other family household: Female householder no spouse present, 4: Nonfamily household: Male householder living alone, 5: Nonfamily household: Male householder: Not living alone, 6: Nonfamily household: Female householder: Living alone, 7: Nonfamily household: Female householder: Not living alone     auto_ownership     (Model output) Auto ownership     num_workers     Number of workers in household     building_category     Units in structure. 0: N/A (GQ), 1: Mobile home or trailer, 2: One-family house detached, 3: One-family house attached, 4: 2 Apartments, 5: 3-4 Apartments, 6: 5-9 Apartments, 7: 10-19 Apartments, 8: 20-49 Apartments, 9: 50 or more apartments, 10: Boat, RV, van, etc.     unittype     Household unit type. 0: Non-GQ Household, 1: GQ Household (used in Visualizer)     sample_rate     Sample rate for household       income_in_thousands     Household income in thousands of dollars ($2023)     income_segment     Household income segment (1-4)     num_non_workers     Number of non-workers in household     num_drivers     Number of persons age 16+     num_adults     Number of persons age 18+     ebike_owner     TRUE if household owns an e-bike, else FALSE (output from e-bike owership simulation)     av_ownership     TRUE if household owns an autonomous vehicle, else FALSE (output from AV Ownership Model)     workplace_location_accessibility     Work location choice logsum (output from Disaggregate Accessibility Model)     shopping_accessibility     Shopping primary destination choice logsum (output from Disaggregate Accessibility Model)     othdiscr_accessibility     Other Discretionary primary destination choice logsum (output from Disaggregate Accessibility Model)     numAVowned     Number of autonomous vehicles owned by household (output from Vehicle Type Choice Model)     transponder_ownership     TRUE if household owns a transponder, else FALSE (output from Transponder Ownership Model)     has_joint_tour     1 if household has at least one fully joint tour, else false (output from Coordinated Daily Activity Pattern Model)     num_under16_not_at_school     Number of persons age less than 16 who do not attend school (output from Coordinated Daily Activity Pattern Model)     num_travel_active     Number of persons in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_adults     Number of adults in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_preschoolers     Number of preschool children in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_children     Number of children in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_non_preschoolers     Number of non-preschoolers household in who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     participates_in_jtf_model     TRUE if household has a joint tour frequency model, else FALSE (output from Coordinated Daily Activity Pattern Model)     school_escorting_outbound     Alternative number for school escort model in the outbound direction (initial output from School Escort Model)     school_escorting_inbound     Alternative number for school escort model in the inbound direction (output from School Escort Model)     school_escorting_outbound_cond     Alternative number for school escort model in the outbound direction (final output from School Escort Model)     auPkRetail     Auto peak access to retail employment from household TAZ (aggregate accessibility output)     auPkTotal     Auto peak access to total employment from household TAZ (aggregate accessibility output)     auOpRetail     Auto offpeak access to retail employment from household TAZ (aggregate accessibility output)     auOpTotal     Auto offpeak access to total employment from household TAZ (aggregate accessibility output)     trPkRetail     Transit peak access to retail employment from household TAZ (aggregate accessibility output)     trPkTotal     Transit peak access to total employment from household TAZ (aggregate accessibility output)     trPkHH     Transit peak access to total employment from household (aggregate accessibility output)     trOpRetail     Transit offpeak access to retail employment from household TAZ (aggregate accessibility output)     trOpTotal     Transit offpeak access to total employment from household TAZ (aggregate accessibility output)     nmRetail     Walk access to retail employment from household TAZ (aggregate accessibility output)     nmTotal     Walk access to total employment from household TAZ (aggregate accessibility output)     microtransit     Microtransit access time in household MGRA     nev     Neighborhood electric vehicle access time in household MGRA     mgra     Household MGRA - same as home_zone_id     TAZ     Household TAZ     micro_dist_local_bus     Distance to closest local bus stop from household MGRA by microtransit, if available. 999999 if not available.     micro_dist_premium_transit     Distance to closest premium transit stop from household MGRA by microtransit, if available. 999999 if not available.     joint_tour_frequency_composition     Joint tour frequency and composition model choice (output from Joint Tour Frequency\\Composition Model)     num_hh_joint_tours     Number of fully joint tours at the household level (0, 1 or 2) (output from Coordinated Daily Activity Pattern Model and Joint Tour Frequency\\Composition Models)     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty.     <p>Resident Model person file (final_persons.csv)</p> Field     Description     household_id     Household ID     age     Person age in years     PNUM     Person number in household (1\u2026n where n is number of persons in household)     sex     1: Male, 2: Female     pemploy     Employment status of person. 1: Employed Full-Time, 2: Employed Part-Time, 3: Unemployed or Not in Labor Force, 4: Less than 16 Years Old     pstudent     Student status of person. 1: Pre K-12, 2: College Undergrad+Grad and Prof. School, 3: Not Attending School     ptype     Person type  1: Full-time worker 2: Part-time worker 3: College\\University Student 4: Non-Working Adult 5: Retired 6: Driving-age student 7: Non-driving age student 8: Pre-school\\Age &lt;=5      educ     Educational attainment. 1: No schooling completed, 9: High school graduate, 13: Bacehlor's degree     soc2     Two-digit Standard Occupational Classification (SOC) codes (https://www.bls.gov/oes/current/oes_stru.htm)     is_student     Person is a K12 or college student     school_segment     School location choice model's segment a student belongs to (preschool, grade school, high school, university)     is_worker     Person is a full-time or part-time worker     is_internal_worker     TRUE if worker works internal to region, else FALSE (output from Internal-External Worker Identification Model)     is_external_worker     TRUE if worker works external to region, else FALSE (output from Internal-External Worker Identification Model)     home_zone_id     Household MGRA     time_factor_work     Travel time sensitivity factor for work tours     time_factor_nonwork     Travel time sensitivity factor for non-work tours (Sampled in person preprocessor)     naics_code     Two-digit NAICS code (https://www.census.gov/naics/)     occupation     Occupation String     work_from_home     TRUE if worker and works from home, else FALSE (output from Work From Home Model)     is_out_of_home_worker     TRUE if worker has a usual out of home work location, else FALSE (output from Work From Home Model)     external_workplace_zone_id     MGRA number of external workplace if external worker, else -1 (output from External Workplace Location Choice Model)     external_workplace_location_logsum     Location choice logsum for external workplace location choice model (output from External Workplace Location Choice Model)     external_workplace_modechoice_logsum     Mode choice logsum for mode choice from external workplace location choice model (output from External Workplace Location Choice Model)     school_zone_id     MGRA number of school location, else -9  (output from School Location Choice Model)     school_location_logsum     Location choice logsum for school location choice model, else -9 (output from School Location Choice Model)     school_modechoice_logsum     Mode choice logsum for mode choice from school location choice model, else -9 (output from School Location Choice Model)     distance_to_school     Distance to school if student, else -9  (output from School Location Choice Model)     roundtrip_auto_time_to_school     Round trip offpeak auto time to school, else -9  (output from School Location Choice Model)     workplace_zone_id     MGRA number of internal work location, else -9  (output from Internal Work Location Choice Model)     workplace_location_logsum     Location choice logsum for work location choice model, else -9 (output from Internal Work Location Choice Model)     workplace_modechoice_logsum     Mode choice logsum for mode choice from work location choice model, else -9 (output from Internal Work Location Choice Model)     distance_to_work     Distance to work if internal worker with work location, else -9  (output from Internal Work Location Choice Model)     work_zone_area_type     Area type of work zone for worker if internal worker with work location, else -9 (output from Internal Work Location Choice Model)     auto_time_home_to_work     Peak auto time from home to work if internal worker with work location, else -9  (output from Internal Work Location Choice Model)     roundtrip_auto_time_to_work     Round trip auto travel time to and from work     work_auto_savings     Travel time savings as a result of  using auto vs. walk-transit mode     exp_daily_work     Expected daily cost of parking at work if internal worker with work location, else -9 (output from Internal Work Location Choice Model)     non_toll_time_work     Time from home to work for path without I-15, if worker with internal workplace, else -9     toll_time_work     Time from home to work for path with I-15, if worker with internal workplace, else -9     toll_dist_work     Travel distance for work using a tolled route      toll_cost_work     Toll cost for going to work     toll_travel_time_savings_work     Work travel time savings for using tolled vs. non-tolled routes     transit_pass_subsidy     1 if person has subsidized transit from their employer or school, else 0 (Output from Transit Subsidy Model)     transit_pass_ownership     1 if person owns a transit pass, else 0 (Output from Transit Pass Ownership Model)     free_parking_at_work     TRUE if person has free parking at work, else FALSE (Output from Free Parking Model)     telecommute_frequency     Telecommute frequency if worker who does not work from hom, else null (Output from Telecommute Frequency Model) String \"No_Telecommute\", \"1_day_week\", \"2_3_days_week\", \"4_days_week\"     cdap_activity     Coordinated daily activity pattern type (Output from Coordinated Daily Activity Pattern Model) String \"M\": Mandatory pattern, \"N\": Non-mandatory pattern, \"H\": Home or out of region pattern     travel_active     TRUE if activity pattern is \"M\" or \"N\", else FALSE  (Output from Coordinated Daily Activity Pattern Model)     num_joint_tours     Total number of fully joint tours (Output from Fully Joint Tour Participation Model)     non_mandatory_tour_frequency     Non-Mandatory Tour Frequency Model Choice (Output from Non-Mandatory Tour Frequency Chopice Model)     num_non_mand     Total number of non-mandatory tours (Output from School Escort Model, Non-Mandatory Tour Frequency Model, and At-Work Subtour Model)     num_escort_tours     Total number of escorting tours (Output from School Escort Model and Non-Mandatory Tour Frequency Model)     num_eatout_tours     Total number of eating out tours (Output from Non-Mandatory Tour Frequency Model)     num_shop_tours     Total number of shopping tours (Output from Non-Mandatory Tour Frequency Model)     num_maint_tours     Total number of other maintenance tours (Output from Non-Mandatory Tour Frequency Model)     num_discr_tours     Total number of discretionary tours (Output from Non-Mandatory Tour Frequency Model)     num_social_tours     Total number of social\\visiting tours (Output from Non-Mandatory Tour Frequency Model)     num_add_shop_maint_tours     Total number of additional shopping and maintenance tours (Output from Non-Mandatory Tour Frequency Extension Model)     num_add_soc_discr_tours     Total number of additional social\\visiting and other discretionary tours (Output from Non-Mandatory Tour Frequency Extension Model)     person_id     Person ID     miltary     1 if serves in the military, else 0     grade     School grade of person: 0 = N/A (not attending school), 2 = K to grade 8, 5 = Grade 9 to grade 12, 6 = College undergraduate     weeks     Weeks worked during past 12 months 0: N/A (less than 16 years old/did not work during the past 12 .months) 1: 50 to 52 weeks worked during past 12 months 2: 48 to 49 weeks worked during past 12 months 3: 40 to 47 weeks worked during past 12 months 4: 27 to 39 weeks worked during past 12 month 5: 14 to 26 weeks worked during past 12 months 6: 13 weeks or less worked during past 12 months     hours     Usual hours worked per week past 12 months <p> 0: .N/A (less than 16 years old/did not work during the past .12 months), 1..98 .1 to 98 usual hours, 99 .99 or more usual hours     race     Recoded detailed race code 1: .White alone, 2: Black or African American alone, 3: American Indian alone, 4: Alaska Native alone, 5: American Indian and Alaska Native tribes specified; or .American Indian or Alaska Native, not specified and no other races, 6: Asian alone, 7: Native Hawaiian and Other Pacific Islander alone, 8: Some Other Race alone, 9: Two or More Races     hispanic     Hispanic flag: 1: Non-Hispanic, 2: Hispanic     <p>Resident Model vehicle file (final_vehicles.csv)</p> Field     Description     vehicle_id     Vehicle ID     household_id     Household ID     vehicle_num     Vehicle number in household from 1\u2026n where n is total vehicles owned by household     vehicle_type     String bodytype_age_fueltype     auto_operating_cost     Auto operating cost for vehicle ($2023 cents/mile)     Range     Range if electric vehicle, else 0     MPG     Miles per gallen for vehicle     vehicle_year     Year of vehicle      vehicle_category     String, Body type (Car, Motorcycle, Pickup, SUV, Van. Autonomous vehicles have _AV extension on body type)     num_occupants     Number of occupants in the vehicle     fuel_type     String. BEV: Battery electric vehicle, Diesel, Gas, Hybrid: Gas\\Electric non plug-in vehicle, PEV: Plug-in hybrid electric vehicle"},{"location":"outputs.html#resident-model-joint-tour-participants-file-final_joint_tour_participantscsv","title":"Resident Model joint tour participants file (final_joint_tour_participants.csv)","text":"Field     Description     participant_id     Participant ID     tour_id     Tour ID     household_id     Household ID     person_id     Person ID     participant_num     Sequent number of participant 1\u2026n where n is total number of participants in joint tour"},{"location":"outputs.html#resident-model-tour-file-final_tourscsv","title":"Resident Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     person_id     Person ID     tour_type     Purpose string of the primary activity on the tour: For home-based tours, the purposes are: \u201cwork\u201d, \u201cschool\u201d, \u201cescort\u201d, \u201cshopping\u201d, \u201cothmaint\u201d, \u201ceatout\u201d, \u201csocial\u201d, and \u201cothdiscr\u201d. For work-based subtours, the purposes are \u201cbusiness\u201d, \u201ceat\u201d, and \u201cmaint\u201d.     tour_type_count     The total number of tours within the tour_type     tour_type_num     The sequential number of the tour within the tour_category. In other words if a person has 3 tours; 1 work tour and 2 non-mandatory tours, the tour_type_num would be 1 for the work tour, 1 for the first non-mandatory tour and 2 for the second non-mandatory tour.     tour_num     Sequential tour ID number for a person     tour_count     Total number of tours per person     tour_category     The category string of the primary activity on the tour. \u201cmandatory\u201d, \u201cjoint\u201d, \u201cnon_mandatory\u201d, \u201catwork\u201d     number_of_participants     Number of participants on the tour for fully joint tours, else 1     destination     MGRA number of primary destination     origin     MGRA number of tour origin     household_id     Household ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     school_esc_outbound     For school tours where the child is being escorted according to the school pickup/dropoff model, this string field indicates the type of escorting in the outbound direction: \u201cpure_escort\u201d or \u201crideshare\u201d     school_esc_inbound     For school tours where the child is being escorted according to the school pickup/dropoff model, this string field indicates the type of escorting in the inbound direction: \u201cpure_escort\u201d or \u201crideshare\u201d     num_escortees     Number of children being escorted on this tour (max of outbound and inbound direction)     tdd     Tour departure and duration. Index of the tour departure and durarion alterntive configs     composition     Composition of tour if joint \u201cadults\u201d, \u201cchildren\u201d     is_external_tour     TRUE if primary destination activity is external to region, else FALSE     is_internal_tour     Whether tour is internal     destination_logsum     Logsum from tour destination choice model     vehicle_occup_1     Tour vehicle with occupancy of 1     vehicle_occup_2     Tour vehicle with occupancy of 2     vehicle_occup_3_5     Tour vehicle with occupancy of 3+     tour_mode     Tour mode string      mode_choice_logsum     Logsum from tour mode choice model     selected_vehicle     Selected vehicle from vehicle type choice model; a string field consisting of [Body type][age][fuel type] and an optional extension \u201c_AV\u201d if the vehicle is an autonomous vehicle     atwork_subtour_frequency     At-work subtour frequency choice model result; a string field with the following values: \u201cno_subtours\u201d, \u201cbusiness1\u201d, \u201cbusiness2\u201d, \u201ceat\u201d, \u201ceat_business\u201d, \u201cmaint\u201d, or blank for non-work tours.     parent_tour_id     Parent tour ID if this is a work-based subtour, else 0     stop_frequency     Stop frequency choice model result; a string value of the form [0\u2026n]out_[0\u2026n]in where the first number is the number of outbound stops and the second number is the number of inbound stops     primary_purpose     Recoding of tour_type where all atwork subtours are identified as \u201catwork\u201d regardless of destination purpose"},{"location":"outputs.html#resident-model-trip-file-final_tripscsv","title":"Resident Model trip file (final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Primary purpose of tour (see tour table)     trip_num     Sequential number of trip by direction (1\u2026n where n is maximum trips on half-tour, e.g. max stops + 1)     outbound     TRUE if trip is in the outbound direction, else FALSE     destination     MGRA of trip destination     origin     MGRA of trip origin     tour_id     Tour ID     escort_participants     Space delimited string field listing person IDs of other children escorted on this trip, else null     school_escort_direction     String field indicating whether child is being dropped off at school (\u201coutbound\u201d) or picked up from school (\u201cinbound\u201d). \u201cnull\u201d if not a child being picked up or dropped off.     purpose     Purpose at destination     destination_logsum     Logsum from trip destination choice model. -9 if destination is tour origin or primary destination.     depart     Departure time period (1\u202648)     trip_mode     Trip mode string     mode_choice_logsum     Logsum from trip mode choice model     vot     Value of time for trip in dollars per hour ($2023)     owns_transponder     True if household owns transponder. Same as ownTrp      totalWaitSingleTNC     Wait time for single pay TNC     totalWaitSharedTNC     Wait time for shared\\pooled TNC     s2_time_skims     HOV2 travel time      s2_dist_skims     HOV3 travel distance     s2_cost_skims     HOV2 travel toll cost     cost_parking     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     cost_fare_drive     Taxi/TNC fare for any trip or trip portion taken on these modes     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Waiting time for a TNC/ Taxi modes     parking_zone     MGRA from parking location choice model at destination, else -1     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Trip distance in miles     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weigth defined as the ratio of the number of particpants on a trip to sample rate of the model run     inbound     TRUE if trip is in the inbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare before subsidy ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     total cost of a trip (sum of auto operating, toll, transit fare)     time_total     Total time (sum of drive, bike, walk, initial transit wait, transit time, transit transfer))     time_transit_wait     Total transit wait time (initial, transfer, NEV wait, waiting for school bus)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     Availability of Neighborhood Electric vehicle at origin     nev_dest     Availability of Neighborhood Electric vehicle at destination     nev_available     TRUE if neighborhood electric vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     trip_veh_body     Body type of vehicle used for trip, else \u201cnull\u201d     trip_veh_age     Age of vehicle used for trip, else \u201cnull\u201d     trip_veh_fueltype     Fuel type of vehicle used for trip, else \u201cnull\u201d     origin_purpose     Purpose at origin     sample_rate     Sample rate     origin_parking_zone     MGRA from parking location choice model at trip origin, else -1     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#resident-model-tour-mode-definitions","title":"Resident Model tour mode definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     PNR_LOC     Local transit with Park&amp;ride access or egress mode     PNR_PRM     Premium transit with Park&amp;ride access or egress mode     PNR_MIX     Mix (local with premium transfers) transit with Park&amp;ride access or egress mode     KNR_LOC     Local transit with Kiss&amp;ride access or egress mode     KNR_PRM     Premium transit with Kiss&amp;ride access or egress mode     KNR_MIX     Mix (local with premium transfers) transit with Kiss&amp;ride access or egress mode     TNC_LOC     Local transit with TNC access or egress mode     TNC_PRM     Premium transit with TNC access or egress mode     TNC_MIX     Mix (local with premium transfers) transit with TNC access or egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride     SCH_BUS     School bus     EBIKE     E-bike     ESCOOTER     E-scooter"},{"location":"outputs.html#resident-model-auto-demand-matrices","title":"Resident Model auto demand matrices","text":"Table Name     Description     SOVNOTRPDR_&lt;&gt;     Drive Alone Non-Transponder for &lt;&gt;     SOVTRPDR_&lt;&gt;     Drive Alone Transponder for &lt;&gt;     SR2NOTRPDR_&lt;&gt;     Shared Ride 2 Non-Transponder for &lt;&gt;     SR2TRPDR_&lt;&gt;     Shared Ride 2 Transponder for &lt;&gt;     SR3NOTRPDR_&lt;&gt;     Shared Ride 3 Non-Transponder for &lt;&gt;     SR3TRPDR_&lt;&gt;     Shared Ride 3 Transponder for &lt;&gt;"},{"location":"outputs.html#resident-model-transit-demand-matrices","title":"Resident Model transit demand matrices","text":"Table Name     Description     &lt;transit_class&gt;_GENCOST__&lt;&gt;     Total generalized cost which includes perception factors from assignment     &lt;transit_class&gt;_FIRSTWAIT__&lt;&gt;     actual wait time at initial boarding point     &lt;transit_class&gt;_XFERWAIT__&lt;&gt;     actual wait time at all transfer boarding points     &lt;transit_class&gt;_TOTALWAIT__&lt;&gt;     total actual wait time     &lt;transit_class&gt;_FARE__&lt;&gt;     fare paid     &lt;transit_class&gt;_XFERS__&lt;&gt;     number of transfers     &lt;transit_class&gt;_ACCWALK__&lt;&gt;     access actual walk time prior to initial boarding     &lt;transit_class&gt;_EGRWALK__&lt;&gt;     egress actual walk time after final alighting     &lt;transit_class&gt;_TOTALWALK__&lt;&gt;     total actual walk time     &lt;transit_class&gt;_TOTALIVTT__&lt;&gt;     Total actual in-vehicle travel time     &lt;transit_class&gt;_DWELLTIME__&lt;&gt;     Total dwell time at stops     &lt;transit_class&gt;_BUSIVTT__&lt;&gt;     actual in-vehicle travel time on local bus mode     &lt;transit_class&gt;_LRTIVTT__&lt;&gt;     actual in-vehicle travel time on LRT mode     &lt;transit_class&gt; _CMRIVTT__&lt;&gt;     actual in-vehicle travel time on commuter rail mode     &lt;transit_class&gt; _EXPIVTT__&lt;&gt;     actual in-vehicle travel time on express bus mode     &lt;transit_class&gt;_LTDEXPIVTT__&lt;&gt;     actual in-vehicle travel time on premium bus mode     &lt;transit_class&gt;_BRTIVTT__&lt;&gt;     actual in-vehicle travel time on  BRT mode     *time period = EA, AM, MD, PM, EV     transit_class = BUS, ALLPEN, PREM"},{"location":"outputs.html#resident-model-non-motorized-demand-matrices","title":"Resident Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;"},{"location":"outputs.html#visitor-model-outputs-visitor","title":"Visitor model outputs (.\\visitor)","text":"<p>This directory contains outputs from the overnight visitor model.</p> File     Description     [final_households.csv](#### Visitor Model household file (final_households.csv))     Visitor model household file     final_land_use.csv     Visitor model land-use file     [final_persons.csv](#### Visitor Model person file (final_persons.csv))     Visitor model person file     [final_tours.csv](#### Visitor Model tour file (final_tours.csv))     Visitor model tour file     [final_trips.csv](#### Visitor Model trip file (final_trips.csv))     Visitor model trip file     model_metadata.yaml     Visitor model Datalake metadata file     nmotVisitortrips_(period).omx     Visitor model non-motorized trips by period (EA, AM, MD, PM, EV)     autoVisitortrips_(period).omx     Visitor model auto trips by period (EA, AM, MD, PM, EV)     transVisitortrips_(period).omx     Visitor model transit trips by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#visitor-model-household-file-final_householdscsv","title":"Visitor Model household file (final_households.csv)","text":"Field     Description     home_zone_id     Home MGRA     sample_rate     Sample rate     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#visitor-model-person-file-final_personscsv","title":"Visitor Model person file (final_persons.csv)","text":"Field     Description     household_id     Household ID     home_zone_id     Home MGRA     person_id     Person ID"},{"location":"outputs.html#visitor-model-tour-file-final_tourscsv","title":"Visitor Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     tour_type     Type of tour. String. \"dining\", \"recreation\", or \"work\"     purpose_id     Type of tour. 0: work, 1: \"dining, 2: \"recreation\"     visitor_travel_type     Visitor purpose. String. \"business\" or \"personal\"     tour_category     Tour category. All tour categories in the visitor model are \"non-mandatory\"     number_of_participants     Number of participants on tour     auto_available     Auto availability indicator 0: not available, 1: available     income     Income 0 - 4     origin     Tour origin MGRA     tour_num     Sequential number of tour 1 to n where n is total number of tours     tour_count     Number of tours per person     household_id     Household ID     person_id     Person ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     destination     Tour primary destination MGRA     destination_logsum     Tour destination choice logsum     tour_mode     Tour mode     mode_choice_logsum     Tour mode choice logsum     stop_frequency     Number of stops on tour by direction. String. xout_yin where x is number of stops in the outbound direction and y is the number of stops in the inbound direction     primary_purpose     Primary purpose of a tour. String (recreation, dining, work)"},{"location":"outputs.html#visitor-model-trip-file-final_tripscsv","title":"Visitor Model trip file ((final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Purpose at primary destination of tour. String. \"dining\", \"recreation\", or \"work\"     trip_num     Sequential number of trip on half-tour from 1 to 4     outbound     TRUE if outbound, else FALSE     trip_count     Number of trips in a tour     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     purpose     Destination purpose. String. \"dining\", \"recreation\", or \"work\"     destination_logsum     Destination choice logsum     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     trip_mode_choice_logsum     Mode choice logsum for trip     vot_da     will drop     vot_s2     will drop     vot_s3     will drop     parking_cost     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     tnc_single_wait_time     Wait time for single pay TNC     tnc_shared_wait_time     Wait time for shared\\pooled TNC     taxi_wait_time     Wait time for taxi     cost_parking     Cost of parking ($2023)     cost_fare_drive     Taxi/TNC fare for any trip or trip portion taken on these modes     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Ridehail/Taxi wait times for a trip     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of tour participants     distance_total     Trip distance     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weigth defined as the ratio of the number of particpants on a trip to sample rate of the model run     vot     Value of time in dollars per hour ($2023)     inbound     TRUE if trip is in outbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     total cost of a trip (sum of auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     True if Neghoborhood Electric Vehicle is available at origin     nev_dest     True if Neghoborhood Electric Vehicle is available at destination     nev_available     TRUE if neighborhood electric vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#visitor-models-tour-mode-choice-definitions","title":"Visitor model\u2019s tour mode choice definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride"},{"location":"outputs.html#trip-mode-definitions","title":"Trip Mode Definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     PNR_LOC     Local transit with Park&amp;ride access or egress mode     PNR_PRM     Premium transit with Park&amp;ride access or egress mode     PNR_MIX     Mix (local with premium transfers) transit with Park&amp;ride access or egress mode     KNR_LOC     Local transit with Kiss&amp;ride access or egress mode     KNR_PRM     Premium transit with Kiss&amp;ride access or egress mode     KNR_MIX     Mix (local with premium transfers) transit with Kiss&amp;ride access or egress mode     TNC_LOC     Local transit with TNC access or egress mode     TNC_PRM     Premium transit with TNC access or egress mode     TNC_MIX     Mix (local with premium transfers) transit with TNC access or egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride     SCH_BUS     School bus     EBIKE     E-bike     ESCOOTER     E-scooter"},{"location":"release-notes.html","title":"Release Notes","text":""},{"location":"release-notes.html#version-1510-september-4-2024","title":"Version 15.1.0 (September 4, 2024)","text":"<p>As mentioned in the notes for Version 15.0.2, several improvements to the Commercial Vehicle Model (CVM) were made, largely due to SANDAG staff realizing that the survey used to estimate the CVM had likely overestimated the amount of commercial vehicle travel that was made on a given day in the region. New weights were estimated, and then the CVM was recalibrated to match these new weights. After doing this, it was found that modeled highway volumes were lower than observed counts, so some further adjustments were made to get them back up. Some components of the resident model were recalibrated to better match the survey, a new database started being used, a bug in the transit network was fixed, and other miscelaneous improvements were made.</p>"},{"location":"release-notes.html#activitysim-version","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features","title":"Features","text":"<ul> <li>PR 167, PR 172, &amp; PR 173: Recalibration of the Commercial Vehicle Model to reflect newly-calculated Commercial Vehicle Survey weights.</li> <li>PR 182, PR 186, PR 194, &amp; PR 195: Miscellaneous calibration, particularly to counter the decrease in freeway travel caused by the CVM update.</li> <li>PR 176 &amp; PR 177: A new database was created for Version 15.1.0 and necessary scripts were modified to point to the new database. Go here to see detailed changes in the database and here for changes in the reporting tool.</li> <li>PR 184, PR 186, &amp; PR 193: The number of EV chargers each year were updated using numbers given by planning, and recalibration was done to ensure that the EV ownership rates for no build scenarios matched the targets.</li> <li>PR 178, PR 188, &amp; PR 189: In previous releases the crossborder model had its own constants.yaml file, which contained a lot of the same values in the common constants.yaml file, meaning that both files would need to be edited. The crossborder model now instead reads from the common constants.yaml file.</li> <li>PR 179, PR 181, PR 190, PR 191, &amp; PR 192: Miscellaneous updates to the scenario creation GUI and scenario build process.</li> </ul>"},{"location":"release-notes.html#bug-fixes","title":"Bug Fixes","text":"<ul> <li>PR 168, PR 170, PR 171, PR 175, &amp; PR 185: A bug in the transit network where connectors were being encoded with the wrong units was fixed. This resulted in a sharp increase in the number of transit boardings so some additional calibration was needed to get them back down to observed levels.</li> <li>PR 174 &amp; PR 180: Miscellaneous file cleanup and restoration.</li> </ul>"},{"location":"release-notes.html#version-1502-july-3-2024","title":"Version 15.0.2 (July 3, 2024)","text":"<p>Since the release of version 15.0.1 more updates were made, particularly regarding the new commercial vehicle model. More updates to the CVM will be forthcoming due to ongoing revision based on new data sources.</p>"},{"location":"release-notes.html#activitysim-version_1","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features_1","title":"Features","text":"<ul> <li>PR 155 &amp; PR 159: Updated the Wiki to reflect changes made for ABM3.</li> <li>PR 156: Made changes to distribution of commercial vehicle type mapping to the categories used in assignment.</li> <li>PR 157: Added calibration factors for determining the probability of a tour made by a single- or multi-unit truck terminating at a given stop.</li> <li>PR 158: Changed firm synthesis to be done at the TAZ level instead of the MGRA level.</li> </ul>"},{"location":"release-notes.html#bug-fixes_1","title":"Bug Fixes","text":"<ul> <li>PR 160: Removed an input file no longer used by the updated heavy truck model.</li> </ul>"},{"location":"release-notes.html#version-1501-june-12-2024","title":"Version 15.0.1 (June 12, 2024)","text":"<p>During the initial testing of the 2025 Regional Plan initial concept, some critical model issues were identified and fixed.</p>"},{"location":"release-notes.html#activitysim-version_2","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features_2","title":"Features","text":"<ul> <li>PR 152: TNC_SHARED was not being properly disabled in 2022 due to misplaced parentheses.</li> <li>PR 148: Fixed TNC_SHARED mode choice to restrict to ride hail tours and help shares on joint tours.</li> <li>Issue 143: Added parameter to discount wait times for rapid bus.</li> </ul>"},{"location":"release-notes.html#bug-fixes_2","title":"Bug Fixes","text":"<ul> <li>PR 150: Updated EI inputs at interstate cordons to reflect 2022 counts.</li> <li>PR 149: Updated MAZ ID for Otay Mesa East Point of Entry from Series 13 to Series 15.</li> <li>PR 147: Updated MGRA references for external cordons in airport models from Series 13 to Series 15.</li> <li>PR 146: Removed suffix from labels in runtime summary.</li> <li>PR 145: Added parking location placeholder datasets needed to open calibration visualizer.</li> <li>Commit a825ae3: Updated CBX inputs to use number of enplanements.</li> <li>Commit 305cdcf: Updated reporting of airport transit costs to be in dollars instead of cents.</li> <li>Commit 363d05a: Removed addition of \u201cpoverty\u201d field when writing output tables as that had been added to reading of input table.</li> <li>Commit 34e4a1d: Set year after which vehicles must have transponders from 2035 to 2029.</li> <li>Commit dc07cc9: Increased default flexible fleet diversion constants.</li> <li>Commit 726f98a: Updated some future year signal factors and truck toll factors on SR-11.</li> </ul>"},{"location":"release-notes.html#version-1500-may-23-2024","title":"Version 15.0.0 (May 23, 2024)","text":"<p>For use in the 2025 Region Plan (RP), SANDAG has developed a new activity-based travel model, known as ABM3. The biggest change from SANDAG\u2019s previous ABM, ABM2+, is the transition from the Java-based CT-RAMP modeling platform to the open-source Python-based ActivitySim platform that has been developed by a consortium of public agencies (of which SANDAG is a founding member) for the past decade. ABM3 will be the first ActivitySim model to be used in production for planning purposes. While most of the model components from ABM3 were translated from ABM2+, there were several notable enhancements that were made, which are described below. Further, several models were either re-estimated and/or recalibrated to match 2022 data.</p>"},{"location":"release-notes.html#activitysim-version_3","title":"ActivitySim Version","text":"<ul> <li>SANDAG/activitysim v15.0.0: This is based on a fork of the ActivitySim consortium repo and customized code in BayDAG_estimation branch.</li> <li>SANDAG/activitysim-cvm v15.0.0: This specific version of ActivitySim is required to run the new Commercial Vehicle Model (CVM) in ABM3. It is based on a fork of the ActivitySim repo under CamSys and customized code in time-settings branch.</li> </ul>"},{"location":"release-notes.html#features_3","title":"Features","text":"<ul> <li>ABM PR 68: The base year was updated from 2016 to 2022, allowing the behavioral models to reflect changes in travel behavior derived from the onset of the COVID-19 pandemic.</li> <li>ABM PR 65: The zone system was transitioned from a 3-zone system (TAZ, MAZ, TAP) to a 2-zone system (TAZ, MAZ).</li> <li>ABM PR 66: E-bike and E-scooter were added as travel modes.</li> <li>ABM PR 64: A new commercial vehicle model (CVM) was implemented using ActivitySim, that includes firm synthesis, commercial vehicle tours, and TNC services such as food delivery.</li> <li>ABM PR 133: Network editing was changed from the ArcInfo-based TCOVED to TNED, a new network editing system.</li> <li>ABM PR 104: Flexible fleet services were added for full trips along with first-mile access to and last-mile egress from fixed-route transit.</li> <li>ABM PR 9: The airport model has been updated with new access options, including the proposed automated people-mover.</li> <li>ABM PR 53: The cross-border model was updated, including a new wait time model.</li> <li>Asim PR 635: A new disaggregate accessibility calculation step was introduced to improve the precision of accessibilities used by modeling components.</li> <li>ABM PR 82: Transit assignment for different time periods is now run in parallel.</li> <li>ABM Configs: The auto ownership model has been moved before work and school location.</li> <li>Asim PR 613: The shadow pricing algorithm was updated to constrain mandatory tour locations to availability instead of traditional shadow pricing.</li> <li>ABM PR 86: Model results are automatically written to a database stored in the cloud via Microsoft Azure Services.</li> </ul>"},{"location":"release-notes.html#new-resident-model-components","title":"New Resident Model Components","text":"<ul> <li>Autonomous Vehicle Ownership</li> <li>External Worker Identification</li> <li>External Workplace Location</li> <li>Transit Pass Subsidy</li> <li>Transit Pass Ownership</li> <li>Vehicle Type Choice</li> <li>Telecommute Frequency</li> <li>External Joint Tour Identification</li> <li>External Joint Tour Location</li> <li>External Nonmandatory Tour Identification</li> <li>External Nonmandatory Tour Destination</li> <li>Vehicle Allocation</li> </ul>"},{"location":"running.html","title":"Installing and Running ABM3","text":"<p>This page describes how to install and run ABM3, including hardware and software requirements. In general, a powerful server is required to run the model. The main software required for the model includes EMME, Python, and Java. EMME is a commercial transportation modeling platform that must be purchased separately and requires a computer with a Windows operating system. Python is an open-source cross-platform programming language that is currently one of the most popular programming languages. Python is the core language of ActivitySim. Java is an open-source programming language required for certain bespoke non-ActivitySim model components. </p>"},{"location":"running.html#system-requirements","title":"System Requirements","text":"<p>ABM3 runs on a Microsoft Windows workstation or server, with the minimum and recommended system specification as follows:</p> <p>Minimum specification:</p> <ul> <li> <p>Operating System: 64-bit Windows 7, 64-bit Windows 8 (8.1), 64-bit Windows 10, 64-bit Windows Server 2019</p> </li> <li> <p>Processor: 24-core CPU processor</p> </li> <li> <p>Memory: 1 TB RAM</p> </li> <li> <p>Disk space: 500 GB</p> </li> </ul> <p>Recommended specification:</p> <ul> <li> <p>Operating System: 64-bit Windows 10</p> </li> <li> <p>Processor: Intel CPU Xeon Gold / AMD CPU Threadripper Pro (24+ cores)</p> </li> <li> <p>Memory: 1 TB RAM</p> </li> <li> <p>Disk space: 1000 GB</p> </li> </ul> <p>In general, a higher CPU core count and RAM will result in faster run times as long as ActivitySim is configured to utilize the additional processors and RAM.</p> <p>Note that the model is unlikely to run on servers that have less than 1 TB of RAM, unless chunking is set to active and in explicit mode (requires an upcoming version of ActivitySim 1.3)</p>"},{"location":"running.html#software-requirements","title":"Software Requirements","text":"<p>Three software applications, EMME, Python package manager Anaconda, and Java should be installed on the computer that will be used to run the model.</p> <p>The ABM3 model system is an integrated model that is controlled by and primarily runs in the EMME transportation planning software platform. EMME is used for network assignment and creating transportation skims, and the model\u2019s Graphical User Interface (GUI). The software also provides functionality for viewing and editing highway and transit network files and viewing of matrix files. The Bentley Connect Edition software (the license manager for EMME) will need to be logged in and activated prior to running the model. </p> <p>A Python package manager is software that creates an environment for an instance of Python. ActivitySim and related Python processes in the model are executed in an environment that is setup with a specific version of Python and specific library versions. This ensures that changes outside of the Python environment will not cause errors or change model results, and additionally ensure that the specific version of Python and specific libraries needed by the model do not cause errors or changes to other Python software installations on the server. The libraries needed by ActivitySim extend the base functionality of Python. Note that Anaconda requires a paid subscription for agencies larger than 200 users. To install Anaconda, follow the instructions here. </p> <p>Java is required in order to create bicycle logsums, run the taxi/TNC routing model, and run the intra-household autonomous vehicle routing model. The model has been tested against Java version 8 (e.g. 1.8) but should run in later versions as well. </p>"},{"location":"running.html#installing-abm3-model","title":"Installing ABM3 Model","text":""},{"location":"running.html#setting-up-the-python-environments","title":"Setting up the Python environments","text":"<p>As noted above, User needs to install Anaconda on the machine they are working on, if it is not already installed. The following step is creating a specific environment to run ActivitySim. The environment is a configuration of Python that is for ActivitySim - this environment allows ActivitySim to use specific software libraries without interfering with the server\u2019s installed version of Python (if one exists, it is not required) and keeps other Python installations from interfering with ActivitySim. </p> <p>To run ABM3, user needs to install two different python environments, one in Python 3, which will be used by all ActivitySim-based models, and one in Python 2, which is required as long as the EMME version in use still depends on Python 2, and is used to convert the omx rip tables out of the ActivitySim models. To set up these environments, use the following instruction from within the Anaconda 3 PowerShell Prompt for Python 3 and Anaconda 2 PowerShell Prompt for Python 2. </p> <p>To set up the Python 3 environment, first, change directories using cd /d to the environment folder under the ActivtySim source code directory. As of June 2024, this directory may be cloned from the BayDAG_estimation branch located on the SANDAG\u2019s forked version of ActivitySim here. The environment folder in this directory contains a number of yaml files that may be used to install the environment. User may use the following command to install the AcitvitySim environment along with SANDAG\u2019s version of AcitivtySim under the asim_baydag name.</p> <p><code>conda env create --file=activitysim-dev.yml -n asim_baydag</code></p> <p>After installing the environment, do a quick test of it by activating it, using:</p> <p><code>conda activate asim_baydag</code></p> <p>To set up the Python 2 environment, user simply needs to install the openmatrix package in the base environment. To do so, first open the Anaconda 2 terminal and use the following command to install the openmatrix package:</p> <p><code>pip install openmatrix</code></p>"},{"location":"running.html#installing-java","title":"Installing Java","text":"<p>Java version 1.81 needs to be installed on the server. SANDAG servers usually have this version of Java already installed on them.</p>"},{"location":"running.html#creating-a-scenario-folder","title":"Creating a scenario folder","text":"<p>Follow the steps below to create a model scenario folder using SANDAG\u2019s tool:</p> <ul> <li>Check for an open server using the DOS tool mascot-abm.</li> <li>Log into server</li> <li>Using the show hidden icons arrow on the taskbar, click the INRO Software Manager to check if EMME license is operating. If it\u2019s not, log into license server on Mustang by typing in the Host box: mustang.sandag.org:5170 (automatic)</li> <li>Using the server\u2019s Windows Explorer, navigate to T:\\ABM\\release\\ABM\\version_14_2_2\\dist</li> <li>Double click on createStudyAndScenario.exe and click Run.</li> <li>On pop-up, enter fields in Create an ABM scenario. Make sure to enter the correct ABM version, EMME version, year, and know your Scenario Folder (where you will run the model from; typically study area/abm_runs) and your Network Folder (input networks). Browse to an existing folder or copy (ctrl + c) and paste (ctrl + v) paths to minimize chance of typos. After fields are entered, click Create.</li> <li>A DOS window will open and necessary files will be copied. If you have a server with a valid license, it will pause for about 30-45 seconds on init emme folder. You will get a pop-up window that says you have successfully created the scenario. Click Quit. Exit the GUI by clicking on Quit.</li> <li>Go to your newly created abm_run folder and double check on input files/date stamps to verify they match expected date stamps. Make any modifications to input files (i.e. <code>parametersByYears.csv</code> for adjusting auto operating costs, <code>filesByYears.csv</code> for specifying year-specific files, or <code>mgra_based_inputXXX.csv</code> file for adjusting parking costs)</li> </ul>"},{"location":"running.html#running-abm3","title":"Running ABM3","text":"<p>To open the EMME application from the created scenario directory, user needs to go to the emme_project folder, and open the start_emme_with_virtualenv.bat file. This opens up the EMME application, where the application prompts the choice of a scenario. It is recommended to select the main highway scenario (Scen. 100) to start off the model run, although other scenarios may be selected as well. </p> <p>Following this step, user should open the EMME Modeler by clicking on the gold square sign at the top left of the screen.  </p> EMME Modeler icon <p> The EMME Modeler opens to the EMME Standard Toolbox, but needs to be switched to the SANDAG toolbox by selecting it from the bottom-left of the screen. From this toolbox, open the Master Run tool.</p> <p></p> Opening SANDAG Toolbox and Master run <p> Opening the Master Run tool allows the user to run all or part of the model, and set a number of settings such as sample size.</p> <p></p> Master Run tool <p> The Master run tool operates the SANDAG travel demand model. To operate the model, configure the inputs by providing Scenario ID, Scenario title and Emmebank title, and keeping Number of Processors to default. Select main ABM directory will automatically be set to the current project directory and does not require change.</p> <ul> <li>Main ABM directory: directory which contains the ABM scenario data, including this project. The default is the parent directory of the current Emme project.</li> <li>Scenario ID: Scenario ID for the base imported network data. The result scenarios are indexed in the next five scenarios by time period.</li> <li>Scenario title: title to use for the scenario.</li> <li>Emmebank title: title to use for the Emmebank (Emme database)</li> <li>Number of processors: the number of processors to use for traffic and transit assignments and skims, aggregate demand models (where required) and other parallelized procedures in Emme. Default is <code>Max available \u2013 1</code>.</li> <li>Properties (<code>conf/sandag_abm.properties</code>)<ul> <li>On opening the Master run tool the <code>sandag_abm.properties</code> file is read and the values cached and the inputs below are pre-set. When the Run button is clicked this file is written out with the values specified. Any manual changes to the file in-between opening the tool and clicking the Run button are overwritten.</li> <li>Sample rate by iteration: three comma-separated values for the ActivitySim sample rates for each iteration</li> <li>Start from iteration: start iteration for the model run</li> <li>Skip steps: optional checkboxes to skip model steps.</li> </ul> </li> <li>Select link: add select link analyses for traffic.</li> </ul> <p>By expanding the Run model \u2013 skip steps drop down, the user can make any custom changes. Usually the defaults should be sufficient although if you are using a new bike network, you should uncheck the Skip bike logsums and check the Skip copy of bikelogsum.</p> <p></p> Run model tool <p></p> <p>Following this setup, you can click Run to start the model run. We recommend occasionally checking the model run status to make sure the run is going smoothly. When the model run finishes successfully, the Master Run tool will show a model run successful message in green at the top of the tool window.</p> <p>If the run is unsuccessful (there will be an error prompt from Emme), check Emme logbook and log files (under \u201clogfiles\u201d) for clues to where it stopped.</p> <p>As the model runs, a full runtime trace of the model steps, inputs and reports is recorded in the Modeller Logbook. As each step completes, it will record an entry in the Logbook along with reports and other results. The Logbook can be opened from the Clock-like icon in the upper right of the Modeller window. This icon can also be found in the toolbar in the Emme Desktop. If a Modeller tool is running, a window will pop-up over the Emme Desktop which includes a Show Logbook button (this window can be closed to use Desktop worksheets and tables while any tool is running). Click on the Refresh button to update the logbook view with the latest status.</p> <p></p> Modeller logbook <p></p> <p>The Logbook provides a real time, automated documentation of the model execution. The overall structure of the model is represented at the top level, with the occurrence, sequence and repetition of the steps involved in the model process. Nested Logbook entries may be collapsed or expanded to see detail. For the Emme assignment procedures, interactive charts are recorded. The statistical summaries of the impedance matrices are recorded for each time period following the assignment. These summary tables provide an easy way to check for skims with obvious outlier values.</p>"},{"location":"application/applying.html","title":"Applying the model","text":"<p>This page contains information needed to apply the model.</p>"},{"location":"application/ev-rebates.html","title":"Electric Vehicle Rebates","text":"<p>One of the policies that SANDAG planners would like to test for the 2025 Regional Plan is providing rebates for low- and middle-income households to purchase electric vehicles. One of the variables in the vehicle type choice model is the new purchase price for a vehicle of a given age, body type, and fuel type. The way the EV rebate is implemented in ABM3 is by deducting the appropriate rebate value for plugin and battery vehicles if a household meets the criteria (based on percentage of the federal poverty level). To configure the rebate values and poverty level thresholds, new constants were added to the common/constants.yaml configuration file. The constants fit into the policy as follows:</p> Fuel Type <code>LowIncomeEVRebateCutoff</code> &lt; Household Poverty Level &lt;= <code>MedIncomeEVRebateCutoff</code> Household Poverty Level &lt;= <code>LowIncomeEVRebateCutoff</code> BEV <code>MedIncomeBEVRebate</code> <code>LowIncomeBEVRebate</code> PEV <code>MedIncomePEVRebate</code> <code>LowIncomePEVRebate</code> <p>For example, if the following policy were to be tested\u2026</p> Fuel Type 300-400% Federal Poverty Limit 300% Federal Poverty Limit or lower BEV $2,000 $6,750 PEV $1,000 $3,375 <p>\u2026then the constants would need to be set as follows: <pre><code>LowIncomeEVRebateCutoff: 3\nMedIncomeEVRebateCutoff: 4\nLowIncomeBEVRebate: 6750\nLowIncomePEVRebate: 3375\nMedIncomeBEVRebate: 2000\nMedIncomePEVRebate: 1000\n</code></pre></p>"},{"location":"application/flexible-fleets.html","title":"Flexible Fleets","text":"<p>The of the five big moves defined in SANDAG\u2019s 2021 regional plan was Flexible Fleets, which involves on-demand transit services. The initial concept of the 2025 Regional Plan involves rapidly expanding these services, with many new services planned to be in operation by 2035. For this reason, it is important that these services be modeled by ABM3. There are two flavors of flexible fleets that were incorporated into ABM3, Neighborhood Electric Vehicles (NEV) and microtransit. A table contrasting these services is shown below.</p> Characteristic NEV Microtransit Vehicle Size Smaller Larger Service Area Smaller Larger Operating Speed Slower Faster"},{"location":"application/flexible-fleets.html#incorporation-into-abm3","title":"Incorporation into ABM3","text":"<p>Rather than creating new modes for flexible fleet services, microtransit and NEV were incorporated into existing modes. How this was done was dependent on whether the trip was a full flexible fleet trip, first-mile access to fixed-route transit, or last-mile egress from fixed-route transit. A table explaining how each of these trip types was incorporated into ABM3 is shown below. Further, a heirarchy of services is enforced. ActivitySim first checks if NEV is available (based on a new land use attribute), and if it is, it\u2019s assumed that NEV is used. If not, ActivitySim checks if microtransit is available (based on a corresponding land use attribute), and if it is, it\u2019s assumed that microtransit is used. If neither are available, ActivitySim looks at the other services that are already available.</p> <p>*For trips on the return leg of a tour the access and egress attributes are swapped</p> Full microtransit trip First-mile access to fixed-route transit Last-mile egress from fixed-route transit What models allow for this type of trip? Resident, Visitor, Crossborder Resident Resident, Visitor, Crossborder Which mode is used? TNC Shared TNC to transit All transit modes How is the flexible fleet travel time factored into the trip? The travel time is the full travel time of the trip The travel time is added to the transit access time and a transfer is added The travel time is added to the transit egress time and a transfer is added if the destination is further from the nearest transit stop than a user would be willing to walk (that distance is configurable) How is the flexible fleet cost factored into the trip? The cost is the full cost of the trip It is assumed that flexible fleet services are free when used to access fixed-route transit It is assumed that flexible fleet services are free when egressing from fixed-route transit"},{"location":"application/flexible-fleets.html#new-attributes","title":"New Attributes","text":"<p>Several new attributes were added to allow the user to configure how flexible fleet services are operated. These are all defined in the common constants.yaml file. Each attribute is defined as follow:</p> Attribute Definition Default value Speed Assumed operating speed in miles per hour MT: 30, NEV: 17 Cost Cost of using service in US Cents 125 for both WaitTime Assumed time passengers wait to wait to use service in minutes 12 for both MaxDist Maximum distance in miles that the service can be used MT: 4.5, NEV: 3 DiversionConstant Additional travel time to divert for servicing other passengers 6 for both DiversionFactor Time multiplier accounting for diversion to service other passengers 1.25 for both StartPeriod Time period to start service (not yet implemented) 9 for both EndPeriod Time period to end service (not yet implemented) MT: 32, NEV: 38 maxWalkIfMTAccessAvailable Maximum disatance someone is willing to walk at the destination end if flexible fleet services are available (same for microtransit and NEV) 1.0"},{"location":"application/flexible-fleets.html#travel-time-calculation","title":"Travel Time Calculation","text":""},{"location":"application/flexible-fleets.html#direct-time","title":"Direct Time","text":"<p>The flexible fleet travel time calculation is a two-step process. The first step is to calculate the time that it would take to travel from the origin to the destination* directly without any diversion to pick up or drop off any passengers. This is done by taking the maximum of the time implied by the operating speed and the congested travel time:</p> <p>\\(t_{\\textnormal{direct}} = \\textnormal{max}(60\\times\\frac{s}{d}, t_{\\textnormal{congested}})\\)</p> <p>where:</p> <p>\\(t_{\\textnormal{direct}} = \\textnormal{Direct flexible fleet travel time}\\)</p> <p>\\(s = \\textnormal{speed}\\)</p> <p>\\(d = \\textnormal{Distance from origin to destination (taken from distance skim)}\\)</p> <p>\\(t_{\\textnormal{congested}} = \\textnormal{Congested travel time from origin to destination (taken from Shared Ride 3 time skim)}\\)</p> <p>*When used to access fixed-route transit, the destination is the nearest transit stop to the trip origin. When used to egress from fixed-route transit, the origin is the nearest transit stop to the trip destination.</p>"},{"location":"application/flexible-fleets.html#total-time","title":"Total Time","text":"<p>The second step of the travel time calculation was to account for diversion to pick up other passengers. These were based on guidelines used in a NEV pilot. The formula to calculated the total flexible fleet travel time is as follows:</p> <p>\\(t_{\\textnormal{total}} = \\textnormal{max}(t_{\\textnormal{direct}}+c, \\alpha\\times t_{\\textnormal{direct}})\\)</p> <p>where:</p> <p>\\(t_{\\textnormal{total}} = \\textnormal{Total flexible fleet travel time}\\)</p> <p>\\(c = \\textnormal{DiversionConstant}\\)</p> <p>\\(\\alpha = \\textnormal{DiversionFactor}\\)</p>"},{"location":"application/landuse-prep.html","title":"Land-Use Data Preparation","text":"<p>//TODO: Describe how to prepare land-use data.</p> <p>Describe how to update parking costs, enrollment data.</p>"},{"location":"application/micromobility.html","title":"Micromobility","text":"<p>//TODO: Describe how to run micromobility policy tests</p>"},{"location":"application/network-coding.html","title":"Network Coding","text":"<p>//TODO: Describe network attributes, how to code network</p>"},{"location":"application/population-synthesis.html","title":"Population Synthesis","text":"<p>//TODO: Describe population synthesis procedure, how to modify inputs and construct new future-year synthetic population</p>"},{"location":"application/scenario-manager.html","title":"Scenario manager","text":"<p>ABM3 uses a python module as the scenario manager. The job of this scenario manager is updating the parameters used throughout the model to match a specific scenario\u2019s definition and needs. A number of these parameters including auto operating cost, taxi and TNC fare, micromobility cost, and AV ownership penetration are usually assumed to change by forecast year or scenario.</p> <p>Manually changing these parameters requires the model user to know where each parameter is located, and individually changing them according to the scenario forecast values. A scenario manager, therefore, can be a convenient and efficient tool to automate this process.</p> <p>The ABM3 Scenario Manager reads in a CSV input file (located under <code>input/parametersByYears.csv</code>) containing the parameter values for each scenario, and updates the associated parameters in the ActivitySim config files. A snapshot of this input parameter CSV file is shown below, where each row is associated with a specific scenario year/name. The parameter names used here can either be identical to the parameter names used in ActivitySim, or different. In case the parameter names are different, a separate file is used to map the parameters names between the input CSV and ActivitySim config files.</p> Scenario Year AOC fuel AOC maintenance Taxi baseFare Taxi costPerMile Taxi costPerMinute 2012 13.5 6.3 1.78 1.87 0.08 2014 12.9 6.3 1.78 1.87 0.08 2015 19.5 6.2 1.78 1.87 0.08 2016 10.7 5.6 1.78 1.87 0.08 2017 10.8 5.5 1.78 1.87 0.08 <p>The scenario manager is run as part of the model setup in the Master Run tool before any ActivitySim model is run (usually only in the first iteration of the run). Model user can choose to run or skip this step, although it is highly recommended to run with each run to ensure correct parameters.</p>"},{"location":"design/design.html","title":"Model Design","text":"<p>The ABM3 model system is primarily based on the ActivitySim platform; ActivitySim is used to model resident travel, cross-border travel, overnight visitor travel, airport ground access travel, and commercial vehicle travel including light, medium, and heavy commercial vehicles. Aggregate models are used to model external-internal travel (from external stations other than the U.S./Mexico border crossing) and through travel. The model system relies on EMME software for network processing, skimming, and assignment. Models are mostly implemented in Python, and some models are implemented in [Java] (https://www.java.com/en/).</p> <p>The overall design of the model is shown in the figure below.</p> <p></p> <p>The system starts by performing initial input processing in EMME. This includes building transport networks and scenarios for skimming and assignment. An initial set of skims are created based on input trip tables (e.g. warm start). Then disaggregate choice models in ActivitySIm are run, including the resident model, the crossborder travel model, two airport ground access models, the overnight visitor model, and the commercial vehicle model. Next auxiliary models are run; the taxi/TNC routing model and the autonomous vehicle intra-household allocation model are run in Java. Aggregate external-internal and through travel models are run in Python. After all models are run, trip tables are built from the result and assigned to transport networks. A check is made to determine whether the model has reached convergence (currently this is set to three feedback iterations). If convergence is reached, outputs are processed for export to the SANDAG Datalake for reporting summaries. If not, speeds from assignment are averaged using method of successive averages, and skims are rebuilt for the next iteration. The model system is then re-run with the updated skims.</p> <p>ActivitySim is used to represent all internal travel and internal-external made by residents of the SANDAG region (modeled area).  The decision-makers in the model system include both persons and households. These decision-makers are created (synthesized) for each simulation year and land-use scenario, based on Census data and forecasted distributions of households and persons by key socio-economic categories. A similar but simplified method is used to generate disaggregate populations for cross-border, airport ground access, and overnight visitor models. The decision-makers are used in the subsequent discrete-choice models in a microsimulation framework where a single alternative is selected from a list of available alternatives according to a probability distribution.  The probability distribution is generated from a logit model which considers the attributes of the decision-maker and the attributes of the various alternatives. The application paradigm is referred to as Monte Carlo simulation, since a random number draw is used to select an alternative from the probability distribution. The decision-making unit is an important element of model estimation and implementation and is explicitly identified for each model specified in the following sections.</p> <p>A key advantage of using the micro-simulation approach is that there are essentially no computational constraints on the number of explanatory variables that can be included in a model specification.  However, even with this flexibility, the model system will include some segmentation of decision-makers.  Segmentation is a useful tool to both structure models (for example, each person type segment could have their own model for certain choices) and to characterize person roles within a household.  Segments can be created for persons as well as households.</p>"},{"location":"design/demand/index.html","title":"Demand Design","text":"<p>Details of demand components of the model.</p>"},{"location":"design/demand/airport.html","title":"Airport Ground Access Models","text":"<p>There are two airport ground access models - one for San Diego International Airport and one for the Crossborder Express terminal which provides access to Tijuana International Airport from the United States. Both models use the same structure and software code, though the parameters that control the total number of airport travel parties, off-airport destination, mode, arrival and departure times, and other characteristics, vary for each airport according to survey and airport-specific data. The airport ground access model simulates trips to and from the airport for residents, visitors, and external travelers. These trips are generated by arriving or departing passengers and are modeled as tours within the ActivitySim framework. A post processing script also generates trips to serve passengers who require a pickup or dropoff at the airport. For example, a passenger who is picked up at the airport generates two trips; one trip to the airport by the driver to pick up the air passenger(s), and another trip from the airport with the driver and the air passenger(s). It is important to note that, to work within the ActivitySim framework, the airport trips must be modeled as tours, rather than being generated directly as in the previous model. These tours are assigned an origin at the airport MGRA. During the stop frequency step of ActivitySim, a trip is assigned to the appropriate leg of the tour (either to or from the airport) while the opposite leg is not assigned any trips (referred to as the \u2018dummy leg\u2019). Passengers who are leaving on a departing flight and traveling to the airport are considered \u201cinbound,\u201d while arriving passengers are considered \u201coutbound\u201d.</p> <p>The overall design of the model is shown in the figure below.</p> <p></p> <ol> <li>Tour Enumeration: A list of airport travel parties is generated from input enplanements and transferring passenger rates, as well as distributions that describe the share of travel parties by purpose (business versus personal), household income, and party size.</li> <li> <p>Tour Level Models</p> <p>2.1 Tour Scheduling Probabilistic: The tour scheduling model uses a probabilistic draw of the scheduling distribution. This model assigns start and end times to the tour. This is important because it will also serve as the schedule model for the final airport trips. In ActivitySim, trips are scheduled based on the tour schedule. If there is only one trip per leg on the tour (such as our case here) the trip is assigned the tour start/end time.</p> <p>2.2 Tour Destination Choice: The destination choice model chooses the non-airport end of the airport trips. Each tour is set with an origin at the airport MGRA. The tour destination model of ActivitySim is used to choose the non-airport end of the trip. The utility equation includes the travel distance, and the destination size terms. ActivitySim destination choice framework requires a mode choice log sum. A dummy tour mode choice log sum was created which generates a value of zero for every destination using the \u2018tour_mode_choice.csv\u2019 and \u2018tour_mode_choice.yml\u2019 file. This is a work around to prevent ActivitySim from crashing and not having to include the tour mode choice log sum in the destination choice model.</p> <p>2.3 Stop Frequency Choice: The stop frequency model is where the trip table is first created. The pre-processor tags each tour with a direction of \u2018inbound\u2019 or \u2018outbound\u2019 according to whether the tour is a departing or arriving passenger. For the Airport Ground Access model, inbound tours are tagged with zero outbound trips and -1 inbound trips (and the opposite is true for outbound tours: -1 outbound trips and 0 inbound trips). The 0 signifies that no intermediate stops are made; this leg of the tour will only have one trip. The -1 signifies that no trip is made at all on that leg. Using the -1 allows us to create \u2018half-tours\u2019 where only one leg of the tour is recorded as a trip. 3. Trip Level Models</p> <p>3.1 Trip Departure Choice: The trip scheduling model assigns depart times for each trip on a tour. ActivitySim requires trip scheduling probabilities; however, these are not used in this implementation since there is only one trip on any given tour leg. This means the trips will be assigned the tour scheduling times which were determined in the tour scheduling model. The trip scheduling probabilities file is just a dummy file.</p> <p>3.2 Trip Mode Choice: Each trip is assigned a trip mode; in the Airport Ground Access Model, trip mode refers to the airport arrival mode which simultaneously predicts the arrival mode and the location which the passenger uses to access that model. The arrival modes are shown in the table below.  The trip mode choice yaml file contains detailed variables associated with each trip mode. For example, each parking location is given an MGRA location, a walk time, a wait-time, and a cost. If a parking location MGRA is set to -999 it is assumed to be unavailable and will not be in the choice set. The pre-processor in this step stores all values of skims from the trip origin to each of the access modes destinations along with any associated costs. Costs include parking fees per day, access fees, fares, and rental car charges. Employees are not fed into the trip mode choice model. Instead, if a transit share is specified in the employee park file, that percentage of employees will be assigned \u2018Walk Premium\u2019 mode in the pre-processor. Otherwise, employees are all assigned \u2018Walk\u2019 mode from the employee parking lot to the terminal.</p> <p>3.3 Airport Returns: Airport trips where the party is dropped of curbside or parked and escorted are assumed to also have the driver make a return trip to the non-airport location. This procedure is done as a post-processing step after mode choice and before trip tables are written out. An \u2018airport_returns.yml\u2019 file takes a user setting to determine which trip modes will include a return trip. These trips records are flagged and duplicated. The duplicated trips swap the origin and destination of the original trip and are assigned a unique trip id. These trips are tagged with \u2018trip_num =2\u2019 so they are easily sorted in any additional processing (such as for writing trip matrices).</p> <p>3.4 Write trip matrices: The write trip matrices step converts the trip lists into vehicle trip matrices. The matrices are segmented by trip mode and value of time bins. The vehicle trip modes in the matrices include SOV, HOV2, HOV3+, Taxi, and TNC-single. Value of time segmentation is either low, medium, or high bins based on the thresholds set in the model settings.</p> </li> </ol> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n    %% D --&gt; D2[PNR Access]\n    D --&gt; D3[KNR Access]\n    D --&gt; D4[TNC Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n\n    D3 --&gt; D31[Local Only]\n    D3 --&gt; D32[Premium Only]\n    D3 --&gt; D33[Mixed]\n\n    D4 --&gt; D41[Local Only]\n    D4 --&gt; D42[Premium Only]\n    D4 --&gt; D43[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n</code></pre></p>"},{"location":"design/demand/airport.html#airport-ground-access-model-trip-arrival-modes","title":"Airport Ground Access Model Trip Arrival Modes","text":"Arrival Mode Description Park Location 1 Party parks personal vehicle at parking location 1. Park Location 2 Party parks personal vehicle at parking location 2. Park Location 3 Party parks personal vehicle at parking location 3. Park Location 4 Party parks personal vehicle at parking location 4. Park Location 5 Party parks personal vehicle at parking location 5. Curb Location 1 Party is dropped off or picked up by another driver at curbside location 1. Curb Location 2 Party is dropped off or picked up by another driver at curbside location 2. Curb Location 3 Party is dropped off or picked up by another driver at curbside location 3. Curb Location 4 Party is dropped off or picked up by another driver at curbside location 4. Curb Location 5 Party is dropped off or picked up by another driver at curbside location 5 Park and Escort Party is driven in personal vehicle, parks on-site at the airport and is escorted to/from airport. Rental Car Party arrives/departs by rental car. Shuttle Van Party takes shuttle van. Hotel Courtesy Party takes hotel courtesy transportation. Ridehail Location 1 Party arrives\\departs using ridehail at ridehail location 1 Ridehail Location 2 Party arrives\\departs using ridehail at ridehail location 2 Taxi Location 1 Party arrives\\departs using taxi at taxi location 1 Taxi Location 2 Party arrives\\departs using taxi at taxi location 2 Walk Local Party arrives\\departs using walk-local bus Walk Premium Party arrives\\departs using walk-premium transit Walk Mix Party arrives\\departs using walk-local plus premium transit KNR Local Party arrives\\departs using KNR-local bus KNR Premium Party arrives\\departs using KNR-premium transit KNR Mix Party arrives\\departs using KNR-local plus premium transit TNC Local Party arrives\\departs using TNC-local bus TNC Premium Party arrives\\departs using TNC-premium transit TNC Mix Party arrives\\departs using TNC-local plus premium transit Walk Party arrives\\departs using walk <p>For more information on the Air Ground Access Travel Model see technical documentation.</p>"},{"location":"design/demand/crossborder.html","title":"Crossborder Model","text":"<p>The Cross-Border Travel Model predicts travel made by residents of Mexico within San Diego County. It predicts the border crossing point of entry as well as all trips made within the county. The model is limited to simulating travel made by Mexican residents who return to Mexico within the simulation day. Cross-border travel not captured by the Cross-Border Model includes:</p> <ul> <li>Residents of San Diego County who travel to/from Mexico. This travel is represented by the resident travel model.</li> <li>Residents of Mexico (including U.S. citizens) who travel into San Diego County and who do not return to Mexico at the end of the day. This travel is represented in the overnight visitor travel model.</li> <li>Travel between points of entry through San Diego County to other U.S. destinations. This travel is represented by the external-external travel model.</li> <li>Commercial vehicle travel to/from points of entry. This travel is represented by the commercial vehicle model.</li> </ul> <p>The overall design of the model is shown in the figure below.</p> <p></p>"},{"location":"design/demand/crossborder.html#crossborder-model-purpose-definitions","title":"Crossborder Model Purpose Definitions","text":"<p>There are five activity purposes in the cross-border travel demand model:   * Work: Any activity involving work for pay.   * School: Pre-k school, K-12, college/university, or trade school.   * Shop: Shopping at retail, wholesale, etc.   * Visit: Visiting friends or family   * Other: A broad category including eating out, medical appointments, recreational activities, etc.</p> <p>Note that home activities are not listed, since we do not model activities south of the border.</p>"},{"location":"design/demand/crossborder.html#crossborder-model-mode-definitions","title":"Crossborder Model Mode Definitions","text":"<p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode\\Border Crossing Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D11,D12,D13 group3;\n</code></pre></p> <p>The model has the following mode types at the trip level:   * Drive-alone: Single occupant private vehicle   * Shared 2: A private vehicle with exactly two passengers   * Shared 3+: A private vehicle with three or more passengers   * Walk: Walk mode   * Bike: Bike mode   * Walk-transit: Walk access to transit. There are three sub-types of transit: Local only,   premium only, local + premium (which includes both local and premium services in the   transit path)   * Taxi: Door-to-door taxi trip   * Single-pay TNC: Door-to-door TNC trip with a single payer (e.g. UberX)   * Shared-pay TNC: Stop-to-stop TNC trip with potentially multiple payers (e.g. UberPool)</p> <p>We also model tour mode, which is the mode used to cross the border. These modes include drive-alone, shared 2, shared 3+ and walk. We assume that anyone crossing by bus or taxi is similar to walk, since they do not have access to a personal vehicle for the rest of their travel in San Diego County.</p> <p>We also classify border crossings by lane type: general purpose, SENTRI, and Ready. We assume that the use of these lanes is related to the border crossing party; we attribute each party with SENTRI or Ready availability. The proportion of total border crossing parties with access to SENTRI and Ready lanes are based on observed survey data, pooled across all stations. This data is used to simulate the availability of the lane to the travel party. Each lane crossing type is related to the wait time that the travel party experiences at each border crossing station by mode.</p> <p>Below is a general description of the model structure.</p> <ol> <li>Tour Enumeration: A list of person-tours is created by first cross-multiplying the input total person tours with the share of tours by pass type, then expanding tours by pass type to tours by pass type and purpose.</li> <li> <p>Tour Level Models     2.1 Time-of-day Choice: Each person-tour is assigned an outbound and return half-hour      period.</p> <p>2.2 Primary Destination and Station Choice: Each border crossing person-tour chooses a  primary destination MGRA and border crossing station.</p> <p>2.3 Border Crossing Mode Choice: Each person-tour chooses a border crossing tour mode.</p> </li> <li> <p>Wait Time Model</p> <p>3.1. Wait time model: Calculate wait time based on demand at each POE from model 2.2</p> <p>3.2. Convergence check: If max iterations reached (currently 3), goto Stop and Trip level models, else goto Model 2.2 3. Stop and Trip Level Models 4.1 Stop Frequency Choice: Each person-tour is assigned number of stops by half-tour (outbound, return).</p> <p>4.2 Stop Purpose Choice: Each stop is assigned a stop purpose (consistent with the tour purposes).</p> <p>4.3 Trip Departure Choice: Each trip is assigned a half-hourly time period.</p> <p>4.4 Stop Location Choice: Each stop chooses an MGRA location.</p> <p>4.5 Trip Mode Choice: Each trip is assigned a trip mode.</p> <p>4.6 Trip Assignments: Trips are assigned to networks, along with resident and other special market trip tables, and skims are created for the next iteration of the model.</p> </li> </ol> <p>For more information on the Crossborder Travel Model see technical documentation.</p>"},{"location":"design/demand/external.html","title":"External Models","text":"<p>Details aggregate external models.</p>"},{"location":"design/demand/external.html#external-internal-model","title":"External Internal Model","text":""},{"location":"design/demand/external.html#external-external-model","title":"External External Model","text":""},{"location":"design/demand/resident.html","title":"Resident Model","text":"<p>The resident model structure is based on the Coordinated Travel Regional Activity-based Modeling Platform (CT-RAMP). The figure below shows the resident model structure. In order to understand the flow chart, some definitions are required. These are described in more detail below.</p> <ul> <li>Tour: A sequence of trips that start and end at an anchor location. In ActivitySim, anchors are home or work.</li> <li>Primary destination: The \u201cmain\u201d activity of the tour; this activity determines the tour purpose. It also divides the tour into two \u201clegs\u201d; the sequence of trips from the anchor location to the primary destination is the outbound leg, and the sequence of trips from the primary destination back to the anchor location is the inbound or return leg.</li> <li>Mandatory activity: Work or school</li> <li>Non-mandatory activity: Any out of home activity that is not work or school, including maintenance activities such as shopping as well as discretionary activities such as out-of-home recreation and eating out.</li> <li>Fully joint tour: A tour in which two or more household members travel together to all out-of-home activity locations and return home together. In other words, no household member is picked-up or dropped-off en route.</li> <li>Intermediate stop: An out-of-home activity location on the tour other than the anchor location or the primary destination. Intermediate stops are made on the way from the anchor location to the primary destination (outbound) or on the way from the primary destination back to the anchor location (inbound).</li> <li>Tour mode: The \u201cmain mode\u201d or \u201cpreferred mode\u201d of the tour. This is an abstract concept used categorize the tour with respect to accessibility and constrain the availability of modes for trips on the tour to ensure some consistency of modes used for each trip.</li> </ul> <p>The resident model design is shown below.</p> <p></p> <p>The first model in the sequence is disaggregate accessibilities. This is a recent addition to ActivitySim in which the tour destination choice model is run for a prototypical sample population covering key market segments and destination choice logsums from the model are written out for each tour in the population. These destination choice logsums are then merged with the actual synthetic population and used as accessibility variables in downstream models such as auto ownership, coordinated daily activity patterns, and tour frequency. are mandatory location choice; this model is run for all workers and students regardless of whether they attend work or school on the simulated day.</p> <p>Next a set of long-term and mobility models are run. The first model in the sequence predicts whether an autonomous vehicle is owned by the household. This model conditions the next model, which predicts the number of autos owned. If an autonomous vehicle is owned, multiple cars are less likely. Next, the mandatory (work and school) location choice models are run. The work location choice models includes a model to predict whether the worker has a usual out-of-home work location or exclusively works from home. If the worker chooses to work from home, they will not generate a work tour. An external worker identification model determines whether each worker with an out-of-home workplace location works within the region or external to the region. If they work external to the region, the external station is identified. Any primary destination of any work tours generated by the worker will be the external station chosen by this model. A work location choice model predicts the internal work location of each internal worker, and a school location choice model predicts the school location of each student.</p> <p>Next, a set of models predicts whether workers and students have subsidized transit fares and if so, the percent of transit fare that is subsidized, and whether each person in the household owns a transit pass. A vehicle type choice model then runs, which predicts the body type, fuel type, and age of each vehicle owned by the household; this model was extended to predict whether each vehicle is autonomous, conditioned by the autonomous vehicle ownership model.</p> <p>Next, we predict whether each household has access to a vehicle transponder which can be used for managed lane use. We assume that all vehicles built after a certain year (configurable by the user) are equipped with transponders. Next we predict whether each worker has subsidized parking available at work. Finally we predict the telecommute frequency of each worker, which affects downstream models including the daily activity pattern model, the non-mandatory tour frequency model, and stop frequency models.</p> <p>Next the daily and tour level models are run. The first daily model is the daily activity pattern model is run, which predicts the general activity pattern type for every household member. Then Mandatory tours are generated for workers and students, the tours are scheduled (their location is already predicted by the work/school location choice model), a vehicle availability model is run that predicts which household vehicle would be used for the tour, and the tour mode is chosen. After mandatory tours are generated, a school pickup/dropoff model forms half-tours where children are dropped off and/or picked up at school. The model assigns chaperones to drive or ride with children, groups children together into \u201cbundles\u201d for ride-sharing, and assigns the chaperone task to either a generated work tour or generates a new tour for the purpose of ridesharing. Fully joint tours \u2013 tours where two or more household members travel together for the entire tour - are generated at a household level, their composition is predicted (adults, children or both), the participants are determined, the vehicle availability model is run, and a tour mode is chosen. The primary destination of fully joint tours is predicted, the tours are scheduled, the vehicle availability model is run, and a tour mode is chosen. Next, non-mandatory tours are generated, their primary destination is chosen, they are scheduled, the vehicle availability model is run, and a tour mode is chosen for each. At-work subtours are tours that start and end at the workplace. These are generated, scheduled (with constraints that the start and end times must nest within the start and end time of the parent work tour), a primary destination is selected, the vehicle availability model is run, and a tour mode is chosen.</p> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    E --&gt; E2[Single-pay TNC]\n    E --&gt; E3[Shared TNC];\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n    D --&gt; D2[PNR Access]\n    D --&gt; D3[KNR Access]\n    D --&gt; D4[TNC Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n\n    D2 --&gt; D21[Local Only]\n    D2 --&gt; D22[Premium Only]\n    D2 --&gt; D23[Mixed]\n\n    D3 --&gt; D31[Local Only]\n    D3 --&gt; D32[Premium Only]\n    D3 --&gt; D33[Mixed]\n\n    D4 --&gt; D41[Local Only]\n    D4 --&gt; D42[Premium Only]\n    D4 --&gt; D43[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    C --&gt; C2[Bike]\n    C --&gt; C3[E-Scooter]\n    C --&gt; C4[E-Bike]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n</code></pre></p> <p>At this point, all tours are generated, scheduled, have a primary destination, and a selected tour mode. The next set of models fills in details about the tours - number of intermediate stops, location of each stop, the departure time of each stop, and the mode of each trip on the tour. Finally, the parking location of each auto trip to the central business district (CBD) is determined. After the model is run, the output files listed above are created. The trip lists are then summarized into origin-destination matrices by time period and vehicle class or transit mode and assigned to the transport network.</p>"},{"location":"design/demand/visitor.html","title":"Overnight Visitor Model","text":"<p>The Overnight Visitor Model simulates trips of visitors staying overnight in hotels, motels, short-term vacation rentals, and with friends and family. The trips are modeled as part of tours that begin and end at the place of lodging. However, unlike the resident model, the Overnight Visitor Model does not utilize a 24-hour activity schedule. Therefore it can be thought of as a simpler, tour-based model. Once each tour is generated, it is scheduled independently. The model uses the same time periods and modes as the resident model. The overall design of the model is shown in the figure below.</p> <p></p> <ol> <li> <p>Tour Enumeration: A list of visitor parties is generated from the input household data and hotel room inventory at the MGRA level. Visitor travel parties by segment (business versus personal) are calculated based on separate rates for hotels and for households. Visitor parties are generated by purpose based on tour rates by segment, then attributed with household income and party size based on input distributions. There are three purposes in the Overnight Visitor model:</p> </li> <li> <p>Work:  Business travel made by business visitors.</p> </li> <li>Dining: Travel to food establishments for both business and personal visitors.</li> <li> <p>Recreational: All other non-work non-food related activities.</p> </li> <li> <p>Tour Level Models</p> <p>2.1 Tour Scheduling Probabilistic: The tour scheduling model uses a probabilistic draw of the scheduling distribution. This model assigns start and end times to the tour. If there is only one trip per leg on the tour, the trip is assigned the tour start/end time.</p> <p>2.2 Tour Destination Choice: The destination choice model chooses the MGRA of the primary activity location on the tour.</p> <p>2.3 Tour Mode Choice: The tour mode choice model determines the primary mode of the tour.</p> </li> <li> <p>Stop Level Models</p> <p>3.1 Stop Frequency Choice: The stop frequency model predicts the number of stops by direction based on input distributions that vary by tour purpose.</p> <p>3.2 Stop Purpose: The stop purpose model chooses the activity purpose of each intermediate stop based on input distributions that vary according to tour purpose.</p> <p>3.3 Stop Location Choice: The location choice model chooses the MGRA for each intermediate stop on the tour.</p> </li> <li> <p>Trip Level Models</p> <p>4.1 Trip Departure Choice: The trip scheduling model assigns depart times for each trip on a tour based on input distributions that vary by direction (inbound versus outbound), stop number, and number of periods remaining on the tour.</p> <p>4.2 Trip Mode Choice: Each trip is assigned a trip mode, consistent with the modes in the resident model.</p> <p>4.3 Trip Assignment: Trips are aggregated by time of day, mode occupancy, value-of-time, and origin-destination TAZ and assigned simultaneously with other trips.</p> </li> </ol> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    E --&gt; E2[Single-pay TNC];\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n\n</code></pre></p> <p>For more information on the Overnight Visitor Travel Model see technical documentation.</p>"},{"location":"design/init/initialization.html","title":"Initialization","text":""},{"location":"design/init/initialization.html#emme-databases","title":"EMME Databases","text":""},{"location":"design/init/initialization.html#import-network","title":"Import Network","text":""},{"location":"design/init/initialization.html#warmup-trip-tables","title":"Warmup Trip Tables","text":""},{"location":"design/init/initialization.html#bike-logsums","title":"Bike Logsums","text":""},{"location":"design/init/initialization.html#initial-highway-skimming","title":"Initial Highway Skimming","text":""},{"location":"design/init/initialization.html#initial-transit-skimming","title":"Initial Transit Skimming","text":""},{"location":"design/init/initialization.html#transponder-export","title":"Transponder Export","text":""},{"location":"design/init/initialization.html#scenario-management","title":"Scenario Management","text":""},{"location":"design/init/initialization.html#abm-pre-processing","title":"ABM Pre-processing","text":""},{"location":"design/report/report.html","title":"Reporting Framework","text":"<p>Reporting Process Overview:</p> <ol> <li> <p>ABM3 model output files are stored to data lake:</p> <ul> <li>Model outputs are written to the data lake immediately following ABM3 model run completion.</li> <li>Output CSV files are converted to Parquet format before writing to the data lake.</li> <li>Each model run is assigned a unique scenario ID.</li> </ul> </li> <li> <p>Data lake files are loaded to Delta tables:</p> <ul> <li>Each output file in the data lake is loaded into its corresponding Delta table. For example, the trips output file is loaded into the trips Delta table, the persons output file is loaded into the persons Delta table, etc.</li> <li>Delta tables store the results from all model runs, organized by scenario ID.</li> </ul> </li> <li> <p>Delta Tables are processed in Databricks:</p> <ul> <li>Delta tables are read, transformed, and aggregated as needed to support analysis and reporting requirements.</li> <li>Once transformations are complete, the resulting data is written back to the data lake as new Delta tables or used to update existing tables.</li> <li>These new Delta tables are also organized by scenario ID, making it easier to manage and query specific versions of processed data.</li> </ul> </li> <li> <p>Delta tables are ingested by Power BI:</p> <ul> <li>Power BI reads the data from the Delta tables.</li> <li>Power BI report templates with various metrics of interest are automatically refreshed with new model run outputs.</li> <li>Metrics can easily be compared across different scenario IDs.</li> </ul> </li> </ol>"},{"location":"design/supply/index.html","title":"Supply Design","text":"<p>Details of supply components of the model.</p>"},{"location":"design/supply/bike-logsums.html","title":"Bike Logsums","text":"<p>Details of bike logsum calculations.</p>"},{"location":"design/supply/highway-skims-assign.html","title":"Highway Skimming and Assignment","text":"<p>Details of highway skimming and assignment.</p>"},{"location":"design/supply/network-import-tned.html","title":"Network Import from TNED","text":"<p>This section describes the procedure by which the ABM3 model system imports (into Emme) network (highway and transit) files along with a general description of the different network files.</p>"},{"location":"design/supply/network-import-tned.html#network-files","title":"Network Files","text":"<p>The ABM3 model system has been configured to be compatible with SANDAG\u2019s Transportation Network Editing Database (TNED) system, which is utilized to edit, maintain and generate transportation networks. The TNED network files, generated via an ETL (i.e., Extract, Tranform, Load) procedure, serve as inputs to the ABM3 model system\u2019s import network procedure and are produced in text file, shapefile, geodatabase table and geodatabase feature class geodatabase formats. There are, additionally, some non-TNED input network files which are manually maintained.</p> <p>The following are the required network files used during the Emme import network procedure:</p> File Source Description EMMEOutputs.gdb/TNED_HwyNet TNED Roadway network links EMMEOutputs.gdb/TNED_HwyNodes TNED Roadway network nodes EMMEOutputs.gdb/TNED_RailNet TNED Rail network links EMMEOutputs.gdb/TNED_RailNodes TNED Rail network nodes EMMEOutputs.gdb/Turns TNED Turn prohibition records special_fares.txt Manually Maintained Special fares in terms of boarding and incremental in-vehicle costs timexfer_{time_of_day}.csv Manually Maintained Timed transfer pairs of lines, by period. Where time_of_day refers to EA, AM, MD, PM, or EV. trrt.csv TNED Attribute data (modes, headways) for the transit lines trlink.csv TNED Sequence of links (routing) for the transit lines trstop.csv TNED Stop data for the transit lines MODE5TOD.csv Manually Maintained Global (per-mode) transit cost and perception attributes vehicle_class_toll_factors.csv Manually Maintained Factors to adjust the toll cost by facility name and class"},{"location":"design/supply/network-import-tned.html#import-network-procedure","title":"Import Network Procedure","text":"<p>This section describes the main steps carried out during the Emme import network procedure. The entire process is executed by the import_network.py script.</p>"},{"location":"design/supply/network-import-tned.html#create-modes","title":"Create Modes","text":"<p>This step creates the different combinations of traffic and transit modes that will get applied to the network links. A mode defines a group of vehicles or users which have access to the same parts of the network. Modes are used in both the traffic and transit assignments to define the available network for each class of demand. Each mode is uniquely identified by a single case-sensitive character. The modes which have access to a given link are listed on that link, and each link must allow at least one mode.</p>"},{"location":"design/supply/network-import-tned.html#create-roadway-base-network","title":"Create Roadway Base Network","text":"<p>This step creates the base roadway network by importing it from the EMMEOutputs.gdb/TNED_HwyNet and EMMEOutputs.gdb/TNED_HwyNodes. The nodes and links (referred to as the base network in Emme) for the traffic network are imported from the TNED_HwyNode and TNED_HwyNet geodatabase feature classes. The nodes are created first and the links connect between them. The I-node (from node, field AN) and J-node (to node, field BN) are used to associate the nodes and links and uniquely identify the link in the Emme network. Separate forward (AB) and reverse (BA) links are generated for links that have been coded as two-way. </p>"},{"location":"design/supply/network-import-tned.html#create-turns","title":"Create Turns","text":"<p>This step processes the EMMEOutputs.gdb/Turns input network file to generate turn restrictions by to- and from- link ID. If the indicated link IDs do not make a valid turn (links not adjacent) an error is reported.</p>"},{"location":"design/supply/network-import-tned.html#calculate-traffic-attributes","title":"Calculate Traffic Attributes","text":"<p>This step calculates derived traffic attributes. It utilizes the vehicle_class_toll_factors.csv to adjust toll costs by facility name and class.</p>"},{"location":"design/supply/network-import-tned.html#check-zone-access","title":"Check Zone Access","text":"<p>This step verifies that every centroid has at least one available access and egress connector.</p>"},{"location":"design/supply/network-import-tned.html#create-rail-base-network","title":"Create Rail Base Network","text":"<p>This step creates the base roadway network by importing it from the EMMEOutputs.gdb/TNED_RailNet and EMMEOutputs.gdb/TNED_RailNodes. The nodes and links (referred to as the base network in Emme) for the rail network are imported from the TNED_RailNode and TNED_RailNet geodatabase feature classes. The nodes are created first and the links connect between them. The I-node (from node, field AN) and J-node (to node, field BN) are used to associate the nodes and links and uniquely identify the link in the Emme network. Separate forward (AB) and reverse (BA) links are generated for links that have been coded as two-way. </p>"},{"location":"design/supply/network-import-tned.html#create-tranist-lines","title":"Create Tranist Lines","text":"<p>This step creates the transit lines by importing them from the trrt.csv, trlink.csv and trstop.csv input network files and matched to the transit base network. The mode-level attributes from MODE5TOD.csv, which vary by mode, are copied to transit line attributes and used in  transit assignment. It is in this step also where the timexfer_{time_of_day}.csv files are used to explicitly set route-to-route specific transfer transit times.</p>"},{"location":"design/supply/network-import-tned.html#calculate-transit-attributes","title":"Calculate Transit Attributes","text":"<p>The transit line and stop / segment attributes (including fares) are imported to Emme attributes. The special_fares.txt lists network-level incremental fares by boarding (line and/or stop) and in-vehicle segment. They specify additive fares based on the network elements encountered on a transit journey and are used to represent the Coaster (or other) zonal fare system.</p>"},{"location":"design/supply/transit-skims-assign.html","title":"Transit Skimming and Assignment","text":"<p>The transit assignment uses a headway-based approach, where the average headway between vehicle arrivals for each transit line is known, but not exact schedules. Passengers and vehicles arrive at stops randomly and passengers choose their travel itineraries considering the expected average waiting time.</p> <p>The Emme Extended transit assignment is based on the concept of optimal strategy but extended to support a number of behavioral variants. The optimal strategy is a set of rules which define sequence(s) of walking links, boarding and alighting stops which produces the minimum expected travel time (generalized cost) to a destination. At each boarding point the strategy may include multiple possible attractive transit lines with different itineraries. A transit strategy will often be a tree of options, not just a single path. A line is considered attractive if it reduces the total expected travel time by its inclusion. The demand is assigned to the attractive lines in proportion to their relative frequencies.</p> <p>The shortest \u201ctravel time\u201d is a generalized cost formulation, including perception factors (or weights) on the different travel time components, along with fares, and other costs / perception biases such as transfer penalties which vary over the network and transit journey.</p> <p>The model has four access modes to transit (walk, park-and-ride (PNR), kiss-and-ride (KNR), and Transportation Network Company (TNC)) and three transit sets (local bus only, premium transit only, and local bus and premium transit sets), for 12 total demand classes by 5 TOD. These classes are assigned by slices, one at a time, to produce the total transit passenger flows on the network.</p> <p>While there are 12 slices of demand, there are only three classes of skims: Local bus only, premium only, and all modes. The access mode does not change the assignment parameters or skims.</p>"},{"location":"design/supply/walk-skims.html","title":"Walk Skims","text":"<p>Details of walk skim calculations.</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"SANDAG ABM3","text":"<p>Welcome to the SANDAG Activity-Based Travel Model documentation site!</p>"},{"location":"index.html#introduction","title":"Introduction","text":"<p>This website describes the travel demand modeling system developed by the San Diego Association of Governments (SANDAG). SANDAG plans for many complex mobility issues facing the San Diego region, including development of the Regional Plan. Transportation models are complex analysis tools used to provide transportation planners and policymakers with information to help allocate scarce resources fairly and equitably. As we plan for the future, models are used to forecast potential future scenarios of where people will live and how they will travel. They are the principal tool used for alternatives analysis.  </p> <p>The SANDAG transportation model is an activity-based model (ABM). It simulates individual and household transportation decisions that make up their daily travel. This includes all trips people make on a daily basis, such as to work, school, shopping, healthcare, and recreation. An ABM provides a controlled, analytical platform so that different inputs and alternatives can be evaluated to predict whether, when, and how this travel occurs. SANDAG ABM accounts for a variety of different weekday travel markets in the region, including San Diego region resident travel, travel by Mexico residents and other travelers crossing San Diego County\u2019s borders, visitor travel, airport passengers at both the San Diego International Airport and the Cross Border Xpress bridge to the Tijuana International Airport, and commercial travel. </p> <p>The most recent version of the SANDAG ABM is referred to as \u201cABM3\u201d, and was developed for use in the 2025 Regional Plan. ABM3 is a significant enhancement from ABM2+ which was used for the 2021 Regional Plan. All of the passenger demand models in ABM2+ were converted from CT-RAMP to ActivitySim, including resident travel, cross-border travel, visitor travel, and airport travel. The internal-external travel component is now fully integrated with the resident model. The model was also enhanced to improve the representation of household and person-based mobility, vehicle fleet ownership, transit, shared and private micro-mobility, and micro-transit. Many of the model components were re-estimated using household survey data collected in 2022, and all model components were re-calibrated to base-year 2023 conditions. A new disaggregate commercial vehicle model was developed based upon a 2020 commercial vehicle survey, and implemented in ActivitySim.</p> <p>This website includes a description of the model system, how to set up and run the models, and a description of model inputs and outputs. Some aspects of the site are a work-in-progress, so we recommend that you check in often, and share your thoughts on ways to improve the site with SANDAG Transportation Modeling staff. Thank you!</p>"},{"location":"cvm.html","title":"Commercial Vehicle Model","text":""},{"location":"cvm.html#design","title":"Design","text":""},{"location":"cvm.html#inputs","title":"Inputs","text":""},{"location":"cvm.html#outputs","title":"Outputs","text":""},{"location":"faq.html","title":"FAQs","text":""},{"location":"faq.html#how-many-abm-versions-does-sandag-maintain","title":"How many ABM versions does SANDAG maintain?","text":"<p>There are four released ABM versions - ABM1, ABM2, ABM2+, and ABM3.</p>"},{"location":"faq.html#who-uses-the-sandag-abm-and-what-for","title":"Who uses the SANDAG ABM and what for?","text":"<p>The SANDAG ABM is used by SANDAG and many other public and private entities in the San Diego region. These entities include the City of San Diego and other local jurisdictions, Caltrans District 11, San Diego Metropolitan Transit System, North County Transit District, and private developers. Typical ABM applications include analysis for regional planning, air quality conformity, corridor studies, and land use development impact studies.</p>"},{"location":"faq.html#what-model-components-does-the-sandag-abm-have","title":"What model components does the SANDAG ABM have?","text":"<p>The SANDAG ABM is a suite of models covering various travel demand markets in the San Diego region. The microsimulation model components include a San Diego resident model, a commercial vehicle model, a Mexican resident crossborder model, a visitor model, a San Diego International Airport ground access model, a Cross-Border Express model serving Tijuana International Airport, and a special event model. The aggregate model components include an external heavy truck model and external trip models.</p>"},{"location":"faq.html#what-is-the-base-year-of-the-sandag-abm","title":"What is the base year of the SANDAG ABM?","text":"<p>ABM2 has a base year of 2022. ABM1 base year was 2012 and both ABM2 and ABM2+ have a base year of 2016.</p>"},{"location":"inputs.html","title":"ABM3 Model Inputs","text":"<p>The main inputs to ABM3 include the transportation network, land-use data, synthetic population data, parameters files, and model specifications. Outputs include a set of files that describe travel decisions made by all travel markets considered by the model (residents, overnight visitors, airport ground access trips, commercial vehicles and trucks, Mexico residents traveling in San Diego County, and travel made by all other non-residents into and through San Diego County).</p>"},{"location":"inputs.html#file-types","title":"File Types","text":"<p>There are several file types used for model inputs and outputs. They are denoted by their extension, as listed in the table below.</p> Extension Format .log, .txt Text files created during a model run containing logging results. .yaml Text files used for setting properties that control ActivitySim or some other process. .csv Comma-separated value files used to store model parameters, input or output data. .omx Open matrix format files used to store input or output trip tables or skims .h5 HDF5 files, used to store pipeline for restarting ActivitySim .shp (along with other files - .cpg, .dbf, .prj, .shx) ArcGIS shapefiles and associated files .html Hypertext markup language files, open in web browser .png Portable network graphics file, open in web browser, Microsoft photos, or third-party graphics editor"},{"location":"inputs.html#model-inputs","title":"Model Inputs","text":"<p>The table below contains brief descriptions of the input files required to execute the SANDAG ABM3.</p> File Name Purpose File Type Prepared By Land Use mgra_based_input{SCENARIO_YEAR}.csv Land use forecast of the size and structure of the region\u2019s economy and corresponding demographic forecast CSV Land Use Modelers, Transportation Modelers, and GIS activity_code_indcen_acs.csv PECAS activity code categories mapping to Census industry codes; This is used for military occupation mapping. CSV Land Use Modelers pecas_occ_occsoc_acs.csv PECAS activity code categories mapping to Census industry codes CSV Lande Use Modelers mobilityHubMGRA.csv CSV Transportation Modelers Synthetic Population households.csv Synthetic households CSV Transportation Modelers persons.csv Synthetic persons CSV Transportation Modelers Network: Highway (to be updated with TNED) hwycov.e00 Highway network nodes from GIS ESRI input exchange Transportation Modelers hwycov.e00 Highway network links from GIS ESRI input exchange Transportation Modelers turns.csv Highway network turns file CSV Transportation Modelers LINKTYPETURNS.dbf Highway network link type turns table DBF Transportation Modelers LINKTYPETURNSCST.DBF DBF Transportation Modelers vehicle_class_toll_factors.csv Relative toll values by six vehicle classes by Facility name. Used to identify \u201cfree for HOV\u201d type managed lane facilities. CSV Transportation Modelers off_peak_toll_factors.csv Relative toll values for the three off-peak times-of-day (EA, MD, EV) by Facility name. Multiplied together with the values from vehicle_class_toll_factors.csv to get the final toll. CSV Transportation Modelers vehicle_class_availability.csv The availability / unavailability of six vehicle classes for five times-of-day by facility name. CSV Transportation Modelers Network: Transit (To be updated with TNED) trcov.e00 Transit network arc data from GIS ESRI input exchange Transportation Modelers trcov.e00 Transit network node data from GIS ESRI input exchange Transportation Modelers trlink.csv Transit route with a list of links file CSV Transportation Modelers trrt.csv Transit route attribute file CSV Transportation Modelers trstop.csv Transit stop attribute file TCSV Transportation Modelers mode5tod.csv Transit mode parameters table CSV Transportation Modelers timexfer_XX.csv Transit timed transfers table between COASTER and feeder buses; XX is the TOD (EA, AM, MD, PM, and EV) CSV Transportation Modelers special_fares.txt Fares to coaster Text File Transportation Modelers Network: Active Transportation SANDAG_Bike_Net.dbf Bike network links DBF GIS SANDAG_Bike_Node.dbf Bike network nodes DBF GIS bikeTazLogsum.csv (not saved in inputs, instead, run at the beginning of a model run) Bike TAZ logsum CSV Transportation Modelers bikeMgraLogsum.csv (not saved in inputs, instead, run at the beginning of a model run) Bike MGRA logsum CSV Transportation Modelers walkMgraEquivMinutes.csv (not saved in inputs, instead, run at the beginning of a model run) Walk, in minutes, between MGRAs CSV Visitor Model (Derived from visitor survey) visitor_businessFrequency.csv Visitor model tour frequency distribution for business travelers CSV Transportation Modelers visitor_personalFrequency.csv Visitor model tour frequency distribution for personal travelers CSV Transportation Modelers visitor_partySize.csv Visitor model party size distribution CSV Transportation Modelers visitor_autoAvailable.csv Visitor model auto availability distribution CSV Transportation Modelers visitor_income.csv Visitor model income distribution CSV Transportation Modelers visitor_tourTOD.csv Visitor model tour time-of-day distribution CSV Transportation Modelers visitor_stopFrequency.csv Visitor model stop frequency distribution CSV Transportation Modelers visitor_stopPurpose.csv Visitor model stop purpose distribution CSV Transportation Modelers visitor_outboundStopDuration.csv Visitor model time-of-day offsets for outbound stops CSV Transportation Modelers visitor_inboundStopDuration.csv Visitor model time-of-day offsets for inbound stops CSV Transportation Modelers Airport Model (Derived from airport survey) airport_purpose.csv Airport model tour purpose frequency table CSV Transportation Modelers airport_party.csv Airport model party type frequency table CSV Transportation Modelers airport_nights.csv Airport model trip duration frequency table CSV Transportation Modelers airport_income.csv Airport model trip income distribution table CSV Transportation Modelers airport_departure.csv Airport model time-of-day distribution for departing trips CSV Transportation Modelers airport_arrival.csv Airport model time-of-day distribution for arriving trips CSV Transportation Modelers Cross-Border Model (Derived from cross-border survey) crossBorder_tourPurpose_control.csv CSV crossBorder_tourPurpose_nonSENTRI.csv Cross Border Model tour purpose distribution for Non-SENTRI tours CSV Transportation Modelers crossBorder_tourPurpose_SENTRI.csv Cross Border Model tour purpose distribution for SENTRI tours CSV Transportation Modelers crossBorder_tourEntryAndReturn.csv Cross Border Model tour entry and return time-of-day distribution CSV Transportation Modelers crossBorder_supercolonia.csv Cross Border Model distance from Colonias to border crossing locations CSV Transportation Modelers crossBorder_pointOfEntryWaitTime.csv Cross Border Model wait times at border crossing locations table CSV GIS - Pat L vtsql crossBorder_stopFrequency.csv Cross Border Model stop frequency data CSV Transportation Modelers crossBorder_stopPurpose.csv Cross Border Model stop purpose distribution CSV Transportation Modelers crossBorder_outboundStopDuration.csv Cross Border Model time-of-day offsets for outbound stops CSV Transportation Modelers crossBorder_inboundStopDuration.csv Cross Border Model time-of-day offsets for inbound stops CSV Transportation Modelers External Models (Derived from SCAG survey) externalExternalTripsByYear.csv  (raw inputs have these by year)  External origin-destination station trip matrix CSV Transportation Modelers externalInternalControlTotalsByYear.csv  (raw inputs have these by year)  External Internal station control totals read by GISDK CSV Transportation Modelers internalExternal_tourTOD.csv Internal-External Model tour time-of-day frequency distribution CSV Transportation Modelers Commercial Vehicle Model (TO BE UPDATED) tazcentroids_cvm.csv Zone centroid coordinates in state plane feet and albers CSV Transportation Modelers commVehFF.csv Commercial Vehicle Model friction factors CSV Transportation Modelers OE.csv Commercial vehicle model parameters file for off-peak early (OE) period CSV Transportation Modelers AM.csv Commercial vehicle model parameters file for AM period CSV Transportation Modelers MD.csv Commercial vehicle model parameters file for mid-day (MD) period CSV Transportation Modelers PM.csv Commercial vehicle model parameters file for PM period CSV Transportation Modelers OL.csv Commercial vehicle model parameters file for off-peak late (OL) period CSV Transportation Modelers FA.csv Commercial vehicle model parameters file for fleet allocator (FA) industry CSV Transportation Modelers GO.csv Commercial vehicle model parameters file for government/ office (GO) industry CSV Transportation Modelers IN.csv Commercial vehicle model parameters file for industrial (IN) industry CSV Transportation Modelers FA.csv Commercial vehicle model parameters file for fleet allocator (FA) industry CSV Transportation Modelers RE.csv Commercial vehicle model parameters file for retail (RE) industry CSV Transportation Modeler SV.csv Commercial vehicle model parameters file for service (SV) industry CSV Transportation Modelers TH.csv Commercial vehicle model parameters file transport and handling (TH) industry CSV Transportation Modelers WH.csv Commercial vehicle model parameters file wholesale (WH) industry CSV Transportation Modelers Truck Model TruckTripRates.csv Truck model data: Truck trip rates CSV Transportation Modelers regionalEItrips.csv Truck model data: Truck external to internal data CSV Transportation Modelers regionalIEtrips.csv Truck model data: Truck internal to external data CSV Transportation Modelers regionalEEtrips.csv Truck model data: Truck external to external data CSV Transportation Modelers specialGenerators.csv Truck model data: Truck special generator data CSV Transportation Modelers Other parametersByYears.csv Parameters by scenario years. Includes AOC, aiport enplanements, cross-border tours, cross-border sentri share. CSV Transportation Modelers filesByYears.csv File names by scenario years. CSV Transportation Modelers trip_XX.omx Warm start trip table; XX is the TOD (EA, AM, MD, PM, and EV) OMX Transportation Modelers zone.term TAZ terminal times Space Delimited Text File Transportation Modelers <p><code>MGRA_BASED_INPUT&lt;&lt;SCENARIO_YEAR&gt;&gt;.CSV</code></p> Column name Description mgra MGRANumber taz TAZ Number luz_id pop total population hhp total household population (exclude gq pop) hs housing structures hs_sf single family structures hs_mf multi family structures hs_mh mobile homes hh total number of households hh_sf number of households - single family hh_mf number of households - multi family hh_mh number of mobile homes hhs household size gq_civ GQ civilian gq_mil GQ military i1 Number of households with income less than \\(15,000 (\\)2010) i2 Number of households with income \\(15,000-\\)29,999 ($2010) i3 Number of households with income \\(30,000-\\)44,999 ($2010) i4 Number of households with income \\(45,000-\\)59,999 ($2010) i5 Number of households with income \\(60,000-\\)74,999 ($2010) i6 Number of households with income \\(75,000-\\)99,999 ($2010) i7 Number of households with income \\(100,000-\\)124,999 ($2010) i8 Number of households with income \\(125,000-\\)149,999 ($2010) i9 Number of households with income \\(150,000-\\)199,999 ($2010) i10 Number of households with income \\(200,000 or more (\\)2010) emp_gov Government employment emp_mil military employment emp_ag_min Agriculture and mining employment emp_bus_svcs Professional and Business Services employment emp_fin_res_mgm Financial and resource management employment emp_educ Education services employment emp_hlth Health services employment emp_ret Retail services employment emp_trn_wrh Transportation and Warehousing employment emp_con Construction employment emp_utl Utilities office support employment emp_mnf Manufacturing employment emp_whl Wholesale employment emp_ent Entertainment services employment emp_accm Hotel and accomodation services emp_food Food services employment emp_oth Other employment emp_non_ws_wfh Non-wage and salary work from home employments emp_non_ws_oth Non-wage and salary other employments emp_total Total employment pseudomsa Pseudo MSA - 1: Downtown 2: Central 3: North City 4: South Suburban 5: East Suburban 6: North County West 7: North County East 8: East County zip09 2009 Zip Code enrollgradekto8 Grade School K-8 enrollment enrollgrade9to12 Grade School 9-12 enrollment collegeenroll Major College enrollment othercollegeenroll Other College enrollment hotelroomtotal Total number of hotel rooms parkactive Acres of Active Park openspaceparkpreserve Acres of Open Park or Preserve beachactive Acres of Active Beach district27 milestocoast Distance (miles) to the nearest coast acres Total acres in the mgra (used in CTM) land_acres Acres of land in the mgra (used in CTM) effective_acres Effective acres in the mgra (used in CTM) truckregiontype exp_hourly Expected hourly prking cost exp_daily Expected daily prking cost exp_monthly Expected monthly prking cost parking_type MGRA parking type parking_spaces MGRA estimated parking spaces ech_dist Elementary school district hch_dist High school district remoteAVParking Remote AV parking available at MGRA: 0 = Not available, 1 = Available refueling_stations Number of refueling stations at MGRA MicroAccessTime Micro-mobility access time (mins) microtransit microtransit access time (mins) nev Neighborhood Electric Vehicle access time (mins) totint Total intersections duden Dwelling unit density empden Employment density popden Population density retempden Retail employment density totintbin Total intersection bin empdenbin Employment density bin dudenbin Dwelling unit density bin PopEmpDenPerMi Population and employment density per mile <p></p>"},{"location":"inputs.html#activity-mapping-to-industry-codes","title":"Activity Mapping to Industry Codes","text":""},{"location":"inputs.html#activity_code_indcen_acscsv","title":"<code>ACTIVITY_CODE_INDCEN_ACS.CSV</code>","text":"Column Name Description indcen Industry code defined in PECAS: They are about 270 industry categories grouped by 6-digit NAICS code (North American Industrial Classification System) activity_code Activity code defined in PECAS. They are about 30 types of activities grouped by the industry categories:1 = Agriculture3 = Construction Non-Building office support (including mining)5 = Utilities office support9 = Manufacturing office support10 = Wholesale and Warehousing11 = Transportation Activity12 = Retail Activity13 = Professional and Business Services14 = Professional and Business Services (Building Maintenance)16 = Private Education Post-Secondary (Post K-12) and Other17 = Health Services18 = Personal Services Office Based19 = Amusement Services20 = Hotels and Motels21 = Restaurants and Bars22 = Personal Services Retail Based23 = Religious Activity24 = Private Households25 = State and Local Government Enterprises Activity27 = Federal Non-Military Activity28 = Federal Military Activity30 = State and Local Government Non-Education Activity office support31 = Public Education"},{"location":"inputs.html#pecas-soc-defined-occupational-codes","title":"PECAS SOC - Defined Occupational Codes","text":""},{"location":"inputs.html#pecas_occ_occsoc_acscsv","title":"<code>PECAS_OCC_OCCSOC_ACS.CSV</code>","text":"Column Name Description occsoc5 Detailed occupation codes defined by the Standard Occupational Classification (SOC) system commodity_id              Commodity code defined in PECAS. The detailed SOC occupations are grouped into 6 types of laborers, which are included as part of commodity:              51 = Services Labor             52 = Work at Home Labor             53 = Sales and Office Labor             54 = Natural Resources Construction and Maintenance Labor             55 = Production Transportation and Material Moving Labor             56 = Military Labor"},{"location":"inputs.html#listing-of-external-zones-attributes","title":"Listing of External Zones Attributes","text":""},{"location":"inputs.html#externalzonesxls","title":"<code>EXTERNALZONES.XLS</code>","text":"Column Name Description Internal Cordon LUZ Internal Cordon Land use zone External LUZ External land use zone Cordon Point Cordon Point description Destination Approximation Name of approximate city destination Miles to be Added to Cordon Point Miles to be added to cordon point Travel Time Travel time to external zone Border Delay Border delay time Minutes to be Added to Cordon Point Minutes to be added to cordon point MPH Average miles per hour based on miles and minutes to be added to cordon point"},{"location":"inputs.html#population-synthesizer-household-data","title":"Population Synthesizer Household Data","text":""},{"location":"inputs.html#householdscsv","title":"<code>HOUSEHOLDS.CSV</code>","text":"Column Name Description hhid Unique Household ID household_serial_no Household serial number taz TAZ of household mgra MGRA of household hinccat1 Household income category:1 = &lt;$30k2 = $30-60k3 = $60-100k4 = $100-150k5 = $150k+ hinc Household income num_workers Number of workers in household veh Number of vehicles in household persons Number of persons in household hht Household/family type:0 = Not in universe (vacant or GQ)1 = Family household: married-couple2 = Family household: male householder, no wife present3 = Family household: female householder, no husband present4 = Nonfamily household: male householder, living alone5 = Nonfamily household: male householder, not living alone6 = Nonfamily household: female householder, living alone7 = Nonfamily household: female householder, not living alone bldgsz Building size - Number of Units in Structure &amp; Quality:1 = Mobile home or trailer2 = One-family house detached3 = One-family house attached8 = 20-49 Apartments9 = 50 or more apartments unittype Household unit type:0 = Non-GQ Household1 = GQ Household version Synthetic population run version. Presently set to 0. poverty Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"inputs.html#population-synthesizer-person-data","title":"Population Synthesizer Person Data","text":""},{"location":"inputs.html#personscsv","title":"<code>PERSONS.CSV</code>","text":"Column Name Description hhid Household ID perid Person ID Household_serial_no Household serial number pnum Person Number age Age of person sex Gender of person1 = Male2 = Female military Military status of person:0 = N/A Less than 17 Years Old1 = Yes, Now on Active Duty pemploy Employment status of person:1 = Employed Full-Time2 = Employed Part-Time3 = Unemployed or Not in Labor Force4 = Less than 16 Years Old pstudent Student status of person:1 = Pre K-122 = College Undergrad+Grad and Prof. School3 = Not Attending School ptype Person type:1 = Full-time Worker2 = Part-time Worker3 = College Student4 = Non-working Adult5 = Non-working Senior6 = Driving Age Student7 = Non-driving Student8 = Pre-school educ Educational attainment:1 = No schooling completed9 = High school graduate13 = Bachelor\u2019s degree grade School grade of person:0 = N/A (not attending school)2 = K to grade 85 = Grade 9 to grade 126 = College undergraduate occen5 Occupation:0 = Not in universe (Under 16 years or LAST-WRK = 2)1..997 = Legal census occupation code occsoc5 Detailed occupation codes defined by the Bureau of Labor Statistics"},{"location":"inputs.html#highway-network-vehicle-class-toll-factors-file","title":"Highway Network Vehicle Class Toll Factors File","text":""},{"location":"inputs.html#vehicle_class_toll_factorscsv","title":"<code>vehicle_class_toll_factors.csv</code>","text":"<p>Required file. Used to specify the relative toll values by six vehicle classes by Facility name, scenario year and time of day. Can be used, for example, to identify \u201cfree for HOV\u201d type managed lane facilties. Used by the Import network Modeller tool.</p> <p>Example:</p> Facility_name Year Time_of_Day DA_Factor S2_Factor S3_Factor TRK_L_Factor TRK_M_Factor TRK_H_Factor I-15 2016 EA 1.0 0.0 0.0 1.0 1.03 2.33 SR-125 2016 ALL 1.0 1.0 1.0 1.0 1.03 2.33 I-5 2035 ALL 1.0 1.0 0.0 1.0 1.03 2.33 <p>The toll values for each class on each link are calculated by multiplying the input toll value from hwycov.e00 (ITOLLA, ITOLLP, ITOLLO) by this factor, matched by the Facility name (together with the toll factors from off_peak_toll_factors.csv in converting ITOLLO to the off-peak times-of-day). </p> <p>The network links are matched to a record in this file based on the NM, FXNM or TXNM values (in that order). A simple substring matching is used, so the record with Facility_name \u201cI-15\u201d matches any link with name \u201cI-15 SB\u201d, \u201cI-15 NB\u201d, \u201cI-15/DEL LAGO DAR NB\u201d etc. The records should not be overlapping: if there are two records which match a given link it will be an arbitrary choice as to which one is used.</p> <p>Note that if a link does not match to a record in this file, the default factors (specified in the table below) will be applied to said link. It is OK if there are records for which there are no link tolls.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields Year Scenario year Time_of_Day              Time of day period:             EA = Early morning (3am - 5:59am)             AM = AM peak (6am to 8:59am)             MD = Mid-day (9am to 3:29pm)             PM = PM peak (3:30pm to 6:59pm)             EV = Evening (7pm to 2:59am)             ALL = All time of day periods          DA_Factor Positive toll factor for Drive Alone (SOV) vehicle classes. The default value is 1.0 S2_Factor Positive toll factor for Shared 2 person (HOV2) vehicle classes. The default value is 1.0 S3_Factor Positive toll factor for Shared 3+ person (HOV3) vehicle classes. The default value is 1.0 TRK_L_Factor Positive toll factor for Light Truck (TRKL) vehicle classes. The default value is 1.0 TRK_M_Factor Positive toll factor for Medium Truck (TRKM) vehicle classes. The default value is 1.03 TRK_H_Factor Positive toll factor for Heavy Truck (TRKH) vehicle classes. The default value is 2.03 <p></p>"},{"location":"inputs.html#highway-network-off-peak-toll-factors-file","title":"Highway Network Off-Peak Toll Factors File","text":""},{"location":"inputs.html#off_peak_toll_factorscsv","title":"<code>off_peak_toll_factors.csv</code>","text":"<p>Optional file. Used to specify different tolls in the off-peak time-of-day scenarios based on the single link ITOLLO field, together with the tolls by vehicle class from vehicle_class_toll_factors.csv. Used by the Import network Modeller tool.</p> <p>Example: <pre><code>Facility_name, OP_EA_factor, OP_MD_factor, OP_EV_factor\nI-15,                  0.75,          1.0,         0.75\nSR-125,                1.0 ,          1.0,         1.0\nSR-52,                 0.8 ,          1.0,         0.8\n</code></pre></p> <p>See note re: network link matching under vehicle_class_toll_factors.csv. Note that all facilities need not be specified, links not matched will use a factor of 1.0.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields OP_EA_FACTOR Positive toll factor for Early AM period tolls OP_MD_FACTOR Positive toll factor for Midday period tolls OP_EV_FACTOR Positive toll factor for Evening period tolls <p></p>"},{"location":"inputs.html#highway-network-vehicle-class-toll-factors-file_1","title":"Highway Network Vehicle Class Toll Factors File","text":""},{"location":"inputs.html#vehicle_class_availabilitycsv","title":"<code>vehicle_class_availability.csv</code>","text":"<p>Optional file. Specifies the availability / unavailability of six vehicle classes for five times-of-day by Facility name. This will override any mode / vehicle class availability specified directly on the network (hwycov.e00), via ITRUCK and IHOV fields. Used in the generation of time-of-day Emme scenarios in the Master run Modeller tool.</p> <p>Example:</p> Facility_name vehicle_class EA_Avail AM_Avail MD_Avail PM_Avail EV_Avail I-15 DA 1 1 1 1 1 I-15 S2 1 1 1 1 1 I-15 S3 1 0 1 0 1 I-15 TRK_L 1 1 1 1 1 I-15 TRK_M 1 0 0 0 1 I-15 TRK_H 1 0 0 0 1 <p>See note re: network link matching under vehicle_class_toll_factors.csv. Note that all facilities need not be specified, links not matched will use the availability as indicated by the link fields in hwycov.e00.</p> Column Name Description Facility_name Name of the facility, used in the substring matching with links by NM, FXNM or TXNM fields Vehicle_class Name of the vehicle class, one of DA, S2, S3, TRK_L, TRK_M, or TRK_H EA_Avail For this facility and vehicle class, is available for Early AM period (0 or 1) AM_Avail For this facility and vehicle class, is available for AM Peak period (0 or 1) MD_Avail For this facility and vehicle class, is available for Midday period (0 or 1) PM_Avail For this facility and vehicle class, is available for PM Peak period (0 or 1) EV_Avail For this facility and vehicle class, is available for Evening period (0 or 1)"},{"location":"inputs.html#special_farestxt","title":"<code>special_fares.txt</code>","text":"<pre><code>boarding_cost:\n   base: \n       - {line: \"398104\", cost: 3.63}\n       - {line: \"398204\", cost: 3.63}\n   stop_increment:\n       - {line: \"398104\", stop: \"SORRENTO VALLEY\", cost: 0.46}\n       - {line: \"398204\", stop: \"SORRENTO VALLEY\", cost: 0.46}\nin_vehicle_cost: \n   - {line: \"398104\", from: \"SOLANA BEACH\", cost: 0.45}\n   - {line: \"398104\", from: \"SORRENTO VALLEY\", cost: 0.45}\n   - {line: \"398204\", from: \"OLD TOWN\",  cost: 0.45}\n   - {line: \"398204\", from: \"SORRENTO VALLEY\", cost: 0.45}\nday_pass: 4.54\nregional_pass: 10.90\n</code></pre>"},{"location":"inputs.html#transit-binary-stop-table","title":"Transit Binary Stop Table","text":""},{"location":"inputs.html#trstopcsv","title":"<code>TRSTOP.CSV</code>","text":"Column Name Description Stop_id Unique stop ID Route_id Sequential route number Link_id Link id associated with route Pass_count Number of times the route passes this stop. Most of value is one, some value is 2 Milepost Stop mile post Longitude Stop Longitude Latitude Stop Latitude NearNode Node number that stop is nearest to FareZone Zones defined in Fare System StopName Name of Stop MODE_NAME              Line haul mode name:             Transfer             Center City Walk             Walk Access             Commuter Rail             Light Rail             Regional BRT (Yellow)             Regional BRT (Red)             Limited Express             Express             Local          MODE_ID              Mode ID             1 = Transfer             2 = Center City Walk             3 = Walk Access             4 = Commuter Rail             5 = Light Rail             6 = Regional BRT (Yellow)             7 = Regional BRT (Red)             8 = Limited Express             9 = Express             10 = Local          PREMODE              Premium Transit mode             0 = No             1 = Yes          EXPBSMODE              Express bus mode             0 = No             1 = Yes          LOCMODE              Local bus mode             0 = No             1 = Yes          OP_TRNTIME              Off peak transcad matrix used by mode:             *oploctime             *oppretime          AM_TRNTIME              AM peak transcad matrix used by mode:             *amloctime             *ampretime          PM_TRNTIME              PM peak transcad matrix used by mode:             *pmloctime             *pmpretime          MODE_ACCES Mode of access (1) MODE_EGRES Mode of egress (1) WT_IVTPK Weight for peak in-vehicle time: 1, 1.5, or 1.8 WT_FWTPK Weight for peak first wait time: 1, 1.5 WT_XWTPK Weight for peak transfer wait time: 1, 3 WT_FAREPK Weight for peak fare: 0.46, 0.60, 0.63, 0.67, 1 WT_IVTOP Weight for off-peak in-vehicle time: 1, 1.5, or 1.6 WT_FWTOP Weight for off-peak first wait time: 1, 1.5 WT_XWTOP Weight for off-peak transfer wait time: 1, 3 WT_FAREOP Weight for off-peak fare: 0.23, 0.51, 0.52, 0.54, 0.58, 1 FARE Transit fare: $0, $1.25, $1.50, $2.50, $3.00, $3.50 DWELLTIME Dwell time: 0, 0.3, 0.5 FARETYPE              Fare Type:             1 = Bus             2 = Rail          FAREFIELD              Fare Field:             coaster fare             lightrail fare          CRMODE Boolean if Commuter rail available LRMODE Boolean if light rail available XFERPENTM Transfer Penalty time: 5 minutes WTXFERTM Transfer Wait time: 1 minute TRNTIME_EA Early AM transit time impedance TRNTIME_AM AM transit time impedance TRNTIME_MD Midday transit time impedance TRNTIME_PM PM transit time impedance TRNTIME_EV Evening transit time impedance"},{"location":"inputs.html#transit-timed-transfers-between-coaster-and-feeder-buses","title":"Transit Timed Transfers Between COASTER and Feeder Buses","text":""},{"location":"inputs.html#timexfer_xxcsv","title":"<code>TIMEXFER_XX.CSV</code>","text":"Column Name Description FROM_LINE From Route Number TO_LINE To Route Number WAIT_TIME Wait time in minutes"},{"location":"inputs.html#transit-stop-table","title":"Transit Stop Table","text":""},{"location":"inputs.html#trstopcsv_1","title":"<code>TRSTOP.CSV</code>","text":"Column Name Description Stop_id Unique stop ID Route_id Sequential route number Link_id Link id associated with route Pass_count Number of times the route passes this stop. Most of value is one, some value is 2 Milepost Stop mile post Longitude Stop Longitude Latitude Stop Latitude NearNode Node number that stop is nearest to FareZone Zones defined in Fare System StopName Name of Stop MODE_NAME Line haul mode name:TransferCenter City WalkWalk AccessCommuter RailLight RailRegional BRT (Yellow)Regional BRT (Red)Limited ExpressExpressLocal MODE_ID Mode ID1 = Transfer2 = Center City Walk3 = Walk Access4 = Commuter Rail5 = Light Rail6 = Regional BRT (Yellow)7 = Regional BRT (Red)8 = Limited Express9 = Express10 = Local PREMODE Premium Transit mode0 = No1 = Yes EXPBSMODE Express bus mode0 = No1 = Yes LOCMODE Local bus mode0 = No1 = Yes OP_TRNTIME Off peak transcad matrix used by mode:oploctimeoppretime AM_TRNTIME AM peak transcad matrix used by mode:amloctimeampretime PM_TRNTIME PM peak transcad matrix used by mode:pmloctimepmpretime MODE_ACCES Mode of access (1) MODE_EGRES Mode of egress (1) WT_IVTPK Weight for peak in-vehicle time: 1, 1.5, or 1.8 WT_FWTPK Weight for peak first wait time: 1, 1.5 WT_XWTPK Weight for peak transfer wait time: 1, 3 WT_FAREPK Weight for peak fare: 0.46, 0.60, 0.63, 0.67, 1 WT_IVTOP Weight for off-peak in-vehicle time: 1, 1.5, or 1.6 WT_FWTOP Weight for off-peak first wait time: 1, 1.5 WT_XWTOP Weight for off-peak transfer wait time: 1, 3 WT_FAREOP Weight for off-peak fare: 0.23, 0.51, 0.52, 0.54, 0.58, 1 FARE Transit fare: $0, $1.25, $1.50, $2.50, $3.00, $3.50 DWELLTIME Dwell time: 0, 0.3, 0.5 FARETYPE Fare Type:1 = Bus2 = Rail FAREFIELD Fare Field:coaster farelightrail fare CRMODE Boolean if Commuter rail available LRMODE Boolean if light rail available XFERPENTM Transfer Penalty time: 5 minutes WTXFERTM Transfer Wait time: 1 minute TRNTIME_EA Early AM transit time impedance TRNTIME_AM AM transit time impedance TRNTIME_MD Midday transit time impedance TRNTIME_PM PM transit time impedance TRNTIME_EV Evening transit time impedance"},{"location":"inputs.html#transit-link-file","title":"Transit Link File","text":""},{"location":"inputs.html#trlinkcsv","title":"<code>TRLINK.CSV</code>","text":"Column Name Description Route_id: Sequential route number Link_id Link id associated with route Direction + or -"},{"location":"inputs.html#bike-network-link-field-list","title":"Bike Network Link Field List","text":""},{"location":"inputs.html#sandag_bike_netdbf","title":"<code>SANDAG_BIKE_NET.DBF</code>","text":"Column Name Description ROADSEGID Road Segment ID RD20FULL Road/Street Name A Foreign key of first node B Foreign key of second node A_LEVEL Level of first node B_LEVEL Level of second node Distance Arc length of link (ft) AB_Gain Cumulative non-negative increase in elevation from A to B nodes (ft) BA_Gain Cumulative non-negative increase in elevation from B to A nodes (ft) ABBikeClas Type of Bike Classification in AB direction where:1 = Multi-Use Path2 = Bike Lane3 = Bike Route BABikeClas Type of Bike Classification in BA direction where:1 = Multi-Use Path2 = Bike Lane3 = Bike Route AB_Lanes Number of Lanes in AB direction BA_Lanes Number of Lanes in BA direction Func_Class Type of Road Functional Class where:1 = Freeway to Freeway Ramp2 = Light (2-lane) Collector Street3 = Rural Collector Road4 = Major Road/4-lane Major Road5 = Rural Light Collector/Local Road6 = Prime Arterial7 = Private Street8 = Recreational Parkway9 = Rural Mountain RoadA = AlleyB = Class I Bicycle PathC = Collector/4-lane Collector StreetD = Two-lane Major StreetE = ExpresswayF = FreewayL = Local Street/Cul-de-sacM = Military Street within BaseP = Paper StreetQ = UndocumentedR = Freeway/Expressway On/Off RampS = Six-lane Major StreetT = TransitwayU = Unpaved RoadW = Pedestrian Way/Bikeway Bike2Sep Separated Bike Lane Flag where:0 = No1 = Yes Bike3Blvd Bike Boulevard Lane Flag where:0 = No1 = Yes SPEED Road Speed A_Elev A Node Elevation B_Elev B Node Elevation ProjectID Project ID in the regional bike network Year Year built/opened to the public Scenicldx Scenic index represents the closeness to the ocean and parks Path Null Shape_Leng length of the link (ft)"},{"location":"inputs.html#bike-network-node-field-list","title":"Bike Network Node Field List","text":""},{"location":"inputs.html#sandag_bike_nodedbf","title":"<code>SANDAG_BIKE_NODE.DBF</code>","text":"Column Name Description NodeLev_ID Node Unique Identifier MGRA MGRA ID for Centroids TAZ TAZ ID for Centroids TAP TAP ID XCOORD X Coordinate of Node in NAD 1983 State Plane California Region VI FIPS: 0406 (ft) YCOORD Y Coordinate of Node in NAD 1983 State Plane California Region VI FIPS: 0406(ft) ZCOORD Elevation (ft) Signal              Traffic Signal Presence where:             0 = Absence             1 = Presence"},{"location":"inputs.html#zone-terminal-time","title":"Zone Terminal Time","text":""},{"location":"inputs.html#zoneterm","title":"<code>ZONE.TERM</code>","text":"Column Name Description Zone TAZ number Terminal time Terminal time (3, 4, 5, 7, 10 minutes)"},{"location":"inputs.html#bike-taz-logsum","title":"Bike TAZ Logsum","text":""},{"location":"inputs.html#biketazlogsumcsv","title":"<code>BIKETAZLOGSUM.CSV</code>","text":"Column Name Description i Origin TAZ j Destination TAZ Logsum Logsum - a measure of the closeness of the origin and the destination of the trip time Time (In minutes)"},{"location":"inputs.html#bike-mgra-logsum","title":"Bike MGRA Logsum","text":""},{"location":"inputs.html#bikemgralogsumcsv","title":"<code>BIKEMGRALOGSUM.CSV</code>","text":"Column Name Description i Origin of MGRA j Destination of MGRA Logsum Logsum - a measure of the closeness of the origin and the destination of the trip time Time (in minutes)"},{"location":"inputs.html#walk-mgra-equivalent-minutes","title":"Walk MGRA Equivalent Minutes","text":""},{"location":"inputs.html#walkmgraequivminutescsv","title":"<code>WALKMGRAEQUIVMINUTES.CSV</code>","text":"Column Name Description i Origin (MGRA) j Destination (MGRA) percieved Percieved time to walk actual Actual time to walk (minutes) gain Gain in elevation"},{"location":"inputs.html#airport-trip-purpose-distribution","title":"Airport Trip Purpose Distribution","text":""},{"location":"inputs.html#airport_purposesancsv-and-airport_purposecbxcsv","title":"<code>AIRPORT_PURPOSE.SAN.CSV AND AIRPORT_PURPOSE.CBX.CSV</code>","text":"Column Name Description Purpose              Trip Purpose:             0 = Resident Business             1 = Resident Personal             2 = Visitor Business             3 = Visitor Personal             4 = External          Percent Distribution of Trips in trip purpose"},{"location":"inputs.html#airport-party-size-by-purpose-distribution","title":"Airport Party Size by Purpose Distribution","text":""},{"location":"inputs.html#airport_partysancsv-and-airport_partycbxcsv","title":"<code>AIRPORT_PARTY.SAN.CSV AND AIRPORT_PARTY.CBX.CSV</code>","text":"Column Name Description Party Party size (0 through 5+) purp0_perc Distribution for Resident Business purpose purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-number-of-nights-by-purpose-distribution","title":"Airport Number of Nights by Purpose Distribution","text":""},{"location":"inputs.html#airport_nightssancsv-and-airport_nightscbxcsv","title":"<code>AIRPORT_NIGHTS.SAN.CSV AND AIRPORT_NIGHTS.CBX.CSV</code>","text":"Column Name Description Nights Number of Nights stayed (0 through 14+) purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-income-by-purpose-distribution","title":"Airport Income by Purpose Distribution","text":""},{"location":"inputs.html#airport_incomesancsv-and-airport_incomecbxcsv","title":"<code>AIRPORT_INCOME.SAN.CSV AND AIRPORT_INCOME.CBX.CSV</code>","text":"Column Name Description Income group              Household income:             0 = Less than $25K             1 = $25K \u2013 $50K             2 = $50K \u2013 $75K             3 = $75K \u2013 $100K             4 = $100K \u2013 $125K             5 = $125K \u2013 $150K             6 = $150K \u2013 $200K             7 = $200K plus          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-departure-time-by-purpose-distribution","title":"Airport Departure Time by Purpose Distribution","text":""},{"location":"inputs.html#airport_departuresancsv-and-airport_departurecbxcsv","title":"<code>AIRPORT_DEPARTURE.SAN.CSV</code> and <code>AIRPORT_DEPARTURE.CBX.CSV</code>","text":"Column Name Description Period              Departure Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#airport-arrival-time-by-purpose-distribution","title":"Airport Arrival Time by Purpose Distribution","text":""},{"location":"inputs.html#airport_arrivalsancsv-and-airport_arrivalcbxcsv","title":"<code>AIRPORT_ARRIVAL.SAN.CSV</code> and <code>AIRPORT_ARRIVAL.CBX.CSV</code>","text":"Column Name Description Period              Arrival Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          purp1_perc Distribution for Resident Personal purpose purp2_perc Distribution for Visitor Business purpose purp3_perc Distribution for Visitor Personal purpose purp4_perc Distribution for External purpose"},{"location":"inputs.html#cross-border-model-tour-entry-and-return-distribution","title":"Cross Border Model Tour Entry and Return Distribution","text":""},{"location":"inputs.html#crossborder_tourentryandreturncsv","title":"<code>CROSSBORDER_TOURENTRYANDRETURN.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          EntryPeriod              Entry Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Return Period              Return Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Percent Distribution of tours in entry and return period time slots"},{"location":"inputs.html#cross-border-model-supercolonia","title":"Cross Border Model Supercolonia","text":""},{"location":"inputs.html#crossborder_supercoloniacsv","title":"<code>CROSSBORDER_SUPERCOLONIA.CSV</code>","text":"Column Name Description Supercolonia_ID Super colonia ID Population Population of the super colonia Distance_poe0 Distance from colonia to point of entry 0 (San Ysidro) Distance_poe1 Distance from colonia to point of entry 1 (Otay Mesa) Distance_poe2 Distance from colonia to point of entry 2 (Tecate)"},{"location":"inputs.html#cross-border-model-point-of-entry-wait-time","title":"Cross Border Model Point of Entry Wait Time","text":""},{"location":"inputs.html#crossborder_pointofentrywaittimecsv","title":"<code>CROSSBORDER_POINTOFENTRYWAITTIME.CSV</code>","text":"Column Name Description poe              Point of Entry number:             0 = San Ysidro             1 = Otay Mesa             2 = Tecate             3 = Otay Mesa East             4 = Jacumba          StartHour Start Hour (1 through 12) EndHour End Hour (1 through 12) StartPeriod              Start Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          EndPeriod              End Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          StandardWait Standard wait time SENTRIWait SENTRI users wait time PedestrianWait Pedestrian wait time"},{"location":"inputs.html#cross-border-model-stop-frequency","title":"Cross Border Model Stop Frequency","text":""},{"location":"inputs.html#crossborder_stopfrequencycsv","title":"<code>CROSSBORDER_STOPFREQUENCY.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          DurationLo Lower bound of tour duration (0, 4, or 8) DurationHi Upper bound of tour duration (4, 8, or 24) Outbound Number of stops on the outbound (0, 1, 2, 3+) Inbound Number of stops on the inbound (0, 1, 2, 3+) Percent Distribution of tours by purpose, duration, number of outbound/inbound stops"},{"location":"inputs.html#cross-border-model-stop-purpose-distribution","title":"Cross Border Model Stop Purpose Distribution","text":""},{"location":"inputs.html#crossborder_stoppurposecsv","title":"<code>CROSSBORDER_STOPPURPOSE.CSV</code>","text":"Column Name Description TourPurp              Tour Purpose:             0 = Work             1 = School             2 = Cargo             3 = Shop             4 = Visit             5 = Other          Inbound Boolean for whether stop is inbound (0=No, 1=Yes) StopNum Stop number on tour (1, 2, or 3) Multiple Boolean for whether there are multiple stops on tour (0=No, 1=Yes) StopPurp0 Distribution of Work stops StopPurp1 Distribution of School stops StopPurp2 Distribution of Cargo stops StopPurp3 Distribution of Shopping stops StopPurp4 Distribution of Visiting stops StopPurp5 Distribution of Other stops"},{"location":"inputs.html#cross-border-model-outbound-stop-duration-distribution","title":"Cross Border Model Outbound Stop Duration Distribution","text":""},{"location":"inputs.html#crossborder_outboundstopdurationcsv","title":"<code>CROSSBORDER_OUTBOUNDSTOPDURATION.CSV</code>","text":"Column Name Description RemainingLow              Lower bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          RemainingHigh              Upper bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Stop Stop number on tour (1, 2, or 3) 0 Probability that stop departure is in same period as last outbound trip 1 Probability that stop departure is in last outbound trip period + 1 2 Probability that stop departure is in last outbound trip period + 2 3 Probability that stop departure is in last outbound trip period + 3 4 Probability that stop departure is in last outbound trip period + 4 5 Probability that stop departure is in last outbound trip period + 5 6 Probability that stop departure is in last outbound trip period + 6 7 Probability that stop departure is in last outbound trip period + 7 8 Probability that stop departure is in last outbound trip period + 8 9 Probability that stop departure is in last outbound trip period + 9 10 Probability that stop departure is in last outbound trip period + 10 11 Probability that stop departure is in last outbound trip period + 11"},{"location":"inputs.html#cross-border-model-inbound-stop-duration-distribution","title":"Cross Border Model Inbound Stop Duration Distribution","text":""},{"location":"inputs.html#crossborder_inboundstopdurationcsv","title":"<code>CROSSBORDER_INBOUNDSTOPDURATION.CSV</code>","text":"Column Name Description RemainingLow              Lower bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          RemainingHigh              Upper bound of remaining half hour periods after last scheduled trip:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Stop Stop number on tour (1, 2, or 3) 0 Probability that stop departure period is same as tour arrival period -1 Probability that stop departure period is tour arrival period - 1 -2 Probability that stop departure period is tour arrival period \u2013 2 -3 Probability that stop departure period is tour arrival period \u2013 3 -4 Probability that stop departure period is tour arrival period \u2013 4 -5 Probability that stop departure period is tour arrival period \u2013 5 -6 Probability that stop departure period is tour arrival period \u2013 6 -7 Probability that stop departure period is tour arrival period - 7"},{"location":"inputs.html#externalexternaltripsbyyearcsv","title":"<code>EXTERNALEXTERNALTRIPSByYEAR.CSV</code>","text":"Column Name Description originTAZ External origin TAZ destinationTAZ External destination TAZ Trips Number of trips between external TAZs"},{"location":"inputs.html#external-internal-control-totals","title":"External Internal Control Totals","text":""},{"location":"inputs.html#externalinternalcontroltotalsbyyearcsv","title":"<code>EXTERNALINTERNALCONTROLTOTALSByYEAR.CSV</code>","text":"Column Name Description Taz External TAZ station Work Number of work vehicle trips Nonwork Number of non-work vehicle trips"},{"location":"inputs.html#internal-external-tours-time-of-day-distribution","title":"Internal External Tours Time of Day Distribution","text":""},{"location":"inputs.html#internalexternal_tourtodcsv","title":"<code>INTERNALEXTERNAL_TOURTOD.CSV</code>","text":"Column Name Description Purpose              Tour Purpose:             0 = All Purposes          EntryPeriod              Entry Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          ReturnPeriod              Return Period:             1 = Before 5:00AM             2 = 5:00AM-5:30AM             3 through 39 is every half hour time slots             40 = After 12:00AM          Percent Distribution of tours by entry and return periods"},{"location":"inputs.html#parameters-by-scenario-years","title":"Parameters by Scenario Years","text":""},{"location":"inputs.html#parametersbyyearscsv","title":"<code>PARAMETERSBYYEARS.CSV</code>","text":"Column Name Description year Scenario build year aoc.fuel Auto operating fuel cost aoc.maintenance Auto operating maitenance cost airport.SAN.enplanements San Diego International Airport enplanements airport.SAN.connecting San Diego International Airport connecting passengers airport.SAN.airportMgra MGRA San Diego International Airport is located in airport.CBX.enplanements Cross Border Express Terminal (Tijuana International Airport) enplanements airport.CBX.connecting Cross Border Express Terminal (Tijuana International Airport) connecting passengers airport.CBX.airportMgra MGRA Cross Border Express Terminal is located in crossBorder.tours Number of cross border tours crossBorders.sentriShare Share of cross border tours that are SENTRI taxi.baseFare Initial taxi fare taxi.costPerMile Taxi cost per mile taxi.cosPerMinute Taxi cost per minute TNC.single.baseFare Initial TNC fare for single ride TNC.single.costPerMile TNC cost per mile for single ride TNC.single.costPerMinute TNC cost per minute for single ride TNC.single.costMinimum TNC minimum cost for single ride TNC.shared.baseFare Initial TNC fare for shared ride TNC.shared.costPerMile TNC cost per mile for shared ride TNC.shared.costPerMinute TNC cost per minute for shared ride TNC.shared.costMinimum TNC minimum cost for shared ride Mobility.AV.RemoteParkingCostPerHour Remote parking cost per hour for autonomous vehicles active.micromobility.variableCost Variable cost for micromobility active.micromobility.fixedCost Fixed cost for micromobility active.microtransit.fixedCost Fixed cost for microtransit Mobility.AV.Share The share of vehicles assumed to be autonomous vehicles in the vehicle fleet smartSignal.factor.LC smartSignal.factor.MA smartSignal.factor.PA atdm.factor"},{"location":"inputs.html#files-by-scenario-years","title":"Files by Scenario Years","text":""},{"location":"inputs.html#filesbyyearscsv","title":"<code>FILESBYYEARS.CSV</code>","text":"Column Name Description year Scenario build year crossborder.dc.soa.alts.file Crossborder model destination choice alternatives file crossBorder.dc.uec.file Crossborder model destination choice UEC file uwsl.dc.uec.file Tour destination choice UEC file nmdc.uec.file Non-mandatory tour destination choice UEC file crossBorder.tour.mc.uec.file Crossborder model tour mode choice UEC file visualizer.reference.path Path to reference scenario for SANDAG ABM visualizer"},{"location":"inputs.html#mgras-at-mobility-hubs","title":"MGRAs at Mobility Hubs","text":""},{"location":"inputs.html#mobilityhubmgracsv","title":"<code>MOBILITYHUBMGRA.CSV</code>","text":"Column Name Decription MGRA MGRA ID MoHubName Mobility Hub name MoHubType              Mobility Hub type:             Suburban             Coastal             Gateway             Major Employment Center             Urban          <p>Go To Top</p>"},{"location":"outputs.html","title":"Model Outputs","text":"<p>Model outputs are stored in the .\\outputs directory. The contents of the directory are listed in the table below.</p>"},{"location":"outputs.html#output-directory-output","title":"Output Directory (.\\output)","text":"Directory\\File Name Description airport.CBX (directory)     Outputs for Cross-Border Express Airport Ground Access Model     airport.SAN (directory)     Outputs for San Diego International Airport Ground Access Model     assignment (directory)     Assignment outputs     crossborder (directory)     Crossborder Travel Model outputs     cvm (directory)     Commercial Vehicle Model outputs     parking (directory)     Parking model outputs     resident (directory)     Resident model outputs     skims (directory)     Skim outputs     visitor (directory)     Visitor Model outputs     bikeMgraLogsum.csv     Bike logsum file for close-together MGRAs     bikeTazLogsum.csv     Bike logsum file for TAZs     datalake_metadata.yaml     Metadata file for datalake reporting system     derivedBikeEdges.csv     Derived bike network edge file     derivedBikeNodes.csv     Derived bike network node file     derivedBikeTraversals.csv     Derived bike network traversals file     microMgraEquivMinutes.csv     Equivalent minutes for using micromobility between close-together MGRAs (not used)     runtime_summary.csv     Summary of model runtime     temp_tazdata_cvm.csv     TAZ data for commercial vehicle model     transponderModelAccessibilities.csv     Transponder model accessibilities (not used)     trip_(period).omx     Trips for each time period, for assignment     walkMgraEquivMinutes.csv     Equivalent minutes for walking between close-together MGRAs"},{"location":"outputs.html#skims-skims","title":"Skims (.\\skims)","text":"<p>This directory contains auto, transit, and non-motorized level-of-service matrices, also known as skims. Each file is a collection of origin destination tables of times and costs, at the TAZ level.</p> File     Description     dest_pmsa.omx     A matrix containing pseudo - metropolitan statistical area code for each destination TAZ     dest_poi.omx     A matrix containing point of interest code for each destination TAZ (currently zeros)     dest_poi.omx.csv     A csv file containing point of interest code for each destination TAZ (currently zeros)     impm(truck type)(toll type)_(period)_(matrixtype).txt     Truck impedance matrix for truck type (ld = Light duty, lhd = light heavy duty, mhd = medium heavy duty, hhd = heavy heavy duty), toll type (n = non-toll, t = toll) and matrixtype (DU = utility, dist = distance, time = time)     maz_maz_bike.csv     Bike logsums between close together MGRAs     maz_maz_walk.csv     Walk times between close together MGRAs     maz_stop_walk.csv     Walk times between MGRAs and transit stops     taz_pmsa_xwalk.csv     Crosswalk file between pseudo-metropolitan statistical areas and TAZs     traffic_skims_(period).omx Auto skims by period (EA, AM, MD, PM, EV)     transit_skims_(period).omx Transit skims by period (EA, AM, MD, PM, EV)     <p></p>"},{"location":"outputs.html#auto-skims-by-period","title":"Auto skims by period","text":"<p><code>TRAFFIC_SKIMS_&lt;time period&gt;.OMX</code></p> Table Name     Description     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TIME     Travel time for evaluation of volume-delay functions     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_DIST     Travel distance     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_REL     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TOLLCOST     Total toll cost (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_TOLLDIST     Total distance on toll facilities (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_MLCOST     Total cost for managed lane facilities (only for TOLL traffic classes)     &lt;time_period&gt;_&lt;traffic_class&gt;&lt;_vot&gt;_HOVDIST     Distance on HOV facilities (only for HOV traffic classes)     *traffic class = SOV_TR, SOV_NT, HOV2, HOV3, TRK     vot = L (low), M (medium), and H (high)     <p></p>"},{"location":"outputs.html#transit-skims-by-period","title":"Transit skims by period","text":"<p><code>TRANSIT_SKIMS_&lt;time_period&gt;.OMX</code></p> Table Name     Description     &lt;time_period&gt;_&lt;transit_class&gt;_GENCOST     Total generalized cost which includes perception factors from assignment     &lt;time_period&gt;_&lt;transit_class&gt;_FIRSTWAIT     actual wait time at initial boarding point     &lt;time_period&gt;_&lt;transit_class&gt;_XFERWAIT     actual wait time at all transfer boarding points     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALWAIT     total actual wait time     &lt;time_period&gt;_&lt;transit_class&gt;_FARE     fare paid     &lt;time_period&gt;_&lt;transit_class&gt;_XFERS     number of transfers     &lt;time_period&gt;_&lt;transit_class&gt;_ACCWALK     access actual walk time prior to initial boarding     &lt;time_period&gt;_&lt;transit_class&gt;_EGRWALK     egress actual walk time after final alighting     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALWALK     total actual walk time     &lt;time_period&gt;_&lt;transit_class&gt;_TOTALIVTT     Total actual in-vehicle travel time     &lt;time_period&gt;_&lt;transit_class&gt;_DWELLTIME     Total dwell time at stops     &lt;time_period&gt;_&lt;transit_class&gt;_BUSIVTT     actual in-vehicle travel time on local bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_LRTIVTT     actual in-vehicle travel time on LRT mode     &lt;time_period&gt;_&lt;transit_class&gt; _CMRIVTT     actual in-vehicle travel time on commuter rail mode     &lt;time_period&gt;_&lt;transit_class&gt; _EXPIVTT     actual in-vehicle travel time on express bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_LTDEXPIVTT     actual in-vehicle travel time on premium bus mode     &lt;time_period&gt;_&lt;transit_class&gt;_BRTIVTT     actual in-vehicle travel time on  BRT mode     *time period = EA, AM, MD, PM, EV     transit_class = LOC, PRM, MIX"},{"location":"outputs.html#activitysim-log-files","title":"ActivitySim log files","text":"<p>ActivitySim writes out various log files when it runs; these have standard names for each model component. Therefore we list them separately, but copies of these files may be in each model\u2019s output directory depending upon the settings used to run ActivitySim for that model component.</p> File  Description activitysim.log     ActivitySim log file for model     breadcrumbs.yaml     Breadcrumbs provides a record of steps that have been run for use when resuming a model run     final_checkpoints.csv     ActivitySim checkpoint file      final_pipeline.h5     ActivitySim pipeline file     mem.csv     ActivitySim memory use log file     mem_mp_households.csv     Memory logs for ActivitySim model steps running with the same num_processes (all except accessibility, initialize, and summarize)     mem_mp_initialize.csv     Memory logs for ActivitySim model step initialize     mem_mp_summarize.csv     Memory logs for ActivitySim model step summarize     mp_households_(processnumber)-activitysim.log     ActivitySim log file for processnumber. This logfile is created if model is run in multiprocess mode     mp_households_(processnumber)-mem.csv     Memory log file for processnumber     mp_households_apportion-activitysim.log     ActivitySim log file for apportioning data between multiple processes     mp_households_coalesce-activitysim.log     ActivitySIm logfile for coalesing output from multiple processes into one     mp_initialize-activitysim.log     ActivitySim log file for the initialization steps     mp_initialize-mem.csv     Memory logs for ActivitySim model step summarize (similar to mp_initialize-mem.csv)     mp_setup_skims-activitysim.log     ActivitySim logfile for reading in skims     mp_summarize-activitysim.log     ActivitySim log file for summarizing model output (omx and csv trip table)     mp_summarize-mem.csv     Memory logs for ActivitySim model step summarize (similar to mem_mp_initialize.csv)     mp_tasks_log.txt     Log files of multiprocessed steps     omnibus_mem.csv     Memory log file of all model steps (similar to mem.csv)     run_list.txt     List of models that have been run     timing_log.csv     Model run time by steps"},{"location":"outputs.html#airport-model-outputs-airportcbx-airportsan","title":"Airport model outputs (.\\airport.CBX, .\\airport.SAN)","text":"<p>There are two subdirectories containing outputs for each of the two airport models. airport.CBX contains output for the Cross-Border Express model, and airport.SAN contains output for the San Diego International Airport model. Each directory has identical files so we provide one generic output table below.</p> Filename Description final_(airport)accessibility.csv     Accessibility file for airport (cbx, san) (not used, created by default)     [final_(airport)households.csv](#### Airport Model household file (final_(airport)households.csv))     Household file for airport (cbx, san)     final_(airport)land_use.csv     Land-use file for airport (cbx, san)     [final_(airport)persons.csv](#### Airport Model person file (final_(airport)persons.csv))     Persons file for airport (cbx, san)     [final_(airport)tours.csv](#### Airport Model tour file (final_(airport)tours.csv))     Tour file for airport (cbx, san)     [final_(airport)trips.csv](#### Airport Model trip file (final_(airport)trips.csv))     Trip file for airport (cbx, san)     model_metadata.yaml     Datalake metadata file     autoairporttrips.(airport)_(period).omx     Auto trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     tranairporttrips.(airport)_(period).omx     Transit trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     nmotairporttrips.(airport)_(period).omx     Non-motorized trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#airport-model-household-file-final_airporthouseholdscsv","title":"Airport Model household file (final_(airport)households.csv)","text":"Field     Description     home_zone_id     Airport MGRA     sample_rate     Sample rate     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#airport-model-person-file-final_airportpersonscsv","title":"Airport Model person file (final_(airport)persons.csv)","text":"Field     Description     household_id     Household ID     person_id     Person ID"},{"location":"outputs.html#airport-model-tour-file-final_airporttourscsv","title":"Airport Model tour file (final_(airport)tours.csv)","text":"Field     Description     tour_id     Tour ID     purpose_id     ID for tour type: <p> 1 = resident business <p> 2 = resident personal <p> 3= visitor business <p> 4 = visitor personal <p> 5 = external     party_size     Number of persons in airport travel party     nights     Number of nights away     income     Income group 0-7,  -99 if employee     direction     Direction of trip. String. outbound: airport to non-airport, inbound: non-airport to airport     household_id     Household ID     person_id     Person ID     tour_category     Tour category. String \"non_mandatory\"     tour_type     Type of tour. String. \"Emp\": Employee, \"ext\": External, \"res_busn\": Resident business where n is the ID for the income bracket (1&lt;25K, 2: between 25K &amp; 50K, 3: between 50K &amp; 75K, 4: between 75K &amp; 100K, 5: between 100K &amp; 125K, 6: between 125K &amp; 150K, 7: between 150K &amp; 200K, 8: 200k+ <p> , \"res_pern\": Resident personal where n is the ID for the income bracket as defined above, \"vis_bus\": Visitor business, \"vis_per\": Visitor personal       origin     Origin MGRA     destination     Destination MGRA     number_of_participants     Same as party_size     outbound     TRUE if outbound, else FALSE     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     destination_logsum     Logsum from destination choice model     stop_frequency     out_0in, 0out_in     primary_purpose     \"busn\", \"emp\", \"extn\", \"pern\""},{"location":"outputs.html#airport-model-trip-file-final_airporttripscsv","title":"Airport Model trip file (final_(airport)trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Primary purpose of trip: \"busn\": Business, where n is..., \"emp\": Employee, \"extn\": External, where n is..., \"pern\": Personal, where n is...     trip_num     1     outbound     TRUE if outbound, else FALSE     trip_count     1     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     mode_choice_logsum     Mode choice logsum for trip     vot     Value of time in dollars per hour ($2023)     arrival_mode     Arrival mode from airport trip mode choice model     cost_parking     Cost of parking ($2023)     cost_fare_drive     Ridehail/Taxi fare on a trip     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Ridehail/Taxi wait times for a trip     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     party     Party size     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Trip distance     add_driver     TRUE if trip requires a driver based on airport mode (for example, TNC, or pickup), else FALSE     weight_trip     1     weight_person_trip     weight_trip * tour_participants     cost_operating_drive     Auto operating cost ($2023)     inbound     TRUE if trip is from (origin) airport to (destination) non-airport zone, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     Sum of all costs a trip might incur (auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#arrival-mode-table-for-airport-models","title":"Arrival Mode Table for Airport Models","text":"Field     Description     Curb_LOCn     Pickup/Dropoff curbside (n=1,5, with 1 = terminal, and 2,5 = other locations)     TAXI_LOCn Taxi to airport (n =1,2 with 1= terminal mgra and 2=other)     RIDEHAIL_LOCn Ridehail to airport (n =1,2 with 1= terminal mgra and 2=other)     PARK_LOCn Parking lot (n=1,5, with 1 = terminal mgra and 2,5= other locations)     PARK_ESCORT     Parking escort     SHUTTLEVAN     Shuttle Vehicle     RENTAL     Rental car     HOTEL_COURTESY     Hotel transportation     WALK     Walk     WALK_LOC, WALK_PRM, WALK_MIX     Walk transit modes     KNR_LOC, KNR_PRM, KNR_MIX     KNR transit modes     TNC_LOC, TNC_PRM, TNC_MIX     TNC transit modes"},{"location":"outputs.html#assignment-model-trip-tables-assignment","title":"Assignment model trip tables (.\\assignment)","text":"<p>This directory contains trip tables from auto and transit assignments.</p>"},{"location":"outputs.html#demand-matrices","title":"Demand Matrices","text":"File  Description autoairportTrips.(airport)_(period_(vot).omx     Auto trip table for airport (CBX, SAN) by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autocrossborderTrips_(period)_(vot).omx     Auto trip table for cross border model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autoTrips_(period)_(vot).omx     Auto trip table for resident model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     autovisitorTrips_(period)_(vot).omx     Auto trip table for visitor model by period (EA, AM, MD, PM, EV) and value of time (low, medium, high)     emptyAVTrips.omx     Empty private autonomous vehicle trips      householdAVTrips.csv     All private autonomous vehicle trips     TNCTrips.csv     All TNC trips     TNCVehicleTrips_(period).omx     TNC vehicle trip table by period (EA, AM, MD, PM, EV)     TranairportTrips.(airport)_(period).omx     Transit trip tables for airport (CBX, SAN) by period (EA, AM, MD, PM, EV)     TrancrossborderTrips_(period).omx     Transit trip tables for cross-border model by period (EA, AM, MD, PM, EV)     TranTrips_(period).omx     Transit trip tables for resident model by period (EA, AM, MD, PM, EV)     TranvisitorTrips_(period).omx     Transit trip tables for visitor model by period (EA, AM, MD, PM, EV)     TripMatrices.csv     Disaggregate commercial vehicle trips"},{"location":"outputs.html#airport-model-auto-demand-matrices","title":"Airport Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#airport-model-transit-demand-matrices","title":"Airport Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#airport-model-non-motorized-demand-matrices","title":"Airport Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-auto-demand-matrices","title":"Crossborder Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-transit-demand-matrices","title":"Crossborder Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#crossborder-model-non-motorized-demand-matrices","title":"Crossborder Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-auto-demand-matrices","title":"Visitor Model auto demand matrices","text":"Table Name     Description     SR2_&lt;&gt;     Shared Ride 2 for &lt;&gt;     SR3_&lt;&gt;     Shared Ride 3 for &lt;&gt;     SOV_&lt;&gt;     Drive Alone for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-transit-demand-matrices","title":"Visitor Model transit demand matrices","text":"Table Name     Description     WLK_SET_set1_&lt;&gt;     PNR_SET_set1_&lt;&gt;     KNR_SET_set1_&lt;&gt;     TNC_SET_set1_&lt;&gt;     WLK_SET_set2_&lt;&gt;     PNR_SET_set2_&lt;&gt;     KNR_SET_set2_&lt;&gt;     TNC_SET_set2_&lt;&gt;     WLK_SET_set3_&lt;&gt;     PNR_SET_set3_&lt;&gt;     KNR_SET_set3_&lt;&gt;     TNC_SET_set3_&lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#visitor-model-non-motorized-demand-matrices","title":"Visitor Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;     where TIME PERIOD = EA, AM, MD, PM, EV"},{"location":"outputs.html#tnc-vehicle-trip-demand-table","title":"TNC Vehicle trip demand table","text":"Column Name     Description     trip_ID     Trip ID     vehicle_ID     Vehicle ID     originTaz     Origin TAZ     destinationTaz     Destination TAZ     originMgra     Origin MGRA     destinationMgra     Destination MGRA     totalPassengers     Number of passengers in the vehicle     startPeriod     Trip starting period     endPeriod     Trip ending period     pickupIdsAtOrigin     Trip id of the pick-up at origin.     CR-RAMP:     \u2003\u2003Individual trips:     \u2003\u2003\"I_\" + personId + \"_\" + purpAbb + \"_\" + tourid + \"_\" + inbound + \"_\" + stopid     \u2003\u2003\u2003where purpAbb is the first 3 letters of the tour_purp field     \u2003\u2003Joint trips:     \u2003\u2003\"J_\" + hhid + \"_\" + purpAbb + \"_\" + tourid + \"_\" + inbound + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Visitor trips:     \u2003\u2003partySize == 1: \"V_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"V_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Cross-border trips:     \u2003\u2003partySize == 1: \"M_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"M_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     CBX airport trips:     \u2003\u2003partySize == 1: \"CBX_\" + tourid + \"_\" + stopid     \u2003\u2003partySize&gt;1: \"CBX_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     SAN airport trips:     \u2003\u2003partySize == 1: \"SAN_\" + tourid + \"_\" + stopid     \u2003\u2003partySize &gt; 1: \"SAN_\" + tourid + \"_\" + stopid + \u201d_\u201d + i     \u2003\u2003\u2003where i is a number ranging from 1 to the total number of participants.     Internal-External trips:     \u2003\u2003\"IE_\" + tourid + \"_\" + inbound     dropoffIdsAtOrigin     Trip id of the drop-off at origin. See pickupIdsAtOrigin for trip id of the trip.     pickupIdsAtDestination     Trip id of the pick-up at destination. See pickupIdsAtOrigin for trip id of the trip.     dropoffIdsAtDestination     Trip id of the drop-off at destination. See pickupIdsAtOrigin for trip id of the trip.     originPurpose     Trip origin purpose     destinationPurpose     Trip destination purpose"},{"location":"outputs.html#household-autonomous-vehicle-trip-data","title":"Household autonomous vehicle trip data","text":"Column Name     Description     hh_id     Household id     veh_id     Vehicle id     vehicleTrip_id     Vehicle trip id     orig_mgra     Trip origin MGRA     dest_gra     Trip destination MGRA     period     Period:     1 = Before 5:00AM     2 = 5:00AM-5:30AM     3 through 39 is every half hour time slots     40 = After 12:00AM     occupants     Number of occupants in the vehicle     originIsHome     Is origin home     0 = No     1 = Yes     destinationIsHome     Is destination home     0 = No     1 = Yes     originIsRemoteParking     Is origin remote parking     0 = No     1 = Yes     destinationIsRemoteParking     Is destination remote parking     0 = No     1 = Yes     parkingChoiceAtDestination     Parking choice at destination:     0 = Not constrained to remote parking     1 = Park at destination     2 = Remote parking     3 = Park at home     person_id     Person id     person_num     Person number     tour_id     Tour id     stop_id     Stop id     inbound     Is trip inbound     1 = Yes     0 = No     tour_purpose     Tour purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     orig_purpose     Origin trip purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     Work related     dest_purpose     Destination trip purpose:     Discretionary     Eating Out     Escort     Home     Maintenance     School     Shop     University     Visiting     Work     Work-Based     Work related     trip_orig_mgra     Trip origin MGRA     trip_dest_mgra     Trip destination MGRA     stop_period     Stop period:     1 = Before 5:00AM     2 = 5:00AM-5:30AM     3 through 39 is every half hour time slots     40 = After 12:00AM     periodsUntilNextTrip     trip_mode     Trip mode:     0 = Empty vehicle trip     1 = Drive Alone     2 = Shared Ride 2     3 = Shared Ride 3"},{"location":"outputs.html#tnc-vehicle-trip-matrix","title":"TNC vehicle trip matrix","text":"Table Name     Description     TNC_&lt;&gt;_0     TNC trips for &lt;&gt; with 0 passenger     TNC_&lt;&gt;_1     TNC trips for &lt;&gt; with 1 passenger     TNC_&lt;&gt;_2     TNC trips for &lt;&gt; with 2 passengers     TNC_&lt;&gt;_3     TNC trips for &lt;&gt; with 3 or more passengers"},{"location":"outputs.html#empty-autonomous-vehicle-trips-data","title":"Empty Autonomous vehicle trips data","text":"Table Name     Description     EmptyAV_EA     Empty AV trips for EA period     EmptyAV_AM     Empty AV trips for AM period     EmptyAV_MD     Empty AV trips for MD period     EmptyAV_PM     Empty AV trips for PM period     EmptyAV_EV     Empty AV trips for EV period"},{"location":"outputs.html#crossborder-model-outputs-crossborder","title":"Crossborder model outputs (.\\crossborder)","text":"<p>This directory contains outputs from the Crossborder model, which represents all travel made by Mexico residents in San Diego County.</p> File      Description     final_accessibility.csv     Accessibility file for Crossborder Model (not used, created by default)     [final_households.csv](#### Crossborder Model household file (final_households.csv))     Household file for Crossborder Model      final_land_use.csv     Land-use file for Crossborder Model      [final_persons.csv](#### Crossborder Model person file (final_persons.csv))     Persons file for Crossborder Model      [final_tours.csv](#### Crossborder Model tour file (final_tours.csv))     Tour file for Crossborder Model      [final_trips.csv](#### Crossborder Model trip file (final_trips.csv))     Tour file for Crossborder Model      model_metadata.yaml     Model run meta data for use in Datalake storage and reporting     nmCrossborderTrips_AM.omx     Non-motorized trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     autoCrossborderTrips_AM.omx     Auto trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     tranCrossborderTrips_AM.omx     Transit trip table for Crossborder Model by period (EA, AM, MD, PM, EV)     othrCrossborderTrips_AM.omx     Other trip table for Crossborder Model by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#crossborder-model-household-file-final_householdscsv","title":"Crossborder Model household file (final_households.csv)","text":"Field     Description     sample_rate     Sample Rate     num_persons     Number of persons in travel party     origin     Origin MGRA (Border crossing station)     home_zone_id     Home MGRA (Border crossing station)     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#crossborder-model-person-file-final_personscsv","title":"Crossborder Model person file (final_persons.csv)","text":"Field     Description     household_id     Household ID     work_time_factor     Travel time sensitivity factor for work tours     non_work_time_factor     Travel time sensitivity factor for non-work tours (Sampled in person preprocessor)     origin     Origin MGRA (Border crossing station)     home_zone_id     Home MGRA (Border crossing station)     person_id     Person ID"},{"location":"outputs.html#crossborder-model-tour-file-final_tourscsv","title":"Crossborder Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     pass_type     Type of border crossing pass. String. \"no_pass\": Does not own a pass, \"sentri\": SENTRI pass, or \"ready\": READY pass     tour_type     Tour purpose. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     purpose_id     Tour purpose ID. 0: work, 1: school, 2: shop, 3: visit, 4: other     tour_category     Tour category. String. Mandatory: Work or school, Non-Mandatory: Shop, visit, other     number_of_participants     Number of participants in tour     household_id     Household ID     person_id     Person ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     origin     Tour origin (Border Crossing) MGRA     destination     Tour primary destination MGRA     tour_od_logsum     Tour origin-crossing-destination logsum     poe_id     Number of border crossing station     tour_mode     Tour mode     mode_choice_logsum     Tour mode choice logsum     stop_frequency     Number of stops on tour by direction. String. xout_yin where x is number of stops in the outbound direction and y is the number of stops in the inbound direction     primary_purpose     will drop"},{"location":"outputs.html#crossborder-model-trip-file-final_tripscsv","title":"Crossborder Model trip file (final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Purpose at primary destination. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     trip_num     Sequential number of trip on half-tour from 1 to 4     outbound     TRUE if outbound, else FALSE     trip_count     number of trips per tour. Will drop     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     purpose     Purpose at trip destination. String. \"other\", \"school\", \"shop\", \"visit\", or \"work\"     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     trip_mode_choice_logsum     Mode choice logsum for trip     parking_cost     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     tnc_single_wait_time     Wait time for single pay TNC     tnc_shared_wait_time     Wait time for shared\\pooled TNC     taxi_wait_time     Wait time for taxi     cost_parking     Cost of parking ($2023)     cost_fare_drive     Taxi/TNC fare (including Taxi/TNC cost of transit access/egress) ($2023)     distance_walk     Distance walked in miles (including access/egress walk distances of a transit mode)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Wait times for Taxi/TNC/NEV modes     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Total distance traveled on a trip     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weight defined as the ratio of the number of participants on a trip to sample rate of the model run     inbound     TRUE if trip is in outbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     Sum of all costs a trip might incur (auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     True if Neighborhood Electric Vehicle is available at origin     nev_dest     True if Neighborhood Electric Vehicle is available at destination     nev_available     TRUE if Neighborhood Electric Vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#crossborder-model-tour-mode-definitions","title":"Crossborder Model Tour Mode Definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk"},{"location":"outputs.html#commercial-vehicle-model-cvm","title":"Commercial Vehicle Model (.\\cvm)","text":"<p>//TODO</p> <p>Update with CVM results once model is updated</p>"},{"location":"outputs.html#parking-cost-calculations-parking","title":"Parking cost calculations (.\\parking)","text":"<p>This directory contains intermediate files and final expected parking costs calculated from input parking supply data and walk distances between MGRAs.</p> File      Description     aggregated_street_data.csv     Street length and intersections aggregated to MGRA level, used to estimate free on-street parking spaces     cache (directory)     Directory containing intermediate calculations for expected parking costs     distances.csv     MGRA-MGRA distances used for expected parking cost calculations     districts.csv     Calculated parking districts at MGRA level used for expected parking cost calculations     final_parking_data.csv     Expected hourly, daily, and monthly parking costs, total spaces, and parking district at the MGRA level for use in travel models     plots     Directory containing plots of the parking model results     shapefiles     Directory containing shapefiles for parking model calculations"},{"location":"outputs.html#resident-model-outputs-resident","title":"Resident model outputs (.\\resident)","text":"<p>This directory contains San Diego resident travel model outputs.</p> File      Description     cdap_joint_spec_(persons).csv     Model specification file for coordinated daily activity pattern model joint tour alternative for (persons)-way interaction terms     cdap_spec_(persons).csv     Model specification file for coordinated daily activity pattern model for (persons)-way interaction terms.     data_dict.csv     Data dictionary for resident model, csv format     data_dict.txt     Data dictionary for resident model, text format     final_accessibility.csv     Resident model aggregate accessibility file      final_disaggregate_accessibility.csv     Resident model disaggregate accessibility file at MGRA level     [final_households.csv](#### Resident Model household file (final_households.csv))     Resident model household file     [final_joint_tour_participants.csv](#### Resident Model joint tour participants file (final_joint_tour_participants.csv))     Resident model joint tour participants file     final_land_use.csv     Resident model land-use file     [final_persons.csv](#### Resident Model vehicle file (final_vehicles.csv))     Resident model persons file     final_proto_disaggregate_accessibility.csv     Resident model disaggregate accessibility file at person level     [final_tours.csv](#### Resident Model tour file (final_tours.csv))     Resident model tour file     [final_trips.csv](#### Resident Model trips file (final_trips.csv))     Resident model trip file     [final_vehicles.csv](#### Resident Model vehicle table (final_vehicles.csv))     Resident model vehicle file     log (directory)     Directory for resident model logging output     model_metadata.yaml     Resident model Datalake metadata file     autoTrips_[tod]_[vot].omx     Residential Auto Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV) and three value of time bins (vot = low, med, high)     tranTrips_[tod].omx     Residential Transit Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV)     nmotTrips_[tod].omx     Residential Non-motorized Trip Matrix for 5 time periods (tod = EA, AM, MD, PM, EV)     skim_usage.txt     Skim usage file     trace (directory)     Directory for resident model trace output"},{"location":"outputs.html#resident-model-household-file-final_householdscsv","title":"Resident Model household file (final_households.csv)","text":"Field     Description     home_zone_id     Household MGRA - same as mgra     income     Household income in dollars ($2023)     hhsize     Number of persons in household     HHT     Household dwelling unit type. 0: N/A (GQ/vacant), 1: Married couple household, 2: Other family household: Male householder no spouse present, 3: Other family household: Female householder no spouse present, 4: Nonfamily household: Male householder living alone, 5: Nonfamily household: Male householder: Not living alone, 6: Nonfamily household: Female householder: Living alone, 7: Nonfamily household: Female householder: Not living alone     auto_ownership     (Model output) Auto ownership     num_workers     Number of workers in household     building_category     Units in structure. 0: N/A (GQ), 1: Mobile home or trailer, 2: One-family house detached, 3: One-family house attached, 4: 2 Apartments, 5: 3-4 Apartments, 6: 5-9 Apartments, 7: 10-19 Apartments, 8: 20-49 Apartments, 9: 50 or more apartments, 10: Boat, RV, van, etc.     unittype     Household unit type. 0: Non-GQ Household, 1: GQ Household (used in Visualizer)     sample_rate     Sample rate for household       income_in_thousands     Household income in thousands of dollars ($2023)     income_segment     Household income segment (1-4)     num_non_workers     Number of non-workers in household     num_drivers     Number of persons age 16+     num_adults     Number of persons age 18+     ebike_owner     TRUE if household owns an e-bike, else FALSE (output from e-bike owership simulation)     av_ownership     TRUE if household owns an autonomous vehicle, else FALSE (output from AV Ownership Model)     workplace_location_accessibility     Work location choice logsum (output from Disaggregate Accessibility Model)     shopping_accessibility     Shopping primary destination choice logsum (output from Disaggregate Accessibility Model)     othdiscr_accessibility     Other Discretionary primary destination choice logsum (output from Disaggregate Accessibility Model)     numAVowned     Number of autonomous vehicles owned by household (output from Vehicle Type Choice Model)     transponder_ownership     TRUE if household owns a transponder, else FALSE (output from Transponder Ownership Model)     has_joint_tour     1 if household has at least one fully joint tour, else false (output from Coordinated Daily Activity Pattern Model)     num_under16_not_at_school     Number of persons age less than 16 who do not attend school (output from Coordinated Daily Activity Pattern Model)     num_travel_active     Number of persons in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_adults     Number of adults in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_preschoolers     Number of preschool children in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_children     Number of children in household who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     num_travel_active_non_preschoolers     Number of non-preschoolers household in who have an active (type M or N) travel pattern (output from Coordinated Daily Activity Pattern Model)     participates_in_jtf_model     TRUE if household has a joint tour frequency model, else FALSE (output from Coordinated Daily Activity Pattern Model)     school_escorting_outbound     Alternative number for school escort model in the outbound direction (initial output from School Escort Model)     school_escorting_inbound     Alternative number for school escort model in the inbound direction (output from School Escort Model)     school_escorting_outbound_cond     Alternative number for school escort model in the outbound direction (final output from School Escort Model)     auPkRetail     Auto peak access to retail employment from household TAZ (aggregate accessibility output)     auPkTotal     Auto peak access to total employment from household TAZ (aggregate accessibility output)     auOpRetail     Auto offpeak access to retail employment from household TAZ (aggregate accessibility output)     auOpTotal     Auto offpeak access to total employment from household TAZ (aggregate accessibility output)     trPkRetail     Transit peak access to retail employment from household TAZ (aggregate accessibility output)     trPkTotal     Transit peak access to total employment from household TAZ (aggregate accessibility output)     trPkHH     Transit peak access to total employment from household (aggregate accessibility output)     trOpRetail     Transit offpeak access to retail employment from household TAZ (aggregate accessibility output)     trOpTotal     Transit offpeak access to total employment from household TAZ (aggregate accessibility output)     nmRetail     Walk access to retail employment from household TAZ (aggregate accessibility output)     nmTotal     Walk access to total employment from household TAZ (aggregate accessibility output)     microtransit     Microtransit access time in household MGRA     nev     Neighborhood electric vehicle access time in household MGRA     mgra     Household MGRA - same as home_zone_id     TAZ     Household TAZ     micro_dist_local_bus     Distance to closest local bus stop from household MGRA by microtransit, if available. 999999 if not available.     micro_dist_premium_transit     Distance to closest premium transit stop from household MGRA by microtransit, if available. 999999 if not available.     joint_tour_frequency_composition     Joint tour frequency and composition model choice (output from Joint Tour Frequency\\Composition Model)     num_hh_joint_tours     Number of fully joint tours at the household level (0, 1 or 2) (output from Coordinated Daily Activity Pattern Model and Joint Tour Frequency\\Composition Models)     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty.     <p>Resident Model person file (final_persons.csv)</p> Field     Description     household_id     Household ID     age     Person age in years     PNUM     Person number in household (1\u2026n where n is number of persons in household)     sex     1: Male, 2: Female     pemploy     Employment status of person. 1: Employed Full-Time, 2: Employed Part-Time, 3: Unemployed or Not in Labor Force, 4: Less than 16 Years Old     pstudent     Student status of person. 1: Pre K-12, 2: College Undergrad+Grad and Prof. School, 3: Not Attending School     ptype     Person type  1: Full-time worker 2: Part-time worker 3: College\\University Student 4: Non-Working Adult 5: Retired 6: Driving-age student 7: Non-driving age student 8: Pre-school\\Age &lt;=5      educ     Educational attainment. 1: No schooling completed, 9: High school graduate, 13: Bacehlor's degree     soc2     Two-digit Standard Occupational Classification (SOC) codes (https://www.bls.gov/oes/current/oes_stru.htm)     is_student     Person is a K12 or college student     school_segment     School location choice model's segment a student belongs to (preschool, grade school, high school, university)     is_worker     Person is a full-time or part-time worker     is_internal_worker     TRUE if worker works internal to region, else FALSE (output from Internal-External Worker Identification Model)     is_external_worker     TRUE if worker works external to region, else FALSE (output from Internal-External Worker Identification Model)     home_zone_id     Household MGRA     time_factor_work     Travel time sensitivity factor for work tours     time_factor_nonwork     Travel time sensitivity factor for non-work tours (Sampled in person preprocessor)     naics_code     Two-digit NAICS code (https://www.census.gov/naics/)     occupation     Occupation String     work_from_home     TRUE if worker and works from home, else FALSE (output from Work From Home Model)     is_out_of_home_worker     TRUE if worker has a usual out of home work location, else FALSE (output from Work From Home Model)     external_workplace_zone_id     MGRA number of external workplace if external worker, else -1 (output from External Workplace Location Choice Model)     external_workplace_location_logsum     Location choice logsum for external workplace location choice model (output from External Workplace Location Choice Model)     external_workplace_modechoice_logsum     Mode choice logsum for mode choice from external workplace location choice model (output from External Workplace Location Choice Model)     school_zone_id     MGRA number of school location, else -9  (output from School Location Choice Model)     school_location_logsum     Location choice logsum for school location choice model, else -9 (output from School Location Choice Model)     school_modechoice_logsum     Mode choice logsum for mode choice from school location choice model, else -9 (output from School Location Choice Model)     distance_to_school     Distance to school if student, else -9  (output from School Location Choice Model)     roundtrip_auto_time_to_school     Round trip offpeak auto time to school, else -9  (output from School Location Choice Model)     workplace_zone_id     MGRA number of internal work location, else -9  (output from Internal Work Location Choice Model)     workplace_location_logsum     Location choice logsum for work location choice model, else -9 (output from Internal Work Location Choice Model)     workplace_modechoice_logsum     Mode choice logsum for mode choice from work location choice model, else -9 (output from Internal Work Location Choice Model)     distance_to_work     Distance to work if internal worker with work location, else -9  (output from Internal Work Location Choice Model)     work_zone_area_type     Area type of work zone for worker if internal worker with work location, else -9 (output from Internal Work Location Choice Model)     auto_time_home_to_work     Peak auto time from home to work if internal worker with work location, else -9  (output from Internal Work Location Choice Model)     roundtrip_auto_time_to_work     Round trip auto travel time to and from work     work_auto_savings     Travel time savings as a result of  using auto vs. walk-transit mode     exp_daily_work     Expected daily cost of parking at work if internal worker with work location, else -9 (output from Internal Work Location Choice Model)     non_toll_time_work     Time from home to work for path without I-15, if worker with internal workplace, else -9     toll_time_work     Time from home to work for path with I-15, if worker with internal workplace, else -9     toll_dist_work     Travel distance for work using a tolled route      toll_cost_work     Toll cost for going to work     toll_travel_time_savings_work     Work travel time savings for using tolled vs. non-tolled routes     transit_pass_subsidy     1 if person has subsidized transit from their employer or school, else 0 (Output from Transit Subsidy Model)     transit_pass_ownership     1 if person owns a transit pass, else 0 (Output from Transit Pass Ownership Model)     free_parking_at_work     TRUE if person has free parking at work, else FALSE (Output from Free Parking Model)     telecommute_frequency     Telecommute frequency if worker who does not work from hom, else null (Output from Telecommute Frequency Model) String \"No_Telecommute\", \"1_day_week\", \"2_3_days_week\", \"4_days_week\"     cdap_activity     Coordinated daily activity pattern type (Output from Coordinated Daily Activity Pattern Model) String \"M\": Mandatory pattern, \"N\": Non-mandatory pattern, \"H\": Home or out of region pattern     travel_active     TRUE if activity pattern is \"M\" or \"N\", else FALSE  (Output from Coordinated Daily Activity Pattern Model)     num_joint_tours     Total number of fully joint tours (Output from Fully Joint Tour Participation Model)     non_mandatory_tour_frequency     Non-Mandatory Tour Frequency Model Choice (Output from Non-Mandatory Tour Frequency Chopice Model)     num_non_mand     Total number of non-mandatory tours (Output from School Escort Model, Non-Mandatory Tour Frequency Model, and At-Work Subtour Model)     num_escort_tours     Total number of escorting tours (Output from School Escort Model and Non-Mandatory Tour Frequency Model)     num_eatout_tours     Total number of eating out tours (Output from Non-Mandatory Tour Frequency Model)     num_shop_tours     Total number of shopping tours (Output from Non-Mandatory Tour Frequency Model)     num_maint_tours     Total number of other maintenance tours (Output from Non-Mandatory Tour Frequency Model)     num_discr_tours     Total number of discretionary tours (Output from Non-Mandatory Tour Frequency Model)     num_social_tours     Total number of social\\visiting tours (Output from Non-Mandatory Tour Frequency Model)     num_add_shop_maint_tours     Total number of additional shopping and maintenance tours (Output from Non-Mandatory Tour Frequency Extension Model)     num_add_soc_discr_tours     Total number of additional social\\visiting and other discretionary tours (Output from Non-Mandatory Tour Frequency Extension Model)     person_id     Person ID     miltary     1 if serves in the military, else 0     grade     School grade of person: 0 = N/A (not attending school), 2 = K to grade 8, 5 = Grade 9 to grade 12, 6 = College undergraduate     weeks     Weeks worked during past 12 months 0: N/A (less than 16 years old/did not work during the past 12 .months) 1: 50 to 52 weeks worked during past 12 months 2: 48 to 49 weeks worked during past 12 months 3: 40 to 47 weeks worked during past 12 months 4: 27 to 39 weeks worked during past 12 month 5: 14 to 26 weeks worked during past 12 months 6: 13 weeks or less worked during past 12 months     hours     Usual hours worked per week past 12 months <p> 0: .N/A (less than 16 years old/did not work during the past .12 months), 1..98 .1 to 98 usual hours, 99 .99 or more usual hours     race     Recoded detailed race code 1: .White alone, 2: Black or African American alone, 3: American Indian alone, 4: Alaska Native alone, 5: American Indian and Alaska Native tribes specified; or .American Indian or Alaska Native, not specified and no other races, 6: Asian alone, 7: Native Hawaiian and Other Pacific Islander alone, 8: Some Other Race alone, 9: Two or More Races     hispanic     Hispanic flag: 1: Non-Hispanic, 2: Hispanic     <p>Resident Model vehicle file (final_vehicles.csv)</p> Field     Description     vehicle_id     Vehicle ID     household_id     Household ID     vehicle_num     Vehicle number in household from 1\u2026n where n is total vehicles owned by household     vehicle_type     String bodytype_age_fueltype     auto_operating_cost     Auto operating cost for vehicle ($2023 cents/mile)     Range     Range if electric vehicle, else 0     MPG     Miles per gallen for vehicle     vehicle_year     Year of vehicle      vehicle_category     String, Body type (Car, Motorcycle, Pickup, SUV, Van. Autonomous vehicles have _AV extension on body type)     num_occupants     Number of occupants in the vehicle     fuel_type     String. BEV: Battery electric vehicle, Diesel, Gas, Hybrid: Gas\\Electric non plug-in vehicle, PEV: Plug-in hybrid electric vehicle"},{"location":"outputs.html#resident-model-joint-tour-participants-file-final_joint_tour_participantscsv","title":"Resident Model joint tour participants file (final_joint_tour_participants.csv)","text":"Field     Description     participant_id     Participant ID     tour_id     Tour ID     household_id     Household ID     person_id     Person ID     participant_num     Sequent number of participant 1\u2026n where n is total number of participants in joint tour"},{"location":"outputs.html#resident-model-tour-file-final_tourscsv","title":"Resident Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     person_id     Person ID     tour_type     Purpose string of the primary activity on the tour: For home-based tours, the purposes are: \u201cwork\u201d, \u201cschool\u201d, \u201cescort\u201d, \u201cshopping\u201d, \u201cothmaint\u201d, \u201ceatout\u201d, \u201csocial\u201d, and \u201cothdiscr\u201d. For work-based subtours, the purposes are \u201cbusiness\u201d, \u201ceat\u201d, and \u201cmaint\u201d.     tour_type_count     The total number of tours within the tour_type     tour_type_num     The sequential number of the tour within the tour_category. In other words if a person has 3 tours; 1 work tour and 2 non-mandatory tours, the tour_type_num would be 1 for the work tour, 1 for the first non-mandatory tour and 2 for the second non-mandatory tour.     tour_num     Sequential tour ID number for a person     tour_count     Total number of tours per person     tour_category     The category string of the primary activity on the tour. \u201cmandatory\u201d, \u201cjoint\u201d, \u201cnon_mandatory\u201d, \u201catwork\u201d     number_of_participants     Number of participants on the tour for fully joint tours, else 1     destination     MGRA number of primary destination     origin     MGRA number of tour origin     household_id     Household ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     school_esc_outbound     For school tours where the child is being escorted according to the school pickup/dropoff model, this string field indicates the type of escorting in the outbound direction: \u201cpure_escort\u201d or \u201crideshare\u201d     school_esc_inbound     For school tours where the child is being escorted according to the school pickup/dropoff model, this string field indicates the type of escorting in the inbound direction: \u201cpure_escort\u201d or \u201crideshare\u201d     num_escortees     Number of children being escorted on this tour (max of outbound and inbound direction)     tdd     Tour departure and duration. Index of the tour departure and durarion alterntive configs     composition     Composition of tour if joint \u201cadults\u201d, \u201cchildren\u201d     is_external_tour     TRUE if primary destination activity is external to region, else FALSE     is_internal_tour     Whether tour is internal     destination_logsum     Logsum from tour destination choice model     vehicle_occup_1     Tour vehicle with occupancy of 1     vehicle_occup_2     Tour vehicle with occupancy of 2     vehicle_occup_3_5     Tour vehicle with occupancy of 3+     tour_mode     Tour mode string      mode_choice_logsum     Logsum from tour mode choice model     selected_vehicle     Selected vehicle from vehicle type choice model; a string field consisting of [Body type][age][fuel type] and an optional extension \u201c_AV\u201d if the vehicle is an autonomous vehicle     atwork_subtour_frequency     At-work subtour frequency choice model result; a string field with the following values: \u201cno_subtours\u201d, \u201cbusiness1\u201d, \u201cbusiness2\u201d, \u201ceat\u201d, \u201ceat_business\u201d, \u201cmaint\u201d, or blank for non-work tours.     parent_tour_id     Parent tour ID if this is a work-based subtour, else 0     stop_frequency     Stop frequency choice model result; a string value of the form [0\u2026n]out_[0\u2026n]in where the first number is the number of outbound stops and the second number is the number of inbound stops     primary_purpose     Recoding of tour_type where all atwork subtours are identified as \u201catwork\u201d regardless of destination purpose"},{"location":"outputs.html#resident-model-trip-file-final_tripscsv","title":"Resident Model trip file (final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Primary purpose of tour (see tour table)     trip_num     Sequential number of trip by direction (1\u2026n where n is maximum trips on half-tour, e.g. max stops + 1)     outbound     TRUE if trip is in the outbound direction, else FALSE     destination     MGRA of trip destination     origin     MGRA of trip origin     tour_id     Tour ID     escort_participants     Space delimited string field listing person IDs of other children escorted on this trip, else null     school_escort_direction     String field indicating whether child is being dropped off at school (\u201coutbound\u201d) or picked up from school (\u201cinbound\u201d). \u201cnull\u201d if not a child being picked up or dropped off.     purpose     Purpose at destination     destination_logsum     Logsum from trip destination choice model. -9 if destination is tour origin or primary destination.     depart     Departure time period (1\u202648)     trip_mode     Trip mode string     mode_choice_logsum     Logsum from trip mode choice model     vot     Value of time for trip in dollars per hour ($2023)     owns_transponder     True if household owns transponder. Same as ownTrp      totalWaitSingleTNC     Wait time for single pay TNC     totalWaitSharedTNC     Wait time for shared\\pooled TNC     s2_time_skims     HOV2 travel time      s2_dist_skims     HOV3 travel distance     s2_cost_skims     HOV2 travel toll cost     cost_parking     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     cost_fare_drive     Taxi/TNC fare for any trip or trip portion taken on these modes     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Waiting time for a TNC/ Taxi modes     parking_zone     MGRA from parking location choice model at destination, else -1     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of joint tour participants if joint tour, else 1     distance_total     Trip distance in miles     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weigth defined as the ratio of the number of particpants on a trip to sample rate of the model run     inbound     TRUE if trip is in the inbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare before subsidy ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     total cost of a trip (sum of auto operating, toll, transit fare)     time_total     Total time (sum of drive, bike, walk, initial transit wait, transit time, transit transfer))     time_transit_wait     Total transit wait time (initial, transfer, NEV wait, waiting for school bus)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     Availability of Neighborhood Electric vehicle at origin     nev_dest     Availability of Neighborhood Electric vehicle at destination     nev_available     TRUE if neighborhood electric vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     trip_veh_body     Body type of vehicle used for trip, else \u201cnull\u201d     trip_veh_age     Age of vehicle used for trip, else \u201cnull\u201d     trip_veh_fueltype     Fuel type of vehicle used for trip, else \u201cnull\u201d     origin_purpose     Purpose at origin     sample_rate     Sample rate     origin_parking_zone     MGRA from parking location choice model at trip origin, else -1     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#resident-model-tour-mode-definitions","title":"Resident Model tour mode definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     PNR_LOC     Local transit with Park&amp;ride access or egress mode     PNR_PRM     Premium transit with Park&amp;ride access or egress mode     PNR_MIX     Mix (local with premium transfers) transit with Park&amp;ride access or egress mode     KNR_LOC     Local transit with Kiss&amp;ride access or egress mode     KNR_PRM     Premium transit with Kiss&amp;ride access or egress mode     KNR_MIX     Mix (local with premium transfers) transit with Kiss&amp;ride access or egress mode     TNC_LOC     Local transit with TNC access or egress mode     TNC_PRM     Premium transit with TNC access or egress mode     TNC_MIX     Mix (local with premium transfers) transit with TNC access or egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride     SCH_BUS     School bus     EBIKE     E-bike     ESCOOTER     E-scooter"},{"location":"outputs.html#resident-model-auto-demand-matrices","title":"Resident Model auto demand matrices","text":"Table Name     Description     SOVNOTRPDR_&lt;&gt;     Drive Alone Non-Transponder for &lt;&gt;     SOVTRPDR_&lt;&gt;     Drive Alone Transponder for &lt;&gt;     SR2NOTRPDR_&lt;&gt;     Shared Ride 2 Non-Transponder for &lt;&gt;     SR2TRPDR_&lt;&gt;     Shared Ride 2 Transponder for &lt;&gt;     SR3NOTRPDR_&lt;&gt;     Shared Ride 3 Non-Transponder for &lt;&gt;     SR3TRPDR_&lt;&gt;     Shared Ride 3 Transponder for &lt;&gt;"},{"location":"outputs.html#resident-model-transit-demand-matrices","title":"Resident Model transit demand matrices","text":"Table Name     Description     &lt;transit_class&gt;_GENCOST__&lt;&gt;     Total generalized cost which includes perception factors from assignment     &lt;transit_class&gt;_FIRSTWAIT__&lt;&gt;     actual wait time at initial boarding point     &lt;transit_class&gt;_XFERWAIT__&lt;&gt;     actual wait time at all transfer boarding points     &lt;transit_class&gt;_TOTALWAIT__&lt;&gt;     total actual wait time     &lt;transit_class&gt;_FARE__&lt;&gt;     fare paid     &lt;transit_class&gt;_XFERS__&lt;&gt;     number of transfers     &lt;transit_class&gt;_ACCWALK__&lt;&gt;     access actual walk time prior to initial boarding     &lt;transit_class&gt;_EGRWALK__&lt;&gt;     egress actual walk time after final alighting     &lt;transit_class&gt;_TOTALWALK__&lt;&gt;     total actual walk time     &lt;transit_class&gt;_TOTALIVTT__&lt;&gt;     Total actual in-vehicle travel time     &lt;transit_class&gt;_DWELLTIME__&lt;&gt;     Total dwell time at stops     &lt;transit_class&gt;_BUSIVTT__&lt;&gt;     actual in-vehicle travel time on local bus mode     &lt;transit_class&gt;_LRTIVTT__&lt;&gt;     actual in-vehicle travel time on LRT mode     &lt;transit_class&gt; _CMRIVTT__&lt;&gt;     actual in-vehicle travel time on commuter rail mode     &lt;transit_class&gt; _EXPIVTT__&lt;&gt;     actual in-vehicle travel time on express bus mode     &lt;transit_class&gt;_LTDEXPIVTT__&lt;&gt;     actual in-vehicle travel time on premium bus mode     &lt;transit_class&gt;_BRTIVTT__&lt;&gt;     actual in-vehicle travel time on  BRT mode     *time period = EA, AM, MD, PM, EV     transit_class = BUS, ALLPEN, PREM"},{"location":"outputs.html#resident-model-non-motorized-demand-matrices","title":"Resident Model non-motorized demand matrices","text":"Table Name     Description     WALK_&lt;&gt;     Walk for &lt;&gt;     BIKE_&lt;&gt;     Bike for &lt;&gt;"},{"location":"outputs.html#visitor-model-outputs-visitor","title":"Visitor model outputs (.\\visitor)","text":"<p>This directory contains outputs from the overnight visitor model.</p> File     Description     [final_households.csv](#### Visitor Model household file (final_households.csv))     Visitor model household file     final_land_use.csv     Visitor model land-use file     [final_persons.csv](#### Visitor Model person file (final_persons.csv))     Visitor model person file     [final_tours.csv](#### Visitor Model tour file (final_tours.csv))     Visitor model tour file     [final_trips.csv](#### Visitor Model trip file (final_trips.csv))     Visitor model trip file     model_metadata.yaml     Visitor model Datalake metadata file     nmotVisitortrips_(period).omx     Visitor model non-motorized trips by period (EA, AM, MD, PM, EV)     autoVisitortrips_(period).omx     Visitor model auto trips by period (EA, AM, MD, PM, EV)     transVisitortrips_(period).omx     Visitor model transit trips by period (EA, AM, MD, PM, EV)"},{"location":"outputs.html#visitor-model-household-file-final_householdscsv","title":"Visitor Model household file (final_households.csv)","text":"Field     Description     home_zone_id     Home MGRA     sample_rate     Sample rate     household_id     Household ID     poverty     Poverty indicator utilized for social equity reports. Percentage value where value &lt;= 2 (200% of the Federal Poverty Level) indicates household is classified under poverty."},{"location":"outputs.html#visitor-model-person-file-final_personscsv","title":"Visitor Model person file (final_persons.csv)","text":"Field     Description     household_id     Household ID     home_zone_id     Home MGRA     person_id     Person ID"},{"location":"outputs.html#visitor-model-tour-file-final_tourscsv","title":"Visitor Model tour file (final_tours.csv)","text":"Field     Description     tour_id     Tour ID     tour_type     Type of tour. String. \"dining\", \"recreation\", or \"work\"     purpose_id     Type of tour. 0: work, 1: \"dining, 2: \"recreation\"     visitor_travel_type     Visitor purpose. String. \"business\" or \"personal\"     tour_category     Tour category. All tour categories in the visitor model are \"non-mandatory\"     number_of_participants     Number of participants on tour     auto_available     Auto availability indicator 0: not available, 1: available     income     Income 0 - 4     origin     Tour origin MGRA     tour_num     Sequential number of tour 1 to n where n is total number of tours     tour_count     Number of tours per person     household_id     Household ID     person_id     Person ID     start     Half-hour time period of departure from tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     end     Half-hour time period of arrival back at tour origin. Periods are number 1 through 48 where period 1 starts at 3:00 AM.     duration     Duration of the tour in number of half-hour periods, including all activity episodes and travel     destination     Tour primary destination MGRA     destination_logsum     Tour destination choice logsum     tour_mode     Tour mode     mode_choice_logsum     Tour mode choice logsum     stop_frequency     Number of stops on tour by direction. String. xout_yin where x is number of stops in the outbound direction and y is the number of stops in the inbound direction     primary_purpose     Primary purpose of a tour. String (recreation, dining, work)"},{"location":"outputs.html#visitor-model-trip-file-final_tripscsv","title":"Visitor Model trip file ((final_trips.csv)","text":"Field     Description     trip_id     Trip ID     person_id     Person ID     household_id     Household ID     primary_purpose     Purpose at primary destination of tour. String. \"dining\", \"recreation\", or \"work\"     trip_num     Sequential number of trip on half-tour from 1 to 4     outbound     TRUE if outbound, else FALSE     trip_count     Number of trips in a tour     destination     Destination MGRA     origin     Origin MGRA     tour_id     Tour ID     purpose     Destination purpose. String. \"dining\", \"recreation\", or \"work\"     destination_logsum     Destination choice logsum     depart     Departure time period (1\u202648)     trip_mode     Trip mode (see trip mode table)     trip_mode_choice_logsum     Mode choice logsum for trip     vot_da     will drop     vot_s2     will drop     vot_s3     will drop     parking_cost     Parking costs at trip origin and destination, calculated as one-half of the costs at each end, with subsidies considered.     tnc_single_wait_time     Wait time for single pay TNC     tnc_shared_wait_time     Wait time for shared\\pooled TNC     taxi_wait_time     Wait time for taxi     cost_parking     Cost of parking ($2023)     cost_fare_drive     Taxi/TNC fare for any trip or trip portion taken on these modes     distance_walk     Distance walked on a trip (including access/egress for transit modes)     time_mm     Micromobility time     distance_mm     Micromobility distance     cost_fare_mm     Micromobility cost ($2023)     distance_bike     Bike distance     time_wait_drive     Ridehail/Taxi wait times for a trip     trip_period     A string indicating the skim period for the trip (\u201cEA\u201d,\u201dAM\u201d,\u201dMD\u201d,\u201dPM\u2019,\u201dEV\u201d)     tour_participants     Number of tour participants     distance_total     Trip distance     cost_operating_drive     Auto operating cost ($2023)     weight_trip     Trip weight defined as the ratio of number of particpants on a  trip to the assumed occupancy rate of a mode (SHARED2,3)     weight_person_trip     Person trip weigth defined as the ratio of the number of particpants on a trip to sample rate of the model run     vot     Value of time in dollars per hour ($2023)     inbound     TRUE if trip is in outbound direction, else FALSE     time_drive     Auto time     distance_drive     Auto distance     cost_toll_drive     Auto toll cost ($2023)     time_transit_in_vehicle     Transit in-vehicle time     time_rapid_transit_in_vehicle     Rapid transit in-vehicle time     time_express_bus_transit_in_vehicle     Express bus in-vehicle time     time_local_bus_transit_in_vehicle     Local bus in-vehicle time     time_light_rail_transit_in_vehicle     Light rail transit in-vehicle time     time_commuter_rail_transit_in_vehicle     Commuter rail in-vehicle time     time_transit_initial_wait     Transit initial-wait time     cost_fare_transit     Transit fare ($2023)     transfers_transit     Number of transfers     time_bike     Bike time     time_walk     Walk mode time     cost_total     total cost of a trip (sum of auto operating, toll, transit fare)     time_total     Total travel time (including iIVT and access/egress and wait times for all modes)     value_of_time_category_id     Value of time bin. 1: Low, 2: Medium, 3: High     origin_micro_prm_dist     Distance from trip origin MGRA to closest premium transit stop by microtransit     dest_micro_prm_dist     Distance from trip destination MGRA to closest premium transit stop by microtransit     microtransit_orig     Distance from trip origin MGRA to closest local transit stop by microtransit     microtransit_dest     Distance from trip destination MGRA to closest local transit stop by microtransit     microtransit_available     TRUE if microtransit is available for trip, else FALSE     nev_orig     True if Neghoborhood Electric Vehicle is available at origin     nev_dest     True if Neghoborhood Electric Vehicle is available at destination     nev_available     TRUE if neighborhood electric vehicle is available, else FALSE     microtransit_access_available_out     TRUE if microtransit is available from the origin, else FALSE     nev_access_available_out     TRUE if neighborhood electric vehicle is available from the origin, else FALSE     microtransit_egress_available_out     Availability of microtransit egress in the outbound direction     nev_egress_available_out     Availability of NEV egress in the outbound direction     microtransit_access_available_in     Availability of microtransit access in the inbound direction     nev_access_available_in     Availability of NEV egress in the inbound direction     microtransit_egress_available_in     Availability of microtransit egress in the inbound direction     nev_egress_available_in     Availability of microtransit egress in the outbound direction     sample_rate     Sample rate     otaz     Origin TAZ     dtaz     Destination TAZ"},{"location":"outputs.html#visitor-models-tour-mode-choice-definitions","title":"Visitor model\u2019s tour mode choice definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride"},{"location":"outputs.html#trip-mode-definitions","title":"Trip Mode Definitions","text":"Field     Description     DRIVEALONE     Drive alone     SHARED2     Shared ride with 2 participants     SHARED3     Shared ride with 3+ participants     WALK     Walk     BIKE     Bike     WALK_LOC     Local transit with walk access/egress mode     WALK_PRM     Premium transit with walk access/egress mode     WALK_MIX     Mix (local with premium transfers) transit with walk access/egress mode     PNR_LOC     Local transit with Park&amp;ride access or egress mode     PNR_PRM     Premium transit with Park&amp;ride access or egress mode     PNR_MIX     Mix (local with premium transfers) transit with Park&amp;ride access or egress mode     KNR_LOC     Local transit with Kiss&amp;ride access or egress mode     KNR_PRM     Premium transit with Kiss&amp;ride access or egress mode     KNR_MIX     Mix (local with premium transfers) transit with Kiss&amp;ride access or egress mode     TNC_LOC     Local transit with TNC access or egress mode     TNC_PRM     Premium transit with TNC access or egress mode     TNC_MIX     Mix (local with premium transfers) transit with TNC access or egress mode     TAXI     Taxi     TNC_SINGLE     Private TNC ride     TNC_SHARED     Shared TNC ride     SCH_BUS     School bus     EBIKE     E-bike     ESCOOTER     E-scooter"},{"location":"release-notes.html","title":"Release Notes","text":""},{"location":"release-notes.html#version-1510-september-4-2024","title":"Version 15.1.0 (September 4, 2024)","text":"<p>As mentioned in the notes for Version 15.0.2, several improvements to the Commercial Vehicle Model (CVM) were made, largely due to SANDAG staff realizing that the survey used to estimate the CVM had likely overestimated the amount of commercial vehicle travel that was made on a given day in the region. New weights were estimated, and then the CVM was recalibrated to match these new weights. After doing this, it was found that modeled highway volumes were lower than observed counts, so some further adjustments were made to get them back up. Some components of the resident model were recalibrated to better match the survey, a new database started being used, a bug in the transit network was fixed, and other miscelaneous improvements were made.</p>"},{"location":"release-notes.html#activitysim-version","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features","title":"Features","text":"<ul> <li>PR 167, PR 172, &amp; PR 173: Recalibration of the Commercial Vehicle Model to reflect newly-calculated Commercial Vehicle Survey weights.</li> <li>PR 182, PR 186, PR 194, &amp; PR 195: Miscellaneous calibration, particularly to counter the decrease in freeway travel caused by the CVM update.</li> <li>PR 176 &amp; PR 177: A new database was created for Version 15.1.0 and necessary scripts were modified to point to the new database. Go here to see detailed changes in the database and here for changes in the reporting tool.</li> <li>PR 184, PR 186, &amp; PR 193: The number of EV chargers each year were updated using numbers given by planning, and recalibration was done to ensure that the EV ownership rates for no build scenarios matched the targets.</li> <li>PR 178, PR 188, &amp; PR 189: In previous releases the crossborder model had its own constants.yaml file, which contained a lot of the same values in the common constants.yaml file, meaning that both files would need to be edited. The crossborder model now instead reads from the common constants.yaml file.</li> <li>PR 179, PR 181, PR 190, PR 191, &amp; PR 192: Miscellaneous updates to the scenario creation GUI and scenario build process.</li> </ul>"},{"location":"release-notes.html#bug-fixes","title":"Bug Fixes","text":"<ul> <li>PR 168, PR 170, PR 171, PR 175, &amp; PR 185: A bug in the transit network where connectors were being encoded with the wrong units was fixed. This resulted in a sharp increase in the number of transit boardings so some additional calibration was needed to get them back down to observed levels.</li> <li>PR 174 &amp; PR 180: Miscellaneous file cleanup and restoration.</li> </ul>"},{"location":"release-notes.html#version-1502-july-3-2024","title":"Version 15.0.2 (July 3, 2024)","text":"<p>Since the release of version 15.0.1 more updates were made, particularly regarding the new commercial vehicle model. More updates to the CVM will be forthcoming due to ongoing revision based on new data sources.</p>"},{"location":"release-notes.html#activitysim-version_1","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features_1","title":"Features","text":"<ul> <li>PR 155 &amp; PR 159: Updated the Wiki to reflect changes made for ABM3.</li> <li>PR 156: Made changes to distribution of commercial vehicle type mapping to the categories used in assignment.</li> <li>PR 157: Added calibration factors for determining the probability of a tour made by a single- or multi-unit truck terminating at a given stop.</li> <li>PR 158: Changed firm synthesis to be done at the TAZ level instead of the MGRA level.</li> </ul>"},{"location":"release-notes.html#bug-fixes_1","title":"Bug Fixes","text":"<ul> <li>PR 160: Removed an input file no longer used by the updated heavy truck model.</li> </ul>"},{"location":"release-notes.html#version-1501-june-12-2024","title":"Version 15.0.1 (June 12, 2024)","text":"<p>During the initial testing of the 2025 Regional Plan initial concept, some critical model issues were identified and fixed.</p>"},{"location":"release-notes.html#activitysim-version_2","title":"ActivitySim Version","text":"<p>No changes made to ActivitySim version.</p>"},{"location":"release-notes.html#features_2","title":"Features","text":"<ul> <li>PR 152: TNC_SHARED was not being properly disabled in 2022 due to misplaced parentheses.</li> <li>PR 148: Fixed TNC_SHARED mode choice to restrict to ride hail tours and help shares on joint tours.</li> <li>Issue 143: Added parameter to discount wait times for rapid bus.</li> </ul>"},{"location":"release-notes.html#bug-fixes_2","title":"Bug Fixes","text":"<ul> <li>PR 150: Updated EI inputs at interstate cordons to reflect 2022 counts.</li> <li>PR 149: Updated MAZ ID for Otay Mesa East Point of Entry from Series 13 to Series 15.</li> <li>PR 147: Updated MGRA references for external cordons in airport models from Series 13 to Series 15.</li> <li>PR 146: Removed suffix from labels in runtime summary.</li> <li>PR 145: Added parking location placeholder datasets needed to open calibration visualizer.</li> <li>Commit a825ae3: Updated CBX inputs to use number of enplanements.</li> <li>Commit 305cdcf: Updated reporting of airport transit costs to be in dollars instead of cents.</li> <li>Commit 363d05a: Removed addition of \u201cpoverty\u201d field when writing output tables as that had been added to reading of input table.</li> <li>Commit 34e4a1d: Set year after which vehicles must have transponders from 2035 to 2029.</li> <li>Commit dc07cc9: Increased default flexible fleet diversion constants.</li> <li>Commit 726f98a: Updated some future year signal factors and truck toll factors on SR-11.</li> </ul>"},{"location":"release-notes.html#version-1500-may-23-2024","title":"Version 15.0.0 (May 23, 2024)","text":"<p>For use in the 2025 Region Plan (RP), SANDAG has developed a new activity-based travel model, known as ABM3. The biggest change from SANDAG\u2019s previous ABM, ABM2+, is the transition from the Java-based CT-RAMP modeling platform to the open-source Python-based ActivitySim platform that has been developed by a consortium of public agencies (of which SANDAG is a founding member) for the past decade. ABM3 will be the first ActivitySim model to be used in production for planning purposes. While most of the model components from ABM3 were translated from ABM2+, there were several notable enhancements that were made, which are described below. Further, several models were either re-estimated and/or recalibrated to match 2022 data.</p>"},{"location":"release-notes.html#activitysim-version_3","title":"ActivitySim Version","text":"<ul> <li>SANDAG/activitysim v15.0.0: This is based on a fork of the ActivitySim consortium repo and customized code in BayDAG_estimation branch.</li> <li>SANDAG/activitysim-cvm v15.0.0: This specific version of ActivitySim is required to run the new Commercial Vehicle Model (CVM) in ABM3. It is based on a fork of the ActivitySim repo under CamSys and customized code in time-settings branch.</li> </ul>"},{"location":"release-notes.html#features_3","title":"Features","text":"<ul> <li>ABM PR 68: The base year was updated from 2016 to 2022, allowing the behavioral models to reflect changes in travel behavior derived from the onset of the COVID-19 pandemic.</li> <li>ABM PR 65: The zone system was transitioned from a 3-zone system (TAZ, MAZ, TAP) to a 2-zone system (TAZ, MAZ).</li> <li>ABM PR 66: E-bike and E-scooter were added as travel modes.</li> <li>ABM PR 64: A new commercial vehicle model (CVM) was implemented using ActivitySim, that includes firm synthesis, commercial vehicle tours, and TNC services such as food delivery.</li> <li>ABM PR 133: Network editing was changed from the ArcInfo-based TCOVED to TNED, a new network editing system.</li> <li>ABM PR 104: Flexible fleet services were added for full trips along with first-mile access to and last-mile egress from fixed-route transit.</li> <li>ABM PR 9: The airport model has been updated with new access options, including the proposed automated people-mover.</li> <li>ABM PR 53: The cross-border model was updated, including a new wait time model.</li> <li>Asim PR 635: A new disaggregate accessibility calculation step was introduced to improve the precision of accessibilities used by modeling components.</li> <li>ABM PR 82: Transit assignment for different time periods is now run in parallel.</li> <li>ABM Configs: The auto ownership model has been moved before work and school location.</li> <li>Asim PR 613: The shadow pricing algorithm was updated to constrain mandatory tour locations to availability instead of traditional shadow pricing.</li> <li>ABM PR 86: Model results are automatically written to a database stored in the cloud via Microsoft Azure Services.</li> </ul>"},{"location":"release-notes.html#new-resident-model-components","title":"New Resident Model Components","text":"<ul> <li>Autonomous Vehicle Ownership</li> <li>External Worker Identification</li> <li>External Workplace Location</li> <li>Transit Pass Subsidy</li> <li>Transit Pass Ownership</li> <li>Vehicle Type Choice</li> <li>Telecommute Frequency</li> <li>External Joint Tour Identification</li> <li>External Joint Tour Location</li> <li>External Nonmandatory Tour Identification</li> <li>External Nonmandatory Tour Destination</li> <li>Vehicle Allocation</li> </ul>"},{"location":"running.html","title":"Installing and Running ABM3","text":"<p>This page describes how to install and run ABM3, including hardware and software requirements. In general, a powerful server is required to run the model. The main software required for the model includes EMME, Python, and Java. EMME is a commercial transportation modeling platform that must be purchased separately and requires a computer with a Windows operating system. Python is an open-source cross-platform programming language that is currently one of the most popular programming languages. Python is the core language of ActivitySim. Java is an open-source programming language required for certain bespoke non-ActivitySim model components. </p>"},{"location":"running.html#system-requirements","title":"System Requirements","text":"<p>ABM3 runs on a Microsoft Windows workstation or server, with the minimum and recommended system specification as follows:</p> <p>Minimum specification:</p> <ul> <li> <p>Operating System: 64-bit Windows 7, 64-bit Windows 8 (8.1), 64-bit Windows 10, 64-bit Windows Server 2019</p> </li> <li> <p>Processor: 24-core CPU processor</p> </li> <li> <p>Memory: 1 TB RAM</p> </li> <li> <p>Disk space: 500 GB</p> </li> </ul> <p>Recommended specification:</p> <ul> <li> <p>Operating System: 64-bit Windows 10</p> </li> <li> <p>Processor: Intel CPU Xeon Gold / AMD CPU Threadripper Pro (24+ cores)</p> </li> <li> <p>Memory: 1 TB RAM</p> </li> <li> <p>Disk space: 1000 GB</p> </li> </ul> <p>In general, a higher CPU core count and RAM will result in faster run times as long as ActivitySim is configured to utilize the additional processors and RAM.</p> <p>Note that the model is unlikely to run on servers that have less than 1 TB of RAM, unless chunking is set to active and in explicit mode (requires an upcoming version of ActivitySim 1.3)</p>"},{"location":"running.html#software-requirements","title":"Software Requirements","text":"<p>Three software applications, EMME, Python package manager Anaconda, and Java should be installed on the computer that will be used to run the model.</p> <p>The ABM3 model system is an integrated model that is controlled by and primarily runs in the EMME transportation planning software platform. EMME is used for network assignment and creating transportation skims, and the model\u2019s Graphical User Interface (GUI). The software also provides functionality for viewing and editing highway and transit network files and viewing of matrix files. The Bentley Connect Edition software (the license manager for EMME) will need to be logged in and activated prior to running the model. </p> <p>A Python package manager is software that creates an environment for an instance of Python. ActivitySim and related Python processes in the model are executed in an environment that is setup with a specific version of Python and specific library versions. This ensures that changes outside of the Python environment will not cause errors or change model results, and additionally ensure that the specific version of Python and specific libraries needed by the model do not cause errors or changes to other Python software installations on the server. The libraries needed by ActivitySim extend the base functionality of Python. Note that Anaconda requires a paid subscription for agencies larger than 200 users. To install Anaconda, follow the instructions here. </p> <p>Java is required in order to create bicycle logsums, run the taxi/TNC routing model, and run the intra-household autonomous vehicle routing model. The model has been tested against Java version 8 (e.g. 1.8) but should run in later versions as well. </p>"},{"location":"running.html#installing-abm3-model","title":"Installing ABM3 Model","text":""},{"location":"running.html#setting-up-the-python-environments","title":"Setting up the Python environments","text":"<p>As noted above, User needs to install Anaconda on the machine they are working on, if it is not already installed. The following step is creating a specific environment to run ActivitySim. The environment is a configuration of Python that is for ActivitySim - this environment allows ActivitySim to use specific software libraries without interfering with the server\u2019s installed version of Python (if one exists, it is not required) and keeps other Python installations from interfering with ActivitySim. </p> <p>To run ABM3, user needs to install two different python environments, one in Python 3, which will be used by all ActivitySim-based models, and one in Python 2, which is required as long as the EMME version in use still depends on Python 2, and is used to convert the omx rip tables out of the ActivitySim models. To set up these environments, use the following instruction from within the Anaconda 3 PowerShell Prompt for Python 3 and Anaconda 2 PowerShell Prompt for Python 2. </p> <p>To set up the Python 3 environment, first, change directories using cd /d to the environment folder under the ActivtySim source code directory. As of June 2024, this directory may be cloned from the BayDAG_estimation branch located on the SANDAG\u2019s forked version of ActivitySim here. The environment folder in this directory contains a number of yaml files that may be used to install the environment. User may use the following command to install the AcitvitySim environment along with SANDAG\u2019s version of AcitivtySim under the asim_baydag name.</p> <p><code>conda env create --file=activitysim-dev.yml -n asim_baydag</code></p> <p>After installing the environment, do a quick test of it by activating it, using:</p> <p><code>conda activate asim_baydag</code></p> <p>To set up the Python 2 environment, user simply needs to install the openmatrix package in the base environment. To do so, first open the Anaconda 2 terminal and use the following command to install the openmatrix package:</p> <p><code>pip install openmatrix</code></p>"},{"location":"running.html#installing-java","title":"Installing Java","text":"<p>Java version 1.81 needs to be installed on the server. SANDAG servers usually have this version of Java already installed on them.</p>"},{"location":"running.html#creating-a-scenario-folder","title":"Creating a scenario folder","text":"<p>Follow the steps below to create a model scenario folder using SANDAG\u2019s tool:</p> <ul> <li>Check for an open server using the DOS tool mascot-abm.</li> <li>Log into server</li> <li>Using the show hidden icons arrow on the taskbar, click the INRO Software Manager to check if EMME license is operating. If it\u2019s not, log into license server on Mustang by typing in the Host box: mustang.sandag.org:5170 (automatic)</li> <li>Using the server\u2019s Windows Explorer, navigate to T:\\ABM\\release\\ABM\\version_14_2_2\\dist</li> <li>Double click on createStudyAndScenario.exe and click Run.</li> <li>On pop-up, enter fields in Create an ABM scenario. Make sure to enter the correct ABM version, EMME version, year, and know your Scenario Folder (where you will run the model from; typically study area/abm_runs) and your Network Folder (input networks). Browse to an existing folder or copy (ctrl + c) and paste (ctrl + v) paths to minimize chance of typos. After fields are entered, click Create.</li> <li>A DOS window will open and necessary files will be copied. If you have a server with a valid license, it will pause for about 30-45 seconds on init emme folder. You will get a pop-up window that says you have successfully created the scenario. Click Quit. Exit the GUI by clicking on Quit.</li> <li>Go to your newly created abm_run folder and double check on input files/date stamps to verify they match expected date stamps. Make any modifications to input files (i.e. <code>parametersByYears.csv</code> for adjusting auto operating costs, <code>filesByYears.csv</code> for specifying year-specific files, or <code>mgra_based_inputXXX.csv</code> file for adjusting parking costs)</li> </ul>"},{"location":"running.html#running-abm3","title":"Running ABM3","text":"<p>To open the EMME application from the created scenario directory, user needs to go to the emme_project folder, and open the start_emme_with_virtualenv.bat file. This opens up the EMME application, where the application prompts the choice of a scenario. It is recommended to select the main highway scenario (Scen. 100) to start off the model run, although other scenarios may be selected as well. </p> <p>Following this step, user should open the EMME Modeler by clicking on the gold square sign at the top left of the screen.  </p> EMME Modeler icon <p> The EMME Modeler opens to the EMME Standard Toolbox, but needs to be switched to the SANDAG toolbox by selecting it from the bottom-left of the screen. From this toolbox, open the Master Run tool.</p> <p></p> Opening SANDAG Toolbox and Master run <p> Opening the Master Run tool allows the user to run all or part of the model, and set a number of settings such as sample size.</p> <p></p> Master Run tool <p> The Master run tool operates the SANDAG travel demand model. To operate the model, configure the inputs by providing Scenario ID, Scenario title and Emmebank title, and keeping Number of Processors to default. Select main ABM directory will automatically be set to the current project directory and does not require change.</p> <ul> <li>Main ABM directory: directory which contains the ABM scenario data, including this project. The default is the parent directory of the current Emme project.</li> <li>Scenario ID: Scenario ID for the base imported network data. The result scenarios are indexed in the next five scenarios by time period.</li> <li>Scenario title: title to use for the scenario.</li> <li>Emmebank title: title to use for the Emmebank (Emme database)</li> <li>Number of processors: the number of processors to use for traffic and transit assignments and skims, aggregate demand models (where required) and other parallelized procedures in Emme. Default is <code>Max available \u2013 1</code>.</li> <li>Properties (<code>conf/sandag_abm.properties</code>)<ul> <li>On opening the Master run tool the <code>sandag_abm.properties</code> file is read and the values cached and the inputs below are pre-set. When the Run button is clicked this file is written out with the values specified. Any manual changes to the file in-between opening the tool and clicking the Run button are overwritten.</li> <li>Sample rate by iteration: three comma-separated values for the ActivitySim sample rates for each iteration</li> <li>Start from iteration: start iteration for the model run</li> <li>Skip steps: optional checkboxes to skip model steps.</li> </ul> </li> <li>Select link: add select link analyses for traffic.</li> </ul> <p>By expanding the Run model \u2013 skip steps drop down, the user can make any custom changes. Usually the defaults should be sufficient although if you are using a new bike network, you should uncheck the Skip bike logsums and check the Skip copy of bikelogsum.</p> <p></p> Run model tool <p></p> <p>Following this setup, you can click Run to start the model run. We recommend occasionally checking the model run status to make sure the run is going smoothly. When the model run finishes successfully, the Master Run tool will show a model run successful message in green at the top of the tool window.</p> <p>If the run is unsuccessful (there will be an error prompt from Emme), check Emme logbook and log files (under \u201clogfiles\u201d) for clues to where it stopped.</p> <p>As the model runs, a full runtime trace of the model steps, inputs and reports is recorded in the Modeller Logbook. As each step completes, it will record an entry in the Logbook along with reports and other results. The Logbook can be opened from the Clock-like icon in the upper right of the Modeller window. This icon can also be found in the toolbar in the Emme Desktop. If a Modeller tool is running, a window will pop-up over the Emme Desktop which includes a Show Logbook button (this window can be closed to use Desktop worksheets and tables while any tool is running). Click on the Refresh button to update the logbook view with the latest status.</p> <p></p> Modeller logbook <p></p> <p>The Logbook provides a real time, automated documentation of the model execution. The overall structure of the model is represented at the top level, with the occurrence, sequence and repetition of the steps involved in the model process. Nested Logbook entries may be collapsed or expanded to see detail. For the Emme assignment procedures, interactive charts are recorded. The statistical summaries of the impedance matrices are recorded for each time period following the assignment. These summary tables provide an easy way to check for skims with obvious outlier values.</p>"},{"location":"application/applying.html","title":"Applying the model","text":"<p>This page contains information needed to apply the model.</p>"},{"location":"application/ev-rebates.html","title":"Electric Vehicle Rebates","text":"<p>One of the policies that SANDAG planners would like to test for the 2025 Regional Plan is providing rebates for low- and middle-income households to purchase electric vehicles. One of the variables in the vehicle type choice model is the new purchase price for a vehicle of a given age, body type, and fuel type. The way the EV rebate is implemented in ABM3 is by deducting the appropriate rebate value for plugin and battery vehicles if a household meets the criteria (based on percentage of the federal poverty level). To configure the rebate values and poverty level thresholds, new constants were added to the common/constants.yaml configuration file. The constants fit into the policy as follows:</p> Fuel Type <code>LowIncomeEVRebateCutoff</code> &lt; Household Poverty Level &lt;= <code>MedIncomeEVRebateCutoff</code> Household Poverty Level &lt;= <code>LowIncomeEVRebateCutoff</code> BEV <code>MedIncomeBEVRebate</code> <code>LowIncomeBEVRebate</code> PEV <code>MedIncomePEVRebate</code> <code>LowIncomePEVRebate</code> <p>For example, if the following policy were to be tested\u2026</p> Fuel Type 300-400% Federal Poverty Limit 300% Federal Poverty Limit or lower BEV $2,000 $6,750 PEV $1,000 $3,375 <p>\u2026then the constants would need to be set as follows: <pre><code>LowIncomeEVRebateCutoff: 3\nMedIncomeEVRebateCutoff: 4\nLowIncomeBEVRebate: 6750\nLowIncomePEVRebate: 3375\nMedIncomeBEVRebate: 2000\nMedIncomePEVRebate: 1000\n</code></pre></p>"},{"location":"application/flexible-fleets.html","title":"Flexible Fleets","text":"<p>The of the five big moves defined in SANDAG\u2019s 2021 regional plan was Flexible Fleets, which involves on-demand transit services. The initial concept of the 2025 Regional Plan involves rapidly expanding these services, with many new services planned to be in operation by 2035. For this reason, it is important that these services be modeled by ABM3. There are two flavors of flexible fleets that were incorporated into ABM3, Neighborhood Electric Vehicles (NEV) and microtransit. A table contrasting these services is shown below.</p> Characteristic NEV Microtransit Vehicle Size Smaller Larger Service Area Smaller Larger Operating Speed Slower Faster"},{"location":"application/flexible-fleets.html#incorporation-into-abm3","title":"Incorporation into ABM3","text":"<p>Rather than creating new modes for flexible fleet services, microtransit and NEV were incorporated into existing modes. How this was done was dependent on whether the trip was a full flexible fleet trip, first-mile access to fixed-route transit, or last-mile egress from fixed-route transit. A table explaining how each of these trip types was incorporated into ABM3 is shown below. Further, a heirarchy of services is enforced. ActivitySim first checks if NEV is available (based on a new land use attribute), and if it is, it\u2019s assumed that NEV is used. If not, ActivitySim checks if microtransit is available (based on a corresponding land use attribute), and if it is, it\u2019s assumed that microtransit is used. If neither are available, ActivitySim looks at the other services that are already available.</p> <p>*For trips on the return leg of a tour the access and egress attributes are swapped</p> Full microtransit trip First-mile access to fixed-route transit Last-mile egress from fixed-route transit What models allow for this type of trip? Resident, Visitor, Crossborder Resident Resident, Visitor, Crossborder Which mode is used? TNC Shared TNC to transit All transit modes How is the flexible fleet travel time factored into the trip? The travel time is the full travel time of the trip The travel time is added to the transit access time and a transfer is added The travel time is added to the transit egress time and a transfer is added if the destination is further from the nearest transit stop than a user would be willing to walk (that distance is configurable) How is the flexible fleet cost factored into the trip? The cost is the full cost of the trip It is assumed that flexible fleet services are free when used to access fixed-route transit It is assumed that flexible fleet services are free when egressing from fixed-route transit"},{"location":"application/flexible-fleets.html#new-attributes","title":"New Attributes","text":"<p>Several new attributes were added to allow the user to configure how flexible fleet services are operated. These are all defined in the common constants.yaml file. Each attribute is defined as follow:</p> Attribute Definition Default value Speed Assumed operating speed in miles per hour MT: 30, NEV: 17 Cost Cost of using service in US Cents 125 for both WaitTime Assumed time passengers wait to wait to use service in minutes 12 for both MaxDist Maximum distance in miles that the service can be used MT: 4.5, NEV: 3 DiversionConstant Additional travel time to divert for servicing other passengers 6 for both DiversionFactor Time multiplier accounting for diversion to service other passengers 1.25 for both StartPeriod Time period to start service (not yet implemented) 9 for both EndPeriod Time period to end service (not yet implemented) MT: 32, NEV: 38 maxWalkIfMTAccessAvailable Maximum disatance someone is willing to walk at the destination end if flexible fleet services are available (same for microtransit and NEV) 1.0"},{"location":"application/flexible-fleets.html#travel-time-calculation","title":"Travel Time Calculation","text":""},{"location":"application/flexible-fleets.html#direct-time","title":"Direct Time","text":"<p>The flexible fleet travel time calculation is a two-step process. The first step is to calculate the time that it would take to travel from the origin to the destination* directly without any diversion to pick up or drop off any passengers. This is done by taking the maximum of the time implied by the operating speed and the congested travel time:</p> <p>\\(t_{\\textnormal{direct}} = \\textnormal{max}(60\\times\\frac{s}{d}, t_{\\textnormal{congested}})\\)</p> <p>where:</p> <p>\\(t_{\\textnormal{direct}} = \\textnormal{Direct flexible fleet travel time}\\)</p> <p>\\(s = \\textnormal{speed}\\)</p> <p>\\(d = \\textnormal{Distance from origin to destination (taken from distance skim)}\\)</p> <p>\\(t_{\\textnormal{congested}} = \\textnormal{Congested travel time from origin to destination (taken from Shared Ride 3 time skim)}\\)</p> <p>*When used to access fixed-route transit, the destination is the nearest transit stop to the trip origin. When used to egress from fixed-route transit, the origin is the nearest transit stop to the trip destination.</p>"},{"location":"application/flexible-fleets.html#total-time","title":"Total Time","text":"<p>The second step of the travel time calculation was to account for diversion to pick up other passengers. These were based on guidelines used in a NEV pilot. The formula to calculated the total flexible fleet travel time is as follows:</p> <p>\\(t_{\\textnormal{total}} = \\textnormal{max}(t_{\\textnormal{direct}}+c, \\alpha\\times t_{\\textnormal{direct}})\\)</p> <p>where:</p> <p>\\(t_{\\textnormal{total}} = \\textnormal{Total flexible fleet travel time}\\)</p> <p>\\(c = \\textnormal{DiversionConstant}\\)</p> <p>\\(\\alpha = \\textnormal{DiversionFactor}\\)</p>"},{"location":"application/landuse-prep.html","title":"Land-Use Data Preparation","text":"<p>//TODO: Describe how to prepare land-use data.</p> <p>Describe how to update parking costs, enrollment data.</p>"},{"location":"application/micromobility.html","title":"Micromobility","text":"<p>//TODO: Describe how to run micromobility policy tests</p>"},{"location":"application/network-coding.html","title":"Network Coding","text":"<p>//TODO: Describe network attributes, how to code network</p>"},{"location":"application/population-synthesis.html","title":"Population Synthesis","text":"<p>//TODO: Describe population synthesis procedure, how to modify inputs and construct new future-year synthetic population</p>"},{"location":"application/scenario-manager.html","title":"Scenario manager","text":"<p>ABM3 uses a python module as the scenario manager. The job of this scenario manager is updating the parameters used throughout the model to match a specific scenario\u2019s definition and needs. A number of these parameters including auto operating cost, taxi and TNC fare, micromobility cost, and AV ownership penetration are usually assumed to change by forecast year or scenario.</p> <p>Manually changing these parameters requires the model user to know where each parameter is located, and individually changing them according to the scenario forecast values. A scenario manager, therefore, can be a convenient and efficient tool to automate this process.</p> <p>The ABM3 Scenario Manager reads in a CSV input file (located under <code>input/parametersByYears.csv</code>) containing the parameter values for each scenario, and updates the associated parameters in the ActivitySim config files. A snapshot of this input parameter CSV file is shown below, where each row is associated with a specific scenario year/name. The parameter names used here can either be identical to the parameter names used in ActivitySim, or different. In case the parameter names are different, a separate file is used to map the parameters names between the input CSV and ActivitySim config files.</p> Scenario Year AOC fuel AOC maintenance Taxi baseFare Taxi costPerMile Taxi costPerMinute 2012 13.5 6.3 1.78 1.87 0.08 2014 12.9 6.3 1.78 1.87 0.08 2015 19.5 6.2 1.78 1.87 0.08 2016 10.7 5.6 1.78 1.87 0.08 2017 10.8 5.5 1.78 1.87 0.08 <p>The scenario manager is run as part of the model setup in the Master Run tool before any ActivitySim model is run (usually only in the first iteration of the run). Model user can choose to run or skip this step, although it is highly recommended to run with each run to ensure correct parameters.</p>"},{"location":"design/design.html","title":"Model Design","text":"<p>The ABM3 model system is primarily based on the ActivitySim platform; ActivitySim is used to model resident travel, cross-border travel, overnight visitor travel, airport ground access travel, and commercial vehicle travel including light, medium, and heavy commercial vehicles. Aggregate models are used to model external-internal travel (from external stations other than the U.S./Mexico border crossing) and through travel. The model system relies on EMME software for network processing, skimming, and assignment. Models are mostly implemented in Python, and some models are implemented in [Java] (https://www.java.com/en/).</p> <p>The overall design of the model is shown in the figure below.</p> <p></p> <p>The system starts by performing initial input processing in EMME. This includes building transport networks and scenarios for skimming and assignment. An initial set of skims are created based on input trip tables (e.g. warm start). Then disaggregate choice models in ActivitySIm are run, including the resident model, the crossborder travel model, two airport ground access models, the overnight visitor model, and the commercial vehicle model. Next auxiliary models are run; the taxi/TNC routing model and the autonomous vehicle intra-household allocation model are run in Java. Aggregate external-internal and through travel models are run in Python. After all models are run, trip tables are built from the result and assigned to transport networks. A check is made to determine whether the model has reached convergence (currently this is set to three feedback iterations). If convergence is reached, outputs are processed for export to the SANDAG Datalake for reporting summaries. If not, speeds from assignment are averaged using method of successive averages, and skims are rebuilt for the next iteration. The model system is then re-run with the updated skims.</p> <p>ActivitySim is used to represent all internal travel and internal-external made by residents of the SANDAG region (modeled area).  The decision-makers in the model system include both persons and households. These decision-makers are created (synthesized) for each simulation year and land-use scenario, based on Census data and forecasted distributions of households and persons by key socio-economic categories. A similar but simplified method is used to generate disaggregate populations for cross-border, airport ground access, and overnight visitor models. The decision-makers are used in the subsequent discrete-choice models in a microsimulation framework where a single alternative is selected from a list of available alternatives according to a probability distribution.  The probability distribution is generated from a logit model which considers the attributes of the decision-maker and the attributes of the various alternatives. The application paradigm is referred to as Monte Carlo simulation, since a random number draw is used to select an alternative from the probability distribution. The decision-making unit is an important element of model estimation and implementation and is explicitly identified for each model specified in the following sections.</p> <p>A key advantage of using the micro-simulation approach is that there are essentially no computational constraints on the number of explanatory variables that can be included in a model specification.  However, even with this flexibility, the model system will include some segmentation of decision-makers.  Segmentation is a useful tool to both structure models (for example, each person type segment could have their own model for certain choices) and to characterize person roles within a household.  Segments can be created for persons as well as households.</p>"},{"location":"design/demand/index.html","title":"Demand Design","text":"<p>Details of demand components of the model.</p>"},{"location":"design/demand/airport.html","title":"Airport Ground Access Models","text":"<p>There are two airport ground access models - one for San Diego International Airport and one for the Crossborder Express terminal which provides access to Tijuana International Airport from the United States. Both models use the same structure and software code, though the parameters that control the total number of airport travel parties, off-airport destination, mode, arrival and departure times, and other characteristics, vary for each airport according to survey and airport-specific data. The airport ground access model simulates trips to and from the airport for residents, visitors, and external travelers. These trips are generated by arriving or departing passengers and are modeled as tours within the ActivitySim framework. A post processing script also generates trips to serve passengers who require a pickup or dropoff at the airport. For example, a passenger who is picked up at the airport generates two trips; one trip to the airport by the driver to pick up the air passenger(s), and another trip from the airport with the driver and the air passenger(s). It is important to note that, to work within the ActivitySim framework, the airport trips must be modeled as tours, rather than being generated directly as in the previous model. These tours are assigned an origin at the airport MGRA. During the stop frequency step of ActivitySim, a trip is assigned to the appropriate leg of the tour (either to or from the airport) while the opposite leg is not assigned any trips (referred to as the \u2018dummy leg\u2019). Passengers who are leaving on a departing flight and traveling to the airport are considered \u201cinbound,\u201d while arriving passengers are considered \u201coutbound\u201d.</p> <p>The overall design of the model is shown in the figure below.</p> <p></p> <ol> <li>Tour Enumeration: A list of airport travel parties is generated from input enplanements and transferring passenger rates, as well as distributions that describe the share of travel parties by purpose (business versus personal), household income, and party size.</li> <li> <p>Tour Level Models</p> <p>2.1 Tour Scheduling Probabilistic: The tour scheduling model uses a probabilistic draw of the scheduling distribution. This model assigns start and end times to the tour. This is important because it will also serve as the schedule model for the final airport trips. In ActivitySim, trips are scheduled based on the tour schedule. If there is only one trip per leg on the tour (such as our case here) the trip is assigned the tour start/end time.</p> <p>2.2 Tour Destination Choice: The destination choice model chooses the non-airport end of the airport trips. Each tour is set with an origin at the airport MGRA. The tour destination model of ActivitySim is used to choose the non-airport end of the trip. The utility equation includes the travel distance, and the destination size terms. ActivitySim destination choice framework requires a mode choice log sum. A dummy tour mode choice log sum was created which generates a value of zero for every destination using the \u2018tour_mode_choice.csv\u2019 and \u2018tour_mode_choice.yml\u2019 file. This is a work around to prevent ActivitySim from crashing and not having to include the tour mode choice log sum in the destination choice model.</p> <p>2.3 Stop Frequency Choice: The stop frequency model is where the trip table is first created. The pre-processor tags each tour with a direction of \u2018inbound\u2019 or \u2018outbound\u2019 according to whether the tour is a departing or arriving passenger. For the Airport Ground Access model, inbound tours are tagged with zero outbound trips and -1 inbound trips (and the opposite is true for outbound tours: -1 outbound trips and 0 inbound trips). The 0 signifies that no intermediate stops are made; this leg of the tour will only have one trip. The -1 signifies that no trip is made at all on that leg. Using the -1 allows us to create \u2018half-tours\u2019 where only one leg of the tour is recorded as a trip. 3. Trip Level Models</p> <p>3.1 Trip Departure Choice: The trip scheduling model assigns depart times for each trip on a tour. ActivitySim requires trip scheduling probabilities; however, these are not used in this implementation since there is only one trip on any given tour leg. This means the trips will be assigned the tour scheduling times which were determined in the tour scheduling model. The trip scheduling probabilities file is just a dummy file.</p> <p>3.2 Trip Mode Choice: Each trip is assigned a trip mode; in the Airport Ground Access Model, trip mode refers to the airport arrival mode which simultaneously predicts the arrival mode and the location which the passenger uses to access that model. The arrival modes are shown in the table below.  The trip mode choice yaml file contains detailed variables associated with each trip mode. For example, each parking location is given an MGRA location, a walk time, a wait-time, and a cost. If a parking location MGRA is set to -999 it is assumed to be unavailable and will not be in the choice set. The pre-processor in this step stores all values of skims from the trip origin to each of the access modes destinations along with any associated costs. Costs include parking fees per day, access fees, fares, and rental car charges. Employees are not fed into the trip mode choice model. Instead, if a transit share is specified in the employee park file, that percentage of employees will be assigned \u2018Walk Premium\u2019 mode in the pre-processor. Otherwise, employees are all assigned \u2018Walk\u2019 mode from the employee parking lot to the terminal.</p> <p>3.3 Airport Returns: Airport trips where the party is dropped of curbside or parked and escorted are assumed to also have the driver make a return trip to the non-airport location. This procedure is done as a post-processing step after mode choice and before trip tables are written out. An \u2018airport_returns.yml\u2019 file takes a user setting to determine which trip modes will include a return trip. These trips records are flagged and duplicated. The duplicated trips swap the origin and destination of the original trip and are assigned a unique trip id. These trips are tagged with \u2018trip_num =2\u2019 so they are easily sorted in any additional processing (such as for writing trip matrices).</p> <p>3.4 Write trip matrices: The write trip matrices step converts the trip lists into vehicle trip matrices. The matrices are segmented by trip mode and value of time bins. The vehicle trip modes in the matrices include SOV, HOV2, HOV3+, Taxi, and TNC-single. Value of time segmentation is either low, medium, or high bins based on the thresholds set in the model settings.</p> </li> </ol> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n    %% D --&gt; D2[PNR Access]\n    D --&gt; D3[KNR Access]\n    D --&gt; D4[TNC Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n\n    D3 --&gt; D31[Local Only]\n    D3 --&gt; D32[Premium Only]\n    D3 --&gt; D33[Mixed]\n\n    D4 --&gt; D41[Local Only]\n    D4 --&gt; D42[Premium Only]\n    D4 --&gt; D43[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n</code></pre></p>"},{"location":"design/demand/airport.html#airport-ground-access-model-trip-arrival-modes","title":"Airport Ground Access Model Trip Arrival Modes","text":"Arrival Mode Description Park Location 1 Party parks personal vehicle at parking location 1. Park Location 2 Party parks personal vehicle at parking location 2. Park Location 3 Party parks personal vehicle at parking location 3. Park Location 4 Party parks personal vehicle at parking location 4. Park Location 5 Party parks personal vehicle at parking location 5. Curb Location 1 Party is dropped off or picked up by another driver at curbside location 1. Curb Location 2 Party is dropped off or picked up by another driver at curbside location 2. Curb Location 3 Party is dropped off or picked up by another driver at curbside location 3. Curb Location 4 Party is dropped off or picked up by another driver at curbside location 4. Curb Location 5 Party is dropped off or picked up by another driver at curbside location 5 Park and Escort Party is driven in personal vehicle, parks on-site at the airport and is escorted to/from airport. Rental Car Party arrives/departs by rental car. Shuttle Van Party takes shuttle van. Hotel Courtesy Party takes hotel courtesy transportation. Ridehail Location 1 Party arrives\\departs using ridehail at ridehail location 1 Ridehail Location 2 Party arrives\\departs using ridehail at ridehail location 2 Taxi Location 1 Party arrives\\departs using taxi at taxi location 1 Taxi Location 2 Party arrives\\departs using taxi at taxi location 2 Walk Local Party arrives\\departs using walk-local bus Walk Premium Party arrives\\departs using walk-premium transit Walk Mix Party arrives\\departs using walk-local plus premium transit KNR Local Party arrives\\departs using KNR-local bus KNR Premium Party arrives\\departs using KNR-premium transit KNR Mix Party arrives\\departs using KNR-local plus premium transit TNC Local Party arrives\\departs using TNC-local bus TNC Premium Party arrives\\departs using TNC-premium transit TNC Mix Party arrives\\departs using TNC-local plus premium transit Walk Party arrives\\departs using walk <p>For more information on the Air Ground Access Travel Model see technical documentation.</p>"},{"location":"design/demand/crossborder.html","title":"Crossborder Model","text":"<p>The Cross-Border Travel Model predicts travel made by residents of Mexico within San Diego County. It predicts the border crossing point of entry as well as all trips made within the county. The model is limited to simulating travel made by Mexican residents who return to Mexico within the simulation day. Cross-border travel not captured by the Cross-Border Model includes:</p> <ul> <li>Residents of San Diego County who travel to/from Mexico. This travel is represented by the resident travel model.</li> <li>Residents of Mexico (including U.S. citizens) who travel into San Diego County and who do not return to Mexico at the end of the day. This travel is represented in the overnight visitor travel model.</li> <li>Travel between points of entry through San Diego County to other U.S. destinations. This travel is represented by the external-external travel model.</li> <li>Commercial vehicle travel to/from points of entry. This travel is represented by the commercial vehicle model.</li> </ul> <p>The overall design of the model is shown in the figure below.</p> <p></p>"},{"location":"design/demand/crossborder.html#crossborder-model-purpose-definitions","title":"Crossborder Model Purpose Definitions","text":"<p>There are five activity purposes in the cross-border travel demand model:   * Work: Any activity involving work for pay.   * School: Pre-k school, K-12, college/university, or trade school.   * Shop: Shopping at retail, wholesale, etc.   * Visit: Visiting friends or family   * Other: A broad category including eating out, medical appointments, recreational activities, etc.</p> <p>Note that home activities are not listed, since we do not model activities south of the border.</p>"},{"location":"design/demand/crossborder.html#crossborder-model-mode-definitions","title":"Crossborder Model Mode Definitions","text":"<p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode\\Border Crossing Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D11,D12,D13 group3;\n</code></pre></p> <p>The model has the following mode types at the trip level:   * Drive-alone: Single occupant private vehicle   * Shared 2: A private vehicle with exactly two passengers   * Shared 3+: A private vehicle with three or more passengers   * Walk: Walk mode   * Bike: Bike mode   * Walk-transit: Walk access to transit. There are three sub-types of transit: Local only,   premium only, local + premium (which includes both local and premium services in the   transit path)   * Taxi: Door-to-door taxi trip   * Single-pay TNC: Door-to-door TNC trip with a single payer (e.g. UberX)   * Shared-pay TNC: Stop-to-stop TNC trip with potentially multiple payers (e.g. UberPool)</p> <p>We also model tour mode, which is the mode used to cross the border. These modes include drive-alone, shared 2, shared 3+ and walk. We assume that anyone crossing by bus or taxi is similar to walk, since they do not have access to a personal vehicle for the rest of their travel in San Diego County.</p> <p>We also classify border crossings by lane type: general purpose, SENTRI, and Ready. We assume that the use of these lanes is related to the border crossing party; we attribute each party with SENTRI or Ready availability. The proportion of total border crossing parties with access to SENTRI and Ready lanes are based on observed survey data, pooled across all stations. This data is used to simulate the availability of the lane to the travel party. Each lane crossing type is related to the wait time that the travel party experiences at each border crossing station by mode.</p> <p>Below is a general description of the model structure.</p> <ol> <li>Tour Enumeration: A list of person-tours is created by first cross-multiplying the input total person tours with the share of tours by pass type, then expanding tours by pass type to tours by pass type and purpose.</li> <li> <p>Tour Level Models     2.1 Time-of-day Choice: Each person-tour is assigned an outbound and return half-hour      period.</p> <p>2.2 Primary Destination and Station Choice: Each border crossing person-tour chooses a  primary destination MGRA and border crossing station.</p> <p>2.3 Border Crossing Mode Choice: Each person-tour chooses a border crossing tour mode.</p> </li> <li> <p>Wait Time Model</p> <p>3.1. Wait time model: Calculate wait time based on demand at each POE from model 2.2</p> <p>3.2. Convergence check: If max iterations reached (currently 3), goto Stop and Trip level models, else goto Model 2.2 3. Stop and Trip Level Models 4.1 Stop Frequency Choice: Each person-tour is assigned number of stops by half-tour (outbound, return).</p> <p>4.2 Stop Purpose Choice: Each stop is assigned a stop purpose (consistent with the tour purposes).</p> <p>4.3 Trip Departure Choice: Each trip is assigned a half-hourly time period.</p> <p>4.4 Stop Location Choice: Each stop chooses an MGRA location.</p> <p>4.5 Trip Mode Choice: Each trip is assigned a trip mode.</p> <p>4.6 Trip Assignments: Trips are assigned to networks, along with resident and other special market trip tables, and skims are created for the next iteration of the model.</p> </li> </ol> <p>For more information on the Crossborder Travel Model see technical documentation.</p>"},{"location":"design/demand/external.html","title":"External Models","text":"<p>The external aggregate travel models predict characteristics of US-SD and SD-US/MX travel behavior for all non-commercial, non-visitor vehicle trips and selected transit trips. Note that non-commercial MX-SD trips are forecast in the crossborder model, and non-commercial SD-US and SD-MX trips are forecast in the resident model.</p> <p></p>"},{"location":"design/demand/external.html#external-model-estimation-of-trip-counts-by-type","title":"External Model Estimation of Trip Counts by Type","text":"<p>The total count of trips by production and attraction location was estimated in a series of steps:</p> <ol> <li>The number of crossborder trips made by Mexican residents to attractions in San Diego was previously determined.</li> <li>The trips in the resident travel survey were expanded to estimate the total number of trips made by San Diego residents to attractions in Mexico.</li> <li>To derive an estimate of the number of US-MX trips, the number of MX-SD (1) and SD-MX (2) trips was subtracted from the total number of border-crossings.<ul> <li>The distribution of US-MX trips among external stations on the US-side of San Diego County will be assumed to be proportional to the total volume at each external station, regardless of the point of entry at the Mexican border.</li> </ul> </li> <li>The number of US-MX trips was then subtracted from the total number of trips in the SCAG cordon survey to arrive at an estimate of the combined total of US-US, US-SD, and SD-US trips with routes through San Diego County.</li> <li>Finally, the actual amounts of US-US, US-SD, and SD-US trips at each external station were estimated from the remaining trips (4) according to their proportions in the successfully geocoded responses in the SCAG cordon survey.</li> </ol>"},{"location":"design/demand/external.html#external-model-design-overview","title":"External Model Design Overview","text":"<p>The behavioral characteristics of the different types of external trip were derived from the various data sources available as follows:</p> <ul> <li>US-US trips: a fixed external station OD trip matrix was estimated from the SCAG cordon survey.<ul> <li>/src/main/emme/toolbox/model/external_external.py</li> </ul> </li> <li>US-MX trips: a fixed external station OD trip matrix was estimated from the SCAG cordon survey, Customs and Border Protection vehicle counts, and Mexican resident border-crossing survey as described in the previous section.<ul> <li>/src/main/emme/toolbox/model/external_external.py</li> </ul> </li> <li>US-SD trips: rates of vehicle trips per household for each external county were developed from the SCAG cordon survey, and the trips were distributed to locations in San Diego County according to a destination choice model estimated from the interregional survey.<ul> <li>Intermediate stops and transit trips are not modeled in this segment due to the small contribution of these events to the total demand in the segment.</li> <li>/src/main/emme/toolbox/model/external_internal.py</li> </ul> </li> </ul>"},{"location":"design/demand/external.html#external-internal-destination-choice-model","title":"External-Internal Destination Choice Model","text":"<p>The external-internal destination choice model distributes the EI trips to destinations within San Diego County. The EI destination choice model explanatory variables are:</p> <ul> <li>Distance</li> <li>The size of each sampled MGRA</li> </ul> <p>Diurnal and vehicle occupancy factors are then applied to the total daily trip tables to distribute the trips among shared ride modes and different times of day.</p>"},{"location":"design/demand/external.html#external-internal-toll-choice-model","title":"External-Internal Toll Choice Model","text":"<p>The trips are then split among toll and non-toll paths according to a simplified toll choice model. The toll choice model included the following explanatory variables:</p> <ul> <li>In-vehicle-time</li> <li>Toll cost</li> </ul>"},{"location":"design/demand/external.html#sources","title":"Sources","text":"<p>information primarily taken from this SANDAG document: link to pdf</p>"},{"location":"design/demand/resident.html","title":"Resident Model","text":"<p>The resident model structure is based on the Coordinated Travel Regional Activity-based Modeling Platform (CT-RAMP). The figure below shows the resident model structure. In order to understand the flow chart, some definitions are required. These are described in more detail below.</p> <ul> <li>Tour: A sequence of trips that start and end at an anchor location. In ActivitySim, anchors are home or work.</li> <li>Primary destination: The \u201cmain\u201d activity of the tour; this activity determines the tour purpose. It also divides the tour into two \u201clegs\u201d; the sequence of trips from the anchor location to the primary destination is the outbound leg, and the sequence of trips from the primary destination back to the anchor location is the inbound or return leg.</li> <li>Mandatory activity: Work or school</li> <li>Non-mandatory activity: Any out of home activity that is not work or school, including maintenance activities such as shopping as well as discretionary activities such as out-of-home recreation and eating out.</li> <li>Fully joint tour: A tour in which two or more household members travel together to all out-of-home activity locations and return home together. In other words, no household member is picked-up or dropped-off en route.</li> <li>Intermediate stop: An out-of-home activity location on the tour other than the anchor location or the primary destination. Intermediate stops are made on the way from the anchor location to the primary destination (outbound) or on the way from the primary destination back to the anchor location (inbound).</li> <li>Tour mode: The \u201cmain mode\u201d or \u201cpreferred mode\u201d of the tour. This is an abstract concept used categorize the tour with respect to accessibility and constrain the availability of modes for trips on the tour to ensure some consistency of modes used for each trip.</li> </ul> <p>The resident model design is shown below.</p> <p></p> <p>The first model in the sequence is disaggregate accessibilities. This is a recent addition to ActivitySim in which the tour destination choice model is run for a prototypical sample population covering key market segments and destination choice logsums from the model are written out for each tour in the population. These destination choice logsums are then merged with the actual synthetic population and used as accessibility variables in downstream models such as auto ownership, coordinated daily activity patterns, and tour frequency. are mandatory location choice; this model is run for all workers and students regardless of whether they attend work or school on the simulated day.</p> <p>Next a set of long-term and mobility models are run. The first model in the sequence predicts whether an autonomous vehicle is owned by the household. This model conditions the next model, which predicts the number of autos owned. If an autonomous vehicle is owned, multiple cars are less likely. Next, the mandatory (work and school) location choice models are run. The work location choice models includes a model to predict whether the worker has a usual out-of-home work location or exclusively works from home. If the worker chooses to work from home, they will not generate a work tour. An external worker identification model determines whether each worker with an out-of-home workplace location works within the region or external to the region. If they work external to the region, the external station is identified. Any primary destination of any work tours generated by the worker will be the external station chosen by this model. A work location choice model predicts the internal work location of each internal worker, and a school location choice model predicts the school location of each student.</p> <p>Next, a set of models predicts whether workers and students have subsidized transit fares and if so, the percent of transit fare that is subsidized, and whether each person in the household owns a transit pass. A vehicle type choice model then runs, which predicts the body type, fuel type, and age of each vehicle owned by the household; this model was extended to predict whether each vehicle is autonomous, conditioned by the autonomous vehicle ownership model.</p> <p>Next, we predict whether each household has access to a vehicle transponder which can be used for managed lane use. We assume that all vehicles built after a certain year (configurable by the user) are equipped with transponders. Next we predict whether each worker has subsidized parking available at work. Finally we predict the telecommute frequency of each worker, which affects downstream models including the daily activity pattern model, the non-mandatory tour frequency model, and stop frequency models.</p> <p>Next the daily and tour level models are run. The first daily model is the daily activity pattern model is run, which predicts the general activity pattern type for every household member. Then Mandatory tours are generated for workers and students, the tours are scheduled (their location is already predicted by the work/school location choice model), a vehicle availability model is run that predicts which household vehicle would be used for the tour, and the tour mode is chosen. After mandatory tours are generated, a school pickup/dropoff model forms half-tours where children are dropped off and/or picked up at school. The model assigns chaperones to drive or ride with children, groups children together into \u201cbundles\u201d for ride-sharing, and assigns the chaperone task to either a generated work tour or generates a new tour for the purpose of ridesharing. Fully joint tours \u2013 tours where two or more household members travel together for the entire tour - are generated at a household level, their composition is predicted (adults, children or both), the participants are determined, the vehicle availability model is run, and a tour mode is chosen. The primary destination of fully joint tours is predicted, the tours are scheduled, the vehicle availability model is run, and a tour mode is chosen. Next, non-mandatory tours are generated, their primary destination is chosen, they are scheduled, the vehicle availability model is run, and a tour mode is chosen for each. At-work subtours are tours that start and end at the workplace. These are generated, scheduled (with constraints that the start and end times must nest within the start and end time of the parent work tour), a primary destination is selected, the vehicle availability model is run, and a tour mode is chosen.</p> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    E --&gt; E2[Single-pay TNC]\n    E --&gt; E3[Shared TNC];\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n    D --&gt; D2[PNR Access]\n    D --&gt; D3[KNR Access]\n    D --&gt; D4[TNC Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n\n    D2 --&gt; D21[Local Only]\n    D2 --&gt; D22[Premium Only]\n    D2 --&gt; D23[Mixed]\n\n    D3 --&gt; D31[Local Only]\n    D3 --&gt; D32[Premium Only]\n    D3 --&gt; D33[Mixed]\n\n    D4 --&gt; D41[Local Only]\n    D4 --&gt; D42[Premium Only]\n    D4 --&gt; D43[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    C --&gt; C2[Bike]\n    C --&gt; C3[E-Scooter]\n    C --&gt; C4[E-Bike]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n</code></pre></p> <p>At this point, all tours are generated, scheduled, have a primary destination, and a selected tour mode. The next set of models fills in details about the tours - number of intermediate stops, location of each stop, the departure time of each stop, and the mode of each trip on the tour. Finally, the parking location of each auto trip to the central business district (CBD) is determined. After the model is run, the output files listed above are created. The trip lists are then summarized into origin-destination matrices by time period and vehicle class or transit mode and assigned to the transport network.</p>"},{"location":"design/demand/visitor.html","title":"Overnight Visitor Model","text":"<p>The Overnight Visitor Model simulates trips of visitors staying overnight in hotels, motels, short-term vacation rentals, and with friends and family. The trips are modeled as part of tours that begin and end at the place of lodging. However, unlike the resident model, the Overnight Visitor Model does not utilize a 24-hour activity schedule. Therefore it can be thought of as a simpler, tour-based model. Once each tour is generated, it is scheduled independently. The model uses the same time periods and modes as the resident model. The overall design of the model is shown in the figure below.</p> <p></p> <ol> <li> <p>Tour Enumeration: A list of visitor parties is generated from the input household data and hotel room inventory at the MGRA level. Visitor travel parties by segment (business versus personal) are calculated based on separate rates for hotels and for households. Visitor parties are generated by purpose based on tour rates by segment, then attributed with household income and party size based on input distributions. There are three purposes in the Overnight Visitor model:</p> </li> <li> <p>Work:  Business travel made by business visitors.</p> </li> <li>Dining: Travel to food establishments for both business and personal visitors.</li> <li> <p>Recreational: All other non-work non-food related activities.</p> </li> <li> <p>Tour Level Models</p> <p>2.1 Tour Scheduling Probabilistic: The tour scheduling model uses a probabilistic draw of the scheduling distribution. This model assigns start and end times to the tour. If there is only one trip per leg on the tour, the trip is assigned the tour start/end time.</p> <p>2.2 Tour Destination Choice: The destination choice model chooses the MGRA of the primary activity location on the tour.</p> <p>2.3 Tour Mode Choice: The tour mode choice model determines the primary mode of the tour.</p> </li> <li> <p>Stop Level Models</p> <p>3.1 Stop Frequency Choice: The stop frequency model predicts the number of stops by direction based on input distributions that vary by tour purpose.</p> <p>3.2 Stop Purpose: The stop purpose model chooses the activity purpose of each intermediate stop based on input distributions that vary according to tour purpose.</p> <p>3.3 Stop Location Choice: The location choice model chooses the MGRA for each intermediate stop on the tour.</p> </li> <li> <p>Trip Level Models</p> <p>4.1 Trip Departure Choice: The trip scheduling model assigns depart times for each trip on a tour based on input distributions that vary by direction (inbound versus outbound), stop number, and number of periods remaining on the tour.</p> <p>4.2 Trip Mode Choice: Each trip is assigned a trip mode, consistent with the modes in the resident model.</p> <p>4.3 Trip Assignment: Trips are aggregated by time of day, mode occupancy, value-of-time, and origin-destination TAZ and assigned simultaneously with other trips.</p> </li> </ol> <p>The major tour modes are shown below: <pre><code>flowchart TD\n    subgraph four\n    direction LR\n    E[Ride-Hail] --&gt; E1[Taxi]\n    E --&gt; E2[Single-pay TNC];\n    end\n    subgraph three\n    direction LR\n    D[Transit] --&gt; D1[Walk Access]\n\n    D1 --&gt; D11[Local Only]\n    D1 --&gt; D12[Premium Only]\n    D1 --&gt; D13[Mixed]\n    end\n    subgraph two\n    direction LR\n    C[Active] --&gt; C1[Walk]\n    end\n\n    subgraph one\n    direction LR\n    B[Auto] --&gt; B1[Drive-alone];\n    B --&gt; B2[Shared 2];\n    B --&gt; B3[Shared 3+];\n    end\n    A[Tour Mode] --&gt; one;\n    A --&gt; two;\n    A --&gt; three;\n    A --&gt; four;\n\n    classDef group1 fill:#f75f5f,stroke:#333,stroke-width:4px,font-size:26px,font-weight:bold;wrap\n    classDef group2 fill:#ffd966,stroke:#333,stroke-width:2px,font-size:20px;wrap\n    classDef group3 fill:#bdabf0,stroke:#333,stroke-width:2px,font-size:18px;wrap\n\n    classDef hiddenTitle color:transparent;\n    class one,two,three,four hiddenTitle;\n\n    class A group1;\n    class B,C,D,E group2;\n    class B1,B2,B3,C1,C2,C3,C4,D1,D2,D3,D4,E1,E2,E3,D11,D12,D13,D21,D22,D23,D31,D32,D33,D41,D42,D43 group3;\n\n</code></pre></p> <p>For more information on the Overnight Visitor Travel Model see technical documentation.</p>"},{"location":"design/init/initialization.html","title":"Initialization","text":""},{"location":"design/init/initialization.html#emme-databases","title":"EMME Databases","text":""},{"location":"design/init/initialization.html#import-network","title":"Import Network","text":""},{"location":"design/init/initialization.html#warmup-trip-tables","title":"Warmup Trip Tables","text":""},{"location":"design/init/initialization.html#bike-logsums","title":"Bike Logsums","text":""},{"location":"design/init/initialization.html#initial-highway-skimming","title":"Initial Highway Skimming","text":""},{"location":"design/init/initialization.html#initial-transit-skimming","title":"Initial Transit Skimming","text":""},{"location":"design/init/initialization.html#transponder-export","title":"Transponder Export","text":""},{"location":"design/init/initialization.html#scenario-management","title":"Scenario Management","text":""},{"location":"design/init/initialization.html#abm-pre-processing","title":"ABM Pre-processing","text":""},{"location":"design/report/report.html","title":"Reporting Framework","text":"<p>Reporting Process Overview:</p> <ol> <li> <p>ABM3 model output files are stored to data lake:</p> <ul> <li>Model outputs are written to the data lake immediately following ABM3 model run completion.</li> <li>Output CSV files are converted to Parquet format before writing to the data lake.</li> <li>Each model run is assigned a unique scenario ID.</li> </ul> </li> <li> <p>Data lake files are loaded to Delta tables:</p> <ul> <li>Each output file in the data lake is loaded into its corresponding Delta table. For example, the trips output file is loaded into the trips Delta table, the persons output file is loaded into the persons Delta table, etc.</li> <li>Delta tables store the results from all model runs, organized by scenario ID.</li> </ul> </li> <li> <p>Delta Tables are processed in Databricks:</p> <ul> <li>Delta tables are read, transformed, and aggregated as needed to support analysis and reporting requirements.</li> <li>Once transformations are complete, the resulting data is written back to the data lake as new Delta tables or used to update existing tables.</li> <li>These new Delta tables are also organized by scenario ID, making it easier to manage and query specific versions of processed data.</li> </ul> </li> <li> <p>Delta tables are ingested by Power BI:</p> <ul> <li>Power BI reads the data from the Delta tables.</li> <li>Power BI report templates with various metrics of interest are automatically refreshed with new model run outputs.</li> <li>Metrics can easily be compared across different scenario IDs.</li> </ul> </li> </ol>"},{"location":"design/supply/index.html","title":"Supply Design","text":"<p>Details of supply components of the model.</p>"},{"location":"design/supply/bike-logsums.html","title":"Bike Logsums","text":"<p>Details of bike logsum calculations.</p>"},{"location":"design/supply/highway-skims-assign.html","title":"Highway Skimming and Assignment","text":"<p>Details of highway skimming and assignment.</p>"},{"location":"design/supply/network-import-tned.html","title":"Network Import from TNED","text":"<p>This section describes the procedure by which the ABM3 model system imports (into Emme) network (highway and transit) files along with a general description of the different network files.</p>"},{"location":"design/supply/network-import-tned.html#network-files","title":"Network Files","text":"<p>The ABM3 model system has been configured to be compatible with SANDAG\u2019s Transportation Network Editing Database (TNED) system, which is utilized to edit, maintain and generate transportation networks. The TNED network files, generated via an ETL (i.e., Extract, Tranform, Load) procedure, serve as inputs to the ABM3 model system\u2019s import network procedure and are produced in text file, shapefile, geodatabase table and geodatabase feature class geodatabase formats. There are, additionally, some non-TNED input network files which are manually maintained.</p> <p>The following are the required network files used during the Emme import network procedure:</p> File Source Description EMMEOutputs.gdb/TNED_HwyNet TNED Roadway network links EMMEOutputs.gdb/TNED_HwyNodes TNED Roadway network nodes EMMEOutputs.gdb/TNED_RailNet TNED Rail network links EMMEOutputs.gdb/TNED_RailNodes TNED Rail network nodes EMMEOutputs.gdb/Turns TNED Turn prohibition records special_fares.txt Manually Maintained Special fares in terms of boarding and incremental in-vehicle costs timexfer_{time_of_day}.csv Manually Maintained Timed transfer pairs of lines, by period. Where time_of_day refers to EA, AM, MD, PM, or EV. trrt.csv TNED Attribute data (modes, headways) for the transit lines trlink.csv TNED Sequence of links (routing) for the transit lines trstop.csv TNED Stop data for the transit lines MODE5TOD.csv Manually Maintained Global (per-mode) transit cost and perception attributes vehicle_class_toll_factors.csv Manually Maintained Factors to adjust the toll cost by facility name and class"},{"location":"design/supply/network-import-tned.html#import-network-procedure","title":"Import Network Procedure","text":"<p>This section describes the main steps carried out during the Emme import network procedure. The entire process is executed by the import_network.py script.</p>"},{"location":"design/supply/network-import-tned.html#create-modes","title":"Create Modes","text":"<p>This step creates the different combinations of traffic and transit modes that will get applied to the network links. A mode defines a group of vehicles or users which have access to the same parts of the network. Modes are used in both the traffic and transit assignments to define the available network for each class of demand. Each mode is uniquely identified by a single case-sensitive character. The modes which have access to a given link are listed on that link, and each link must allow at least one mode.</p>"},{"location":"design/supply/network-import-tned.html#create-roadway-base-network","title":"Create Roadway Base Network","text":"<p>This step creates the base roadway network by importing it from the EMMEOutputs.gdb/TNED_HwyNet and EMMEOutputs.gdb/TNED_HwyNodes. The nodes and links (referred to as the base network in Emme) for the traffic network are imported from the TNED_HwyNode and TNED_HwyNet geodatabase feature classes. The nodes are created first and the links connect between them. The I-node (from node, field AN) and J-node (to node, field BN) are used to associate the nodes and links and uniquely identify the link in the Emme network. Separate forward (AB) and reverse (BA) links are generated for links that have been coded as two-way. </p>"},{"location":"design/supply/network-import-tned.html#create-turns","title":"Create Turns","text":"<p>This step processes the EMMEOutputs.gdb/Turns input network file to generate turn restrictions by to- and from- link ID. If the indicated link IDs do not make a valid turn (links not adjacent) an error is reported.</p>"},{"location":"design/supply/network-import-tned.html#calculate-traffic-attributes","title":"Calculate Traffic Attributes","text":"<p>This step calculates derived traffic attributes. It utilizes the vehicle_class_toll_factors.csv to adjust toll costs by facility name and class.</p>"},{"location":"design/supply/network-import-tned.html#check-zone-access","title":"Check Zone Access","text":"<p>This step verifies that every centroid has at least one available access and egress connector.</p>"},{"location":"design/supply/network-import-tned.html#create-rail-base-network","title":"Create Rail Base Network","text":"<p>This step creates the base roadway network by importing it from the EMMEOutputs.gdb/TNED_RailNet and EMMEOutputs.gdb/TNED_RailNodes. The nodes and links (referred to as the base network in Emme) for the rail network are imported from the TNED_RailNode and TNED_RailNet geodatabase feature classes. The nodes are created first and the links connect between them. The I-node (from node, field AN) and J-node (to node, field BN) are used to associate the nodes and links and uniquely identify the link in the Emme network. Separate forward (AB) and reverse (BA) links are generated for links that have been coded as two-way. </p>"},{"location":"design/supply/network-import-tned.html#create-tranist-lines","title":"Create Tranist Lines","text":"<p>This step creates the transit lines by importing them from the trrt.csv, trlink.csv and trstop.csv input network files and matched to the transit base network. The mode-level attributes from MODE5TOD.csv, which vary by mode, are copied to transit line attributes and used in  transit assignment. It is in this step also where the timexfer_{time_of_day}.csv files are used to explicitly set route-to-route specific transfer transit times.</p>"},{"location":"design/supply/network-import-tned.html#calculate-transit-attributes","title":"Calculate Transit Attributes","text":"<p>The transit line and stop / segment attributes (including fares) are imported to Emme attributes. The special_fares.txt lists network-level incremental fares by boarding (line and/or stop) and in-vehicle segment. They specify additive fares based on the network elements encountered on a transit journey and are used to represent the Coaster (or other) zonal fare system.</p>"},{"location":"design/supply/transit-skims-assign.html","title":"Transit Skimming and Assignment","text":"<p>The transit assignment uses a headway-based approach, where the average headway between vehicle arrivals for each transit line is known, but not exact schedules. Passengers and vehicles arrive at stops randomly and passengers choose their travel itineraries considering the expected average waiting time.</p> <p>The Emme Extended transit assignment is based on the concept of optimal strategy but extended to support a number of behavioral variants. The optimal strategy is a set of rules which define sequence(s) of walking links, boarding and alighting stops which produces the minimum expected travel time (generalized cost) to a destination. At each boarding point the strategy may include multiple possible attractive transit lines with different itineraries. A transit strategy will often be a tree of options, not just a single path. A line is considered attractive if it reduces the total expected travel time by its inclusion. The demand is assigned to the attractive lines in proportion to their relative frequencies.</p> <p>The shortest \u201ctravel time\u201d is a generalized cost formulation, including perception factors (or weights) on the different travel time components, along with fares, and other costs / perception biases such as transfer penalties which vary over the network and transit journey.</p> <p>The model has four access modes to transit (walk, park-and-ride (PNR), kiss-and-ride (KNR), and Transportation Network Company (TNC)) and three transit sets (local bus only, premium transit only, and local bus and premium transit sets), for 12 total demand classes by 5 TOD. These classes are assigned by slices, one at a time, to produce the total transit passenger flows on the network.</p> <p>While there are 12 slices of demand, there are only three classes of skims: Local bus only, premium only, and all modes. The access mode does not change the assignment parameters or skims.</p>"},{"location":"design/supply/walk-skims.html","title":"Walk Skims","text":"<p>Details of walk skim calculations.</p>"}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 0375065e6..9d47b3fef 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,152 +2,152 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://sandag.github.io/abm/index.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/cvm.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/faq.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/inputs.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/outputs.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/release-notes.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/running.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/applying.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/ev-rebates.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/flexible-fleets.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/landuse-prep.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/micromobility.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/network-coding.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/population-synthesis.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/application/scenario-manager.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/design.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/index.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/airport.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/crossborder.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/external.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/resident.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/demand/visitor.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/init/initialization.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/report/report.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/index.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/bike-logsums.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/highway-skims-assign.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/network-import-tned.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/transit-skims-assign.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://sandag.github.io/abm/design/supply/walk-skims.html</loc>
-         <lastmod>2024-11-12</lastmod>
+         <lastmod>2024-11-14</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index c4bcce34680ddf00a4b4bb94b3310a38d29b2e07..2b7fd4be203e6788334777c32767b060bb468b5e 100644
GIT binary patch
literal 487
zcmV<D0T})tiwFoaOEzZ$|8r?{Wo=<_E_iKh0M*yQj+-zL0MPq>Ma12ZtoG1W347Zw
zXg^?p35;ToS<etczrGHkReJ2DvN^=YnpjWPFbv1{o3pzs1|iR<;!y639dheC;{H_p
z`2JzO6z}!RaSB#YcQKgdR1B))x2l@wxfD`#FiPn|Ur9T}8>zO%YF~aW>X%)-?i)O2
z>vgogt?#=?+(v*q=*ymTn3|G&1&ynSJG_;HI(w|{!O#B%QRln*b^rQi4hM61iy_<E
zQ&>9y_jnHYS$9BoIaW_A4^;I>_0PWc>JrwS;WJ?!@i?g@4D^#GE(~Z91Pyz|q@5FU
zEF}pGVH_>Bpt1g~^CcfHUQNIT($0Wq@Y&*x8jB`QP;*h+7%;_WZ45YOLUz;!?|eg+
zbjifbsIw0j^JqRYL63f%>^e2Funs7cOIk~d41v6Hz|dnznBB!=?Rgt=aK<C;l5b)E
z)&hmm2hGMC3!F&fLzhS9u4cR`1_qlAIK;aSIiIY!QvCMx8Ds=8>H0%p>E~LJ(?`b!
zD3*wANS`ayy`Rse4sY6qE@-UpWpa`YdZ2!oVKH(cCk7;s_w<JU-FT9_r?pYWE*rZB
d;8^kUJop*x<stt+<aH3#`WM^WxefLd000_f@go2L

literal 486
zcmV<C0U7=uiwFp7#4~3C|8r?{Wo=<_E_iKh0M*yQ&YLg{0O0%o6czVCTkWt-E&pv#
zuswhQ7px`@e{4$G(=VlL>W;fi35O;`ZuBWK#+=^o&hBm)ggl>%L%A<@$gS^)`*ZQ*
z`#1Bsc(311Q?P=%i@_}CVo)8wR@FSurI4b7QA!{BO4=dbNVP3i`|?XszwP4n*x)%^
zuaos{{n$m~HUiv1U-qQK)Rg2aXk10y;k_Kx*;Dlhe*G_qI^WgD{qd7I9L(VuL$<Y-
zuyz3M@e=T(?ttuas$N!}sOpdEpMCAkC9J!^N5VSdaZ*Vb=qF8F7|<dJ8up4wJ16E?
zN)i^rI9h5!WBps_OFmq@nSc$XodK`li^V%N7EPR>=AyPSV2aP$7;wyl?5GXi`Gzd%
zl8Kp7XCJQS*?eSz9{o7kb!uc`9Z)Ejw3Zeb0(s+rp~sLgyNk!#^ETw*j7Qof-@^W_
z1q!1NnvFLWIFZJOE|1Jz&3IP~3^p5Zh<6=wK3Q?2`0eR4$OvN6^@qUH&$S|_kB$vc
zED_s~K3AqkKc7n--n0!}(OBQh<RlyPK>aYoV&qCr3`idD=?(w8@g(<1Yom-^Hg*lb
cvEt=<@H5!!Q~rO*>maE0FOxxv@Aeb`01Z3*00000