Modelling in PTM

Modelling a project scenario within PTM involves the following key steps:

  1. Inputs:
    • Project Setup – Prepare PTM schema folder.
    • Project Data Processing – Creation and storage of base network, transit network, and demand matrices ready for import into EMME through a series of Jupyter notebooks.
  2. Assignment – Assigning the demand to the network within EMME.
  3. Outputs – Validation and output workflows, including complementary Tableau dashboards.

The PTM model structure for a PTM run, including model inputs, model interactions and outputs, is shown below.

PTM Overview

PTM Folder Structure

This model structure is mapped onto the following folder structure within PTM;

+-- ptm
|   +-- 100_input_workflows
|   +-- 200_assignment_workflows
|   +-- 300_validation_workflows
|   +-- 400_output_workflows
|   +-- assets
|   +-- ptm
|   +-- schemas

These folders include;

  • 100_input_workflows - core input workflows (as Jupyter notebooks) for PTM, including processes to generate the base demand and networks for a PTM run
  • 200_assignment_workflows - main assignment script to execute models within EMME
  • 300_validation_workflows - validation notebooks for both network and model validation of PTM
  • 400_output_workflows - standard model output notebooks for PTM, including processes to obtain processed results into Tableau dashboards.
  • assets - a series of core assets for PTM, including configuration files, parameter files etc
  • ptm - the core source code for PTM including all code required for modelling in EMME
  • schemas - each PTM run is stored within a ‘schema’ folder containing all data about that run, including EMME files, inputs and output files

PTM Input Notebooks

PTM Input Notebooks (‘100_input_workflows’) have been organised into the following folder structure:

+-- ptm
|   +-- 100_input_workflows
|   |   +-- 110_Project_Setup
|   |   +-- 120_Project_Data_Processing
|   |   |   +-- 121_base_network
|   |   |   +-- 122_transit_network
|   |   |   +-- 123_demand
|   |   +-- 130_Database_Setup

These folders provide the core input processes for PTM, and include:

  • 110_Project_Setup - notebooks to initially build a PTM schema folder and obtain all default parameter files and configurations for the run
  • 120_Project_Data_Processing - notebooks to build the key inputs for a PTM run. This includes base network, transit network and demand inputs
  • 130_Database_Setup - supporting notebooks to upload a schema to the internal TMR PostgreSQL database

More information on Database and Project Setup (and their respective notebooks) is included within this section.