Development of the ITHIM-R, also known as ITHIM version 3.0. Started in January 2018.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
R changes to input parameters and summary function call file produced Feb 20, 2019
code Fix trip id and add dest and origin walk as new trips Feb 14, 2019
tests changes to input parameters and summary function call file produced Feb 20, 2019
.gitignore Ignore sub-folders of rprof.user Jul 10, 2018
NAMESPACE moved error handling function Feb 11, 2019 ithim.rd file Oct 23, 2018
accra_master_script.R uncertainty for injury linearity Feb 13, 2019
ithim_r_function_descriptions.Rmd Update ithim_r_function_descriptions.Rmd Nov 6, 2018
ithim_r_function_descriptions.html function descriptions Oct 22, 2018

html_document pdf_document


Development of the ITHIM-R, also known as ITHIM version 3.0. Started in January 2018.

This document aims to be a comprehensive record of the calculations in the ITHIM pipeline, specifically the ITHIM- R package. Some details here are specific to the Accra version of that model, as Accra has been the setting for construction of the prototype.


In this document, in general, lower-case letters correspond to indices, or dimensions, of objects, and take one of a set of possible values, detailed in Table 1 (Convert from LATEX).

The set of fixed input data items are denoted by capital letters, and variable parameters are denoted by greek letters. These are tabulated in Table 2 (Convert from LATEX).

Data inputs

In general ITHIM-R requires X number of user defined inputs from various data sources. There are also numerous assumptions that you can parameterize in the model.


  • Synthetic Population
    • Travel survey
    • Leisure time and work physical activity
  • Who Hit Who Matrix
    • Police report data
  • Air Pollution
    • Background concentrations of PM2.5
    • Source apportionment of PM2.5 for vehicles
    • Country or City specific Vehicle Emissions Factors

Synthetic Population

Description The first input you will need to provide is the synthetic population data. This data typically comes from a household travel survey or travel time use survey, and a self-report leisure time physical activity survey. These data will be uses throughout the process.

Synthetic Population Dataset Format You should have a table with the following variables

  • trip_id
  • trip_mode
  • trip_duration
  • participant_id
  • age
  • sex
  • age_cat
  • ltpa_marg_met
  • work_marg_met

Montreal Synthetic Population Dataset Example

Who Hit Who Matrix

Description TEXT HERE

Who Hit Who Matrix Dataset Format A matrix

Montreal Who Hit Who Matrix Dataset Example

Air Pollution

Description TEXT HERE

Air Pollution Dataset Format A matrix

Montreal Air Pollution Dataset Example

We are currently working on developing a separate package to create a synthetic population

For further documentation consult the wiki. For ongoing discussions, see issues. In addition, relevant documents are stored in shared GDrive folder, and a Slack channel is available for communications among contributors.

See communication channels on Wiki

Related Repositories