The primary ActivitySim example model.

The prototype_mtc example is based on (but has evolved away from) the Bay Area Metro Travel Model One, also known as "TM1". TM1 has its roots in a wide array of analytical approaches, including discrete choice forms (multinomial and nested logit models), activity duration models, time-use models, models of individual micro-simulation with constraints, entropy-maximization models, etc. These tools are combined in the model design to realistically represent travel behavior, adequately replicate observed activity-travel patterns, and ensure model sensitivity to infrastructure and policies. The model is implemented in a micro-simulation framework. Microsimulation methods capture aggregate outcomes through the representation of the behavior of individual decision-makers.

There are two model structures in the prototype_mtc example: a simpler model that is relatively close to the TM1 model, and a more complex model that is incorporates new model components that have been added by the ActivitySim consortium over the past few years.

See https://activitysim.github.io for more information.

The following short Python script will download and prepare the example data for the prototype_mtc_extended example model.

from pathlib import Path
from activitysim.examples.external import download_external_example

example_dir = download_external_example(
  name="prototype_mtc_extended", 
  working_dir=Path.cwd(),
  url="https://github.com/ActivitySim/activitysim-prototype-mtc/archive/refs/heads/extended.tar.gz",
  assets={
    "data_full.tar.zst": {
      "url": "https://github.com/ActivitySim/activitysim-prototype-mtc/releases/download/v1.3.4/data_full.tar.zst",
      "sha256": "b402506a61055e2d38621416dd9a5c7e3cf7517c0a9ae5869f6d760c03284ef3",
      "unpack": "data_full",
    },
    "test/prototype_mtc_reference_pipeline.zip": {
      "url": "https://github.com/ActivitySim/activitysim-prototype-mtc/releases/download/v1.3.2/prototype_mtc_extended_reference_pipeline.zip",
      "sha256": "4d94b6a8a83225dda17e9ca19c9110bc1df2df5b4b362effa153d1c8d31524f5",
    }
  }
)

The prototype_mtc example model is run using the activitysim command line tool. A quick and easy way to run the model for benchmarking is to use the following command:

cd activitysim-prototype-mtc-extended
activitysim workflow performance-benchmarking