ITHIM R modules

Below modules define the ITHIM-R project structure. They may or may not have equivalents in the tool interface structure.
The first set of modules roughly follows the tool work flow (workflow here refers to the main, linear flow from inputs to outputs. Think of it as a highly simplified architecture. Also see master flow chart).
At the bottom, overarching modules are listed. These affect multiple of the workflow modules.
The module names will be a key part of project and tool nomenclature (i.e. the bold names will referred to in GitHub projects, GitHub issue labels, Wiki pages, Call topics, etc.

1. Data Sources (Everything related to external data, i.e. user input data, generic data used by the tool, and their various formats, implications, metadata)

2. Data Localization (The process of adjustments, calibration of international, national data to local settings of a specific ITHIM application. This may include spatial scaling, temporal extrapolation, adjustment for population attributes, etc.)

3. Data Harmonization (The process of conversion or matching of various data formats and variable definitions of external data to the generic data formats used in ITHIM (e.g. mode categories))

4. Synthetic Baseline Data (i.e. individual data, vehicle data, crash data)

   1. The process of creating a Synthetic population (sample of 10k individuals), through probabilistic matching of separate input data from population, travel, and health surveys, for baseline.
   2. The creation of a Vehicle distance dataset based on travel behaviour, occupancy factors, and transport statistics, for baseline.
   3. The creation of a Who-hit-whom matrix based on crash statistics, for baseline.

5. Scenario Definition (Creation of "Synthetic counterfactual data") (2 options:)

   1. Manipulation of baseline data through a Scenario definition module (interface or code).
   2. Creation of Synthetic scenario data, based on local data sources, analogous to steps for baseline data above.

6. Environmental Impacts Calculations

   1. Carbon emissions
   2. Background AP concentration (i.e. as affected under scenario conditions)

7. Exposure Calculations for each scenario (for baseline only as needed beyond Synthetic Baseline Data)

   1. Exposure calculation for PA (calculation of total METhrs/week or similar)
   2. Exposure calculation for AP (calculation of long term exposure equivalents, PM2.5,..)

8. Impact Calculations

   A. Health Impact Calculations (PA, AP)

   1. Calculation of Potential Impact Fractions (PIFs)
   2. Application of PIFs (or PAFs) to either:
      1. GBD-derived rates of various outcomes (YLL, YLD, deaths), or
      2. Proportionate Multi-State Life Table calculations

   B. Injury Impact Calculations (Crashes)

   1. Events Calculation based on Who-hit-whom matrix
   2. Conversion of injury events into various units of disease burdens (e.g YLLs)

9. Impacts Presentations (outcome definitions, level of detail, aggregation, visualization)

   1. combined pathway results
   2. pathway specific

10. Overarching modules

    1. User interface (including data visualization, explortation and validation features)
    2. Website contents/documentation
    3. Tool Parameters ("is the math being done in miles or km?" A central place for default values, units, constants, assumptions to be called by various tool elements)

11. Overarching project domains

    1. Coding guidelines
    2. Documentation
    3. Scientific publications
    4. Dissemenination
    5. Case studies/applications