From 3650eb9e5a6819d7e2b2a45a7a4e01c4ee264763 Mon Sep 17 00:00:00 2001 From: usr110 Date: Wed, 27 Mar 2024 10:30:03 +0000 Subject: [PATCH] Built site for ithimr: 0.1.2@ --- articles/how-to-run-ITHIM.html | 7 +- index.html | 2 +- pkgdown.yml | 2 +- reference/extract_data_for_voi.html | 152 ++++++++++++++++++ .../figures/disease_interaction_table.png | Bin 0 -> 39255 bytes .../multi_city_script_specifcy_cities_gh1.png | Bin 50601 -> 0 bytes reference/index.html | 5 + search.json | 2 +- sitemap.xml | 3 + 9 files changed, 166 insertions(+), 7 deletions(-) create mode 100644 reference/extract_data_for_voi.html create mode 100644 reference/figures/disease_interaction_table.png delete mode 100644 reference/figures/multi_city_script_specifcy_cities_gh1.png diff --git a/articles/how-to-run-ITHIM.html b/articles/how-to-run-ITHIM.html index b6f04547..81d2ebd4 100644 --- a/articles/how-to-run-ITHIM.html +++ b/articles/how-to-run-ITHIM.html @@ -304,11 +304,10 @@
Global files (global input which do not change across cities/ applied similarly to all cities and are hence referred to as “Global”, such as:

diff --git a/pkgdown.yml b/pkgdown.yml index 1f128ba6..3061996f 100644 --- a/pkgdown.yml +++ b/pkgdown.yml @@ -3,7 +3,7 @@ pkgdown: 2.0.7 pkgdown_sha: ~ articles: how-to-run-ITHIM: how-to-run-ITHIM.html -last_built: 2024-03-18T14:11Z +last_built: 2024-03-27T10:28Z urls: reference: https://ithim.github.io/ITHIM-R/reference article: https://ithim.github.io/ITHIM-R/articles diff --git a/reference/extract_data_for_voi.html b/reference/extract_data_for_voi.html new file mode 100644 index 00000000..075b537c --- /dev/null +++ b/reference/extract_data_for_voi.html @@ -0,0 +1,152 @@ + +Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi • ithimr + Skip to contents + + +
+
+
+

Get ITHIM-results into correct format for VoI analysis

+ Source: R/extract_data_for_voi.R +
extract_data_for_voi.Rd
+
+ +
+

This function extracts the relevant information from the multi_city_ithim object and gets the results into +the correct format for further analysis.

+
+ +
+

Usage

+ 
extract_data_for_voi(
+  NSCEN,
+  NSAMPLES,
+  SCEN_SHORT_NAME,
+  outcome_age_groups,
+  cities,
+  multi_city_ithim
+)
+
+ +
+

Arguments

+
NSCEN
+

number of scenarios (not incl. baseline)

+ + +
NSAMPLES
+

number of model runs per city

+ + +
SCEN_SHORT_NAME
+

names of the scenarios (incl. baseline)

+ + +
outcome_age_groups
+

outcome age groups as defined as input parameters to the model

+ + +
cities
+

list of cities for which the model was run

+ + +
multi_city_ithim
+

list containing the ithim model information including results for the various model runs

+ +
+
+

Value

+ + +

ithim_results list with the following objects:

+ + +

summary_ylls_df: dateframe with total ylls (median, 5th and 95th percentiles) per age group and city (plus combined results)

+ + +

voi_data_all_df: dataframe for all cities with all outcomes for all model runs, age groups and disease and scenario combinations

+ + +

yll_per_hundred_thousand: yll per 100,000 people for each city, outcome age category, model run and disease and scen combination

+ + +

yll_per_hundred_thousand_stats: total ylls per 100,000 (median, 5th and 95th percentiles) as sum across all disease per outcome age group, scenario and city (plus combined results)

+ + +

outcome: total yll outcome for all outcome age categories per city and scenario and disease combination, also combined city result (sum)

+
+
+

Details

+

The function performs the following steps:

+

  • by looping through the cities:

    +

    • calculate average outcome (yll) per person in the population considered by the model

      • +

    • calculate the total ylls per 100 000 for each outcome age category, scenario and disease combination and model run

      • +

    • calculate total yll outcome across all outcome age categories per city and scenario and disease combinations

      • +

    • create one dataframe for all cities with all outcomes for all model runs, age groups and disease and + scenario combinations

      • +
    • +

  • compute yll per hundred thousand by outcome age group by summing across all diseases (double counting!) + by city and scenario and also summing across all cities

    • +

  • create one dateframe with total ylls (median, 5th and 95th percentiles) per age group and city + (plus combined results as sum across all cities)

    • +
+ +
+ + +
+

Developed by Ali Abbas, Anna Schroeder, Daniel Gil, Lambed Tatah, Rob Johnson.

+
+ +
+

Site built with pkgdown 2.0.7.

+
+ +
+ + + + + + + diff --git a/reference/figures/disease_interaction_table.png b/reference/figures/disease_interaction_table.png new file mode 100644 index 0000000000000000000000000000000000000000..88e12c2c0f664ba7cb627f957a520d2b15cfcef0 GIT binary patch literal 39255 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:S$jYJlwz6TDYyA;z`0yNg6@c_Gy1<@xE4%F2 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 bncWjAhaw^~208TintCFu{17hv^!5J&$ccc0 diff --git a/reference/index.html b/reference/index.html index d40700ee..313ebaff 100644 --- a/reference/index.html +++ b/reference/index.html @@ -170,6 +170,11 @@

Others<
Get distances and duration summaries by mode
+ extract_data_for_voi() +
+
Get ITHIM-results into correct format for VoI analysis
+
+ gen_ap_rr()
Get relative risk for diseases given PM exposure
diff --git a/search.json b/search.json index 4174152f..36ace6f5 100644 --- a/search.json +++ b/search.json @@ -1 +1 @@ -[{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"how-to-run-ithim-global","dir":"Articles","previous_headings":"","what":"How to run ITHIM-Global","title":"How to run ITHIM","text":"guide explain install ITHIM-R package, run model ITHIM-Global using package produce summaries key results. Please note guide written Windows 10 work similarly different operating systems. using latest R version - time writing, R version 4.3.3 (2024-02-29).","code":""},{"path":[]},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"pre-requisites","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Pre-requisites","title":"How to run ITHIM","text":"following programmes need installed ITHIM-R package can used: Git R - version 4.3.3 (2024-02-29) R Studio","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"cloning-the-github-repository","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Cloning the Github repository","title":"How to run ITHIM","text":"clone (.e. download) ITHIM-R Github repository, open command window pressing button Git tab, press New Terminal terminal window appear navigate folder want install repository type: Note: ’d like install just latest version ignoring history, may use --depth 1 parameter, : much quicker install. Github repository now downloaded computer working branch - default branch, set bogota documentation refers .","code":"git clone https://github.com/ITHIM/ITHIM-R.git git clone https://github.com/ITHIM/ITHIM-R.git --depth 1"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"installing-the-package-in-rstudio","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Installing the package in RStudio","title":"How to run ITHIM","text":"open ITHIM-R package RStudio double click ITHIM-R.Rproj file inside ITHIM-R folder saved computer. open package RStudio.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"install-all-dependent-packages","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package > Installing the package in RStudio","what":"Install all dependent packages","title":"How to run ITHIM","text":"install ITHIM package, need make sure dependent packages already installed computer. process continue, please make sure already installed renv package. installed, please run command console: install package see message package renv successfully unpacked MD5 sums checked completed, may use package renv verify/check already dependent R packages ithim locally installed computer. , please run command: case missing date packages, display list , may run restore function updated/installed, : update install required packages.","code":"install.packages(\"renv\") renv::status() renv::restore()"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"install-the-ithim-r-package","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package > Installing the package in RStudio","what":"Install the ITHIM-R package","title":"How to run ITHIM","text":"install ITHIM-R package RStudio, following steps need performed: 1.) Git installed Build tab top right hand corner RStudio. Click tab Install panel . get newest updates Bogota branch, go Git tab RStudio next Build tab click Pull. automatically download newest changes Github. update ITHIM-R package computer, need go Build tab click Install . (Alternatively, code none input files changed, instead clicking Install, can also click Load option exists , .e. devtools installed. faster way update package work minor code changes.) recommended pull install newest updates regular basis.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"running-ithim-global","dir":"Articles","previous_headings":"How to run ITHIM-Global","what":"Running ITHIM-Global","title":"How to run ITHIM","text":"run ITHIM-Global using ITHIM-R package various input files parameters need updated first. multi_city_script.R can used call core functions required run ITHIM-R. Note multi_city_script.R set run ITHIM-Global various cities one go required looping cities one one.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"update-input-parameters","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Update input parameters","title":"How to run ITHIM","text":"several input parameters files need updating running ITIHM-Global: 5 files specific city saved directory city’s name. (See inst/ext/local/bogota example files also information). files need saved inst/extdata/local/‘city’ folder, city replaced appropriate city name. file containing various input parameters cities code run saved ITHIM-R folder. branch, file called Bogota_InputParameters_vxx.xlsx, vxx refers latest version number file. contains input parameters Bogota can easily extended contain input parameter values various cities, using format structure shown sheet. global datasets - exposure-response relationships air pollution pathway. files can found inst/extdata/global folder usually need changed, unless user different preferences. See information.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"city-specific-files-local-input-parametersdatasets-","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Update input parameters","what":"City-specific files (local input parameters/datasets).","title":"How to run ITHIM","text":"section covers 5 city-specific input files required run model. Travel survey (example trips dataset). table trips taken group people given weekday. also includes people take trips. data come official travel survey city possible. One row per trip (stage trip) Minimal columns: participant_id, age, sex, trip_mode, trip_duration (trip_distance) columns: stage_mode, stage_duration (stage_distance) Injury events (example injuries dataset). table recorded road-traffic injury (fatality) events city one years.NOV refers Vehicle. One row per event Minimal columns: victim mode (cas_mode) strike mode (strike_mode) columns: year, cas_age, cas_gender, weight (weight column give number years data exists year information given) Baseline mortality years life lost (example dataset). gives burden mortality years life lost (YLL) different causes mortality YLL. city-specific information exists, country level information can used. One row per health outcome/metric/age/gender combination Minimal rows: Measure (death/YLL); sex_name (Male/Female); age_name (‘x y’); cause_name (health outcome names); val (value burden); population (number people val corresponds , e.g. population country) Population city (example population dataset). information used scale baseline mortality YLL data country’s value city’s population study. One row per demographic group Columns: sex, age, population age column share boundaries age_name baseline mortality YLL data, can aggregated. Physical activity survey (example physical activity dataset). used represent physical activity levels city taken official physical activity survey city possible. One row per person Columns: sex, age, ltpa_marg_met (background non-transport, non-occupational weekly PA volume mMETS hours)","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"global-files-global-input-parametersdatasets","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Update input parameters","what":"Global files (global input parameters/datasets)","title":"How to run ITHIM","text":"order setup model, need fixed list tables/datasets, change across cities/ applied similarly cities hence referred “Global”, : Health outcome interaction table. table list health outcomes related specific pathway Air Pollution Physical Activity also interaction . Air Pollution Exposure Response Functions (ERFs). give exposure-response relationships air pollution (PM2.5) impact health different health outcomes. collected/cleaned datasets published studies . Physical Activity Dose-Response Functions (DRFs). dose-response relationships physical activity impact health different health outcomes. Similar air pollution, comes published studies. now sits independent R package called drpa. Ventilation rate tables. data can found inst/extdata/global/ventilation_rate details distribution parameters required estimate much air inhaled different people across different activities model’s baseline population.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"call-multi_city_script-r","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Call multi_city_script.R","title":"How to run ITHIM","text":"order run ITHIM-R installed various input files described updated, open multi_city_script.R file within RStudio. file can found Files tab middle pane right hand side. key script run ITIHM-Global constant mode (.e. keeping input parameters fixed, without sampling input parameters distributions). reads required datasets initialises variables calling run_ithim_setup runs model calling run_ithim. First, update parameter values beginning script set-e.g. city / cities script run. can found Line 63 set ‘bogota’ worked example. https://github.com/ITHIM/ITHIM-R/blob/de2a88548af6c6be5eb36d939e178b146d1ba055/multi_city_script.R#L63 several city names given vector, model performs ITHIM-R analysis one city another. parameter values updated, click Source model run. produces pop-windows showing plots results giving years life lost scenario required health outcomes.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"ithim_objects","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"ithim_objects","title":"How to run ITHIM","text":"ithim_objects list saved results/multi_city/io_“,output_version,”.rds, output_version currently set SHA number (.e. unique identifier) latest update Github can also updated manually user multi_city_script.R. may view using command View(ithim_objects) show content : may click individual sub-items bogota information. list contains comprehensive set intermediate final results model run: city modelled contains following data: trip_scen_sets: trip data scenarios baseline population, .e. population sample built combining household travel survey physical activity survey data. dist: total stage mode distances mode scenario (including baseline) baseline population. dur: total stage mode durations mode scenario (including baseline) baseline population. true_dist: distances trip data scaled total distance travelled baseline population city (age ranges considered model ) scenario (including baseline) mode transport. inj_distances: true_distances: city baseline population mode distances age category sex considered model. injuries_list: scenarios (including baseline) two lists given, one whw (-hit-) injuries strike casualty mode known one nov (vehicle) injuries strike vehicle involved crash lists contain casualty (strike) mode combinations age category sex. Furthermore, detail casualty (strike) mode distances travelled entire city baseline population considered model (‘_sum’) just respective age sex category. also detail casualty (strike) mode exponents used injury Poisson regression model. reg_model: parameterised Poisson injury regression model injuries. injuries_for_model: baseline data containing fatality counts casualty strike mode combinations associated city’s baseline population distance data (true_distances explained ) . demographic: city population counts age categories sex combinations considered model. synth_pop: population extracted physical activity survey assigning non-transport, non-occupational PA component physical activity values mMETs hours per person per week. outcomes: mmets: Marginal MET values person baseline population scenario. pm_conc_pp: PM2.5 concentration attributed person baseline population scenario (including baseline). co2_emission_inventory: total CO2 emission levels mode transport scenario (including baseline). ref_injuries: number injury deaths years life lost age sex category baseline scenario including upper lower confidence interval values hb: health burden (deaths years life lost (YLL) two separate dataframes) age sex category health outcome using combined result health outcomes impacted air pollution physical activity levels. pathway_hb: health burden (deaths years life lost (YLL) two separate dataframes) age sex category health outcome keeping results health outcomes impacted air pollution physical activity levels separate. whw: number fatalities strike casualty modes -hit---vehicle injuries scenarios (including baseline). disease_burden: health outcome burden health outcomes baseline scenario (deaths years life lost) age sex categories considered model (input data). PM_emission_inventory: PM emission inventory mode transport baseline scenario (input data). injury_table: summarised total road fatality counts injury input data age sex category strike casualty mode years (weight column) given input data whw (-hit-) nov (--vehicle) injuries. vehicle_inventory: gives speed CO2 PM2.5 emissions inventories vehicles baseline scenario. location: country continent information. new_walk_trips_count: number rail bus trips additional walking stage added model run. Scen_prop: proportion trips mode converted distance category scenario. Ithim_run: information ITHIM-R run name input parameters file, name scenario definition used, baseline scenario, scenario names, computation mode (constant sample), timestamp model run, output version number, author model run additional comments particular model run.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary-of-key-results","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Summary of key results","title":"How to run ITHIM","text":"various scripts can used produce output summary tables results: three markdown documents (root folder, shown ) producing html csv files: summary_tables.Rmd summary_tables_PA_AP.Rmd injury_tables.Rmd Note: please execute command run (knit) three documents - produce html files along necessary CSV files (stored results subfolder) Shiny application creating Pivot table: app.R results_app folder","code":"source(\"Create_output_summaries.R\")"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"producing-the--rmd-file-outputs","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Producing the .Rmd file outputs","title":"How to run ITHIM","text":"run various .Rmd files, can use Create_output_summaries.R script saved root folder source(\"Create_output_summaries.R\") following outputs produced:","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary_tables-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"summary_tables.Rmd","title":"How to run ITHIM","text":".Rmd file summarises mode splits, distances durations travelled, addition attributable health impacts (YLL deaths different health outcomes) different injury, physical activity (PA) air pollution (AP) pathways also health outcome produces following output documents: html file (saved root folder) containing information listed . Note Rmd file set produce many distance, duration health outcomes tables commented highlight main results easily added : table displays Baseline mode split distance category, case: 0-2 km, 2-6 km >6km table displays mode split scenario city-specific distance tables showing average daily distances km travelled person baseline population mode scenarios (including Baseline) city-specific distance tables showing average daily distances km travelled person baseline population trip mode scenarios (including Baseline) city-specific duration tables showing average daily duration (mins) spent travelling person baseline population mode scenarios (including Baseline) city-specific duration tables showing average daily duration (mins) spent travelling person baseline population trip mode scenarios (including Baseline) output .csv files containing information listed . Note files also saved version number file name: ylls.csv file (results/multi_city/health_impacts/ylls.csv) gives changes YLL age sex category, health outcome scenario compared baseline scenario. also shows health outcomes three level heirarchy, whether health outcome attributed changes AP, PA , age, age sex specific population levels. results either AP PA health outcomes impacted AP PA seperately, results combined AP PA, health outcomes impacted AP PA. ylls_pathway.csv file (results/multi_city/health_impacts/ylls_pathway.csv) gives changes YLL age sex category, health outcome scenario compared baseline scenario. also shows health outcome three level hierarchy, whether health outcome attributed changes AP PA, age, age sex specific population levels. results given AP PA independently even health outcome impacted pathways. deaths.csv file (results/multi_city/health_impacts/deaths.csv) gives changes deaths age sex category, health outcome scenario compared baseline scenario. also shows health outcomes three level hierarchy, whether health outcome attributed changes AP, PA , age, age sex specific population levels. results either AP PA health outcomes impacted AP PA results combined AP PA impacts health outcomes impacted AP PA. deaths_pathway.csv file (results/multi_city/health_impacts/deaths_pathway.csv) gives changes deaths age sex category, health outcome scenario compared baseline scenario. also shows health outcome three level hierarchy, whether health outcome attributed changes AP PA, age, age sex specific population levels. results given AP PA independently even health outcome impacted pathways.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary_tables_pa_ap-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"summary_tables_PA_AP.Rmd","title":"How to run ITHIM","text":".Rmd file can used summarise ambient PM2.5 concentrations, PM2.5 personal exposure levels, CO2 emissions physical activity levels scenarios including baseline. produces following output documents: html file (saved root folder) containing information listed : boxplots daily individual PM2.5 exposure levels scenario including baseline one table detailing individual PM2.5 exposure levels including mean, 5th, 50th 95th percentiles, mean PM2.5 concentration levels scenario change PM2.5 compared baseline scenario one table detailing percentage baseline PM2.5 emissions attributed transport mode, city wide PM2.5 concentration percentage concentration attributed transport one table detailing baseline CO2 emissions scenario boxplots individual mMET physical activity levels scenario one table giving mean, 5th, 50th 95th percentile levels individual physical activity levels (mMETs) scenario one table detailing average mMETs levels scenario 2nd Option: boxplots daily individual PM2.5 exposure levels scenario one table detailing baseline PM2.5 emissions mode, city wide PM2.5 concentration percentage concentration attributed transport one table detailing individual PM2.5 exposure levels including mean, 5th, 50th 95th percentiles, mean PM2.5 concentration scenario change PM2.5 compared baseline scenario. table also contains CO2 emissions scenario boxplots individual mMET physical activity levels scenario output .csv/.xlsx files containing information listed : desc_stats.csv file (results/multi_city/AP/desc_stats.csv, also saved output version name) containing summary statistics individual PM2.5 exposure levels, total PM2.5 concentration, change PM2.5 concentration compared baseline scenario total transport related CO2 emissions scenario desc_stats.xlsx file (results/multi_city/AP/desc_stats_output_version.xlsx) containing following tabs: PM_2.5_emission_inventory: table detailing percentage Baseline PM2.5 emissions attributed transport mode, city wide PM2.5 concentration percentage concentrations attributed transport CO2_emission_inventory: table detailing CO2 emissions scenario summary_stats_PM2.5_CO2: summary statistics individual PM2.5 exposure levels, total PM2.5 concentration, change PM2.5 concentration compared baseline scenario total transport related CO2 emissions scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"injury_tables-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"injury_tables.Rmd","title":"How to run ITHIM","text":".Rmd file can used summarise injury outcomes. produces following output documents: html file (saved root folder) containing information listed : fatality counts strike casualty mode scenario (including lower upper confidence interval values applicable); one table scenario mean, upper lower confidence interval values fatality counts giving lower, mean upper bounds (applicable) casualty mode strike mode scenario; one table casualty mode, scenario tables showing fatalities per billion km travelled scenario mean, upper lower confidence interval values (applicable). tables showing number deaths per 100,000 people scenario mean, upper lower confidence interval values (applicable). tables showing fatalities per 100 million hours travelled scenario mean, upper lower confidence interval values (applicable). output .csv files containing information listed . Note files also saved version number file name: inj_counts.csv file (results/multi_city/inj/inj_counts.csv) contains fatality counts (mean upper lower confidence interval values required, seperate row) scenario casualty strike mode pair. also includes observed baseline fatality counts active travel fatality counts casualty mode (sum cycle walk casualty mode fatalities) injury_risks_per_billion_kms.csv file (results/multi_city/inj/injury_risks_per_billion_kms.csv) gives fatalities per billion km travelled scenario casualty mode. also includes upper lower confidence interval values required, separate row, active travel counts sum walking cycling injury_risks_per_100k_pop.csv file (results/multi_city/inj/injury_risks_per_100k_pop.csv) gives fatalities per 100k people scenario casualty mode. also includes upper lower confidence interval values required, separate row, active travel counts sum walking cycling distances.csv file (results/multi_city/inj/distances.csv) contains population distances travelled per day scenario mode injury_risks_per_100million_h.csv file (results/multi_city/inj/injury_risks_per_100million_h.csv) gives fatalities per 100 million hours travelled scenario casualty mode. also includes upper lower confidence interval values required, seperate row, active travel counts sum walking cycling inj_data.xlsx file (results/multi_city/inj/inj_data.xlsx) contains injury output csv files","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"shiny-app-pivot-table","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Shiny App Pivot table","title":"How to run ITHIM","text":"application allows produce Pivot tables health injury outcomes. Pivot tables allow filter outcomes follows. scenario deaths years life lost health outcome levels three levels hierarchy age sex group pathway / dose whether include interaction air pollution physical activity pathways whether include confidence intervals scenario mode risk type (total fatalities, per billion km, per 100k people, per 100 million hours)","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"producing-the-shiny-app-pivot-table-output","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Producing the Shiny App Pivot table output","title":"How to run ITHIM","text":"produce Shiny App Pivot tables, run function app.R results_app folder. Depending whether want read results latest updates Github local drive, set (Comment option don’t need.)","code":"github_path <- \"https://raw.githubusercontent.com/ITHIM/ITHIM-R/bogota/\" github_path <- \"../\""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"structure-of-ithim-global-github-repository---bogota-branch","dir":"Articles","previous_headings":"How to run ITHIM-Global","what":"Structure of ITHIM-Global Github repository - Bogota branch","title":"How to run ITHIM","text":"Github repository Bogota branch structured follows: .github: specifies metadata various documents, automatically created Github. R: contains R functions written ITIHM-R package. inst/extdata: folder containing local city-specific global input files. man: manual containing various functions used within ITHIM-R figures used various documentation documents. also built automatically. results: contains results model runs. results_app: contains functions used produce Shiny pivot tables results. vignettes: contains additional documentation information .Rbuildignore, .gitignore: metadata created Github. Bogota_InputParameters_vxx.xlsx - file containing local city-specific input parameters needs manual updating. Create_output_summaries.R - wrapper script create various output documents. DESCRIPTION: automatically created Github. How_To_Run_ITHIM: document describing various steps needed run ITHIM-Global model downloading installing ITHIM-R preparing input parameters files running code. ITHIM-R.Rproj: contains metadata ITHIM-R package. LICENSE: gives information licence applied repository. NAMESPACE: automatically created Github. OutputVersionControl.txt: file storing main run information ITHIM-R runs. automatically updated, required, using multi_city_script.R. README: document giving overview ITHIM-R package. _config.yml, _pkgdown.yml: metadata created Github. injury_tables.Rmd: R markdown document can used create summary statistics injury results. injury_tables_output_version.html: html files containing injury summary statistics respective model runs. multi_city_script.R: wrapper function call various functions needed perform ITHIM-Global analysis. summary_tables.Rmd: R markdown document create summary output statistics distance, duration, mode splits health outcomes. summary_tables_output_version.html: html files containing output summaries respective model runs. summary_tables_PA.Rmd: R markdown document create summary output statistics air pollution physical activity levels. summary_tables_PA_output_version.html: html files containing air pollution physical activity output statistics respective model runs.","code":""},{"path":"https://ithim.github.io/ITHIM-R/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Ali Abbas. Author, maintainer. Anna Schroeder. Author. Daniel Gil. Author. Lambed Tatah. Author. Rob Johnson. Author.","code":""},{"path":"https://ithim.github.io/ITHIM-R/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Abbas , Schroeder , Gil D, Tatah L, Johnson R (2023). “ithimr: Integrated Transport Health Impact Model.” https://ithim.github.io/ITHIM-R/.","code":"@Misc{ithim_methods_paper, url = {https://ithim.github.io/ITHIM-R/}, author = {Ali Abbas and Anna Schroeder and Daniel Gil and Lambed Tatah and Rob Johnson}, title = {ithimr: Integrated Transport and Health Impact Model}, year = {2023}, }"},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"ithim-r","dir":"","previous_headings":"","what":"Integrated Transport and Health Impact Model","title":"Integrated Transport and Health Impact Model","text":"Development Integrated Transport Health Impact Modelling Tool (ITHIM) R, also known ITHIM version 3.0. Started January 2018. document aims comprehensive record calculations ITHIM pipeline, specifically ITHIM- R package.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"how-to-use-the-package","dir":"","previous_headings":"","what":"How to use the package","title":"Integrated Transport and Health Impact Model","text":"written -guide explains install ITHIM-R package, run ITHIM-Global model using package produce summaries key results. Please read : run ITHIM?.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"citation","dir":"","previous_headings":"How to use the package","what":"Citation","title":"Integrated Transport and Health Impact Model","text":"cite package ‘ithimr’ publications use: Ali Abbas, Anna Schroeder et al. (2023). ithimr: Integrated Transport Health Impact Model. R package version 0.1.2. BibTeX entry LaTeX users @Manual{, title = {ithimr: Integrated Transport Health Impact Model}, author = {Ali Abbas Anna Schroeder Daniel Gil Lambed Tatah Rob Johnson}, year = {2023}, note = {R package version 0.1.2, https://github.com/ITHIM/ITHIM-R}, url = {https://ithim.github.io/ITHIM-R/}, }","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"outline","dir":"","previous_headings":"How to use the package","what":"Outline","title":"Integrated Transport and Health Impact Model","text":"ITHIM performs integrated assessments health impacts user-defined transport scenarios policies urban national levels. health impacts transport policies modelled changes physical activity, road traffic injury risk, exposure fine particulate matter (PM2.5) air pollution. addition, model estimates changes CO2 emissions. ITHIM used researchers health transport professionals estimate health impacts scenarios, compare impacts travel patterns different locations, model impacts interventions. ITHIM works either stand-alone model can linked models (e.g. transport, health, economic) quasi-microsimulation model exposure individual person level, health impacts estimated aggregated age groups, constrained available Global Burden Disease (GBD) data.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"physical-activity","dir":"","previous_headings":"How to use the package > Outline","what":"Physical Activity","title":"Integrated Transport and Health Impact Model","text":"ITHIM models exposure physical activity comparing distributions weekly physical activity different scenarios. Walking, cycling types physical activity combined marginal MET hours per week activity. Outcomes affected physical activity include several cardiovascular diseases, depression, dementia, diabetes, breast cancer colon cancer. ITHIM also models changes health -cause mortality. comparative risk assessment method used estimate changes population physical activity lead changes health burden.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"road-traffic-injuries","dir":"","previous_headings":"How to use the package > Outline","what":"Road Traffic Injuries","title":"Integrated Transport and Health Impact Model","text":"Road traffic injuries modelled using model based risk, distance speed. Differences risk sex age also taken account. approach allows ITHIM look absolute number injuries risk injury might change different modes transport travel distances modes change.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"air-pollution","dir":"","previous_headings":"How to use the package > Outline","what":"Air Pollution","title":"Integrated Transport and Health Impact Model","text":"Fine particulate matter (PM2.5) air pollution risks calculated general population (background rates) well travellers using mode specific rates different transport modes. Inhalation rates assumptions time use used calculate PM2.5 dose across different travel non-travel activities. Exposure changes population based comparison locally generated PM2.5 emissions concentrations study area.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"co2-emissions","dir":"","previous_headings":"How to use the package > Outline","what":"CO2 Emissions","title":"Integrated Transport and Health Impact Model","text":"carbon dioxide (CO2) pathway models carbon dioxide (CO2) emissions motorised vehicles. CO2 pathway estimates single metric: total CO2 emissions modelled scenario. method calculate CO2 emissions similar one PM2.5.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"health-outcomes","dir":"","previous_headings":"How to use the package > Outline","what":"Health Outcomes","title":"Integrated Transport and Health Impact Model","text":"health impacts ITHIM presented years life lost (YLL) number attributable deaths seperately pathway, addition accounting interaction physical activity air pollution. Background mortality YLL data study areas estimated Global Burden Disease studies.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"data-inputs","dir":"","previous_headings":"How to use the package","what":"Data inputs","title":"Integrated Transport and Health Impact Model","text":"ITHIM-R requires 5 user defined input files csv format, saved directory city’s name. See inst/ext/local/bogota example files. also numerous assumptions user can parameterize model. section talks files (datasets) required setup run model. two subsections, : City-specific files (local input parameters/datasets). Global files (global input parameters/datasets).","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"city-specific-files","dir":"","previous_headings":"How to use the package","what":"City-specific files","title":"Integrated Transport and Health Impact Model","text":"section covers file inputs (specific city) required run model. Travel survey (example trips dataset). table trips taken group people given weekday. also includes people take trips. One row per trip (stage trip). Minimal columns: participant_id, age, sex, trip_mode, trip_duration (trip_distance). columns: stage_mode, stage_duration (stage_distance). Injury events (example injuries dataset). table recorded road-traffic injury (fatality) events city one years. One row per event. Minimal columns: victim mode (cas_mode) strike mode (strike_mode). columns: year, cas_age, cas_gender, weight (e.g. multiple years combined). Baseline mortality years life lost data (example burden dataset). One row per health outcome/metric/age/gender combination. Minimal rows: Measure (death/YLL); sex_name (Male/Female); age_name (‘x y’); cause_name (cause mortality YLL); val (value burden); population (number people val corresponds , e.g. population country). Population city (example population dataset). used order scale baseline mortality YLL data country’s values city’s population study. One row per demographic group. Columns: sex, age, population. age column share boundaries age_name baseline mortality YLL data, can aggregated. Physical activity survey (example physical activity dataset) One row per person. Columns: sex, age, ltpa_marg_met (total non-occupational PA week).","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"global-files","dir":"","previous_headings":"How to use the package","what":"Global files","title":"Integrated Transport and Health Impact Model","text":"order setup model, need fixed list tables/datasets, change across cities/ applied similarly cities hence referred “Global”, : Health outcome interaction table. table list health outcomes related specific pathway Air Pollution Physical Activity also interaction . Air Pollution Exposure Response Functions (ERFs). give exposure-response relationships air pollution (PM2.5) impact health different health outcomes. collected/cleaned datasets published studies . Physical Activity Dose-Response Functions (DRFs). dose-response relationships physical activity impact health different health outcomes. Similar air pollution, comes published studies. now sits independent R package called drpa.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"how-to-run-the-model","dir":"","previous_headings":"","what":"How to run the model?","title":"Integrated Transport and Health Impact Model","text":"setup, reading required datasets initialising variables, call run_ithim_setup() run model, call run_ithim(). function used call run_ithim_setup run_ithim multi_city_script also reads relevant input parameter files.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc.  Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"GNU General Public License free, copyleft license software kinds works. licenses software practical works designed take away freedom share change works. contrast, GNU General Public License intended guarantee freedom share change versions program–make sure remains free software users. , Free Software Foundation, use GNU General Public License software; applies also work released way authors. can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge wish), receive source code can get want , can change software use pieces new free programs, know can things. protect rights, need prevent others denying rights asking surrender rights. Therefore, certain responsibilities distribute copies software, modify : responsibilities respect freedom others. example, distribute copies program, whether gratis fee, must pass recipients freedoms received. must make sure , , receive can get source code. must show terms know rights. Developers use GNU GPL protect rights two steps: (1) assert copyright software, (2) offer License giving legal permission copy, distribute /modify . developers’ authors’ protection, GPL clearly explains warranty free software. users’ authors’ sake, GPL requires modified versions marked changed, problems attributed erroneously authors previous versions. devices designed deny users access install run modified versions software inside , although manufacturer can . fundamentally incompatible aim protecting users’ freedom change software. systematic pattern abuse occurs area products individuals use, precisely unacceptable. Therefore, designed version GPL prohibit practice products. problems arise substantially domains, stand ready extend provision domains future versions GPL, needed protect freedom users. Finally, every program threatened constantly software patents. States allow patents restrict development use software general-purpose computers, , wish avoid special danger patents applied free program make effectively proprietary. prevent , GPL assures patents used render program non-free. precise terms conditions copying, distribution modification follow.","code":""},{"path":[]},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_0-definitions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"0. Definitions","title":"GNU General Public License","text":"“License” refers version 3 GNU General Public License. “Copyright” also means copyright-like laws apply kinds works, semiconductor masks. “Program” refers copyrightable work licensed License. licensee addressed “”. “Licensees” “recipients” may individuals organizations. “modify” work means copy adapt part work fashion requiring copyright permission, making exact copy. resulting work called “modified version” earlier work work “based ” earlier work. “covered work” means either unmodified Program work based Program. “propagate” work means anything , without permission, make directly secondarily liable infringement applicable copyright law, except executing computer modifying private copy. Propagation includes copying, distribution (without modification), making available public, countries activities well. “convey” work means kind propagation enables parties make receive copies. Mere interaction user computer network, transfer copy, conveying. interactive user interface displays “Appropriate Legal Notices” extent includes convenient prominently visible feature (1) displays appropriate copyright notice, (2) tells user warranty work (except extent warranties provided), licensees may convey work License, view copy License. interface presents list user commands options, menu, prominent item list meets criterion.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_1-source-code","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"1. Source Code","title":"GNU General Public License","text":"“source code” work means preferred form work making modifications . “Object code” means non-source form work. “Standard Interface” means interface either official standard defined recognized standards body, , case interfaces specified particular programming language, one widely used among developers working language. “System Libraries” executable work include anything, work whole, () included normal form packaging Major Component, part Major Component, (b) serves enable use work Major Component, implement Standard Interface implementation available public source code form. “Major Component”, context, means major essential component (kernel, window system, ) specific operating system () executable work runs, compiler used produce work, object code interpreter used run . “Corresponding Source” work object code form means source code needed generate, install, (executable work) run object code modify work, including scripts control activities. However, include work’s System Libraries, general-purpose tools generally available free programs used unmodified performing activities part work. example, Corresponding Source includes interface definition files associated source files work, source code shared libraries dynamically linked subprograms work specifically designed require, intimate data communication control flow subprograms parts work. Corresponding Source need include anything users can regenerate automatically parts Corresponding Source. Corresponding Source work source code form work.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_2-basic-permissions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"2. Basic Permissions","title":"GNU General Public License","text":"rights granted License granted term copyright Program, irrevocable provided stated conditions met. License explicitly affirms unlimited permission run unmodified Program. output running covered work covered License output, given content, constitutes covered work. License acknowledges rights fair use equivalent, provided copyright law. may make, run propagate covered works convey, without conditions long license otherwise remains force. may convey covered works others sole purpose make modifications exclusively , provide facilities running works, provided comply terms License conveying material control copyright. thus making running covered works must exclusively behalf, direction control, terms prohibit making copies copyrighted material outside relationship . Conveying circumstances permitted solely conditions stated . Sublicensing allowed; section 10 makes unnecessary.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_3-protecting-users-legal-rights-from-anti-circumvention-law","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"3. Protecting Users’ Legal Rights From Anti-Circumvention Law","title":"GNU General Public License","text":"covered work shall deemed part effective technological measure applicable law fulfilling obligations article 11 WIPO copyright treaty adopted 20 December 1996, similar laws prohibiting restricting circumvention measures. convey covered work, waive legal power forbid circumvention technological measures extent circumvention effected exercising rights License respect covered work, disclaim intention limit operation modification work means enforcing, work’s users, third parties’ legal rights forbid circumvention technological measures.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_4-conveying-verbatim-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"4. Conveying Verbatim Copies","title":"GNU General Public License","text":"may convey verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice; keep intact notices stating License non-permissive terms added accord section 7 apply code; keep intact notices absence warranty; give recipients copy License along Program. may charge price price copy convey, may offer support warranty protection fee.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_5-conveying-modified-source-versions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"5. Conveying Modified Source Versions","title":"GNU General Public License","text":"may convey work based Program, modifications produce Program, form source code terms section 4, provided also meet conditions: ) work must carry prominent notices stating modified , giving relevant date. b) work must carry prominent notices stating released License conditions added section 7. requirement modifies requirement section 4 “keep intact notices”. c) must license entire work, whole, License anyone comes possession copy. License therefore apply, along applicable section 7 additional terms, whole work, parts, regardless packaged. License gives permission license work way, invalidate permission separately received . d) work interactive user interfaces, must display Appropriate Legal Notices; however, Program interactive interfaces display Appropriate Legal Notices, work need make . compilation covered work separate independent works, nature extensions covered work, combined form larger program, volume storage distribution medium, called “aggregate” compilation resulting copyright used limit access legal rights compilation’s users beyond individual works permit. Inclusion covered work aggregate cause License apply parts aggregate.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_6-conveying-non-source-forms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"6. Conveying Non-Source Forms","title":"GNU General Public License","text":"may convey covered work object code form terms sections 4 5, provided also convey machine-readable Corresponding Source terms License, one ways: ) Convey object code , embodied , physical product (including physical distribution medium), accompanied Corresponding Source fixed durable physical medium customarily used software interchange. b) Convey object code , embodied , physical product (including physical distribution medium), accompanied written offer, valid least three years valid long offer spare parts customer support product model, give anyone possesses object code either (1) copy Corresponding Source software product covered License, durable physical medium customarily used software interchange, price reasonable cost physically performing conveying source, (2) access copy Corresponding Source network server charge. c) Convey individual copies object code copy written offer provide Corresponding Source. alternative allowed occasionally noncommercially, received object code offer, accord subsection 6b. d) Convey object code offering access designated place (gratis charge), offer equivalent access Corresponding Source way place charge. need require recipients copy Corresponding Source along object code. place copy object code network server, Corresponding Source may different server (operated third party) supports equivalent copying facilities, provided maintain clear directions next object code saying find Corresponding Source. Regardless server hosts Corresponding Source, remain obligated ensure available long needed satisfy requirements. e) Convey object code using peer--peer transmission, provided inform peers object code Corresponding Source work offered general public charge subsection 6d. separable portion object code, whose source code excluded Corresponding Source System Library, need included conveying object code work. “User Product” either (1) “consumer product”, means tangible personal property normally used personal, family, household purposes, (2) anything designed sold incorporation dwelling. determining whether product consumer product, doubtful cases shall resolved favor coverage. particular product received particular user, “normally used” refers typical common use class product, regardless status particular user way particular user actually uses, expects expected use, product. product consumer product regardless whether product substantial commercial, industrial non-consumer uses, unless uses represent significant mode use product. “Installation Information” User Product means methods, procedures, authorization keys, information required install execute modified versions covered work User Product modified version Corresponding Source. information must suffice ensure continued functioning modified object code case prevented interfered solely modification made. convey object code work section , , specifically use , User Product, conveying occurs part transaction right possession use User Product transferred recipient perpetuity fixed term (regardless transaction characterized), Corresponding Source conveyed section must accompanied Installation Information. requirement apply neither third party retains ability install modified object code User Product (example, work installed ROM). requirement provide Installation Information include requirement continue provide support service, warranty, updates work modified installed recipient, User Product modified installed. Access network may denied modification materially adversely affects operation network violates rules protocols communication across network. Corresponding Source conveyed, Installation Information provided, accord section must format publicly documented (implementation available public source code form), must require special password key unpacking, reading copying.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_7-additional-terms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"7. Additional Terms","title":"GNU General Public License","text":"“Additional permissions” terms supplement terms License making exceptions one conditions. Additional permissions applicable entire Program shall treated though included License, extent valid applicable law. additional permissions apply part Program, part may used separately permissions, entire Program remains governed License without regard additional permissions. convey copy covered work, may option remove additional permissions copy, part . (Additional permissions may written require removal certain cases modify work.) may place additional permissions material, added covered work, can give appropriate copyright permission. Notwithstanding provision License, material add covered work, may (authorized copyright holders material) supplement terms License terms: ) Disclaiming warranty limiting liability differently terms sections 15 16 License; b) Requiring preservation specified reasonable legal notices author attributions material Appropriate Legal Notices displayed works containing ; c) Prohibiting misrepresentation origin material, requiring modified versions material marked reasonable ways different original version; d) Limiting use publicity purposes names licensors authors material; e) Declining grant rights trademark law use trade names, trademarks, service marks; f) Requiring indemnification licensors authors material anyone conveys material (modified versions ) contractual assumptions liability recipient, liability contractual assumptions directly impose licensors authors. non-permissive additional terms considered “restrictions” within meaning section 10. Program received , part , contains notice stating governed License along term restriction, may remove term. license document contains restriction permits relicensing conveying License, may add covered work material governed terms license document, provided restriction survive relicensing conveying. add terms covered work accord section, must place, relevant source files, statement additional terms apply files, notice indicating find applicable terms. Additional terms, permissive non-permissive, may stated form separately written license, stated exceptions; requirements apply either way.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_8-termination","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"8. Termination","title":"GNU General Public License","text":"may propagate modify covered work except expressly provided License. attempt otherwise propagate modify void, automatically terminate rights License (including patent licenses granted third paragraph section 11). However, cease violation License, license particular copyright holder reinstated () provisionally, unless copyright holder explicitly finally terminates license, (b) permanently, copyright holder fails notify violation reasonable means prior 60 days cessation. Moreover, license particular copyright holder reinstated permanently copyright holder notifies violation reasonable means, first time received notice violation License (work) copyright holder, cure violation prior 30 days receipt notice. Termination rights section terminate licenses parties received copies rights License. rights terminated permanently reinstated, qualify receive new licenses material section 10.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_9-acceptance-not-required-for-having-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"9. Acceptance Not Required for Having Copies","title":"GNU General Public License","text":"required accept License order receive run copy Program. Ancillary propagation covered work occurring solely consequence using peer--peer transmission receive copy likewise require acceptance. However, nothing License grants permission propagate modify covered work. actions infringe copyright accept License. Therefore, modifying propagating covered work, indicate acceptance License .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_10-automatic-licensing-of-downstream-recipients","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"10. Automatic Licensing of Downstream Recipients","title":"GNU General Public License","text":"time convey covered work, recipient automatically receives license original licensors, run, modify propagate work, subject License. responsible enforcing compliance third parties License. “entity transaction” transaction transferring control organization, substantially assets one, subdividing organization, merging organizations. propagation covered work results entity transaction, party transaction receives copy work also receives whatever licenses work party’s predecessor interest give previous paragraph, plus right possession Corresponding Source work predecessor interest, predecessor can get reasonable efforts. may impose restrictions exercise rights granted affirmed License. example, may impose license fee, royalty, charge exercise rights granted License, may initiate litigation (including cross-claim counterclaim lawsuit) alleging patent claim infringed making, using, selling, offering sale, importing Program portion .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_11-patents","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"11. Patents","title":"GNU General Public License","text":"“contributor” copyright holder authorizes use License Program work Program based. work thus licensed called contributor’s “contributor version”. contributor’s “essential patent claims” patent claims owned controlled contributor, whether already acquired hereafter acquired, infringed manner, permitted License, making, using, selling contributor version, include claims infringed consequence modification contributor version. purposes definition, “control” includes right grant patent sublicenses manner consistent requirements License. contributor grants non-exclusive, worldwide, royalty-free patent license contributor’s essential patent claims, make, use, sell, offer sale, import otherwise run, modify propagate contents contributor version. following three paragraphs, “patent license” express agreement commitment, however denominated, enforce patent (express permission practice patent covenant sue patent infringement). “grant” patent license party means make agreement commitment enforce patent party. convey covered work, knowingly relying patent license, Corresponding Source work available anyone copy, free charge terms License, publicly available network server readily accessible means, must either (1) cause Corresponding Source available, (2) arrange deprive benefit patent license particular work, (3) arrange, manner consistent requirements License, extend patent license downstream recipients. “Knowingly relying” means actual knowledge , patent license, conveying covered work country, recipient’s use covered work country, infringe one identifiable patents country reason believe valid. , pursuant connection single transaction arrangement, convey, propagate procuring conveyance , covered work, grant patent license parties receiving covered work authorizing use, propagate, modify convey specific copy covered work, patent license grant automatically extended recipients covered work works based . patent license “discriminatory” include within scope coverage, prohibits exercise , conditioned non-exercise one rights specifically granted License. may convey covered work party arrangement third party business distributing software, make payment third party based extent activity conveying work, third party grants, parties receive covered work , discriminatory patent license () connection copies covered work conveyed (copies made copies), (b) primarily connection specific products compilations contain covered work, unless entered arrangement, patent license granted, prior 28 March 2007. Nothing License shall construed excluding limiting implied license defenses infringement may otherwise available applicable patent law.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_12-no-surrender-of-others-freedom","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"12. No Surrender of Others’ Freedom","title":"GNU General Public License","text":"conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. convey covered work satisfy simultaneously obligations License pertinent obligations, consequence may convey . example, agree terms obligate collect royalty conveying convey Program, way satisfy terms License refrain entirely conveying Program.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_13-use-with-the-gnu-affero-general-public-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"13. Use with the GNU Affero General Public License","title":"GNU General Public License","text":"Notwithstanding provision License, permission link combine covered work work licensed version 3 GNU Affero General Public License single combined work, convey resulting work. terms License continue apply part covered work, special requirements GNU Affero General Public License, section 13, concerning interaction network apply combination .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_14-revised-versions-of-this-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"14. Revised Versions of this License","title":"GNU General Public License","text":"Free Software Foundation may publish revised /new versions GNU General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies certain numbered version GNU General Public License “later version” applies , option following terms conditions either numbered version later version published Free Software Foundation. Program specify version number GNU General Public License, may choose version ever published Free Software Foundation. Program specifies proxy can decide future versions GNU General Public License can used, proxy’s public statement acceptance version permanently authorizes choose version Program. Later license versions may give additional different permissions. However, additional obligations imposed author copyright holder result choosing follow later version.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_15-disclaimer-of-warranty","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"15. Disclaimer of Warranty","title":"GNU General Public License","text":"WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_16-limitation-of-liability","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"16. Limitation of Liability","title":"GNU General Public License","text":"EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MODIFIES /CONVEYS PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_17-interpretation-of-sections-15-and-16","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"17. Interpretation of Sections 15 and 16","title":"GNU General Public License","text":"disclaimer warranty limitation liability provided given local legal effect according terms, reviewing courts shall apply local law closely approximates absolute waiver civil liability connection Program, unless warranty assumption liability accompanies copy Program return fee. END TERMS CONDITIONS","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively state exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program terminal interaction, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, program’s commands might different; GUI interface, use “box”. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. information , apply follow GNU GPL, see . GNU General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License. first, please read .","code":" Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":null,"dir":"Reference","previous_headings":"","what":"Add strike and casualty distances to injury tables — add_distance_columns","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"function adds strike casualty distance information individual age sex categories aggregated mode -hit-(whw) --vehicle (nov) injury fatality matrices.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"","code":"add_distance_columns( injury_table, mode_names, true_distances_0, dist, scenarios = SCEN )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"injury_table (list ) data frame(s) edited, contains aggregated fatality counts split whw nov matrices mode_names modes take distances , taken aggregated modes trip data true_distances_0 population distances add injury table dist table used access bus distance - currently used scenarios scenarios process","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"injury tables strike casualty distance information whw nov matrices","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"function performs following steps: set dataframe containing age sex categories found injury table input data add age sex index mode distances define list two elements whw nov indices used true_distances dataframe age sex categories define list (two elements whw nov) matching indices mode_names casualty modes injury table whw matrix create strike mode indices vector matching strike modes injury table strike_modes vector find strike casualty distances modes injury tables sum across age sex categories individual age sex category. modes exist injury tables known distances, mean mode distances known modes used add strike casualty modes whw nov matrices injuries_list output list","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Addition of ghost trips — add_ghost_trips","title":"Addition of ghost trips — add_ghost_trips","text":"Add trips get assigned physical activity component, can used proxy vehicle distances.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Addition of ghost trips — add_ghost_trips","text":"","code":"add_ghost_trips( raw_trip_set, trip_mode = \"bus_driver\", distance_ratio = BUS_TO_PASSENGER_RATIO * DISTANCE_SCALAR_PT, reference_mode = \"bus\", prop_male = 1, agerange_male = \"18, 65\", agerange_female = \"18, 65\", scenario = NA )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Addition of ghost trips — add_ghost_trips","text":"raw_trip_set data frame trips trip_mode mode add distance_ratio fraction reference distance use calculate new mode distance reference_mode name reference mode prop_male proportion newly added mode assigned males agerange_male age range males associated newly added mode agerange_female age range female drivers associated newly added mode scenario name scenario mode added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Addition of ghost trips — add_ghost_trips","text":"data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Addition of ghost trips — add_ghost_trips","text":"function creates trips based distance relative another (reference) mode, without altering synthetic population. .e. adds trips get assigned physical activity component. function can used add e.g. car_driver bus_driver trips used proxy vehicle distances needed injury CO2 pathways. can also used add truck commercial motorcycle trips included travel surveys. needed injury pathway, newly added trips assigned trips made males females based proportion males given input parameter. age ranges males females taking newly added trips can also defined. new mode distance equally split number people times number trips per people added. used distance new male trips. proportion female trips tends low, distance calculated male trips split 10 using 10th distance male trips, 10 times many female trips added compared low number female trips added distance used male trips. E.g. number people added 100 1 trip per person 98 trips made males, add 98 male trips 10 * 2 = 20 female trips 10th distance male trips. ensure better representation demographics female trips whilst keeping number newly added trips small possible reduce run time model. function performs following steps: set number people (regards males) trips per per person added find total distance reference mode find age ranges male female trips find number male female participants calculate total distance new mode added based reference distance find speed new mode male trips: define distance range male trip added, assume trip equal length add new male trips sampling given age range (add_trips.R) add age distance categories plus scenario name repeat female trips (assuming female trips 10th distance male trips adding proportionally 10 times many female trips)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":null,"dir":"Reference","previous_headings":"","what":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"Function create personal motorcycle trips Chilean cities","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"","code":"add_motorcycle_trips_Chile(raw_trip_set, PROPORTION_MOTORCYCLE_TRIPS)"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"raw_trip_set data frame trips travel survey PROPORTION_MOTORCYCLE_TRIPS proportion trips travel survey added personal motorcycle trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"original trip data additional personal motorcycle trips added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"function used create personal motorcycle trips Chilean cities motorcycle trips travel surveys. uses input existing travel survey data city proportion travel survey trips added additional new motorcycle trips. Based analysis motorcycle trips travel surveys Santiago, San Antonio, Valparaiso Puerto Montt makes assumptions split male female motorcyclists, number trips per person truncated normal distributions distances ages drivers personal motorcycle trips added. creates new trips assuming trip one stage, .e. trip duration distance equals stage duration distance. function contains following steps: characteristics motorcycle trips added defined set parameters truncated normal distributions male female trip duration set parameters truncated normal distributions male female age ranges find number male female motorcycle trips added divide number new male female trips 2 (= number trips per person) calculate number new participant ids added. number male female trips odd, add additional trip get trip number divisible 2 sample truncated normal distributions find duration new trips (assuming trip consists one stage) sample known age ranges find ages new male female motorcycle trips create new motorcycle trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Additional trips for trip data set — add_trips","title":"Additional trips for trip data set — add_trips","text":"Creates data frame given characteristics added existing trip data set.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Additional trips for trip data set — add_trips","text":"","code":"add_trips( trip_ids = 0, new_mode = \"pedestrian\", distance = 1, participant_id = 0, age = 20, sex = \"male\", nTrips = 3, speed = 4.8 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Additional trips for trip data set — add_trips","text":"trip_ids ids new trips new_mode mode new trips distance distances sample participant_id participant id new trips age age participant sex sex participant nTrips number trips participant speed speed new trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Additional trips for trip data set — add_trips","text":"data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Additional trips for trip data set — add_trips","text":"function used create new trips certain characteristics can added existing trip data set. input distance given upper limit trip distances added function takes number trips per person (nTrips) random samples 1 input distance given. Age sex participant also sampled range input age sex values. function performs following steps: create nTrips new trips sampling distances, ages sexes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"Add walk 'public transport stages' public transport trips walking stage","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"","code":"add_walk_trips(pt_trips)"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"pt_trips data frame PT trips without walking component","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"list data frames PT trips walk--PT trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"Function add additional walking stages public transport trips walking stage longer trip duration MINIMUM_PT_TIME plus BUS_WALK_TIME / RAIL_WALK_TIME parameters. MINIMUM_PT_TIME global input parameter determines minimum amount time (minutes) person travelling public transport spends public transport stage. BUS_WALK_TIME / RAIL_WALK_TIME parameter city specific input parameter determines duration walk public transport walking stage. function performs following steps: filter PT stages PT trips keep stage longest duration add one 'walk public transport' stage per trip find trip stages need changing add new 'walk pt' stages. duration public transport stage shorter BUS_WALK_TIME / RAIL_WALK_TIME + MINIMUM_PT_TIME, set new stage duration 3. Otherwise, set new stage duration either BUS_WALK_TIME RAIL_WALK_TIME depending trip mode update original public transport stage duration calculate 'walk pt' stage distance using walking speed update original public transport stage distance using respective public transport speed updated duration keep record number newly added 'walk pt' stages update total trip distances update trip distance categories remove 'walk pt' stages zero duration length","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate relative risk given PM exposure level — AP_dose_response","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"Calculate relative risk (RR) person synthetic population disease related air pollution scenario based individual PM exposure levels","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"","code":"AP_dose_response(cause, dose, quantile, confidence_intervals = F)"},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"cause name disease dose vector PM exposure levels individuals given age range scenario quantile quantile dose response functions used output value confidence_intervals logic: whether return confidence intervals","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"data frame relative risks person synthetic population AP related disease scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"function performs following steps: various checks ensure correct PM exposure levels (doses) disease read get lookup table required dose response functions contains dose median RR upper lower confidence interval RR values PM exposure doses synthetic population find needed RR extrapolating dose responses given lookup table confidence interval required, repeat interpolation using upper lower confidence RR values required quantile 0.5, .e. median, find required RR value defining normal function mean median RR value dose standard deviations defined upper lower confidence RR values. Use correct quantile normal function RR value.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"Computes RR DR relationship given four parameters PM2.5 exposure","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"","code":"ap_dose_response_curve(pm, alpha, beta, gamma, tmrel)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"pm PM2.5 exposure alpha DR parameter beta DR parameter gamma DR parameter tmrel DR parameter","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"RR","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign age groups to individuals — assign_age_groups","title":"Assign age groups to individuals — assign_age_groups","text":"Prunes dataset given max min ages, .e. removes entries people ages outside scope model assigns age group labels given age","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign age groups to individuals — assign_age_groups","text":"","code":"assign_age_groups( dataset, age_category = AGE_CATEGORY, age_lower_bounds = AGE_LOWER_BOUNDS, max_age = MAX_AGE, min_age = AGE_LOWER_BOUNDS[1], age_label = \"age\" )"},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign age groups to individuals — assign_age_groups","text":"dataset data frame age categories added ages outside model scope removed age_category vector strings giving age categories age_lower_bounds lower boundaries age categories max_age maximum age model min_age minimum age model age_label string label age column","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign age groups to individuals — assign_age_groups","text":"edited data frame","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Assign age groups to individuals — assign_age_groups","text":"function contains following steps: remove dataset entries ages max min ages missing age information add age categories","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":null,"dir":"Reference","previous_headings":"","what":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"Takes confidence value 0 1 returns parameter beta distribution","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"","code":"beta_pointiness(confidence)"},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"confidence value 0 1 representing confident PA dataset","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"value parametrise beta distribution","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"Combine relative risks (RR) air pollution (AP) physical activity (PA) multiplication diseases affected AP PA","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"","code":"combined_rr_ap_pa(ind_pa, ind_ap, conf_int = FALSE)"},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"ind_pa data frame individual RRs diseases affected PA ind_ap data frame individual RRs diseases affected AP conf_int logic: whether include confidence interval dose response relationships ","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"dataframe giving RR risk AP, PA combined AP PA exposure levels every person synthetic population scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"function performs following steps: join ap pa relative risk datasets loop disease outcomes affected PA AP: scenario multiply relative risks PA AP store new column confidence intervals required, multiply upper lower RR AP PA respectively wherever possible, otherwise use given median RR values instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"Applies PIF calculated relative risks (RRs) current observed health burden Global Burden Disease data generate scenario health burdens","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"","code":"combine_health_and_pif(pif_values, hc = DISEASE_BURDEN)"},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"pif_values vector values PIFs age sex categories hc data frame current burden disease","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"estimated scenario burden disease age sex categories","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"function performs following steps: current observed health burden particular disease multiplied PIF, .e change fraction disease expected current scenario compared reference scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":null,"dir":"Reference","previous_headings":"","what":"Add missing trip information — complete_trip_distance_duration","title":"Add missing trip information — complete_trip_distance_duration","text":"Adds missing trip information stage duration stage distance.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add missing trip information — complete_trip_distance_duration","text":"","code":"complete_trip_distance_duration()"},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add missing trip information — complete_trip_distance_duration","text":"function performs following steps calculate stage duration stage distance. Note need least trip duration stage distance stage stage duration: add speed column stage duration: calculate stage duration stage distance given using mode speeds stage duration sum 'NA' (.e. stage distances exist stage distances ): trip duration exists sum NA, find trip ids 'NA' stage duration replace stage duration trip duration divided number stages particular trip remove remaining trips 'NA' stage distance update stage speed column stage distance: calculate stage distance using stage duration mode speeds trip distance: calculate trip distance summing stage distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":null,"dir":"Reference","previous_headings":"","what":"Create scenarios for Bogota — create_bogota_scenarios","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"Creates three scenarios one, mode share given mode elevated set percentage total trips. scenario modes cycle, car, bus.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"","code":"create_bogota_scenarios(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"trip_set data frame, baseline scenario trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"list baseline scenario three scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"function creates three scenarios increasing mode shares cycling, car bus pre-defined percentage total mode shares. assume : total number trips remains trips modes (apart truck, bus driver, car driver commercial motorcycle trips remain unchanged - least initially) converted mode question; truck commercial motorcycle trips remain constant across scenarios whilst bus driver car driver trips updated based new total distance car bus trips increase mode share conducted scenario percentage share across three distance bands mode increased preserved, .e. 10 band 0-2km increasing cycling mode share x still 10 scenario always convert question, independently original overall mode share mode. .e. e.g. 1 5 car scenario 55 total trips. preserve proportion trips distance band. E.g. 20 trips distance band 0-2km, scenario 20 trips still distance band 0-2km. Example: Assume two distance bands B 80 cycling trips lie distance band remaining 20 band B. Assume 60 band B. Assume want increase cycling mode share 5 , need convert 5 cycling trips 5 cycling trips. Overall, leads increase (5 cycling trips, whilst preserving cycling mode shares 80 band 20 distance band 40 preserved. function performs following steps: overall mode shares cycle, car bus modes across three distance categories extracted trip data set trip data extract trip information, calculate total number trips find proportion trips distance category find proportion trips converted mode, scenario distance category define modes changeable (least initially) scenarios divide trip data set modes can changed another set trips whose modes changed split changeable trips also trips distance band create scenarios loop scenarios: loop distance band: find changeable trips mode increased count number trips made mode increased bus scenario aim increase public transport trips, .e. find changeable trips made bus rail count number trips made bus rail find number total trips like convert number trips changeable equals number trips converted, changeable trips converted mode question trips changeable want change, sample number trips change changeable trip ids trips converted changeable trips, convert many trips possible create warning message convert required trips new mode question add trips across distance bands add non-changeable trips update bus_driver car_driver trips create list containing trips scenario elements","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":null,"dir":"Reference","previous_headings":"","what":"Create global scenarios — create_global_scenarios","title":"Create global scenarios — create_global_scenarios","text":"Creates four scenarios one, mode share given mode elevated set percentage total trips. scenario modes cycle, car, bus motorcycle.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create global scenarios — create_global_scenarios","text":"","code":"create_global_scenarios(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create global scenarios — create_global_scenarios","text":"trip_set data frame, baseline scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create global scenarios — create_global_scenarios","text":"list baseline scenario four mode scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create global scenarios — create_global_scenarios","text":"function creates four scenarios increasing mode shares cycling, car, bus motorcycle pre-defined percentage total mode shares. assume : total number trips remains trips modes (apart truck, bus driver, car driver commercial motorcycle trips remain unchanged - least initially) converted mode question; truck commercial motorcycle trips remain constant across scenarios whilst bus driver car driver trips updated based new total distance car bus trips increase mode share conducted scenario percentage share across three distance bands mode increased preserved, .e. 10 band 0-2km increasing cycling mode share x still 10 mean mode split across 28 cities (Antofagasta, Arica, Belo Horizonte, Bogota, Buenos Aires, Cali, Copiapo, Coquimbo / La Serena, Gran Valparaiso, Iquique / Alto Hospicio, Medellin, Mexico City, Montevideo, Osorno, Puerto Montt, San Antonio, Santiago, Sao Paulo, Temuco / Padre las Casas, Valdivia, Accra, Bangalore, Cape Town, Delhi, Vizag, Kisumu, Nairobi Port Louis) baseline mode split mode. scenario always convert question, independently original overall mode share mode. .e. e.g. 1 5 car scenario 55 total trips. preserve proportion trips distance band. E.g. 20 trips distance band 0-2km, scenario 20 trips still distance band 0-2km. proportions calculated city individually. Example: Assume two distance bands B 80 cycling trips lie distance band remaining 20 band B. Assume 60 band B. Assume want increase cycling mode share 5 , need convert 5 cycling trips 5 cycling trips. Overall, leads increase (5 cycling trips, whilst preserving cycling mode shares 80 band 20 distance band 40 preserved. function performs following steps: overall mode shares cycle, car, bus motorcycle modes across three distance categories defined trip data extract trip information, calculate total number trips find proportion trips distance category find proportion trips converted mode, scenario distance category define modes changeable (least initially) scenarios divide trip data set modes can changed another set trips whose modes changed split changeable trips also trips distance band create scenarios loop scenarios, .e. 4 different modes: loop distance band: find changeable trips mode increased count number trips made mode increased bus scenario aim increase public transport trips, .e. find changeable trips made bus rail count number trips made bus rail find number total trips like convert number trips changeable equals number trips converted, changeable trips converted mode question trips changeable want change, sample number trips change changeable trip ids trips converted changeable trips, convert many trips possible create warning message convert required trips new mode question add trips across distance bands add non-changeable trips update bus_driver car_driver trips create list containing trips scenario elements","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":null,"dir":"Reference","previous_headings":"","what":"Creates synthetic population — create_synth_pop","title":"Creates synthetic population — create_synth_pop","text":"Creates synthetic population matching individuals trip set individuals physical activity (PA) dataset","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Creates synthetic population — create_synth_pop","text":"","code":"create_synth_pop(raw_trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Creates synthetic population — create_synth_pop","text":"raw_trip_set data frame raw trips taken, bus_driver, new motorcycle truck trips already added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Creates synthetic population — create_synth_pop","text":"synthetic population trip set pruned","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Creates synthetic population — create_synth_pop","text":"function performs following steps: adds age category trip physical activity datasets calling assign_age_groups.R match people trip data people physical activity dataset: create synthetic population taking unique participant ids together age gender information trip data (including bus driver, truck, car driver commercial motorcycle trips) assign non-occupational physical activity MMET values synthetic population, following steps performed: sex age category, find proportion people zero non-occupational MMET values also find list people non-zero MMET values BACKGROUND_PA_CONFIDENCE < 1 calling value information script, .e. input values sampled distributions, beta distribution built proportion people zero work leisure MMET values sampled using known proportion mean distribution sample replacement vector 0 MMET values vector non-zero MMET values ( people non-zero work leisure MMET values) using proportion people zero work leisure MMET values assign sampled MMET values synthetic population remove participants trip stage modes Vehicle inventory","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":null,"dir":"Reference","previous_headings":"","what":"Function for Dirichlet parameters — dirichlet_pointiness","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"Function map confidence value parameterisation Dirichlet distribution.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"","code":"dirichlet_pointiness(confidence)"},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"confidence value 0 1","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"parameterisation","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"Note parameterisation somewhat arbitrary seems work visual inspection.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":null,"dir":"Reference","previous_headings":"","what":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"Computes exposures (distances) mode parameterise injury regression model, computed Poisson model used ITHIM-Global model predict injury fatalities later stage","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"","code":"distances_for_injury_function(journeys, dist)"},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"journeys data frame total distance (total population) age sex category scenario dist table (total population) distances per mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"true_distances (mode distances age sex walking modes car modes combined bus drivers added relevant), injuries_list (list strike, casualty, age, sex mode distance combinations baseline scenarios), reg_model (parameterised Poisson regression model), injuries_for_model (baseline data containing injury counts casualty strike mode combinations associated distance data)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"function uses distance data individual injury fatality data perform following steps parameterise Poisson injury regression model: stage modes aggregated walk related stages (walk walk pt) mode (walk), similarly car related journeys bus drivers added bus journeys (relevant) accurately represent people bus Takes Baseline injury tables, split -hit (whw) --vehicle (nov) parts, adds total population distances strike casualty mode (add_distance_columns.R). Distances added age gender category exists information injury counts (injuries_for_model dataframe). exists fatality casualty strike mode age sex category mode distance age sex category, fatalities distances aggregated strike casualty mode. , aggregation still exist fatalities either casualty strike mode distance missing, fatalities removed predict injury counts zero distances. However, happen total distances modes (possibly inferred modes) appear injury data. - data used parameterise Poisson injury model. new list (injuries_list) created containing strike casualty mode age sex combinations together strike casualty mode distances (add_distance_columns()) baseline scenarios. whw model, strike mode casualty pairs strike mode equals casualty mode removed fatalities combinations already added nov matrix. Combinations non-zero strike casualty mode distance also removed. list later used injuries_function_2() function predict fatality counts using Poisson injury regression model. casualty strike mode exponents used account safety number effect added injuries_for_model injuries_list. best possible regression model built using Baseline injury counts distances (injuries_for_model) standard errors small wherever possible. Strike casualty mode pairs cas mode = strike mode removed still exist removed ithim_load_data.R function. Two different forms whw nov matrices defined, taking account age sex information exists. standard errors newly built regression models checked large data aggregated age sex yet, data aggregated new Poisson regression model build. standard errors still large aggregation, message printed screen warning standard errors large.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":null,"dir":"Reference","previous_headings":"","what":"Get distances and duration summaries by mode — dist_dur_tbls","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"Summaries total distances durations spent travelling per mode per scenario, synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"","code":"dist_dur_tbls(trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"trip_scen_sets list synthetic trip sets scenario including baseline","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"list table (total) distances durations per mode per scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"function performs following steps: loop scenarios (incl Baseline): using trip data, sum across distances stage mode get total distance mode scenario synthetic population sum across duration stage mode get total duration mode scenario 'walk_to_pt' stages exist, add pedestrian stages duration distance create one dataframe containing total distances mode scenario create one dataframe containing total duration mode scenario remove 'walk_to_pt' stages added pedestrian stages update bus car driver distances duration scenarios using ratio bus/car bus_driver/car_driver baseline scenario ( redundant GLOBAL, BOGOTA, AFRICA_INDIA LATAM scenario definitions bus car driver distances already updated scenario creation)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":null,"dir":"Reference","previous_headings":"","what":"Get relative risk for diseases given PM exposure — gen_ap_rr","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"Computes relative risk (RR) individuals synthetic population disease given PM exposure","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"","code":"gen_ap_rr(pm_conc_pp)"},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"pm_conc_pp individual PM exposures person synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"data frame relative risks per person disease scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"function performs following steps: minimum ages age group corresponding disease risks assigned individuals synthetic population (added PM exposure levels) loop diseases related PM pollution: depending disease (disease different relative risks depending age individual) loop disease specific age groups (just one age group disease) set quantile value dose response curves extracted. running constant mode, quantile usually set 0.5, .e. median dose response curves. running sample mode, quantile can set sampled distribution input parameters. loop scenarios: assign relative risk given disease, age group, quantile scenario relevant people synthetic population calling AP_dose_response() function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":null,"dir":"Reference","previous_headings":"","what":"Get relative risk for diseases given mMETs — gen_pa_rr","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"Computes relative risks (RR) individuals synthetic population disease given mMETs (PA exposure)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"","code":"gen_pa_rr(mmets_pp, conf_int = F)"},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"mmets_pp individual mMETs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"data frame relative risks per person per disease","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"function performs following steps: loop diseases related physical activity levels: set quantile value dose response curves extracted. running constant mode, quantile usually set 0.5, .e. median dose response curves. running sample mode, quantile can set sampled distribution input parameters. create one vector containing mMET values scenarios assign relative risk given disease quantile given mMET values people synthetic population scenarios calling drpa::dose_response function extract RR scenario vector containing RR scenarios confidence intervals required, also extract RR upper lower confidence values scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":null,"dir":"Reference","previous_headings":"","what":"Find population distances by mode for entire population — get_all_distances","title":"Find population distances by mode for entire population — get_all_distances","text":"Function find distances travelled age, sex, scenario mode entire population rather just synthetic population.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find population distances by mode for entire population — get_all_distances","text":"","code":"get_all_distances(ithim_object)"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find population distances by mode for entire population — get_all_distances","text":"ithim_object list containing city specific information including synthetic trip set","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find population distances by mode for entire population — get_all_distances","text":"ithim_object , additional total population distance mode scenario, distances injury pathway plus parameterised Poisson injury regression model","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Find population distances by mode for entire population — get_all_distances","text":"function performs following steps: generate distance duration matrices age, sex, mode scenario ithim_object$trip_scen_sets synthetic population calling dist_dur_tbls() function find total mode distances scenario scale distance travelled entire population using demographic information city order scale distances age, sex, mode scenario entire population, proportion distances travelled age, sex, mode scenario combination synthetic population total distances mode scenario synthetic population found. total population distances mode multiplied proportions find total population distances travelled mode age sex category. distances_for_injury_function() function called creates list inj_distances added ithim_object containing following matrices: true_distances (population mode distances age sex walking modes car modes combined bus drivers added relevant) injuries_list (list strike, casualty, age, sex mode distance combinations baseline scenarios, used predict fatalities later model run) reg_model (parameterised Poisson injury regression model) injuries_for_model (baseline data containing injury counts casualty strike mode combinations associated distance data)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":null,"dir":"Reference","previous_headings":"","what":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"Computes mode shares different distance categories maximum mode share specified mode types specified distance categories across specified (stored) cities. Used max mode share scenario generation.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"","code":"get_scenario_settings( cities = c(\"accra\", \"bangalore\", \"belo_horizonte\", \"bogota\", \"buenos_aires\", \"cape_town\", \"delhi\", \"mexico_city\", \"santiago\", \"sao_paulo\", \"vizag\"), modes = c(\"pedestrian\", \"cycle\", \"car\", \"motorcycle\", \"bus\"), distances = c(\"0-2 km\", \"2-6 km\", \"6+ km\"), speeds = list(bus = 8.1, bus_driver = 8.1, minibus = 8.1, minibus_driver = 8.1, car = 13.8, car_driver = 13.8, taxi = 13.8, pedestrian = 2.5, walk_to_pt = 2.5, cycle = 7.2, motorcycle = 15.2, truck = 8.1, van = 13.8, subway = 18.1, rail = 21.9, auto_rickshaw = 4, shared_auto = 13.8, shared_taxi = 13.8, cycle_rickshaw = 4, other = 9.1) )"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"cities cities use modes modes use distances distance categories use speeds named list mode speeds (applied cities)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"data frame maximum proportions mode distance category","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"function performs following steps: define minimum distances distance category loop pre-defined cities: read trip data get data correct format assign distance categories distance category pre-defined mode find proportional modal share (distance category, proportion modes adds 100 rail trips exist, added proportion bus trips get one value public transport find maximum mode shares mode distance category city print one table showing mode shares distance category","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate synthetic population from trip data — get_synthetic_from_trips","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"Sequence functions set synthetic population, synthetic trips, scenarios.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"","code":"get_synthetic_from_trips()"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"data frame synthetic trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"function performs following steps: columns TRIP_SET put correct order multiply trip distances, stage distances, durations day_to_week scalar divide 7 get distances durations 'average' day week add bus_driver truck trips required (add_ghost_trips()) add personal motorcycle trips needed (call appropriate function) add commercial motorcycle trips required (add_ghost_trips()) build synthetic population creating data set contains (non-zero) participant ids demographic information trip data set adds work leisure MMET values calling create_synth_pop() (non travel entries trip data set also removed) adds car driver trips required (add_ghost_trips()) call ithim_setup_baseline_scenario() function get baseline data correct format creation different scenarios create required scenarios calling appropriate function add walk pt trips combine scenarios one dataframe calling walk_to_pt_and_combine_scen() function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute health burden — health_burden","title":"Compute health burden — health_burden","text":"Compute health burden population scenarios given relative risks diseases","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute health burden — health_burden","text":"","code":"health_burden(ind_ap_pa, conf_int = F, combined_AP_PA = T)"},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute health burden — health_burden","text":"ind_ap_pa dataframe individuals' relative risks diseases conf_int=F logic: whether include confidence interval dose response relationships combined_AP_PA=T logic: whether combine two exposure pathways (AP PA) compute independently","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute health burden — health_burden","text":"list dataframes: one deaths per disease per demographic group scenario, likewise YLLs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute health burden — health_burden","text":"function performs following steps: get demographic disease burden (subset Global Burden Disease dataset) data correct formats join two datasets scale burden data CHRONIC_DISEASE_SCALAR account bias data split dataframe two dataframes, one deaths one years life lost (YLLs) add demographic index (age sex category) dataframe containing individual relative risk different diseases set reference scenarios iterate disease outcomes: define column names loop either 1 2 pathways depending whether PA AP affecting disease whether AP PA pathways combined : extract relevant burden disease specific scenario YLLs deaths find sum relative risks (RR) specific disease age sex category reference scenario loop non-reference scenarios: define column names find sum relative risks (RR) specific disease age sex category non-reference scenario calculate PIF (potential impact fraction), .e proportional change sum relative risks reference non-reference scenario age sex category calculate health burden (deaths ylls) non-reference scenario compared reference scenario multiplying current burden disease PIF (combine_health_and_pif.R) confidence intervals required, loop upper lower confidence interval limits calculate health burden deaths YLLs using upper lower confidence relative risks. upper lower relative risk values exist, use median value instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict injuries — injuries_function_2","title":"Predict injuries — injuries_function_2","text":"Predict injuries baseline scenarios based Poisson regression model fitted baseline fatality counts distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict injuries — injuries_function_2","text":"","code":"injuries_function_2( true_distances, injuries_list, reg_model, constant_mode = F )"},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict injuries — injuries_function_2","text":"true_distances data frame containing population distances scenario injuries_list list dataframes set scenario specific information supply regression model prediction reg_model Poisson injury regression model constant_mode whether constant (vs sampling) mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict injuries — injuries_function_2","text":"injuries2 - dataframe containing predicted fatality counts casualty mode age sex scenario, plus confidence interval limits constant mode whw_temp - list containing fatality predictions casualty strike mode pair split whw nov matrices scenario. Upper lower confidence interval predictions also included constant mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict injuries — injuries_function_2","text":"function uses Poisson regression model built distances_for_injury_function() predict fatality counts Baseline scenarios. performs following steps: create injuries data frame containing distances travelled mode, age, sex scenario predict fatalities strike casualty mode combination, age sex category scenario (incl Baseline). sample mode set 'constant' ('sample'), also predict upper lower confidence interval boundaries create whw_temp list containing total predicted fatality counts casualty strike mode pair scenario split whw nov matrices , constant mode also give upper lower confidence interval limit predictions create injuries2 data frame containing total predicted fatality counts casualty mode age sex scenario. dataframe also contains total death per age sex category , constant mode upper lower total death predictions confidence interval.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":null,"dir":"Reference","previous_headings":"","what":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"Calculate YLL burden death burden injury based ratio GBD data.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"","code":"injury_death_to_yll(injuries)"},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"injuries data frame injury deaths age sex category scenario incl. baseline","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"list injury deaths YLLs (given differences reference scenario) plus values reference scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"function performs following steps: join estimated injury deaths global burden disease (GBD) injury data age sex multiply estimated injury deaths yll injury death ratio GBD data predict YLL estimated injury deaths extract create matrices deaths ylls one column scenario create dataframe ylls deaths reference scenario create dataframe B showing differences deaths yll non-reference scenario reference scenario confidence intervals required: create dataframe ylls deaths reference scenario using lower upper relative risk boundary values create dataframe showing differences deaths yll non-reference scenario reference scenario using lower upper relative risk boundary values add confidence upper lower interval boundary values two output dataframes B","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":null,"dir":"Reference","previous_headings":"","what":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"Ordered set computations part ITHIM-Global calculates required output parameters","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"","code":"ithim_calculation_sequence(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"ithim_object name disease seed","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"ithim_object - list items making ithim result","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"function performs following steps: extract lists variables ithim_object list air pollution pathway: calculate PM2.5 exposure person synthetic population PM2.5 emissions mode scenario (scenario_pm_calculations()) calculate CO2 emissions mode scenario (scenario_co2_calculations()) assign relative risk person synthetic population disease related PM pollution scenario based individual PM exposure levels (gen_ap_rr()) physical activity pathway: calculate total mMETs person synthetic population (total_mmet()) assign relative risk person synthetic population disease related physical activity levels scenario based individual mMET values (gen_pa_rr()) physical activity air pollution combined: combine PA AP datasets joining two datasets. disease affected PA AP calculate joined relative risk multiplying PA AP relative risks (combined_rr_ap_pa()) calculate health burden (Yll deaths) disease age sex category (health_burden()): calculate health burden (Yll deaths) disease age sex category. Combine AP PA pathways diseases affected AP PA running constant mode also calculate health burden AP PA pathways separately injury pathway: estimate injury deaths baseline scenario age sex category, also estimate total injury deaths counts -hit---vehicle matrices casualty (strike) mode baseline scenario (injuries_function2()) running constant mode include upper lower confidence intervals calculate years life lost injury deaths (injury_death_to_yll()) combine pathways using outputs 3. 4.: combine AP, PA injury health burden data ylls deaths (join_hb_and_injury()) diseases, injuries scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Load data for model and prepare input data for model — ithim_load_data","title":"Load data for model and prepare input data for model — ithim_load_data","text":"Loads processes data files using city specific local data global data. Processes input data ready ITHIM-Global model run. Writes objects global environment.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load data for model and prepare input data for model — ithim_load_data","text":"","code":"ithim_load_data( speeds = list(bus = 8.1, bus_driver = 8.1, minibus = 8.1, minibus_driver = 8.1, car = 13.8, car_driver = 13.8, taxi = 13.8, pedestrian = 2.5, walk_to_pt = 2.5, cycle = 7.2, motorcycle = 15.2, truck = 8.1, van = 13.8, subway = 18.1, rail = 21.9, auto_rickshaw = 4, shared_auto = 13.8, shared_taxi = 13.8, cycle_rickshaw = 4, other = 9.1) )"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load data for model and prepare input data for model — ithim_load_data","text":"speeds named list mode speeds","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load data for model and prepare input data for model — ithim_load_data","text":"function performs following steps load process input data: find path ithimr package global local data can found check whether drpa package installed read Global Burden Disease data country read city specific trip data: set missing stage trip information known stage trip information, e.g. stage duration missing trip duration known set stage duration trip duration ensure stage modes trip modes consist set keywords, replace mode names key words, e.g. replace 'train' 'rail' remove trips age sex 'NA' Rename pedestrian stage modes non-pedestrian trips 'pedestrian' 'walk_to_pt' (call get_scenario_settings() using max_mode_share_scenario) read local Global Burden Disease (GBD) data: combine various head neck cancers, combine myeloid leukemia diseases, combine respiratory diseases level 2 adjust rectum cancer combined colon rectum cancer burden read local demographic data: find / re-define max min ages based max min ages trip data, demographic data max min ages considered model remove population data outside max min ages find proportion total population considered model total population get age-category details population data, ages max min ages removed extract diseases plus road injures GBD data, update format max min ages entry compute proportion injuries age range considered model GBD data, proportion applied injury datasets without age sex information remove ages outside age ranges considered model GBD_data create burden_of_disease dataframe GBD_data changing layout GBD_data: add city specific population data add country specific disease rate GBD data, ie. proportion number people country disease population country age sex category using country disease rate calculate city population affected disease using burden_of_disease data (now called DISEASE_BURDEN), calculate ratio YLL death age sex category road_injuries data read city specific road injury data: Set 'weight' column unique number years injury data exists (column already exist) strike mode equals casualty mode, set strike mode 'nov' (vehicle) call set_injury_contingency.R function set tables WHW (hit ) NOV (vehicle) fatalities","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"Set baseline scenario ready scenario development","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"","code":"ithim_setup_baseline_scenario(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"trip_set data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"trip_set baseline scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"function performs following steps trip set data: add distance categories add scenario='baseline' column","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":null,"dir":"Reference","previous_headings":"","what":"Set parameters for ITHIM-Global run — ithim_setup_parameters","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"Function set parameters either using constant value sampling pre-defined function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"","code":"ithim_setup_parameters( NSAMPLES = 1, BUS_WALK_TIME = 16, RAIL_WALK_TIME = 12.5, CYCLING_MET = 6.8, WALKING_MET = 3.5, PASSENGER_MET = 1.3, CAR_DRIVER_MET = 2.5, MOTORCYCLIST_MET = 2.8, SEDENTARY_ACTIVITY_MET = 1.3, LIGHT_ACTIVITY_MET = 1.3, MODERATE_PA_MET = 4, VIGOROUS_PA_MET = 8, PM_CONC_BASE = 12.69, PM_TRANS_SHARE = 0.42, PA_DOSE_RESPONSE_QUANTILE = F, AP_DOSE_RESPONSE_QUANTILE = F, BACKGROUND_PA_SCALAR = 1, BACKGROUND_PA_CONFIDENCE = 1, INJURY_REPORTING_RATE = 1, CHRONIC_DISEASE_SCALAR = 1, DAY_TO_WEEK_TRAVEL_SCALAR = 7, SIN_EXPONENT_SUM = 2, CASUALTY_EXPONENT_FRACTION = 0.5, SIN_EXPONENT_SUM_NOV = 1, SIN_EXPONENT_SUM_CYCLE = 2, CASUALTY_EXPONENT_FRACTION_CYCLE = 0.5, SIN_EXPONENT_SUM_PED = 2, CASUALTY_EXPONENT_FRACTION_PED = 0.5, SIN_EXPONENT_SUM_VEH = 2, CASUALTY_EXPONENT_FRACTION_VEH = 0.5, BUS_TO_PASSENGER_RATIO = 0.0389, CAR_OCCUPANCY_RATIO = 0.625, TRUCK_TO_CAR_RATIO = 0.3, FLEET_TO_MOTORCYCLE_RATIO = 0.441, PROPORTION_MOTORCYCLE_TRIPS = 0, PM_EMISSION_INVENTORY_CONFIDENCE = 1, CO2_EMISSION_INVENTORY_CONFIDENCE = 1, DISTANCE_SCALAR_CAR_TAXI = 1, DISTANCE_SCALAR_WALKING = 1, DISTANCE_SCALAR_PT = 1, DISTANCE_SCALAR_CYCLING = 1, DISTANCE_SCALAR_MOTORCYCLE = 1, BUS_DRIVER_PROP_MALE = 0.98, BUS_DRIVER_MALE_AGERANGE = \"19, 65\", BUS_DRIVER_FEMALE_AGERANGE = \"19, 65\", TRUCK_DRIVER_PROP_MALE = 0.98, TRUCK_DRIVER_MALE_AGERANGE = \"18, 65\", TRUCK_DRIVER_FEMALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_PROP_MALE = 0.99, COMMERCIAL_MBIKE_MALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_FEMALE_AGERANGE = \"18, 65\", MINIMUM_PT_TIME = 3, MODERATE_PA_CONTRIBUTION = 0.5, CALL_INDIVIDUAL_SIN = F, SCENARIO_NAME = \"GLOBAL\", SCENARIO_INCREASE = 0.05 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"NSAMPLES constant integer: number samples take BUS_WALK_TIME lognormal parameter: duration walk bus stage RAIL_WALK_TIME lognormal parameter: duration walk rail stage CYCLING_MET lognormal parameter: METs cycling WALKING_MET lognormal parameter: METs walking PASSENGER_MET lognormal parameter: MET value associated passenger public transport CAR_DRIVER_MET lognormal parameter: MET value associated car driver MOTORCYCLIST_MET lognormal parameter: MET value associated motorcyclist SEDENTARY_ACTIVITY_MET lognormal parameter: MET value associated sedentary activity LIGHT_ACTIVITY_MET lognormal parameter: MET value associated light activity MODERATE_PA_MET lognormal parameter: MET value associated moderate activity VIGOROUS_PA_MET lognormal parameter: MET value associated vigorous activity PM_CONC_BASE lognormal parameter: background PM2.5 concentration PM_TRANS_SHARE beta parameter: fraction background PM2.5 attributable transport PA_DOSE_RESPONSE_QUANTILE logic: whether sample physical activity relative risk dose response functions AP_DOSE_RESPONSE_QUANTILE logic: whether sample air pollution relative risk dose response functions BACKGROUND_PA_SCALAR lognormal parameter: reporting scalar physical activity correct bias data BACKGROUND_PA_CONFIDENCE beta parameter: confidence accuracy zero non-travel physical activity levels INJURY_REPORTING_RATE lognormal parameter: rate injury fatality reporting CHRONIC_DISEASE_SCALAR lognormal parameter: scalar background disease rates adjust bias GBD data DAY_TO_WEEK_TRAVEL_SCALAR beta parameter: rate scaling travel one day one week - CURRENTLY used constant (using beta parameter need considerations) SIN_EXPONENT_SUM lognormal parameter: linearity injuries respect two modes. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION beta parameter: casualty exponent contribution SIN_EXPONENT_SUM SIN_EXPONENT_SUM_NOV lognormal parameter: linearity injuries respect two modes strike mode = NOV. SIN_EXPONENT_SUM=2 means safety numbers SIN_EXPONENT_SUM_CYCLE lognormal parameter: linearity injuries respect two modes victim mode = cycle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_CYCLE beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_CYCLE victim mode = cycle SIN_EXPONENT_SUM_PED lognormal parameter: linearity injuries respect two modes victim mode = pedestrian. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_PED beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_PED victim mode = pedestrian SIN_EXPONENT_SUM_VEH lognormal parameter: linearity injuries respect two modes victim mode = vehicle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_VEH beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_VEH victim mode = vehicle BUS_TO_PASSENGER_RATIO beta parameter: number buses per passenger CAR_OCCUPANCY_RATIO beta parameter: number people per car (including driver) TRUCK_TO_CAR_RATIO beta parameter: proportion truck car vehicle km travelled FLEET_TO_MOTORCYCLE_RATIO beta parameter: amount motorcycle trips added commercial trips PROPORTION_MOTORCYCLE_TRIPS beta parameter: proportion trips added personal motorcycle trips PM_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy PM emission inventory CO2_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy CO2 emission inventory DISTANCE_SCALAR_CAR_TAXI lognormal parameter: scalar adjust bias car distance travelled DISTANCE_SCALAR_WALKING lognormal parameter: scalar adjust bias walking distance travelled DISTANCE_SCALAR_PT lognormal parameter: scalar adjust bias PT distance travelled DISTANCE_SCALAR_CYCLING lognormal parameter: scalar adjust bias cycling distance travelled DISTANCE_SCALAR_MOTORCYCLE lognormal parameter: scalar adjust biase motorcycle distance travelled BUS_DRIVER_PROP_MALE scalar: proportion bus drivers male BUS_DRIVER_MALE_AGERANGE character: age range male bus drivers BUS_DRIVER_FEMALE_AGERANGE character: age range female bus drivers TRUCK_DRIVER_PROP_MALE scalar: proportion truck drivers male TRUCK_DRIVER_MALE_AGERANGE character: age range male truck drivers TRUCK_DRIVER_FEMALE_AGERANGE character: age range female truck drivers COMMERCIAL_MBIKE_PROP_MALE scalar: proportion commercial motorcycle drivers male COMMERCIAL_MBIKE_MALE_AGERANGE character: age range male commercial motorcycle drivers COMMERCIAL_MBIKE_FEMALE_AGERANGE character: age range female commercial motorcycle drivers MINIMUM_PT_TIME scalar: minimum time person spends public transport MODERATE_PA_CONTRIBUTION scalar: proportion contribution moderate PA Leisure MVPA CALL_INDIVIDUAL_SIN logic: whether call safety number coefficients individual vehicles use coefficients modes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"list samples uncertain parameters","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"input parameters two options: set constant, sampled specified distribution. parameter given argument length 1 2. length 1, constant, set global environment. length 2, distribution defined sampled NSAMPLE times. exceptions, listed . function performs following steps: set input parameters global environment (sampling function called, overwritten) loop potential variables lognormal distribution sample distribution required loop potential variables beta distribution sample distribution required BACKGROUND_PA_CONFIDENCE<1 add BACKGROUND_PA_ZEROS parameters PM_EMISSION_INVENTORY_CONFIDENCE<1, sample PM inventory values using Dirichlet distribution parameterised gamma random variables CO2_EMISSION_INVENTORY_CONFIDENCE<1, sample CO2 inventory values using Dirichlet distribution parameterised gamma random variables PA_DOSE_RESPONSE_QUANTILE == T, find diseases related physical activity levels assign quantile sampling uniform distribution 0 1 AP_DOSE_RESPONSE_QUANTILE == T, find diseases related air pollution levels assign quantile sampling uniform distribution 0 1 bottom function, dirichlet_pointiness() function defined parameterises Dirichlet distributions PM CO2 emission inventories.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":null,"dir":"Reference","previous_headings":"","what":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"Sets sampled parameters global environment calls ITHIM routine","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"","code":"ithim_uncertainty(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"ithim_object list necessary inputs, including parameters seed sample take","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"list ITHIM outcomes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"function works performing following steps: extract ithim_object list entries extract sampled parameters stored ithim_object call set_vehicle_inventory() update emissions emission parameters sampled distribution call get_synthetic_from_trips() update synthetic trips synthetic population relevant input parameters sampled distribution call get_all_distances() recalculate distances relevant input parameters sampled distribution run ITHIM-Global model calling ithim_calculation_sequence()","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":null,"dir":"Reference","previous_headings":"","what":"Join disease health burden and injury data — join_hb_and_injury","title":"Join disease health burden and injury data — join_hb_and_injury","text":"Join two data frames health burden: disease, road-traffic injury","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join disease health burden and injury data — join_hb_and_injury","text":"","code":"join_hb_and_injury(ind_ap_pa, inj)"},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join disease health burden and injury data — join_hb_and_injury","text":"ind_ap_pa list (deaths, YLLs) data frames demographic groups' burdens diseases inj list (deaths, YLLs) data frames demographic groups' burdens road-traffic injury","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join disease health burden and injury data — join_hb_and_injury","text":"list dataframes: one deaths per cause per demographic group, likewise YLLs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join disease health burden and injury data — join_hb_and_injury","text":"function performs following steps: extract yll deaths data AP PA pathways extract yll deaths data injury data create one dataframe yll one deaths containing AP, PA injury data","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrapper for running ITHIM — run_ithim","title":"Wrapper for running ITHIM — run_ithim","text":"Switch either calculate health burden using constant input parameter values sample distributions first","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrapper for running ITHIM — run_ithim","text":"","code":"run_ithim(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrapper for running ITHIM — run_ithim","text":"ithim_object list input data needed calculate health burden seed","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrapper for running ITHIM — run_ithim","text":"ithim_object list items giving input data output results","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Wrapper for running ITHIM — run_ithim","text":"function works creating switch run computation calling ithim_calculation_sequence() directly, divert sampling case ithim_uncertainty() first extracts sampled parameters calls ithim_calculation_sequence().","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":null,"dir":"Reference","previous_headings":"","what":"Run the set up scripts for ITHIM — run_ithim_setup","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"Sets basic ITHIM object onward calculation. Data loading, processing harmonisation. Setting global values.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"","code":"run_ithim_setup( seed = 1, CITY = \"bogota\", speeds = NULL, PM_emission_inventory = NULL, CO2_emission_inventory = NULL, DIST_CAT = c(\"0-2 km\", \"2-6 km\", \"6+ km\"), AGE_RANGE = c(15, 69), ADD_WALK_TO_PT_TRIPS = T, ADD_BUS_DRIVERS = T, ADD_CAR_DRIVERS = T, ADD_TRUCK_DRIVERS = T, ADD_MOTORCYCLE_FLEET = T, ADD_PERSONAL_MOTORCYCLE_TRIPS = \"no\", REFERENCE_SCENARIO = \"baseline\", PATH_TO_LOCAL_DATA = NULL, NSAMPLES = 1, BUS_WALK_TIME = 16, RAIL_WALK_TIME = 12.5, CYCLING_MET = 6.8, WALKING_MET = 3.5, PASSENGER_MET = 1.3, CAR_DRIVER_MET = 2.5, MOTORCYCLIST_MET = 2.8, SEDENTARY_ACTIVITY_MET = 1.3, LIGHT_ACTIVITY_MET = 1.3, MODERATE_PA_MET = 4, VIGOROUS_PA_MET = 8, PM_CONC_BASE = 12.69, PM_TRANS_SHARE = 0.42, PA_DOSE_RESPONSE_QUANTILE = F, AP_DOSE_RESPONSE_QUANTILE = F, BACKGROUND_PA_SCALAR = 1, BACKGROUND_PA_CONFIDENCE = 1, INJURY_REPORTING_RATE = 1, CHRONIC_DISEASE_SCALAR = 1, DAY_TO_WEEK_TRAVEL_SCALAR = 7, SIN_EXPONENT_SUM = 2, CASUALTY_EXPONENT_FRACTION = 0.5, SIN_EXPONENT_SUM_NOV = 1, SIN_EXPONENT_SUM_CYCLE = 2, CASUALTY_EXPONENT_FRACTION_CYCLE = 0.5, SIN_EXPONENT_SUM_PED = 2, CASUALTY_EXPONENT_FRACTION_PED = 0.5, SIN_EXPONENT_SUM_VEH = 2, CASUALTY_EXPONENT_FRACTION_VEH = 0.5, BUS_TO_PASSENGER_RATIO = 0.0389, CAR_OCCUPANCY_RATIO = 0.625, TRUCK_TO_CAR_RATIO = 0.3, FLEET_TO_MOTORCYCLE_RATIO = 0.441, PROPORTION_MOTORCYCLE_TRIPS = 0, PM_EMISSION_INVENTORY_CONFIDENCE = 1, CO2_EMISSION_INVENTORY_CONFIDENCE = 1, DISTANCE_SCALAR_CAR_TAXI = 1, DISTANCE_SCALAR_WALKING = 1, DISTANCE_SCALAR_PT = 1, DISTANCE_SCALAR_CYCLING = 1, DISTANCE_SCALAR_MOTORCYCLE = 1, BUS_DRIVER_PROP_MALE = 0.98, BUS_DRIVER_MALE_AGERANGE = \"19, 65\", BUS_DRIVER_FEMALE_AGERANGE = \"19, 65\", TRUCK_DRIVER_PROP_MALE = 0.98, TRUCK_DRIVER_MALE_AGERANGE = \"18, 65\", TRUCK_DRIVER_FEMALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_PROP_MALE = 0.99, COMMERCIAL_MBIKE_MALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_FEMALE_AGERANGE = \"18, 65\", MINIMUM_PT_TIME = 3, MODERATE_PA_CONTRIBUTION = 0.5, CALL_INDIVIDUAL_SIN = F, SCENARIO_NAME = \"GLOBAL\", SCENARIO_INCREASE = 0.05 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"seed set seed get results sampling distribution CITY name city, name directory containing city data files speeds named list mode speeds PM_emission_inventory named list mode PM emissions CO2_emission_inventory named list CO2 mode emissions DIST_CAT vector string distance categories form '0-6'. (unit assumed trip set related speed values, usually km) AGE_RANGE vector minimum maximum ages include ADD_WALK_TO_PT_TRIPS logic: whether add short walks PT trips ADD_BUS_DRIVERS logic: whether add bus drivers ADD_CAR_DRIVERS logic: whether find add distance travelled individual cars, denoted car drivers ADD_TRUCK_DRIVERS logic: whether add truck drivers ADD_MOTORCYCLE_FLEET logic: whether add additional commercial motorcycle fleet ghost trips ADD_PERSONAL_MOTORCYCLE_TRIPS character: '' add personal motorcycle trips otherwise set geographic region defines set-motorcycle trips added REFERENCE_SCENARIO scenario forms reference health comparison PATH_TO_LOCAL_DATA path CITY directory, using package NSAMPLES constant integer: number samples take BUS_WALK_TIME lognormal parameter: duration walk bus stage RAIL_WALK_TIME lognormal parameter: duration walk rail stage CYCLING_MET lognormal parameter: METs cycling WALKING_MET lognormal parameter: METs walking PASSENGER_MET lognormal parameter: MET value associated passenger public transport CAR_DRIVER_MET lognormal parameter: MET value associated car driver MOTORCYCLIST_MET lognormal parameter: MET value associated motorcyclist SEDENTARY_ACTIVITY_MET lognormal parameter: MET value associated sedentary activity LIGHT_ACTIVITY_MET lognormal parameter: MET value associated light activity MODERATE_PA_MET lognormal parameter: MET value associated moderate activity VIGOROUS_PA_MET lognormal parameter: MET value associated vigorous activity PM_CONC_BASE lognormal parameter: background PM2.5 concentration PM_TRANS_SHARE beta parameter: fraction background PM2.5 attributable transport PA_DOSE_RESPONSE_QUANTILE logic: whether sample physical activity relative risk dose response functions AP_DOSE_RESPONSE_QUANTILE logic: whether sample air pollution relative risk dose response functions BACKGROUND_PA_SCALAR lognormal parameter: reporting scalar physical activity correct bias data BACKGROUND_PA_CONFIDENCE beta parameter: confidence accuracy zero non-travel physical activity levels INJURY_REPORTING_RATE lognormal parameter: rate injury fatality reporting CHRONIC_DISEASE_SCALAR lognormal parameter: scalar background disease rates adjust bias GBD data DAY_TO_WEEK_TRAVEL_SCALAR beta parameter: rate scaling travel one day one week - CURRENTLY used constant (using beta parameter need considerations) SIN_EXPONENT_SUM lognormal parameter: linearity injuries respect two modes. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION beta parameter: casualty exponent contribution SIN_EXPONENT_SUM SIN_EXPONENT_SUM_NOV lognormal parameter: linearity injuries respect two modes strike mode = NOV. SIN_EXPONENT_SUM=2 means safety numbers SIN_EXPONENT_SUM_CYCLE lognormal parameter: linearity injuries respect two modes victim mode = cycle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_CYCLE beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_CYCLE victim mode = cycle SIN_EXPONENT_SUM_PED lognormal parameter: linearity injuries respect two modes victim mode = pedestrian. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_PED beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_PED victim mode = pedestrian SIN_EXPONENT_SUM_VEH lognormal parameter: linearity injuries respect two modes victim mode = vehicle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_VEH beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_VEH victim mode = vehicle BUS_TO_PASSENGER_RATIO beta parameter: number buses per passenger CAR_OCCUPANCY_RATIO beta parameter: number people per car (including driver) TRUCK_TO_CAR_RATIO beta parameter: proportion truck car vehicle km travelled FLEET_TO_MOTORCYCLE_RATIO beta parameter: amount motorcycle trips added commercial trips PROPORTION_MOTORCYCLE_TRIPS beta parameter: proportion trips added personal motorcycle trips PM_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy PM emission inventory CO2_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy CO2 emission inventory DISTANCE_SCALAR_CAR_TAXI lognormal parameter: scalar adjust bias car distance travelled DISTANCE_SCALAR_WALKING lognormal parameter: scalar adjust bias walking distance travelled DISTANCE_SCALAR_PT lognormal parameter: scalar adjust bias PT distance travelled DISTANCE_SCALAR_CYCLING lognormal parameter: scalar adjust bias cycling distance travelled DISTANCE_SCALAR_MOTORCYCLE lognormal parameter: scalar adjust biase motorcycle distance travelled BUS_DRIVER_PROP_MALE scalar: proportion bus drivers male BUS_DRIVER_MALE_AGERANGE character: age range male bus drivers BUS_DRIVER_FEMALE_AGERANGE character: age range female bus drivers TRUCK_DRIVER_PROP_MALE scalar: proportion truck drivers male TRUCK_DRIVER_MALE_AGERANGE character: age range male truck drivers TRUCK_DRIVER_FEMALE_AGERANGE character: age range female truck drivers COMMERCIAL_MBIKE_PROP_MALE scalar: proportion commercial motorcycle drivers male COMMERCIAL_MBIKE_MALE_AGERANGE character: age range male commercial motorcycle drivers COMMERCIAL_MBIKE_FEMALE_AGERANGE character: age range female commercial motorcycle drivers MINIMUM_PT_TIME scalar: minimum time person spends public transport MODERATE_PA_CONTRIBUTION scalar: proportion contribution moderate PA Leisure MVPA CALL_INDIVIDUAL_SIN logic: whether call safety number coefficients individual vehicles use coefficients modes SCENARIO_NAME name scenarios (currently supports: TEST_WALK_SCENARIO, TEST_CYCLE_SCENARIO, MAX_MODE_SHARE_SCENARIO, LATAM, GLOBAL, AFRICA_INDIA, BOGOTA) SCENARIO_INCREASE increase given mode scenario (currently used GLOBAL, BOGOTA, LATAM AFRICA_INDIA scenarios)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"ithim_object list objects onward use.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"function used read various input files parameters process harmonise data ready health impact assessment. Input Parameters two options: set constant sampled pre-specified distribution. parameters given argument length 1 2. length 1, parameter usually used constant. parameter length 2, distribution defined sampled NSAMPLE times. function performs following steps: check whether valid scenario name called, get error message set various input parameters global parameters find path local data define fixed parameters air pollution inhalation define mode speeds: set default speeds various modes update default speeds city specific mode speeds given input parameters ensure similar modes speed assigned set-dataframe modes speeds define PM emissions inventory define default emission values update default values city specific values given input parameters define CO2 emissions inventory set default emission values update default values city specific values given input parameters load process data files calling ithim_load_data() call ithim_setup_parameters() set given input parameters global environment running constant mode obtain NSAMPLE samples given distributions input parameters running sample mode set flags cause certain parts model called later stage (ithim_uncertainty()) certain input parameters sampled distribution call complete_trip_distance_duration() add missing stage distance information trip data none corresponding input parameters sampled distribution, call set_vehicle_inventory() create dataframe mode specific speed, distance emission information none corresponding input parameters sampled distribution, call get_synthetic_from_trips() set synthetic trips synthetic population none corresponding input parameters sampled distribution, call get_all_distances() calculate trip distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale trip distances — scale_trip_distances","title":"Scale trip distances — scale_trip_distances","text":"Applies mode-specific distance scalars trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale trip distances — scale_trip_distances","text":"","code":"scale_trip_distances(trips)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale trip distances — scale_trip_distances","text":"trips data frame, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale trip distances — scale_trip_distances","text":"data frame, trips scenarios scaled distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Scale trip distances — scale_trip_distances","text":"function used multiply trip stages belonging certain mode city specific scalar. Note walk pt stages counted public transport stages multiplied DISTANCE_SCALAR_PT function performs following steps: define car public transport modes multiply stage distances stage durations corresponding distance scalars","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"Calculate total CO2 exposure mode scenario based CO2 emissions inventory","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"","code":"scenario_co2_calculations(dist)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"dist data frame population travel scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"total CO2 exposure per mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"function performs following steps: calculate emission factors mode dividing total emissions distances travelled calculate CO2 emissions mode scenario multiplying scenario distance times emission factors modes without assigned distance, use CO2 emissions VEHICLE_INVENTORY instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total AP exposure per person — scenario_pm_calculations","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"Calculate total AP exposure per person based population personal travel","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"","code":"scenario_pm_calculations(dist, trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"dist total distance travelled mode population scenarios trip_scen_sets trips data frame trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"background PM concentration baseline scenarios total AP exposure per person synthetic population (baseline scenarios)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"function performs following steps: exposure factor rates activity defined - parameters fixed calculate pm concentration related transport calculate PM emission factors mode dividing total emissions distances travelled calculate PM emissions mode scenario multiplying scenario distance emission factors modes without assigned distance, use PM emissions VEHICLE_INVENTORY instead calculate total PM concentrations scenario add exposure factors trip set stage mode add total scenario PM concentrations trip set calculate ventilation rate stage taking account demographic characteristics exposure factors calculate inhaled air total PM (micro grams) trip set calculate amount time per day spent sleep, moderate vigorous activities add total time spent travelling participant trip set calculate ventilation rate sleep, moderate vigorous activities participant synthetic population (travel component), calculate total air inhaled, total PM inhaled total PM concentration inhaled scenario assign participants synthetic population without travel component, baseline scenario PM concentrations join people without travel synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":null,"dir":"Reference","previous_headings":"","what":"Injury summary statistics — set_injury_contingency","title":"Injury summary statistics — set_injury_contingency","text":"Creates summarised injury tables 'hit ' 'vehicle' fatality counts casualty strike mode combination (age sex combination information exists)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Injury summary statistics — set_injury_contingency","text":"","code":"set_injury_contingency(injuries)"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Injury summary statistics — set_injury_contingency","text":"injuries data frame individual injury events","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Injury summary statistics — set_injury_contingency","text":"function performs following steps using individual fatality injury input file: data split WHW (hit ) matrix casualty strike mode given NOV (vehicle) matrix strike mode set NOV ithim_load_data() vehicle involved accident. age gender information given, counts multiplied proportion injuries relevant proportion population considered model (e.g. 15 - 65 year olds) based GBD data Data aggregated casualty strike mode, age sex information exists Complete whw nov matrices containing casualty strike (age sex) combinations created zero counts combinations fatalities list aggregated whw nov matrices set Global environment","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_scenario_specific_variables.html","id":null,"dir":"Reference","previous_headings":"","what":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","title":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","text":"Set NSCEN, SCEN SCEN_SHORT_NAME","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_scenario_specific_variables.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","text":"","code":"set_scenario_specific_variables()"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":null,"dir":"Reference","previous_headings":"","what":"Collate all vehicle information — set_vehicle_inventory","title":"Collate all vehicle information — set_vehicle_inventory","text":"Puts vehicle information one place including speeds emission factors. Writes global environment.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Collate all vehicle information — set_vehicle_inventory","text":"","code":"set_vehicle_inventory()"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Collate all vehicle information — set_vehicle_inventory","text":"function performs following operations: Based city specific (default) mode speeds, vehicle inventory initialised PM emissions added city specific (default) PM inventory big_truck mode added distance mode used air pollution modules mode added already exist travel survey (hence mode speeds) CO2 emissions added city specific (default) CO2 inventory car_driver exists, car_driver emissions set PM CO2 car emissions VEHICLE_INVENTORY set global variable","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total mMETs per person — total_mmet","title":"Calculate total mMETs per person — total_mmet","text":"Calculate total mMETs per person synthetic population based non-travel PA active travel scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total mMETs per person — total_mmet","text":"","code":"total_mmet(trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total mMETs per person — total_mmet","text":"trip_scen_sets data frame trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total mMETs per person — total_mmet","text":"mmets - total mMETs per week per person scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total mMETs per person — total_mmet","text":"function performs following steps: extract people trip set active travel (walk cycle) stage mode (non-ghost trips ) calculate weekly time spent active travel scenario: scale non-travel mMET value people synthetic population BACKGROUND_PA_SCALAR adjust biases PA data calculate total cycling walking mMET values relevant person trip set scale week add active travel mMET non-travel mMET values person synthetic population create one dataframe total MMET people synthetic population scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":null,"dir":"Reference","previous_headings":"","what":"Add walk to public transport stages — walk_to_pt_and_combine_scen","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"Adds short walk stage public transport (PT) trip required.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"","code":"walk_to_pt_and_combine_scen(SYNTHETIC_TRIPS)"},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"trip_set list data frames, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"data frame, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"function performs following steps: create list containing dataframes synthetic trips scenario ADD_WALK_TO_PT_TRIPS == T, .e additional 'walk pt' stages added: filter trips public transport stage mode divide public transport trips without 'walk pt' stage add 'walk pt' stage public transport trips without walking stage (add_walk_trips()) combine trips scenarios one dataframe scale stage distances durations calling scale_trip_distances.R function","code":""}] +[{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"how-to-run-ithim-global","dir":"Articles","previous_headings":"","what":"How to run ITHIM-Global","title":"How to run ITHIM","text":"guide explain install ITHIM-R package, run model ITHIM-Global using package produce summaries key results. Please note guide written Windows 10 work similarly different operating systems. using latest R version - time writing, R version 4.3.3 (2024-02-29).","code":""},{"path":[]},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"pre-requisites","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Pre-requisites","title":"How to run ITHIM","text":"following programmes need installed ITHIM-R package can used: Git R - version 4.3.3 (2024-02-29) R Studio","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"cloning-the-github-repository","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Cloning the Github repository","title":"How to run ITHIM","text":"clone (.e. download) ITHIM-R Github repository, open command window pressing button Git tab, press New Terminal terminal window appear navigate folder want install repository type: Note: ’d like install just latest version ignoring history, may use --depth 1 parameter, : much quicker install. Github repository now downloaded computer working branch - default branch, set bogota documentation refers .","code":"git clone https://github.com/ITHIM/ITHIM-R.git git clone https://github.com/ITHIM/ITHIM-R.git --depth 1"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"installing-the-package-in-rstudio","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package","what":"Installing the package in RStudio","title":"How to run ITHIM","text":"open ITHIM-R package RStudio double click ITHIM-R.Rproj file inside ITHIM-R folder saved computer. open package RStudio.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"install-all-dependent-packages","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package > Installing the package in RStudio","what":"Install all dependent packages","title":"How to run ITHIM","text":"install ITHIM package, need make sure dependent packages already installed computer. process continue, please make sure already installed renv package. installed, please run command console: install package see message package renv successfully unpacked MD5 sums checked completed, may use package renv verify/check already dependent R packages ithim locally installed computer. , please run command: case missing date packages, display list , may run restore function updated/installed, : update install required packages.","code":"install.packages(\"renv\") renv::status() renv::restore()"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"install-the-ithim-r-package","dir":"Articles","previous_headings":"How to run ITHIM-Global > How to install the ITHIM-R package > Installing the package in RStudio","what":"Install the ITHIM-R package","title":"How to run ITHIM","text":"install ITHIM-R package RStudio, following steps need performed: 1.) Git installed Build tab top right hand corner RStudio. Click tab Install panel . get newest updates Bogota branch, go Git tab RStudio next Build tab click Pull. automatically download newest changes Github. update ITHIM-R package computer, need go Build tab click Install . (Alternatively, code none input files changed, instead clicking Install, can also click Load option exists , .e. devtools installed. faster way update package work minor code changes.) recommended pull install newest updates regular basis.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"running-ithim-global","dir":"Articles","previous_headings":"How to run ITHIM-Global","what":"Running ITHIM-Global","title":"How to run ITHIM","text":"run ITHIM-Global using ITHIM-R package various input files parameters need updated first. multi_city_script.R can used call core functions required run ITHIM-R. Note multi_city_script.R set run ITHIM-Global various cities one go required looping cities one one.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"update-input-parameters","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Update input parameters","title":"How to run ITHIM","text":"several input parameters files need updating running ITIHM-Global: 5 files specific city saved directory city’s name. (See inst/ext/local/bogota example files also information). files need saved inst/extdata/local/‘city’ folder, city replaced appropriate city name. file containing various input parameters cities code run saved ITHIM-R folder. branch, file called Bogota_InputParameters_vxx.xlsx, vxx refers latest version number file. contains input parameters Bogota can easily extended contain input parameter values various cities, using format structure shown sheet. global datasets - exposure-response relationships air pollution pathway. files can found inst/extdata/global folder usually need changed, unless user different preferences. See information.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"city-specific-files-local-input-parametersdatasets-","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Update input parameters","what":"City-specific files (local input parameters/datasets).","title":"How to run ITHIM","text":"section covers 5 city-specific input files required run model. Travel survey (example trips dataset). table trips taken group people given weekday. also includes people take trips. data come official travel survey city possible. One row per trip (stage trip) Minimal columns: participant_id, age, sex, trip_mode, trip_duration (trip_distance) columns: stage_mode, stage_duration (stage_distance) Injury events (example injuries dataset). table recorded road-traffic injury (fatality) events city one years.NOV refers Vehicle. One row per event Minimal columns: victim mode (cas_mode) strike mode (strike_mode) columns: year, cas_age, cas_gender, weight (weight column give number years data exists year information given) Baseline mortality years life lost (example dataset). gives burden mortality years life lost (YLL) different causes mortality YLL. city-specific information exists, country level information can used. One row per health outcome/metric/age/gender combination Minimal rows: Measure (death/YLL); sex_name (Male/Female); age_name (‘x y’); cause_name (health outcome names); val (value burden); population (number people val corresponds , e.g. population country) Population city (example population dataset). information used scale baseline mortality YLL data country’s value city’s population study. One row per demographic group Columns: sex, age, population age column share boundaries age_name baseline mortality YLL data, can aggregated. Physical activity survey (example physical activity dataset). used represent physical activity levels city taken official physical activity survey city possible. One row per person Columns: sex, age, ltpa_marg_met (background non-transport, non-occupational weekly PA volume mMETS hours)","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"global-files-global-input-parametersdatasets","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Update input parameters","what":"Global files (global input parameters/datasets)","title":"How to run ITHIM","text":"order setup model, need fixed list tables/datasets, change across cities/ applied similarly cities hence referred “Global”, : Health outcome interaction table. table list health outcomes related specific pathway Air Pollution Physical Activity also interaction . Air Pollution Exposure Response Functions (ERFs). give exposure-response relationships air pollution (PM2.5) impact health different health outcomes. collected/cleaned datasets published studies . Physical Activity Dose-Response Functions (DRFs). dose-response relationships physical activity impact health different health outcomes. Similar air pollution, comes published studies. now sits independent R package called drpa. Ventilation rate tables. data can found inst/extdata/global/ventilation_rate details distribution parameters required estimate much air inhaled different people across different activities model’s baseline population.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"call-multi_city_script-r","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Call multi_city_script.R","title":"How to run ITHIM","text":"order run ITHIM-R installed various input files described updated, open multi_city_script.R file within RStudio. file can found Files tab middle pane right hand side. key script run ITIHM-Global constant mode (.e. keeping input parameters fixed, without sampling input parameters distributions). reads required datasets initialises variables calling run_ithim_setup runs model calling run_ithim. First, update parameter values beginning script set-e.g. city / cities script run. can found Line 63 set ‘bogota’ worked example. https://github.com/ITHIM/ITHIM-R/blob/de2a88548af6c6be5eb36d939e178b146d1ba055/multi_city_script.R#L63 several city names given vector, model performs ITHIM-R analysis one city another. parameter values updated, click Source model run. produces pop-windows showing plots results giving years life lost scenario required health outcomes.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"ithim_objects","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"ithim_objects","title":"How to run ITHIM","text":"ithim_objects list saved results/multi_city/io_“,output_version,”.rds, output_version currently set SHA number (.e. unique identifier) latest update Github can also updated manually user multi_city_script.R. may view using command View(ithim_objects) show content : may click individual sub-items bogota information. list contains comprehensive set intermediate final results model run: city modelled contains following data: trip_scen_sets: trip data scenarios baseline population, .e. population sample built combining household travel survey physical activity survey data. dist: total stage mode distances mode scenario (including baseline) baseline population. dur: total stage mode durations mode scenario (including baseline) baseline population. true_dist: distances trip data scaled total distance travelled baseline population city (age ranges considered model ) scenario (including baseline) mode transport. inj_distances: true_distances: city baseline population mode distances age category sex considered model. injuries_list: scenarios (including baseline) two lists given, one whw (-hit-) injuries strike casualty mode known one nov (vehicle) injuries strike vehicle involved crash lists contain casualty (strike) mode combinations age category sex. Furthermore, detail casualty (strike) mode distances travelled entire city baseline population considered model (‘_sum’) just respective age sex category. also detail casualty (strike) mode exponents used injury Poisson regression model. reg_model: parameterised Poisson injury regression model injuries. injuries_for_model: baseline data containing fatality counts casualty strike mode combinations associated city’s baseline population distance data (true_distances explained ) . demographic: city population counts age categories sex combinations considered model. synth_pop: population extracted physical activity survey assigning non-transport, non-occupational PA component physical activity values mMETs hours per person per week. outcomes: mmets: Marginal MET values person baseline population scenario. pm_conc_pp: PM2.5 concentration attributed person baseline population scenario (including baseline). co2_emission_inventory: total CO2 emission levels mode transport scenario (including baseline). ref_injuries: number injury deaths years life lost age sex category baseline scenario including upper lower confidence interval values hb: health burden (deaths years life lost (YLL) two separate dataframes) age sex category health outcome using combined result health outcomes impacted air pollution physical activity levels. pathway_hb: health burden (deaths years life lost (YLL) two separate dataframes) age sex category health outcome keeping results health outcomes impacted air pollution physical activity levels separate. whw: number fatalities strike casualty modes -hit---vehicle injuries scenarios (including baseline). disease_burden: health outcome burden health outcomes baseline scenario (deaths years life lost) age sex categories considered model (input data). PM_emission_inventory: PM emission inventory mode transport baseline scenario (input data). injury_table: summarised total road fatality counts injury input data age sex category strike casualty mode years (weight column) given input data whw (-hit-) nov (--vehicle) injuries. vehicle_inventory: gives speed CO2 PM2.5 emissions inventories vehicles baseline scenario. location: country continent information. new_walk_trips_count: number rail bus trips additional walking stage added model run. Scen_prop: proportion trips mode converted distance category scenario. Ithim_run: information ITHIM-R run name input parameters file, name scenario definition used, baseline scenario, scenario names, computation mode (constant sample), timestamp model run, output version number, author model run additional comments particular model run.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary-of-key-results","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global","what":"Summary of key results","title":"How to run ITHIM","text":"various scripts can used produce output summary tables results: three markdown documents (root folder, shown ) producing html csv files: summary_tables.Rmd summary_tables_PA_AP.Rmd injury_tables.Rmd Note: please execute command run (knit) three documents - produce html files along necessary CSV files (stored results subfolder) Shiny application creating Pivot table: app.R results_app folder","code":"source(\"Create_output_summaries.R\")"},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"producing-the--rmd-file-outputs","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Producing the .Rmd file outputs","title":"How to run ITHIM","text":"run various .Rmd files, can use Create_output_summaries.R script saved root folder source(\"Create_output_summaries.R\") following outputs produced:","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary_tables-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"summary_tables.Rmd","title":"How to run ITHIM","text":".Rmd file summarises mode splits, distances durations travelled, addition attributable health impacts (YLL deaths different health outcomes) different injury, physical activity (PA) air pollution (AP) pathways also health outcome produces following output documents: html file (saved root folder) containing information listed . Note Rmd file set produce many distance, duration health outcomes tables commented highlight main results easily added : table displays Baseline mode split distance category, case: 0-2 km, 2-6 km >6km table displays mode split scenario city-specific distance tables showing average daily distances km travelled person baseline population mode scenarios (including Baseline) city-specific distance tables showing average daily distances km travelled person baseline population trip mode scenarios (including Baseline) city-specific duration tables showing average daily duration (mins) spent travelling person baseline population mode scenarios (including Baseline) city-specific duration tables showing average daily duration (mins) spent travelling person baseline population trip mode scenarios (including Baseline) output .csv files containing information listed . Note files also saved version number file name: ylls.csv file (results/multi_city/health_impacts/ylls.csv) gives changes YLL age sex category, health outcome scenario compared baseline scenario. also shows health outcomes three level heirarchy, whether health outcome attributed changes AP, PA , age, age sex specific population levels. results either AP PA health outcomes impacted AP PA seperately, results combined AP PA, health outcomes impacted AP PA. ylls_pathway.csv file (results/multi_city/health_impacts/ylls_pathway.csv) gives changes YLL age sex category, health outcome scenario compared baseline scenario. also shows health outcome three level hierarchy, whether health outcome attributed changes AP PA, age, age sex specific population levels. results given AP PA independently even health outcome impacted pathways. deaths.csv file (results/multi_city/health_impacts/deaths.csv) gives changes deaths age sex category, health outcome scenario compared baseline scenario. also shows health outcomes three level hierarchy, whether health outcome attributed changes AP, PA , age, age sex specific population levels. results either AP PA health outcomes impacted AP PA results combined AP PA impacts health outcomes impacted AP PA. deaths_pathway.csv file (results/multi_city/health_impacts/deaths_pathway.csv) gives changes deaths age sex category, health outcome scenario compared baseline scenario. also shows health outcome three level hierarchy, whether health outcome attributed changes AP PA, age, age sex specific population levels. results given AP PA independently even health outcome impacted pathways.","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"summary_tables_pa_ap-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"summary_tables_PA_AP.Rmd","title":"How to run ITHIM","text":".Rmd file can used summarise ambient PM2.5 concentrations, PM2.5 personal exposure levels, CO2 emissions physical activity levels scenarios including baseline. produces following output documents: html file (saved root folder) containing information listed : boxplots daily individual PM2.5 exposure levels scenario including baseline one table detailing individual PM2.5 exposure levels including mean, 5th, 50th 95th percentiles, mean PM2.5 concentration levels scenario change PM2.5 compared baseline scenario one table detailing percentage baseline PM2.5 emissions attributed transport mode, city wide PM2.5 concentration percentage concentration attributed transport one table detailing baseline CO2 emissions scenario boxplots individual mMET physical activity levels scenario one table giving mean, 5th, 50th 95th percentile levels individual physical activity levels (mMETs) scenario one table detailing average mMETs levels scenario 2nd Option: boxplots daily individual PM2.5 exposure levels scenario one table detailing baseline PM2.5 emissions mode, city wide PM2.5 concentration percentage concentration attributed transport one table detailing individual PM2.5 exposure levels including mean, 5th, 50th 95th percentiles, mean PM2.5 concentration scenario change PM2.5 compared baseline scenario. table also contains CO2 emissions scenario boxplots individual mMET physical activity levels scenario output .csv/.xlsx files containing information listed : desc_stats.csv file (results/multi_city/AP/desc_stats.csv, also saved output version name) containing summary statistics individual PM2.5 exposure levels, total PM2.5 concentration, change PM2.5 concentration compared baseline scenario total transport related CO2 emissions scenario desc_stats.xlsx file (results/multi_city/AP/desc_stats_output_version.xlsx) containing following tabs: PM_2.5_emission_inventory: table detailing percentage Baseline PM2.5 emissions attributed transport mode, city wide PM2.5 concentration percentage concentrations attributed transport CO2_emission_inventory: table detailing CO2 emissions scenario summary_stats_PM2.5_CO2: summary statistics individual PM2.5 exposure levels, total PM2.5 concentration, change PM2.5 concentration compared baseline scenario total transport related CO2 emissions scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"injury_tables-rmd","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"injury_tables.Rmd","title":"How to run ITHIM","text":".Rmd file can used summarise injury outcomes. produces following output documents: html file (saved root folder) containing information listed : fatality counts strike casualty mode scenario (including lower upper confidence interval values applicable); one table scenario mean, upper lower confidence interval values fatality counts giving lower, mean upper bounds (applicable) casualty mode strike mode scenario; one table casualty mode, scenario tables showing fatalities per billion km travelled scenario mean, upper lower confidence interval values (applicable). tables showing number deaths per 100,000 people scenario mean, upper lower confidence interval values (applicable). tables showing fatalities per 100 million hours travelled scenario mean, upper lower confidence interval values (applicable). output .csv files containing information listed . Note files also saved version number file name: inj_counts.csv file (results/multi_city/inj/inj_counts.csv) contains fatality counts (mean upper lower confidence interval values required, seperate row) scenario casualty strike mode pair. also includes observed baseline fatality counts active travel fatality counts casualty mode (sum cycle walk casualty mode fatalities) injury_risks_per_billion_kms.csv file (results/multi_city/inj/injury_risks_per_billion_kms.csv) gives fatalities per billion km travelled scenario casualty mode. also includes upper lower confidence interval values required, separate row, active travel counts sum walking cycling injury_risks_per_100k_pop.csv file (results/multi_city/inj/injury_risks_per_100k_pop.csv) gives fatalities per 100k people scenario casualty mode. also includes upper lower confidence interval values required, separate row, active travel counts sum walking cycling distances.csv file (results/multi_city/inj/distances.csv) contains population distances travelled per day scenario mode injury_risks_per_100million_h.csv file (results/multi_city/inj/injury_risks_per_100million_h.csv) gives fatalities per 100 million hours travelled scenario casualty mode. also includes upper lower confidence interval values required, seperate row, active travel counts sum walking cycling inj_data.xlsx file (results/multi_city/inj/inj_data.xlsx) contains injury output csv files","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"shiny-app-pivot-table","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Shiny App Pivot table","title":"How to run ITHIM","text":"application allows produce Pivot tables health injury outcomes. Pivot tables allow filter outcomes follows. scenario deaths years life lost health outcome levels three levels hierarchy age sex group pathway / dose whether include interaction air pollution physical activity pathways whether include confidence intervals scenario mode risk type (total fatalities, per billion km, per 100k people, per 100 million hours)","code":""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"producing-the-shiny-app-pivot-table-output","dir":"Articles","previous_headings":"How to run ITHIM-Global > Running ITHIM-Global > Summary of key results","what":"Producing the Shiny App Pivot table output","title":"How to run ITHIM","text":"produce Shiny App Pivot tables, run function app.R results_app folder. Depending whether want read results latest updates Github local drive, set (Comment option don’t need.)","code":"github_path <- \"https://raw.githubusercontent.com/ITHIM/ITHIM-R/bogota/\" github_path <- \"../\""},{"path":"https://ithim.github.io/ITHIM-R/articles/how-to-run-ITHIM.html","id":"structure-of-ithim-global-github-repository---bogota-branch","dir":"Articles","previous_headings":"How to run ITHIM-Global","what":"Structure of ITHIM-Global Github repository - Bogota branch","title":"How to run ITHIM","text":"Github repository Bogota branch structured follows: .github: specifies metadata various documents, automatically created Github. R: contains R functions written ITIHM-R package. inst/extdata: folder containing local city-specific global input files. man: manual containing various functions used within ITHIM-R figures used various documentation documents. also built automatically. results: contains results model runs. results_app: contains functions used produce Shiny pivot tables results. vignettes: contains additional documentation information .Rbuildignore, .gitignore: metadata created Github. Bogota_InputParameters_vxx.xlsx - file containing local city-specific input parameters needs manual updating. Create_output_summaries.R - wrapper script create various output documents. DESCRIPTION: automatically created Github. How_To_Run_ITHIM: document describing various steps needed run ITHIM-Global model downloading installing ITHIM-R preparing input parameters files running code. ITHIM-R.Rproj: contains metadata ITHIM-R package. LICENSE: gives information licence applied repository. NAMESPACE: automatically created Github. OutputVersionControl.txt: file storing main run information ITHIM-R runs. automatically updated, required, using multi_city_script.R. README: document giving overview ITHIM-R package. _config.yml, _pkgdown.yml: metadata created Github. injury_tables.Rmd: R markdown document can used create summary statistics injury results. injury_tables_output_version.html: html files containing injury summary statistics respective model runs. multi_city_script.R: wrapper function call various functions needed perform ITHIM-Global analysis. summary_tables.Rmd: R markdown document create summary output statistics distance, duration, mode splits health outcomes. summary_tables_output_version.html: html files containing output summaries respective model runs. summary_tables_PA.Rmd: R markdown document create summary output statistics air pollution physical activity levels. summary_tables_PA_output_version.html: html files containing air pollution physical activity output statistics respective model runs.","code":""},{"path":"https://ithim.github.io/ITHIM-R/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Ali Abbas. Author, maintainer. Anna Schroeder. Author. Daniel Gil. Author. Lambed Tatah. Author. Rob Johnson. Author.","code":""},{"path":"https://ithim.github.io/ITHIM-R/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Abbas , Schroeder , Gil D, Tatah L, Johnson R (2023). “ithimr: Integrated Transport Health Impact Model.” https://ithim.github.io/ITHIM-R/.","code":"@Misc{ithim_methods_paper, url = {https://ithim.github.io/ITHIM-R/}, author = {Ali Abbas and Anna Schroeder and Daniel Gil and Lambed Tatah and Rob Johnson}, title = {ithimr: Integrated Transport and Health Impact Model}, year = {2023}, }"},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"ithim-r","dir":"","previous_headings":"","what":"Integrated Transport and Health Impact Model","title":"Integrated Transport and Health Impact Model","text":"Development Integrated Transport Health Impact Modelling Tool (ITHIM) R, also known ITHIM version 3.0. Started January 2018. document aims comprehensive record calculations ITHIM pipeline, specifically ITHIM- R package.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"how-to-use-the-package","dir":"","previous_headings":"","what":"How to use the package","title":"Integrated Transport and Health Impact Model","text":"written -guide explains install ITHIM-R package, run ITHIM-Global model using package produce summaries key results. Please read : run ITHIM?.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"citation","dir":"","previous_headings":"How to use the package","what":"Citation","title":"Integrated Transport and Health Impact Model","text":"cite package ‘ithimr’ publications use: Ali Abbas, Anna Schroeder et al. (2023). ithimr: Integrated Transport Health Impact Model. R package version 0.1.2. BibTeX entry LaTeX users @Manual{, title = {ithimr: Integrated Transport Health Impact Model}, author = {Ali Abbas Anna Schroeder Daniel Gil Lambed Tatah Rob Johnson}, year = {2023}, note = {R package version 0.1.2, https://github.com/ITHIM/ITHIM-R}, url = {https://ithim.github.io/ITHIM-R/}, }","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"outline","dir":"","previous_headings":"How to use the package","what":"Outline","title":"Integrated Transport and Health Impact Model","text":"ITHIM performs integrated assessments health impacts user-defined transport scenarios policies urban national levels. health impacts transport policies modelled changes physical activity, road traffic injury risk, exposure fine particulate matter (PM2.5) air pollution. addition, model estimates changes CO2 emissions. ITHIM used researchers health transport professionals estimate health impacts scenarios, compare impacts travel patterns different locations, model impacts interventions. ITHIM works either stand-alone model can linked models (e.g. transport, health, economic) quasi-microsimulation model exposure individual person level, health impacts estimated aggregated age groups, constrained available Global Burden Disease (GBD) data.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"physical-activity","dir":"","previous_headings":"How to use the package > Outline","what":"Physical Activity","title":"Integrated Transport and Health Impact Model","text":"ITHIM models exposure physical activity comparing distributions weekly physical activity different scenarios. Walking, cycling types physical activity combined marginal MET hours per week activity. Outcomes affected physical activity include several cardiovascular diseases, depression, dementia, diabetes, breast cancer colon cancer. ITHIM also models changes health -cause mortality. comparative risk assessment method used estimate changes population physical activity lead changes health burden.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"road-traffic-injuries","dir":"","previous_headings":"How to use the package > Outline","what":"Road Traffic Injuries","title":"Integrated Transport and Health Impact Model","text":"Road traffic injuries modelled using model based risk, distance speed. Differences risk sex age also taken account. approach allows ITHIM look absolute number injuries risk injury might change different modes transport travel distances modes change.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"air-pollution","dir":"","previous_headings":"How to use the package > Outline","what":"Air Pollution","title":"Integrated Transport and Health Impact Model","text":"Fine particulate matter (PM2.5) air pollution risks calculated general population (background rates) well travellers using mode specific rates different transport modes. Inhalation rates assumptions time use used calculate PM2.5 dose across different travel non-travel activities. Exposure changes population based comparison locally generated PM2.5 emissions concentrations study area.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"co2-emissions","dir":"","previous_headings":"How to use the package > Outline","what":"CO2 Emissions","title":"Integrated Transport and Health Impact Model","text":"carbon dioxide (CO2) pathway models carbon dioxide (CO2) emissions motorised vehicles. CO2 pathway estimates single metric: total CO2 emissions modelled scenario. method calculate CO2 emissions similar one PM2.5.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"health-outcomes","dir":"","previous_headings":"How to use the package > Outline","what":"Health Outcomes","title":"Integrated Transport and Health Impact Model","text":"health impacts ITHIM presented years life lost (YLL) number attributable deaths seperately pathway, addition accounting interaction physical activity air pollution. Background mortality YLL data study areas estimated Global Burden Disease studies.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"data-inputs","dir":"","previous_headings":"How to use the package","what":"Data inputs","title":"Integrated Transport and Health Impact Model","text":"ITHIM-R requires 5 user defined input files csv format, saved directory city’s name. See inst/ext/local/bogota example files. also numerous assumptions user can parameterize model. section talks files (datasets) required setup run model. two subsections, : City-specific files (local input parameters/datasets). Global files (global input parameters/datasets).","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"city-specific-files","dir":"","previous_headings":"How to use the package","what":"City-specific files","title":"Integrated Transport and Health Impact Model","text":"section covers file inputs (specific city) required run model. Travel survey (example trips dataset). table trips taken group people given weekday. also includes people take trips. One row per trip (stage trip). Minimal columns: participant_id, age, sex, trip_mode, trip_duration (trip_distance). columns: stage_mode, stage_duration (stage_distance). Injury events (example injuries dataset). table recorded road-traffic injury (fatality) events city one years. One row per event. Minimal columns: victim mode (cas_mode) strike mode (strike_mode). columns: year, cas_age, cas_gender, weight (e.g. multiple years combined). Baseline mortality years life lost data (example burden dataset). One row per health outcome/metric/age/gender combination. Minimal rows: Measure (death/YLL); sex_name (Male/Female); age_name (‘x y’); cause_name (cause mortality YLL); val (value burden); population (number people val corresponds , e.g. population country). Population city (example population dataset). used order scale baseline mortality YLL data country’s values city’s population study. One row per demographic group. Columns: sex, age, population. age column share boundaries age_name baseline mortality YLL data, can aggregated. Physical activity survey (example physical activity dataset) One row per person. Columns: sex, age, ltpa_marg_met (total non-occupational PA week).","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"global-files","dir":"","previous_headings":"How to use the package","what":"Global files","title":"Integrated Transport and Health Impact Model","text":"order setup model, need fixed list tables/datasets, change across cities/ applied similarly cities hence referred “Global”, : Health outcome interaction table. table list health outcomes related specific pathway Air Pollution Physical Activity also interaction . Air Pollution Exposure Response Functions (ERFs). give exposure-response relationships air pollution (PM2.5) impact health different health outcomes. collected/cleaned datasets published studies . Physical Activity Dose-Response Functions (DRFs). dose-response relationships physical activity impact health different health outcomes. Similar air pollution, comes published studies. now sits independent R package called drpa.","code":""},{"path":"https://ithim.github.io/ITHIM-R/index.html","id":"how-to-run-the-model","dir":"","previous_headings":"","what":"How to run the model?","title":"Integrated Transport and Health Impact Model","text":"setup, reading required datasets initialising variables, call run_ithim_setup() run model, call run_ithim(). function used call run_ithim_setup run_ithim multi_city_script also reads relevant input parameter files.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc.  Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"GNU General Public License free, copyleft license software kinds works. licenses software practical works designed take away freedom share change works. contrast, GNU General Public License intended guarantee freedom share change versions program–make sure remains free software users. , Free Software Foundation, use GNU General Public License software; applies also work released way authors. can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge wish), receive source code can get want , can change software use pieces new free programs, know can things. protect rights, need prevent others denying rights asking surrender rights. Therefore, certain responsibilities distribute copies software, modify : responsibilities respect freedom others. example, distribute copies program, whether gratis fee, must pass recipients freedoms received. must make sure , , receive can get source code. must show terms know rights. Developers use GNU GPL protect rights two steps: (1) assert copyright software, (2) offer License giving legal permission copy, distribute /modify . developers’ authors’ protection, GPL clearly explains warranty free software. users’ authors’ sake, GPL requires modified versions marked changed, problems attributed erroneously authors previous versions. devices designed deny users access install run modified versions software inside , although manufacturer can . fundamentally incompatible aim protecting users’ freedom change software. systematic pattern abuse occurs area products individuals use, precisely unacceptable. Therefore, designed version GPL prohibit practice products. problems arise substantially domains, stand ready extend provision domains future versions GPL, needed protect freedom users. Finally, every program threatened constantly software patents. States allow patents restrict development use software general-purpose computers, , wish avoid special danger patents applied free program make effectively proprietary. prevent , GPL assures patents used render program non-free. precise terms conditions copying, distribution modification follow.","code":""},{"path":[]},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_0-definitions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"0. Definitions","title":"GNU General Public License","text":"“License” refers version 3 GNU General Public License. “Copyright” also means copyright-like laws apply kinds works, semiconductor masks. “Program” refers copyrightable work licensed License. licensee addressed “”. “Licensees” “recipients” may individuals organizations. “modify” work means copy adapt part work fashion requiring copyright permission, making exact copy. resulting work called “modified version” earlier work work “based ” earlier work. “covered work” means either unmodified Program work based Program. “propagate” work means anything , without permission, make directly secondarily liable infringement applicable copyright law, except executing computer modifying private copy. Propagation includes copying, distribution (without modification), making available public, countries activities well. “convey” work means kind propagation enables parties make receive copies. Mere interaction user computer network, transfer copy, conveying. interactive user interface displays “Appropriate Legal Notices” extent includes convenient prominently visible feature (1) displays appropriate copyright notice, (2) tells user warranty work (except extent warranties provided), licensees may convey work License, view copy License. interface presents list user commands options, menu, prominent item list meets criterion.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_1-source-code","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"1. Source Code","title":"GNU General Public License","text":"“source code” work means preferred form work making modifications . “Object code” means non-source form work. “Standard Interface” means interface either official standard defined recognized standards body, , case interfaces specified particular programming language, one widely used among developers working language. “System Libraries” executable work include anything, work whole, () included normal form packaging Major Component, part Major Component, (b) serves enable use work Major Component, implement Standard Interface implementation available public source code form. “Major Component”, context, means major essential component (kernel, window system, ) specific operating system () executable work runs, compiler used produce work, object code interpreter used run . “Corresponding Source” work object code form means source code needed generate, install, (executable work) run object code modify work, including scripts control activities. However, include work’s System Libraries, general-purpose tools generally available free programs used unmodified performing activities part work. example, Corresponding Source includes interface definition files associated source files work, source code shared libraries dynamically linked subprograms work specifically designed require, intimate data communication control flow subprograms parts work. Corresponding Source need include anything users can regenerate automatically parts Corresponding Source. Corresponding Source work source code form work.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_2-basic-permissions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"2. Basic Permissions","title":"GNU General Public License","text":"rights granted License granted term copyright Program, irrevocable provided stated conditions met. License explicitly affirms unlimited permission run unmodified Program. output running covered work covered License output, given content, constitutes covered work. License acknowledges rights fair use equivalent, provided copyright law. may make, run propagate covered works convey, without conditions long license otherwise remains force. may convey covered works others sole purpose make modifications exclusively , provide facilities running works, provided comply terms License conveying material control copyright. thus making running covered works must exclusively behalf, direction control, terms prohibit making copies copyrighted material outside relationship . Conveying circumstances permitted solely conditions stated . Sublicensing allowed; section 10 makes unnecessary.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_3-protecting-users-legal-rights-from-anti-circumvention-law","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"3. Protecting Users’ Legal Rights From Anti-Circumvention Law","title":"GNU General Public License","text":"covered work shall deemed part effective technological measure applicable law fulfilling obligations article 11 WIPO copyright treaty adopted 20 December 1996, similar laws prohibiting restricting circumvention measures. convey covered work, waive legal power forbid circumvention technological measures extent circumvention effected exercising rights License respect covered work, disclaim intention limit operation modification work means enforcing, work’s users, third parties’ legal rights forbid circumvention technological measures.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_4-conveying-verbatim-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"4. Conveying Verbatim Copies","title":"GNU General Public License","text":"may convey verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice; keep intact notices stating License non-permissive terms added accord section 7 apply code; keep intact notices absence warranty; give recipients copy License along Program. may charge price price copy convey, may offer support warranty protection fee.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_5-conveying-modified-source-versions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"5. Conveying Modified Source Versions","title":"GNU General Public License","text":"may convey work based Program, modifications produce Program, form source code terms section 4, provided also meet conditions: ) work must carry prominent notices stating modified , giving relevant date. b) work must carry prominent notices stating released License conditions added section 7. requirement modifies requirement section 4 “keep intact notices”. c) must license entire work, whole, License anyone comes possession copy. License therefore apply, along applicable section 7 additional terms, whole work, parts, regardless packaged. License gives permission license work way, invalidate permission separately received . d) work interactive user interfaces, must display Appropriate Legal Notices; however, Program interactive interfaces display Appropriate Legal Notices, work need make . compilation covered work separate independent works, nature extensions covered work, combined form larger program, volume storage distribution medium, called “aggregate” compilation resulting copyright used limit access legal rights compilation’s users beyond individual works permit. Inclusion covered work aggregate cause License apply parts aggregate.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_6-conveying-non-source-forms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"6. Conveying Non-Source Forms","title":"GNU General Public License","text":"may convey covered work object code form terms sections 4 5, provided also convey machine-readable Corresponding Source terms License, one ways: ) Convey object code , embodied , physical product (including physical distribution medium), accompanied Corresponding Source fixed durable physical medium customarily used software interchange. b) Convey object code , embodied , physical product (including physical distribution medium), accompanied written offer, valid least three years valid long offer spare parts customer support product model, give anyone possesses object code either (1) copy Corresponding Source software product covered License, durable physical medium customarily used software interchange, price reasonable cost physically performing conveying source, (2) access copy Corresponding Source network server charge. c) Convey individual copies object code copy written offer provide Corresponding Source. alternative allowed occasionally noncommercially, received object code offer, accord subsection 6b. d) Convey object code offering access designated place (gratis charge), offer equivalent access Corresponding Source way place charge. need require recipients copy Corresponding Source along object code. place copy object code network server, Corresponding Source may different server (operated third party) supports equivalent copying facilities, provided maintain clear directions next object code saying find Corresponding Source. Regardless server hosts Corresponding Source, remain obligated ensure available long needed satisfy requirements. e) Convey object code using peer--peer transmission, provided inform peers object code Corresponding Source work offered general public charge subsection 6d. separable portion object code, whose source code excluded Corresponding Source System Library, need included conveying object code work. “User Product” either (1) “consumer product”, means tangible personal property normally used personal, family, household purposes, (2) anything designed sold incorporation dwelling. determining whether product consumer product, doubtful cases shall resolved favor coverage. particular product received particular user, “normally used” refers typical common use class product, regardless status particular user way particular user actually uses, expects expected use, product. product consumer product regardless whether product substantial commercial, industrial non-consumer uses, unless uses represent significant mode use product. “Installation Information” User Product means methods, procedures, authorization keys, information required install execute modified versions covered work User Product modified version Corresponding Source. information must suffice ensure continued functioning modified object code case prevented interfered solely modification made. convey object code work section , , specifically use , User Product, conveying occurs part transaction right possession use User Product transferred recipient perpetuity fixed term (regardless transaction characterized), Corresponding Source conveyed section must accompanied Installation Information. requirement apply neither third party retains ability install modified object code User Product (example, work installed ROM). requirement provide Installation Information include requirement continue provide support service, warranty, updates work modified installed recipient, User Product modified installed. Access network may denied modification materially adversely affects operation network violates rules protocols communication across network. Corresponding Source conveyed, Installation Information provided, accord section must format publicly documented (implementation available public source code form), must require special password key unpacking, reading copying.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_7-additional-terms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"7. Additional Terms","title":"GNU General Public License","text":"“Additional permissions” terms supplement terms License making exceptions one conditions. Additional permissions applicable entire Program shall treated though included License, extent valid applicable law. additional permissions apply part Program, part may used separately permissions, entire Program remains governed License without regard additional permissions. convey copy covered work, may option remove additional permissions copy, part . (Additional permissions may written require removal certain cases modify work.) may place additional permissions material, added covered work, can give appropriate copyright permission. Notwithstanding provision License, material add covered work, may (authorized copyright holders material) supplement terms License terms: ) Disclaiming warranty limiting liability differently terms sections 15 16 License; b) Requiring preservation specified reasonable legal notices author attributions material Appropriate Legal Notices displayed works containing ; c) Prohibiting misrepresentation origin material, requiring modified versions material marked reasonable ways different original version; d) Limiting use publicity purposes names licensors authors material; e) Declining grant rights trademark law use trade names, trademarks, service marks; f) Requiring indemnification licensors authors material anyone conveys material (modified versions ) contractual assumptions liability recipient, liability contractual assumptions directly impose licensors authors. non-permissive additional terms considered “restrictions” within meaning section 10. Program received , part , contains notice stating governed License along term restriction, may remove term. license document contains restriction permits relicensing conveying License, may add covered work material governed terms license document, provided restriction survive relicensing conveying. add terms covered work accord section, must place, relevant source files, statement additional terms apply files, notice indicating find applicable terms. Additional terms, permissive non-permissive, may stated form separately written license, stated exceptions; requirements apply either way.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_8-termination","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"8. Termination","title":"GNU General Public License","text":"may propagate modify covered work except expressly provided License. attempt otherwise propagate modify void, automatically terminate rights License (including patent licenses granted third paragraph section 11). However, cease violation License, license particular copyright holder reinstated () provisionally, unless copyright holder explicitly finally terminates license, (b) permanently, copyright holder fails notify violation reasonable means prior 60 days cessation. Moreover, license particular copyright holder reinstated permanently copyright holder notifies violation reasonable means, first time received notice violation License (work) copyright holder, cure violation prior 30 days receipt notice. Termination rights section terminate licenses parties received copies rights License. rights terminated permanently reinstated, qualify receive new licenses material section 10.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_9-acceptance-not-required-for-having-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"9. Acceptance Not Required for Having Copies","title":"GNU General Public License","text":"required accept License order receive run copy Program. Ancillary propagation covered work occurring solely consequence using peer--peer transmission receive copy likewise require acceptance. However, nothing License grants permission propagate modify covered work. actions infringe copyright accept License. Therefore, modifying propagating covered work, indicate acceptance License .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_10-automatic-licensing-of-downstream-recipients","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"10. Automatic Licensing of Downstream Recipients","title":"GNU General Public License","text":"time convey covered work, recipient automatically receives license original licensors, run, modify propagate work, subject License. responsible enforcing compliance third parties License. “entity transaction” transaction transferring control organization, substantially assets one, subdividing organization, merging organizations. propagation covered work results entity transaction, party transaction receives copy work also receives whatever licenses work party’s predecessor interest give previous paragraph, plus right possession Corresponding Source work predecessor interest, predecessor can get reasonable efforts. may impose restrictions exercise rights granted affirmed License. example, may impose license fee, royalty, charge exercise rights granted License, may initiate litigation (including cross-claim counterclaim lawsuit) alleging patent claim infringed making, using, selling, offering sale, importing Program portion .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_11-patents","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"11. Patents","title":"GNU General Public License","text":"“contributor” copyright holder authorizes use License Program work Program based. work thus licensed called contributor’s “contributor version”. contributor’s “essential patent claims” patent claims owned controlled contributor, whether already acquired hereafter acquired, infringed manner, permitted License, making, using, selling contributor version, include claims infringed consequence modification contributor version. purposes definition, “control” includes right grant patent sublicenses manner consistent requirements License. contributor grants non-exclusive, worldwide, royalty-free patent license contributor’s essential patent claims, make, use, sell, offer sale, import otherwise run, modify propagate contents contributor version. following three paragraphs, “patent license” express agreement commitment, however denominated, enforce patent (express permission practice patent covenant sue patent infringement). “grant” patent license party means make agreement commitment enforce patent party. convey covered work, knowingly relying patent license, Corresponding Source work available anyone copy, free charge terms License, publicly available network server readily accessible means, must either (1) cause Corresponding Source available, (2) arrange deprive benefit patent license particular work, (3) arrange, manner consistent requirements License, extend patent license downstream recipients. “Knowingly relying” means actual knowledge , patent license, conveying covered work country, recipient’s use covered work country, infringe one identifiable patents country reason believe valid. , pursuant connection single transaction arrangement, convey, propagate procuring conveyance , covered work, grant patent license parties receiving covered work authorizing use, propagate, modify convey specific copy covered work, patent license grant automatically extended recipients covered work works based . patent license “discriminatory” include within scope coverage, prohibits exercise , conditioned non-exercise one rights specifically granted License. may convey covered work party arrangement third party business distributing software, make payment third party based extent activity conveying work, third party grants, parties receive covered work , discriminatory patent license () connection copies covered work conveyed (copies made copies), (b) primarily connection specific products compilations contain covered work, unless entered arrangement, patent license granted, prior 28 March 2007. Nothing License shall construed excluding limiting implied license defenses infringement may otherwise available applicable patent law.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_12-no-surrender-of-others-freedom","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"12. No Surrender of Others’ Freedom","title":"GNU General Public License","text":"conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. convey covered work satisfy simultaneously obligations License pertinent obligations, consequence may convey . example, agree terms obligate collect royalty conveying convey Program, way satisfy terms License refrain entirely conveying Program.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_13-use-with-the-gnu-affero-general-public-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"13. Use with the GNU Affero General Public License","title":"GNU General Public License","text":"Notwithstanding provision License, permission link combine covered work work licensed version 3 GNU Affero General Public License single combined work, convey resulting work. terms License continue apply part covered work, special requirements GNU Affero General Public License, section 13, concerning interaction network apply combination .","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_14-revised-versions-of-this-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"14. Revised Versions of this License","title":"GNU General Public License","text":"Free Software Foundation may publish revised /new versions GNU General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies certain numbered version GNU General Public License “later version” applies , option following terms conditions either numbered version later version published Free Software Foundation. Program specify version number GNU General Public License, may choose version ever published Free Software Foundation. Program specifies proxy can decide future versions GNU General Public License can used, proxy’s public statement acceptance version permanently authorizes choose version Program. Later license versions may give additional different permissions. However, additional obligations imposed author copyright holder result choosing follow later version.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_15-disclaimer-of-warranty","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"15. Disclaimer of Warranty","title":"GNU General Public License","text":"WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_16-limitation-of-liability","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"16. Limitation of Liability","title":"GNU General Public License","text":"EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MODIFIES /CONVEYS PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES.","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"id_17-interpretation-of-sections-15-and-16","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"17. Interpretation of Sections 15 and 16","title":"GNU General Public License","text":"disclaimer warranty limitation liability provided given local legal effect according terms, reviewing courts shall apply local law closely approximates absolute waiver civil liability connection Program, unless warranty assumption liability accompanies copy Program return fee. END TERMS CONDITIONS","code":""},{"path":"https://ithim.github.io/ITHIM-R/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively state exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program terminal interaction, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, program’s commands might different; GUI interface, use “box”. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. information , apply follow GNU GPL, see . GNU General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License. first, please read .","code":" Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":null,"dir":"Reference","previous_headings":"","what":"Add strike and casualty distances to injury tables — add_distance_columns","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"function adds strike casualty distance information individual age sex categories aggregated mode -hit-(whw) --vehicle (nov) injury fatality matrices.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"","code":"add_distance_columns( injury_table, mode_names, true_distances_0, dist, scenarios = SCEN )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"injury_table (list ) data frame(s) edited, contains aggregated fatality counts split whw nov matrices mode_names modes take distances , taken aggregated modes trip data true_distances_0 population distances add injury table dist table used access bus distance - currently used scenarios scenarios process","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"injury tables strike casualty distance information whw nov matrices","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_distance_columns.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add strike and casualty distances to injury tables — add_distance_columns","text":"function performs following steps: set dataframe containing age sex categories found injury table input data add age sex index mode distances define list two elements whw nov indices used true_distances dataframe age sex categories define list (two elements whw nov) matching indices mode_names casualty modes injury table whw matrix create strike mode indices vector matching strike modes injury table strike_modes vector find strike casualty distances modes injury tables sum across age sex categories individual age sex category. modes exist injury tables known distances, mean mode distances known modes used add strike casualty modes whw nov matrices injuries_list output list","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Addition of ghost trips — add_ghost_trips","title":"Addition of ghost trips — add_ghost_trips","text":"Add trips get assigned physical activity component, can used proxy vehicle distances.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Addition of ghost trips — add_ghost_trips","text":"","code":"add_ghost_trips( raw_trip_set, trip_mode = \"bus_driver\", distance_ratio = BUS_TO_PASSENGER_RATIO * DISTANCE_SCALAR_PT, reference_mode = \"bus\", prop_male = 1, agerange_male = \"18, 65\", agerange_female = \"18, 65\", scenario = NA )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Addition of ghost trips — add_ghost_trips","text":"raw_trip_set data frame trips trip_mode mode add distance_ratio fraction reference distance use calculate new mode distance reference_mode name reference mode prop_male proportion newly added mode assigned males agerange_male age range males associated newly added mode agerange_female age range female drivers associated newly added mode scenario name scenario mode added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Addition of ghost trips — add_ghost_trips","text":"data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_ghost_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Addition of ghost trips — add_ghost_trips","text":"function creates trips based distance relative another (reference) mode, without altering synthetic population. .e. adds trips get assigned physical activity component. function can used add e.g. car_driver bus_driver trips used proxy vehicle distances needed injury CO2 pathways. can also used add truck commercial motorcycle trips included travel surveys. needed injury pathway, newly added trips assigned trips made males females based proportion males given input parameter. age ranges males females taking newly added trips can also defined. new mode distance equally split number people times number trips per people added. used distance new male trips. proportion female trips tends low, distance calculated male trips split 10 using 10th distance male trips, 10 times many female trips added compared low number female trips added distance used male trips. E.g. number people added 100 1 trip per person 98 trips made males, add 98 male trips 10 * 2 = 20 female trips 10th distance male trips. ensure better representation demographics female trips whilst keeping number newly added trips small possible reduce run time model. function performs following steps: set number people (regards males) trips per per person added find total distance reference mode find age ranges male female trips find number male female participants calculate total distance new mode added based reference distance find speed new mode male trips: define distance range male trip added, assume trip equal length add new male trips sampling given age range (add_trips.R) add age distance categories plus scenario name repeat female trips (assuming female trips 10th distance male trips adding proportionally 10 times many female trips)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":null,"dir":"Reference","previous_headings":"","what":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"Function create personal motorcycle trips Chilean cities","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"","code":"add_motorcycle_trips_Chile(raw_trip_set, PROPORTION_MOTORCYCLE_TRIPS)"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"raw_trip_set data frame trips travel survey PROPORTION_MOTORCYCLE_TRIPS proportion trips travel survey added personal motorcycle trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"original trip data additional personal motorcycle trips added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_motorcycle_trips_Chile.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Personal motorcycle trips for Chilean cities — add_motorcycle_trips_Chile","text":"function used create personal motorcycle trips Chilean cities motorcycle trips travel surveys. uses input existing travel survey data city proportion travel survey trips added additional new motorcycle trips. Based analysis motorcycle trips travel surveys Santiago, San Antonio, Valparaiso Puerto Montt makes assumptions split male female motorcyclists, number trips per person truncated normal distributions distances ages drivers personal motorcycle trips added. creates new trips assuming trip one stage, .e. trip duration distance equals stage duration distance. function contains following steps: characteristics motorcycle trips added defined set parameters truncated normal distributions male female trip duration set parameters truncated normal distributions male female age ranges find number male female motorcycle trips added divide number new male female trips 2 (= number trips per person) calculate number new participant ids added. number male female trips odd, add additional trip get trip number divisible 2 sample truncated normal distributions find duration new trips (assuming trip consists one stage) sample known age ranges find ages new male female motorcycle trips create new motorcycle trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Additional trips for trip data set — add_trips","title":"Additional trips for trip data set — add_trips","text":"Creates data frame given characteristics added existing trip data set.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Additional trips for trip data set — add_trips","text":"","code":"add_trips( trip_ids = 0, new_mode = \"pedestrian\", distance = 1, participant_id = 0, age = 20, sex = \"male\", nTrips = 3, speed = 4.8 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Additional trips for trip data set — add_trips","text":"trip_ids ids new trips new_mode mode new trips distance distances sample participant_id participant id new trips age age participant sex sex participant nTrips number trips participant speed speed new trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Additional trips for trip data set — add_trips","text":"data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Additional trips for trip data set — add_trips","text":"function used create new trips certain characteristics can added existing trip data set. input distance given upper limit trip distances added function takes number trips per person (nTrips) random samples 1 input distance given. Age sex participant also sampled range input age sex values. function performs following steps: create nTrips new trips sampling distances, ages sexes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"Add walk 'public transport stages' public transport trips walking stage","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"","code":"add_walk_trips(pt_trips)"},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"pt_trips data frame PT trips without walking component","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"list data frames PT trips walk--PT trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/add_walk_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Addition of 'walk to public transport' stages to trip set — add_walk_trips","text":"Function add additional walking stages public transport trips walking stage longer trip duration MINIMUM_PT_TIME plus BUS_WALK_TIME / RAIL_WALK_TIME parameters. MINIMUM_PT_TIME global input parameter determines minimum amount time (minutes) person travelling public transport spends public transport stage. BUS_WALK_TIME / RAIL_WALK_TIME parameter city specific input parameter determines duration walk public transport walking stage. function performs following steps: filter PT stages PT trips keep stage longest duration add one 'walk public transport' stage per trip find trip stages need changing add new 'walk pt' stages. duration public transport stage shorter BUS_WALK_TIME / RAIL_WALK_TIME + MINIMUM_PT_TIME, set new stage duration 3. Otherwise, set new stage duration either BUS_WALK_TIME RAIL_WALK_TIME depending trip mode update original public transport stage duration calculate 'walk pt' stage distance using walking speed update original public transport stage distance using respective public transport speed updated duration keep record number newly added 'walk pt' stages update total trip distances update trip distance categories remove 'walk pt' stages zero duration length","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate relative risk given PM exposure level — AP_dose_response","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"Calculate relative risk (RR) person synthetic population disease related air pollution scenario based individual PM exposure levels","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"","code":"AP_dose_response(cause, dose, quantile, confidence_intervals = F)"},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"cause name disease dose vector PM exposure levels individuals given age range scenario quantile quantile dose response functions used output value confidence_intervals logic: whether return confidence intervals","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"data frame relative risks person synthetic population AP related disease scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/AP_dose_response.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate relative risk given PM exposure level — AP_dose_response","text":"function performs following steps: various checks ensure correct PM exposure levels (doses) disease read get lookup table required dose response functions contains dose median RR upper lower confidence interval RR values PM exposure doses synthetic population find needed RR extrapolating dose responses given lookup table confidence interval required, repeat interpolation using upper lower confidence RR values required quantile 0.5, .e. median, find required RR value defining normal function mean median RR value dose standard deviations defined upper lower confidence RR values. Use correct quantile normal function RR value.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"Computes RR DR relationship given four parameters PM2.5 exposure","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"","code":"ap_dose_response_curve(pm, alpha, beta, gamma, tmrel)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"pm PM2.5 exposure alpha DR parameter beta DR parameter gamma DR parameter tmrel DR parameter","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ap_dose_response_curve.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes RR as a DR relationship - CURRENTLY NOT USED — ap_dose_response_curve","text":"RR","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign age groups to individuals — assign_age_groups","title":"Assign age groups to individuals — assign_age_groups","text":"Prunes dataset given max min ages, .e. removes entries people ages outside scope model assigns age group labels given age","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign age groups to individuals — assign_age_groups","text":"","code":"assign_age_groups( dataset, age_category = AGE_CATEGORY, age_lower_bounds = AGE_LOWER_BOUNDS, max_age = MAX_AGE, min_age = AGE_LOWER_BOUNDS[1], age_label = \"age\" )"},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign age groups to individuals — assign_age_groups","text":"dataset data frame age categories added ages outside model scope removed age_category vector strings giving age categories age_lower_bounds lower boundaries age categories max_age maximum age model min_age minimum age model age_label string label age column","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign age groups to individuals — assign_age_groups","text":"edited data frame","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/assign_age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Assign age groups to individuals — assign_age_groups","text":"function contains following steps: remove dataset entries ages max min ages missing age information add age categories","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":null,"dir":"Reference","previous_headings":"","what":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"Takes confidence value 0 1 returns parameter beta distribution","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"","code":"beta_pointiness(confidence)"},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"confidence value 0 1 representing confident PA dataset","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/beta_pointiness.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parameterise confidence in PA data - CURRENTLY NOT IN USE — beta_pointiness","text":"value parametrise beta distribution","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"Combine relative risks (RR) air pollution (AP) physical activity (PA) multiplication diseases affected AP PA","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"","code":"combined_rr_ap_pa(ind_pa, ind_ap, conf_int = FALSE)"},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"ind_pa data frame individual RRs diseases affected PA ind_ap data frame individual RRs diseases affected AP conf_int logic: whether include confidence interval dose response relationships ","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"dataframe giving RR risk AP, PA combined AP PA exposure levels every person synthetic population scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combined_rr_ap_pa.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine relative risks from air pollution and physical activity — combined_rr_ap_pa","text":"function performs following steps: join ap pa relative risk datasets loop disease outcomes affected PA AP: scenario multiply relative risks PA AP store new column confidence intervals required, multiply upper lower RR AP PA respectively wherever possible, otherwise use given median RR values instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"Applies PIF calculated relative risks (RRs) current observed health burden Global Burden Disease data generate scenario health burdens","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"","code":"combine_health_and_pif(pif_values, hc = DISEASE_BURDEN)"},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"pif_values vector values PIFs age sex categories hc data frame current burden disease","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"estimated scenario burden disease age sex categories","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/combine_health_and_pif.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine health and potential impact fraction (PIF) — combine_health_and_pif","text":"function performs following steps: current observed health burden particular disease multiplied PIF, .e change fraction disease expected current scenario compared reference scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":null,"dir":"Reference","previous_headings":"","what":"Add missing trip information — complete_trip_distance_duration","title":"Add missing trip information — complete_trip_distance_duration","text":"Adds missing trip information stage duration stage distance.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add missing trip information — complete_trip_distance_duration","text":"","code":"complete_trip_distance_duration()"},{"path":"https://ithim.github.io/ITHIM-R/reference/complete_trip_distance_duration.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add missing trip information — complete_trip_distance_duration","text":"function performs following steps calculate stage duration stage distance. Note need least trip duration stage distance stage stage duration: add speed column stage duration: calculate stage duration stage distance given using mode speeds stage duration sum 'NA' (.e. stage distances exist stage distances ): trip duration exists sum NA, find trip ids 'NA' stage duration replace stage duration trip duration divided number stages particular trip remove remaining trips 'NA' stage distance update stage speed column stage distance: calculate stage distance using stage duration mode speeds trip distance: calculate trip distance summing stage distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":null,"dir":"Reference","previous_headings":"","what":"Create scenarios for Bogota — create_bogota_scenarios","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"Creates three scenarios one, mode share given mode elevated set percentage total trips. scenario modes cycle, car, bus.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"","code":"create_bogota_scenarios(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"trip_set data frame, baseline scenario trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"list baseline scenario three scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_bogota_scenarios.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create scenarios for Bogota — create_bogota_scenarios","text":"function creates three scenarios increasing mode shares cycling, car bus pre-defined percentage total mode shares. assume : total number trips remains trips modes (apart truck, bus driver, car driver commercial motorcycle trips remain unchanged - least initially) converted mode question; truck commercial motorcycle trips remain constant across scenarios whilst bus driver car driver trips updated based new total distance car bus trips increase mode share conducted scenario percentage share across three distance bands mode increased preserved, .e. 10 band 0-2km increasing cycling mode share x still 10 scenario always convert question, independently original overall mode share mode. .e. e.g. 1 5 car scenario 55 total trips. preserve proportion trips distance band. E.g. 20 trips distance band 0-2km, scenario 20 trips still distance band 0-2km. Example: Assume two distance bands B 80 cycling trips lie distance band remaining 20 band B. Assume 60 band B. Assume want increase cycling mode share 5 , need convert 5 cycling trips 5 cycling trips. Overall, leads increase (5 cycling trips, whilst preserving cycling mode shares 80 band 20 distance band 40 preserved. function performs following steps: overall mode shares cycle, car bus modes across three distance categories extracted trip data set trip data extract trip information, calculate total number trips find proportion trips distance category find proportion trips converted mode, scenario distance category define modes changeable (least initially) scenarios divide trip data set modes can changed another set trips whose modes changed split changeable trips also trips distance band create scenarios loop scenarios: loop distance band: find changeable trips mode increased count number trips made mode increased bus scenario aim increase public transport trips, .e. find changeable trips made bus rail count number trips made bus rail find number total trips like convert number trips changeable equals number trips converted, changeable trips converted mode question trips changeable want change, sample number trips change changeable trip ids trips converted changeable trips, convert many trips possible create warning message convert required trips new mode question add trips across distance bands add non-changeable trips update bus_driver car_driver trips create list containing trips scenario elements","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":null,"dir":"Reference","previous_headings":"","what":"Create global scenarios — create_global_scenarios","title":"Create global scenarios — create_global_scenarios","text":"Creates four scenarios one, mode share given mode elevated set percentage total trips. scenario modes cycle, car, bus motorcycle.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create global scenarios — create_global_scenarios","text":"","code":"create_global_scenarios(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create global scenarios — create_global_scenarios","text":"trip_set data frame, baseline scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create global scenarios — create_global_scenarios","text":"list baseline scenario four mode scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_global_scenarios.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create global scenarios — create_global_scenarios","text":"function creates four scenarios increasing mode shares cycling, car, bus motorcycle pre-defined percentage total mode shares. assume : total number trips remains trips modes (apart truck, bus driver, car driver commercial motorcycle trips remain unchanged - least initially) converted mode question; truck commercial motorcycle trips remain constant across scenarios whilst bus driver car driver trips updated based new total distance car bus trips increase mode share conducted scenario percentage share across three distance bands mode increased preserved, .e. 10 band 0-2km increasing cycling mode share x still 10 mean mode split across 28 cities (Antofagasta, Arica, Belo Horizonte, Bogota, Buenos Aires, Cali, Copiapo, Coquimbo / La Serena, Gran Valparaiso, Iquique / Alto Hospicio, Medellin, Mexico City, Montevideo, Osorno, Puerto Montt, San Antonio, Santiago, Sao Paulo, Temuco / Padre las Casas, Valdivia, Accra, Bangalore, Cape Town, Delhi, Vizag, Kisumu, Nairobi Port Louis) baseline mode split mode. scenario always convert question, independently original overall mode share mode. .e. e.g. 1 5 car scenario 55 total trips. preserve proportion trips distance band. E.g. 20 trips distance band 0-2km, scenario 20 trips still distance band 0-2km. proportions calculated city individually. Example: Assume two distance bands B 80 cycling trips lie distance band remaining 20 band B. Assume 60 band B. Assume want increase cycling mode share 5 , need convert 5 cycling trips 5 cycling trips. Overall, leads increase (5 cycling trips, whilst preserving cycling mode shares 80 band 20 distance band 40 preserved. function performs following steps: overall mode shares cycle, car, bus motorcycle modes across three distance categories defined trip data extract trip information, calculate total number trips find proportion trips distance category find proportion trips converted mode, scenario distance category define modes changeable (least initially) scenarios divide trip data set modes can changed another set trips whose modes changed split changeable trips also trips distance band create scenarios loop scenarios, .e. 4 different modes: loop distance band: find changeable trips mode increased count number trips made mode increased bus scenario aim increase public transport trips, .e. find changeable trips made bus rail count number trips made bus rail find number total trips like convert number trips changeable equals number trips converted, changeable trips converted mode question trips changeable want change, sample number trips change changeable trip ids trips converted changeable trips, convert many trips possible create warning message convert required trips new mode question add trips across distance bands add non-changeable trips update bus_driver car_driver trips create list containing trips scenario elements","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":null,"dir":"Reference","previous_headings":"","what":"Creates synthetic population — create_synth_pop","title":"Creates synthetic population — create_synth_pop","text":"Creates synthetic population matching individuals trip set individuals physical activity (PA) dataset","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Creates synthetic population — create_synth_pop","text":"","code":"create_synth_pop(raw_trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Creates synthetic population — create_synth_pop","text":"raw_trip_set data frame raw trips taken, bus_driver, new motorcycle truck trips already added","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Creates synthetic population — create_synth_pop","text":"synthetic population trip set pruned","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/create_synth_pop.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Creates synthetic population — create_synth_pop","text":"function performs following steps: adds age category trip physical activity datasets calling assign_age_groups.R match people trip data people physical activity dataset: create synthetic population taking unique participant ids together age gender information trip data (including bus driver, truck, car driver commercial motorcycle trips) assign non-occupational physical activity MMET values synthetic population, following steps performed: sex age category, find proportion people zero non-occupational MMET values also find list people non-zero MMET values BACKGROUND_PA_CONFIDENCE < 1 calling value information script, .e. input values sampled distributions, beta distribution built proportion people zero work leisure MMET values sampled using known proportion mean distribution sample replacement vector 0 MMET values vector non-zero MMET values ( people non-zero work leisure MMET values) using proportion people zero work leisure MMET values assign sampled MMET values synthetic population remove participants trip stage modes Vehicle inventory","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":null,"dir":"Reference","previous_headings":"","what":"Function for Dirichlet parameters — dirichlet_pointiness","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"Function map confidence value parameterisation Dirichlet distribution.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"","code":"dirichlet_pointiness(confidence)"},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"confidence value 0 1","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"parameterisation","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dirichlet_pointiness.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Function for Dirichlet parameters — dirichlet_pointiness","text":"Note parameterisation somewhat arbitrary seems work visual inspection.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":null,"dir":"Reference","previous_headings":"","what":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"Computes exposures (distances) mode parameterise injury regression model, computed Poisson model used ITHIM-Global model predict injury fatalities later stage","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"","code":"distances_for_injury_function(journeys, dist)"},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"journeys data frame total distance (total population) age sex category scenario dist table (total population) distances per mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"true_distances (mode distances age sex walking modes car modes combined bus drivers added relevant), injuries_list (list strike, casualty, age, sex mode distance combinations baseline scenarios), reg_model (parameterised Poisson regression model), injuries_for_model (baseline data containing injury counts casualty strike mode combinations associated distance data)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/distances_for_injury_function.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get distances and parameterise Poisson regression model for injuries — distances_for_injury_function","text":"function uses distance data individual injury fatality data perform following steps parameterise Poisson injury regression model: stage modes aggregated walk related stages (walk walk pt) mode (walk), similarly car related journeys bus drivers added bus journeys (relevant) accurately represent people bus Takes Baseline injury tables, split -hit (whw) --vehicle (nov) parts, adds total population distances strike casualty mode (add_distance_columns.R). Distances added age gender category exists information injury counts (injuries_for_model dataframe). exists fatality casualty strike mode age sex category mode distance age sex category, fatalities distances aggregated strike casualty mode. , aggregation still exist fatalities either casualty strike mode distance missing, fatalities removed predict injury counts zero distances. However, happen total distances modes (possibly inferred modes) appear injury data. - data used parameterise Poisson injury model. new list (injuries_list) created containing strike casualty mode age sex combinations together strike casualty mode distances (add_distance_columns()) baseline scenarios. whw model, strike mode casualty pairs strike mode equals casualty mode removed fatalities combinations already added nov matrix. Combinations non-zero strike casualty mode distance also removed. list later used injuries_function_2() function predict fatality counts using Poisson injury regression model. casualty strike mode exponents used account safety number effect added injuries_for_model injuries_list. best possible regression model built using Baseline injury counts distances (injuries_for_model) standard errors small wherever possible. Strike casualty mode pairs cas mode = strike mode removed still exist removed ithim_load_data.R function. Two different forms whw nov matrices defined, taking account age sex information exists. standard errors newly built regression models checked large data aggregated age sex yet, data aggregated new Poisson regression model build. standard errors still large aggregation, message printed screen warning standard errors large.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":null,"dir":"Reference","previous_headings":"","what":"Get distances and duration summaries by mode — dist_dur_tbls","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"Summaries total distances durations spent travelling per mode per scenario, synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"","code":"dist_dur_tbls(trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"trip_scen_sets list synthetic trip sets scenario including baseline","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"list table (total) distances durations per mode per scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get distances and duration summaries by mode — dist_dur_tbls","text":"function performs following steps: loop scenarios (incl Baseline): using trip data, sum across distances stage mode get total distance mode scenario synthetic population sum across duration stage mode get total duration mode scenario 'walk_to_pt' stages exist, add pedestrian stages duration distance create one dataframe containing total distances mode scenario create one dataframe containing total duration mode scenario remove 'walk_to_pt' stages added pedestrian stages update bus car driver distances duration scenarios using ratio bus/car bus_driver/car_driver baseline scenario ( redundant GLOBAL, BOGOTA, AFRICA_INDIA LATAM scenario definitions bus car driver distances already updated scenario creation)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html","id":null,"dir":"Reference","previous_headings":"","what":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","title":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","text":"function extracts relevant information multi_city_ithim object gets results correct format analysis.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","text":"","code":"extract_data_for_voi( NSCEN, NSAMPLES, SCEN_SHORT_NAME, outcome_age_groups, cities, multi_city_ithim )"},{"path":"https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","text":"NSCEN number scenarios (incl. baseline) NSAMPLES number model runs per city SCEN_SHORT_NAME names scenarios (incl. baseline) outcome_age_groups outcome age groups defined input parameters model cities list cities model run multi_city_ithim list containing ithim model information including results various model runs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","text":"ithim_results list following objects: summary_ylls_df: dateframe total ylls (median, 5th 95th percentiles) per age group city (plus combined results) voi_data_all_df: dataframe cities outcomes model runs, age groups disease scenario combinations yll_per_hundred_thousand: yll per 100,000 people city, outcome age category, model run disease scen combination yll_per_hundred_thousand_stats: total ylls per 100,000 (median, 5th 95th percentiles) sum across disease per outcome age group, scenario city (plus combined results) outcome: total yll outcome outcome age categories per city scenario disease combination, also combined city result (sum)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get ITHIM-results into correct format for VoI analysis — extract_data_for_voi","text":"function performs following steps: looping cities: calculate average outcome (yll) per person population considered model calculate total ylls per 100 000 outcome age category, scenario disease combination model run calculate total yll outcome across outcome age categories per city scenario disease combinations create one dataframe cities outcomes model runs, age groups disease scenario combinations compute yll per hundred thousand outcome age group summing across diseases (double counting!) city scenario also summing across cities create one dateframe total ylls (median, 5th 95th percentiles) per age group city (plus combined results sum across cities)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":null,"dir":"Reference","previous_headings":"","what":"Get relative risk for diseases given PM exposure — gen_ap_rr","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"Computes relative risk (RR) individuals synthetic population disease given PM exposure","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"","code":"gen_ap_rr(pm_conc_pp)"},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"pm_conc_pp individual PM exposures person synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"data frame relative risks per person disease scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get relative risk for diseases given PM exposure — gen_ap_rr","text":"function performs following steps: minimum ages age group corresponding disease risks assigned individuals synthetic population (added PM exposure levels) loop diseases related PM pollution: depending disease (disease different relative risks depending age individual) loop disease specific age groups (just one age group disease) set quantile value dose response curves extracted. running constant mode, quantile usually set 0.5, .e. median dose response curves. running sample mode, quantile can set sampled distribution input parameters. loop scenarios: assign relative risk given disease, age group, quantile scenario relevant people synthetic population calling AP_dose_response() function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":null,"dir":"Reference","previous_headings":"","what":"Get relative risk for diseases given mMETs — gen_pa_rr","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"Computes relative risks (RR) individuals synthetic population disease given mMETs (PA exposure)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"","code":"gen_pa_rr(mmets_pp, conf_int = F)"},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"mmets_pp individual mMETs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"data frame relative risks per person per disease","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/gen_pa_rr.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get relative risk for diseases given mMETs — gen_pa_rr","text":"function performs following steps: loop diseases related physical activity levels: set quantile value dose response curves extracted. running constant mode, quantile usually set 0.5, .e. median dose response curves. running sample mode, quantile can set sampled distribution input parameters. create one vector containing mMET values scenarios assign relative risk given disease quantile given mMET values people synthetic population scenarios calling drpa::dose_response function extract RR scenario vector containing RR scenarios confidence intervals required, also extract RR upper lower confidence values scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":null,"dir":"Reference","previous_headings":"","what":"Find population distances by mode for entire population — get_all_distances","title":"Find population distances by mode for entire population — get_all_distances","text":"Function find distances travelled age, sex, scenario mode entire population rather just synthetic population.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find population distances by mode for entire population — get_all_distances","text":"","code":"get_all_distances(ithim_object)"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find population distances by mode for entire population — get_all_distances","text":"ithim_object list containing city specific information including synthetic trip set","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find population distances by mode for entire population — get_all_distances","text":"ithim_object , additional total population distance mode scenario, distances injury pathway plus parameterised Poisson injury regression model","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_all_distances.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Find population distances by mode for entire population — get_all_distances","text":"function performs following steps: generate distance duration matrices age, sex, mode scenario ithim_object$trip_scen_sets synthetic population calling dist_dur_tbls() function find total mode distances scenario scale distance travelled entire population using demographic information city order scale distances age, sex, mode scenario entire population, proportion distances travelled age, sex, mode scenario combination synthetic population total distances mode scenario synthetic population found. total population distances mode multiplied proportions find total population distances travelled mode age sex category. distances_for_injury_function() function called creates list inj_distances added ithim_object containing following matrices: true_distances (population mode distances age sex walking modes car modes combined bus drivers added relevant) injuries_list (list strike, casualty, age, sex mode distance combinations baseline scenarios, used predict fatalities later model run) reg_model (parameterised Poisson injury regression model) injuries_for_model (baseline data containing injury counts casualty strike mode combinations associated distance data)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":null,"dir":"Reference","previous_headings":"","what":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"Computes mode shares different distance categories maximum mode share specified mode types specified distance categories across specified (stored) cities. Used max mode share scenario generation.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"","code":"get_scenario_settings( cities = c(\"accra\", \"bangalore\", \"belo_horizonte\", \"bogota\", \"buenos_aires\", \"cape_town\", \"delhi\", \"mexico_city\", \"santiago\", \"sao_paulo\", \"vizag\"), modes = c(\"pedestrian\", \"cycle\", \"car\", \"motorcycle\", \"bus\"), distances = c(\"0-2 km\", \"2-6 km\", \"6+ km\"), speeds = list(bus = 8.1, bus_driver = 8.1, minibus = 8.1, minibus_driver = 8.1, car = 13.8, car_driver = 13.8, taxi = 13.8, pedestrian = 2.5, walk_to_pt = 2.5, cycle = 7.2, motorcycle = 15.2, truck = 8.1, van = 13.8, subway = 18.1, rail = 21.9, auto_rickshaw = 4, shared_auto = 13.8, shared_taxi = 13.8, cycle_rickshaw = 4, other = 9.1) )"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"cities cities use modes modes use distances distance categories use speeds named list mode speeds (applied cities)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"data frame maximum proportions mode distance category","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_scenario_settings.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get values for mode share across distance categories and for max mode share scenario\r\n - CURRENTLY only used when calling summary_tables.Rmd — get_scenario_settings","text":"function performs following steps: define minimum distances distance category loop pre-defined cities: read trip data get data correct format assign distance categories distance category pre-defined mode find proportional modal share (distance category, proportion modes adds 100 rail trips exist, added proportion bus trips get one value public transport find maximum mode shares mode distance category city print one table showing mode shares distance category","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate synthetic population from trip data — get_synthetic_from_trips","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"Sequence functions set synthetic population, synthetic trips, scenarios.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"","code":"get_synthetic_from_trips()"},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"data frame synthetic trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/get_synthetic_from_trips.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate synthetic population from trip data — get_synthetic_from_trips","text":"function performs following steps: columns TRIP_SET put correct order multiply trip distances, stage distances, durations day_to_week scalar divide 7 get distances durations 'average' day week add bus_driver truck trips required (add_ghost_trips()) add personal motorcycle trips needed (call appropriate function) add commercial motorcycle trips required (add_ghost_trips()) build synthetic population creating data set contains (non-zero) participant ids demographic information trip data set adds work leisure MMET values calling create_synth_pop() (non travel entries trip data set also removed) adds car driver trips required (add_ghost_trips()) call ithim_setup_baseline_scenario() function get baseline data correct format creation different scenarios create required scenarios calling appropriate function add walk pt trips combine scenarios one dataframe calling walk_to_pt_and_combine_scen() function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute health burden — health_burden","title":"Compute health burden — health_burden","text":"Compute health burden population scenarios given relative risks diseases","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute health burden — health_burden","text":"","code":"health_burden(ind_ap_pa, conf_int = F, combined_AP_PA = T)"},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute health burden — health_burden","text":"ind_ap_pa dataframe individuals' relative risks diseases conf_int=F logic: whether include confidence interval dose response relationships combined_AP_PA=T logic: whether combine two exposure pathways (AP PA) compute independently","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute health burden — health_burden","text":"list dataframes: one deaths per disease per demographic group scenario, likewise YLLs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/health_burden.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute health burden — health_burden","text":"function performs following steps: get demographic disease burden (subset Global Burden Disease dataset) data correct formats join two datasets scale burden data CHRONIC_DISEASE_SCALAR account bias data split dataframe two dataframes, one deaths one years life lost (YLLs) add demographic index (age sex category) dataframe containing individual relative risk different diseases set reference scenarios iterate disease outcomes: define column names loop either 1 2 pathways depending whether PA AP affecting disease whether AP PA pathways combined : extract relevant burden disease specific scenario YLLs deaths find sum relative risks (RR) specific disease age sex category reference scenario loop non-reference scenarios: define column names find sum relative risks (RR) specific disease age sex category non-reference scenario calculate PIF (potential impact fraction), .e proportional change sum relative risks reference non-reference scenario age sex category calculate health burden (deaths ylls) non-reference scenario compared reference scenario multiplying current burden disease PIF (combine_health_and_pif.R) confidence intervals required, loop upper lower confidence interval limits calculate health burden deaths YLLs using upper lower confidence relative risks. upper lower relative risk values exist, use median value instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict injuries — injuries_function_2","title":"Predict injuries — injuries_function_2","text":"Predict injuries baseline scenarios based Poisson regression model fitted baseline fatality counts distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict injuries — injuries_function_2","text":"","code":"injuries_function_2( true_distances, injuries_list, reg_model, constant_mode = F )"},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict injuries — injuries_function_2","text":"true_distances data frame containing population distances scenario injuries_list list dataframes set scenario specific information supply regression model prediction reg_model Poisson injury regression model constant_mode whether constant (vs sampling) mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict injuries — injuries_function_2","text":"injuries2 - dataframe containing predicted fatality counts casualty mode age sex scenario, plus confidence interval limits constant mode whw_temp - list containing fatality predictions casualty strike mode pair split whw nov matrices scenario. Upper lower confidence interval predictions also included constant mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injuries_function_2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict injuries — injuries_function_2","text":"function uses Poisson regression model built distances_for_injury_function() predict fatality counts Baseline scenarios. performs following steps: create injuries data frame containing distances travelled mode, age, sex scenario predict fatalities strike casualty mode combination, age sex category scenario (incl Baseline). sample mode set 'constant' ('sample'), also predict upper lower confidence interval boundaries create whw_temp list containing total predicted fatality counts casualty strike mode pair scenario split whw nov matrices , constant mode also give upper lower confidence interval limit predictions create injuries2 data frame containing total predicted fatality counts casualty mode age sex scenario. dataframe also contains total death per age sex category , constant mode upper lower total death predictions confidence interval.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":null,"dir":"Reference","previous_headings":"","what":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"Calculate YLL burden death burden injury based ratio GBD data.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"","code":"injury_death_to_yll(injuries)"},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"injuries data frame injury deaths age sex category scenario incl. baseline","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"list injury deaths YLLs (given differences reference scenario) plus values reference scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/injury_death_to_yll.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Map injury death burden to YLL (years of life lost) burden — injury_death_to_yll","text":"function performs following steps: join estimated injury deaths global burden disease (GBD) injury data age sex multiply estimated injury deaths yll injury death ratio GBD data predict YLL estimated injury deaths extract create matrices deaths ylls one column scenario create dataframe ylls deaths reference scenario create dataframe B showing differences deaths yll non-reference scenario reference scenario confidence intervals required: create dataframe ylls deaths reference scenario using lower upper relative risk boundary values create dataframe showing differences deaths yll non-reference scenario reference scenario using lower upper relative risk boundary values add confidence upper lower interval boundary values two output dataframes B","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":null,"dir":"Reference","previous_headings":"","what":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"Ordered set computations part ITHIM-Global calculates required output parameters","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"","code":"ithim_calculation_sequence(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"ithim_object name disease seed","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"ithim_object - list items making ithim result","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_calculation_sequence.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Cascade of computations that form ITHIM-Global — ithim_calculation_sequence","text":"function performs following steps: extract lists variables ithim_object list air pollution pathway: calculate PM2.5 exposure person synthetic population PM2.5 emissions mode scenario (scenario_pm_calculations()) calculate CO2 emissions mode scenario (scenario_co2_calculations()) assign relative risk person synthetic population disease related PM pollution scenario based individual PM exposure levels (gen_ap_rr()) physical activity pathway: calculate total mMETs person synthetic population (total_mmet()) assign relative risk person synthetic population disease related physical activity levels scenario based individual mMET values (gen_pa_rr()) physical activity air pollution combined: combine PA AP datasets joining two datasets. disease affected PA AP calculate joined relative risk multiplying PA AP relative risks (combined_rr_ap_pa()) calculate health burden (Yll deaths) disease age sex category (health_burden()): calculate health burden (Yll deaths) disease age sex category. Combine AP PA pathways diseases affected AP PA running constant mode also calculate health burden AP PA pathways separately injury pathway: estimate injury deaths baseline scenario age sex category, also estimate total injury deaths counts -hit---vehicle matrices casualty (strike) mode baseline scenario (injuries_function2()) running constant mode include upper lower confidence intervals calculate years life lost injury deaths (injury_death_to_yll()) combine pathways using outputs 3. 4.: combine AP, PA injury health burden data ylls deaths (join_hb_and_injury()) diseases, injuries scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Load data for model and prepare input data for model — ithim_load_data","title":"Load data for model and prepare input data for model — ithim_load_data","text":"Loads processes data files using city specific local data global data. Processes input data ready ITHIM-Global model run. Writes objects global environment.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load data for model and prepare input data for model — ithim_load_data","text":"","code":"ithim_load_data( speeds = list(bus = 8.1, bus_driver = 8.1, minibus = 8.1, minibus_driver = 8.1, car = 13.8, car_driver = 13.8, taxi = 13.8, pedestrian = 2.5, walk_to_pt = 2.5, cycle = 7.2, motorcycle = 15.2, truck = 8.1, van = 13.8, subway = 18.1, rail = 21.9, auto_rickshaw = 4, shared_auto = 13.8, shared_taxi = 13.8, cycle_rickshaw = 4, other = 9.1) )"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load data for model and prepare input data for model — ithim_load_data","text":"speeds named list mode speeds","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_load_data.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load data for model and prepare input data for model — ithim_load_data","text":"function performs following steps load process input data: find path ithimr package global local data can found check whether drpa package installed read Global Burden Disease data country read city specific trip data: set missing stage trip information known stage trip information, e.g. stage duration missing trip duration known set stage duration trip duration ensure stage modes trip modes consist set keywords, replace mode names key words, e.g. replace 'train' 'rail' remove trips age sex 'NA' Rename pedestrian stage modes non-pedestrian trips 'pedestrian' 'walk_to_pt' (call get_scenario_settings() using max_mode_share_scenario) read local Global Burden Disease (GBD) data: combine various head neck cancers, combine myeloid leukemia diseases, combine respiratory diseases level 2 adjust rectum cancer combined colon rectum cancer burden read local demographic data: find / re-define max min ages based max min ages trip data, demographic data max min ages considered model remove population data outside max min ages find proportion total population considered model total population get age-category details population data, ages max min ages removed extract diseases plus road injures GBD data, update format max min ages entry compute proportion injuries age range considered model GBD data, proportion applied injury datasets without age sex information remove ages outside age ranges considered model GBD_data create burden_of_disease dataframe GBD_data changing layout GBD_data: add city specific population data add country specific disease rate GBD data, ie. proportion number people country disease population country age sex category using country disease rate calculate city population affected disease using burden_of_disease data (now called DISEASE_BURDEN), calculate ratio YLL death age sex category road_injuries data read city specific road injury data: Set 'weight' column unique number years injury data exists (column already exist) strike mode equals casualty mode, set strike mode 'nov' (vehicle) call set_injury_contingency.R function set tables WHW (hit ) NOV (vehicle) fatalities","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"Set baseline scenario ready scenario development","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"","code":"ithim_setup_baseline_scenario(trip_set)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"trip_set data frame trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"trip_set baseline scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_baseline_scenario.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up baseline scenario data frame — ithim_setup_baseline_scenario","text":"function performs following steps trip set data: add distance categories add scenario='baseline' column","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":null,"dir":"Reference","previous_headings":"","what":"Set parameters for ITHIM-Global run — ithim_setup_parameters","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"Function set parameters either using constant value sampling pre-defined function","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"","code":"ithim_setup_parameters( NSAMPLES = 1, BUS_WALK_TIME = 16, RAIL_WALK_TIME = 12.5, CYCLING_MET = 6.8, WALKING_MET = 3.5, PASSENGER_MET = 1.3, CAR_DRIVER_MET = 2.5, MOTORCYCLIST_MET = 2.8, SEDENTARY_ACTIVITY_MET = 1.3, LIGHT_ACTIVITY_MET = 1.3, MODERATE_PA_MET = 4, VIGOROUS_PA_MET = 8, PM_CONC_BASE = 12.69, PM_TRANS_SHARE = 0.42, PA_DOSE_RESPONSE_QUANTILE = F, AP_DOSE_RESPONSE_QUANTILE = F, BACKGROUND_PA_SCALAR = 1, BACKGROUND_PA_CONFIDENCE = 1, INJURY_REPORTING_RATE = 1, CHRONIC_DISEASE_SCALAR = 1, DAY_TO_WEEK_TRAVEL_SCALAR = 7, SIN_EXPONENT_SUM = 2, CASUALTY_EXPONENT_FRACTION = 0.5, SIN_EXPONENT_SUM_NOV = 1, SIN_EXPONENT_SUM_CYCLE = 2, CASUALTY_EXPONENT_FRACTION_CYCLE = 0.5, SIN_EXPONENT_SUM_PED = 2, CASUALTY_EXPONENT_FRACTION_PED = 0.5, SIN_EXPONENT_SUM_VEH = 2, CASUALTY_EXPONENT_FRACTION_VEH = 0.5, BUS_TO_PASSENGER_RATIO = 0.0389, CAR_OCCUPANCY_RATIO = 0.625, TRUCK_TO_CAR_RATIO = 0.3, FLEET_TO_MOTORCYCLE_RATIO = 0.441, PROPORTION_MOTORCYCLE_TRIPS = 0, PM_EMISSION_INVENTORY_CONFIDENCE = 1, CO2_EMISSION_INVENTORY_CONFIDENCE = 1, DISTANCE_SCALAR_CAR_TAXI = 1, DISTANCE_SCALAR_WALKING = 1, DISTANCE_SCALAR_PT = 1, DISTANCE_SCALAR_CYCLING = 1, DISTANCE_SCALAR_MOTORCYCLE = 1, BUS_DRIVER_PROP_MALE = 0.98, BUS_DRIVER_MALE_AGERANGE = \"19, 65\", BUS_DRIVER_FEMALE_AGERANGE = \"19, 65\", TRUCK_DRIVER_PROP_MALE = 0.98, TRUCK_DRIVER_MALE_AGERANGE = \"18, 65\", TRUCK_DRIVER_FEMALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_PROP_MALE = 0.99, COMMERCIAL_MBIKE_MALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_FEMALE_AGERANGE = \"18, 65\", MINIMUM_PT_TIME = 3, MODERATE_PA_CONTRIBUTION = 0.5, CALL_INDIVIDUAL_SIN = F, SCENARIO_NAME = \"GLOBAL\", SCENARIO_INCREASE = 0.05 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"NSAMPLES constant integer: number samples take BUS_WALK_TIME lognormal parameter: duration walk bus stage RAIL_WALK_TIME lognormal parameter: duration walk rail stage CYCLING_MET lognormal parameter: METs cycling WALKING_MET lognormal parameter: METs walking PASSENGER_MET lognormal parameter: MET value associated passenger public transport CAR_DRIVER_MET lognormal parameter: MET value associated car driver MOTORCYCLIST_MET lognormal parameter: MET value associated motorcyclist SEDENTARY_ACTIVITY_MET lognormal parameter: MET value associated sedentary activity LIGHT_ACTIVITY_MET lognormal parameter: MET value associated light activity MODERATE_PA_MET lognormal parameter: MET value associated moderate activity VIGOROUS_PA_MET lognormal parameter: MET value associated vigorous activity PM_CONC_BASE lognormal parameter: background PM2.5 concentration PM_TRANS_SHARE beta parameter: fraction background PM2.5 attributable transport PA_DOSE_RESPONSE_QUANTILE logic: whether sample physical activity relative risk dose response functions AP_DOSE_RESPONSE_QUANTILE logic: whether sample air pollution relative risk dose response functions BACKGROUND_PA_SCALAR lognormal parameter: reporting scalar physical activity correct bias data BACKGROUND_PA_CONFIDENCE beta parameter: confidence accuracy zero non-travel physical activity levels INJURY_REPORTING_RATE lognormal parameter: rate injury fatality reporting CHRONIC_DISEASE_SCALAR lognormal parameter: scalar background disease rates adjust bias GBD data DAY_TO_WEEK_TRAVEL_SCALAR beta parameter: rate scaling travel one day one week - CURRENTLY used constant (using beta parameter need considerations) SIN_EXPONENT_SUM lognormal parameter: linearity injuries respect two modes. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION beta parameter: casualty exponent contribution SIN_EXPONENT_SUM SIN_EXPONENT_SUM_NOV lognormal parameter: linearity injuries respect two modes strike mode = NOV. SIN_EXPONENT_SUM=2 means safety numbers SIN_EXPONENT_SUM_CYCLE lognormal parameter: linearity injuries respect two modes victim mode = cycle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_CYCLE beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_CYCLE victim mode = cycle SIN_EXPONENT_SUM_PED lognormal parameter: linearity injuries respect two modes victim mode = pedestrian. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_PED beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_PED victim mode = pedestrian SIN_EXPONENT_SUM_VEH lognormal parameter: linearity injuries respect two modes victim mode = vehicle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_VEH beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_VEH victim mode = vehicle BUS_TO_PASSENGER_RATIO beta parameter: number buses per passenger CAR_OCCUPANCY_RATIO beta parameter: number people per car (including driver) TRUCK_TO_CAR_RATIO beta parameter: proportion truck car vehicle km travelled FLEET_TO_MOTORCYCLE_RATIO beta parameter: amount motorcycle trips added commercial trips PROPORTION_MOTORCYCLE_TRIPS beta parameter: proportion trips added personal motorcycle trips PM_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy PM emission inventory CO2_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy CO2 emission inventory DISTANCE_SCALAR_CAR_TAXI lognormal parameter: scalar adjust bias car distance travelled DISTANCE_SCALAR_WALKING lognormal parameter: scalar adjust bias walking distance travelled DISTANCE_SCALAR_PT lognormal parameter: scalar adjust bias PT distance travelled DISTANCE_SCALAR_CYCLING lognormal parameter: scalar adjust bias cycling distance travelled DISTANCE_SCALAR_MOTORCYCLE lognormal parameter: scalar adjust biase motorcycle distance travelled BUS_DRIVER_PROP_MALE scalar: proportion bus drivers male BUS_DRIVER_MALE_AGERANGE character: age range male bus drivers BUS_DRIVER_FEMALE_AGERANGE character: age range female bus drivers TRUCK_DRIVER_PROP_MALE scalar: proportion truck drivers male TRUCK_DRIVER_MALE_AGERANGE character: age range male truck drivers TRUCK_DRIVER_FEMALE_AGERANGE character: age range female truck drivers COMMERCIAL_MBIKE_PROP_MALE scalar: proportion commercial motorcycle drivers male COMMERCIAL_MBIKE_MALE_AGERANGE character: age range male commercial motorcycle drivers COMMERCIAL_MBIKE_FEMALE_AGERANGE character: age range female commercial motorcycle drivers MINIMUM_PT_TIME scalar: minimum time person spends public transport MODERATE_PA_CONTRIBUTION scalar: proportion contribution moderate PA Leisure MVPA CALL_INDIVIDUAL_SIN logic: whether call safety number coefficients individual vehicles use coefficients modes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"list samples uncertain parameters","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_setup_parameters.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set parameters for ITHIM-Global run — ithim_setup_parameters","text":"input parameters two options: set constant, sampled specified distribution. parameter given argument length 1 2. length 1, constant, set global environment. length 2, distribution defined sampled NSAMPLE times. exceptions, listed . function performs following steps: set input parameters global environment (sampling function called, overwritten) loop potential variables lognormal distribution sample distribution required loop potential variables beta distribution sample distribution required BACKGROUND_PA_CONFIDENCE<1 add BACKGROUND_PA_ZEROS parameters PM_EMISSION_INVENTORY_CONFIDENCE<1, sample PM inventory values using Dirichlet distribution parameterised gamma random variables CO2_EMISSION_INVENTORY_CONFIDENCE<1, sample CO2 inventory values using Dirichlet distribution parameterised gamma random variables PA_DOSE_RESPONSE_QUANTILE == T, find diseases related physical activity levels assign quantile sampling uniform distribution 0 1 AP_DOSE_RESPONSE_QUANTILE == T, find diseases related air pollution levels assign quantile sampling uniform distribution 0 1 bottom function, dirichlet_pointiness() function defined parameterises Dirichlet distributions PM CO2 emission inventories.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":null,"dir":"Reference","previous_headings":"","what":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"Sets sampled parameters global environment calls ITHIM routine","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"","code":"ithim_uncertainty(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"ithim_object list necessary inputs, including parameters seed sample take","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"list ITHIM outcomes","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/ithim_uncertainty.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sampling routine for running ITHIM with uncertainty — ithim_uncertainty","text":"function works performing following steps: extract ithim_object list entries extract sampled parameters stored ithim_object call set_vehicle_inventory() update emissions emission parameters sampled distribution call get_synthetic_from_trips() update synthetic trips synthetic population relevant input parameters sampled distribution call get_all_distances() recalculate distances relevant input parameters sampled distribution run ITHIM-Global model calling ithim_calculation_sequence()","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":null,"dir":"Reference","previous_headings":"","what":"Join disease health burden and injury data — join_hb_and_injury","title":"Join disease health burden and injury data — join_hb_and_injury","text":"Join two data frames health burden: disease, road-traffic injury","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join disease health burden and injury data — join_hb_and_injury","text":"","code":"join_hb_and_injury(ind_ap_pa, inj)"},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join disease health burden and injury data — join_hb_and_injury","text":"ind_ap_pa list (deaths, YLLs) data frames demographic groups' burdens diseases inj list (deaths, YLLs) data frames demographic groups' burdens road-traffic injury","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join disease health burden and injury data — join_hb_and_injury","text":"list dataframes: one deaths per cause per demographic group, likewise YLLs","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/join_hb_and_injury.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join disease health burden and injury data — join_hb_and_injury","text":"function performs following steps: extract yll deaths data AP PA pathways extract yll deaths data injury data create one dataframe yll one deaths containing AP, PA injury data","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrapper for running ITHIM — run_ithim","title":"Wrapper for running ITHIM — run_ithim","text":"Switch either calculate health burden using constant input parameter values sample distributions first","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrapper for running ITHIM — run_ithim","text":"","code":"run_ithim(ithim_object, seed = 1)"},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrapper for running ITHIM — run_ithim","text":"ithim_object list input data needed calculate health burden seed","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrapper for running ITHIM — run_ithim","text":"ithim_object list items giving input data output results","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Wrapper for running ITHIM — run_ithim","text":"function works creating switch run computation calling ithim_calculation_sequence() directly, divert sampling case ithim_uncertainty() first extracts sampled parameters calls ithim_calculation_sequence().","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":null,"dir":"Reference","previous_headings":"","what":"Run the set up scripts for ITHIM — run_ithim_setup","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"Sets basic ITHIM object onward calculation. Data loading, processing harmonisation. Setting global values.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"","code":"run_ithim_setup( seed = 1, CITY = \"bogota\", speeds = NULL, PM_emission_inventory = NULL, CO2_emission_inventory = NULL, DIST_CAT = c(\"0-2 km\", \"2-6 km\", \"6+ km\"), AGE_RANGE = c(15, 69), ADD_WALK_TO_PT_TRIPS = T, ADD_BUS_DRIVERS = T, ADD_CAR_DRIVERS = T, ADD_TRUCK_DRIVERS = T, ADD_MOTORCYCLE_FLEET = T, ADD_PERSONAL_MOTORCYCLE_TRIPS = \"no\", REFERENCE_SCENARIO = \"baseline\", PATH_TO_LOCAL_DATA = NULL, NSAMPLES = 1, BUS_WALK_TIME = 16, RAIL_WALK_TIME = 12.5, CYCLING_MET = 6.8, WALKING_MET = 3.5, PASSENGER_MET = 1.3, CAR_DRIVER_MET = 2.5, MOTORCYCLIST_MET = 2.8, SEDENTARY_ACTIVITY_MET = 1.3, LIGHT_ACTIVITY_MET = 1.3, MODERATE_PA_MET = 4, VIGOROUS_PA_MET = 8, PM_CONC_BASE = 12.69, PM_TRANS_SHARE = 0.42, PA_DOSE_RESPONSE_QUANTILE = F, AP_DOSE_RESPONSE_QUANTILE = F, BACKGROUND_PA_SCALAR = 1, BACKGROUND_PA_CONFIDENCE = 1, INJURY_REPORTING_RATE = 1, CHRONIC_DISEASE_SCALAR = 1, DAY_TO_WEEK_TRAVEL_SCALAR = 7, SIN_EXPONENT_SUM = 2, CASUALTY_EXPONENT_FRACTION = 0.5, SIN_EXPONENT_SUM_NOV = 1, SIN_EXPONENT_SUM_CYCLE = 2, CASUALTY_EXPONENT_FRACTION_CYCLE = 0.5, SIN_EXPONENT_SUM_PED = 2, CASUALTY_EXPONENT_FRACTION_PED = 0.5, SIN_EXPONENT_SUM_VEH = 2, CASUALTY_EXPONENT_FRACTION_VEH = 0.5, BUS_TO_PASSENGER_RATIO = 0.0389, CAR_OCCUPANCY_RATIO = 0.625, TRUCK_TO_CAR_RATIO = 0.3, FLEET_TO_MOTORCYCLE_RATIO = 0.441, PROPORTION_MOTORCYCLE_TRIPS = 0, PM_EMISSION_INVENTORY_CONFIDENCE = 1, CO2_EMISSION_INVENTORY_CONFIDENCE = 1, DISTANCE_SCALAR_CAR_TAXI = 1, DISTANCE_SCALAR_WALKING = 1, DISTANCE_SCALAR_PT = 1, DISTANCE_SCALAR_CYCLING = 1, DISTANCE_SCALAR_MOTORCYCLE = 1, BUS_DRIVER_PROP_MALE = 0.98, BUS_DRIVER_MALE_AGERANGE = \"19, 65\", BUS_DRIVER_FEMALE_AGERANGE = \"19, 65\", TRUCK_DRIVER_PROP_MALE = 0.98, TRUCK_DRIVER_MALE_AGERANGE = \"18, 65\", TRUCK_DRIVER_FEMALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_PROP_MALE = 0.99, COMMERCIAL_MBIKE_MALE_AGERANGE = \"18, 65\", COMMERCIAL_MBIKE_FEMALE_AGERANGE = \"18, 65\", MINIMUM_PT_TIME = 3, MODERATE_PA_CONTRIBUTION = 0.5, CALL_INDIVIDUAL_SIN = F, SCENARIO_NAME = \"GLOBAL\", SCENARIO_INCREASE = 0.05 )"},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"seed set seed get results sampling distribution CITY name city, name directory containing city data files speeds named list mode speeds PM_emission_inventory named list mode PM emissions CO2_emission_inventory named list CO2 mode emissions DIST_CAT vector string distance categories form '0-6'. (unit assumed trip set related speed values, usually km) AGE_RANGE vector minimum maximum ages include ADD_WALK_TO_PT_TRIPS logic: whether add short walks PT trips ADD_BUS_DRIVERS logic: whether add bus drivers ADD_CAR_DRIVERS logic: whether find add distance travelled individual cars, denoted car drivers ADD_TRUCK_DRIVERS logic: whether add truck drivers ADD_MOTORCYCLE_FLEET logic: whether add additional commercial motorcycle fleet ghost trips ADD_PERSONAL_MOTORCYCLE_TRIPS character: '' add personal motorcycle trips otherwise set geographic region defines set-motorcycle trips added REFERENCE_SCENARIO scenario forms reference health comparison PATH_TO_LOCAL_DATA path CITY directory, using package NSAMPLES constant integer: number samples take BUS_WALK_TIME lognormal parameter: duration walk bus stage RAIL_WALK_TIME lognormal parameter: duration walk rail stage CYCLING_MET lognormal parameter: METs cycling WALKING_MET lognormal parameter: METs walking PASSENGER_MET lognormal parameter: MET value associated passenger public transport CAR_DRIVER_MET lognormal parameter: MET value associated car driver MOTORCYCLIST_MET lognormal parameter: MET value associated motorcyclist SEDENTARY_ACTIVITY_MET lognormal parameter: MET value associated sedentary activity LIGHT_ACTIVITY_MET lognormal parameter: MET value associated light activity MODERATE_PA_MET lognormal parameter: MET value associated moderate activity VIGOROUS_PA_MET lognormal parameter: MET value associated vigorous activity PM_CONC_BASE lognormal parameter: background PM2.5 concentration PM_TRANS_SHARE beta parameter: fraction background PM2.5 attributable transport PA_DOSE_RESPONSE_QUANTILE logic: whether sample physical activity relative risk dose response functions AP_DOSE_RESPONSE_QUANTILE logic: whether sample air pollution relative risk dose response functions BACKGROUND_PA_SCALAR lognormal parameter: reporting scalar physical activity correct bias data BACKGROUND_PA_CONFIDENCE beta parameter: confidence accuracy zero non-travel physical activity levels INJURY_REPORTING_RATE lognormal parameter: rate injury fatality reporting CHRONIC_DISEASE_SCALAR lognormal parameter: scalar background disease rates adjust bias GBD data DAY_TO_WEEK_TRAVEL_SCALAR beta parameter: rate scaling travel one day one week - CURRENTLY used constant (using beta parameter need considerations) SIN_EXPONENT_SUM lognormal parameter: linearity injuries respect two modes. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION beta parameter: casualty exponent contribution SIN_EXPONENT_SUM SIN_EXPONENT_SUM_NOV lognormal parameter: linearity injuries respect two modes strike mode = NOV. SIN_EXPONENT_SUM=2 means safety numbers SIN_EXPONENT_SUM_CYCLE lognormal parameter: linearity injuries respect two modes victim mode = cycle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_CYCLE beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_CYCLE victim mode = cycle SIN_EXPONENT_SUM_PED lognormal parameter: linearity injuries respect two modes victim mode = pedestrian. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_PED beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_PED victim mode = pedestrian SIN_EXPONENT_SUM_VEH lognormal parameter: linearity injuries respect two modes victim mode = vehicle. SIN_EXPONENT_SUM=2 means safety numbers CASUALTY_EXPONENT_FRACTION_VEH beta parameter: casualty exponent contribution SIN_EXPONENT_SUM_VEH victim mode = vehicle BUS_TO_PASSENGER_RATIO beta parameter: number buses per passenger CAR_OCCUPANCY_RATIO beta parameter: number people per car (including driver) TRUCK_TO_CAR_RATIO beta parameter: proportion truck car vehicle km travelled FLEET_TO_MOTORCYCLE_RATIO beta parameter: amount motorcycle trips added commercial trips PROPORTION_MOTORCYCLE_TRIPS beta parameter: proportion trips added personal motorcycle trips PM_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy PM emission inventory CO2_EMISSION_INVENTORY_CONFIDENCE beta parameter: confidence accuracy CO2 emission inventory DISTANCE_SCALAR_CAR_TAXI lognormal parameter: scalar adjust bias car distance travelled DISTANCE_SCALAR_WALKING lognormal parameter: scalar adjust bias walking distance travelled DISTANCE_SCALAR_PT lognormal parameter: scalar adjust bias PT distance travelled DISTANCE_SCALAR_CYCLING lognormal parameter: scalar adjust bias cycling distance travelled DISTANCE_SCALAR_MOTORCYCLE lognormal parameter: scalar adjust biase motorcycle distance travelled BUS_DRIVER_PROP_MALE scalar: proportion bus drivers male BUS_DRIVER_MALE_AGERANGE character: age range male bus drivers BUS_DRIVER_FEMALE_AGERANGE character: age range female bus drivers TRUCK_DRIVER_PROP_MALE scalar: proportion truck drivers male TRUCK_DRIVER_MALE_AGERANGE character: age range male truck drivers TRUCK_DRIVER_FEMALE_AGERANGE character: age range female truck drivers COMMERCIAL_MBIKE_PROP_MALE scalar: proportion commercial motorcycle drivers male COMMERCIAL_MBIKE_MALE_AGERANGE character: age range male commercial motorcycle drivers COMMERCIAL_MBIKE_FEMALE_AGERANGE character: age range female commercial motorcycle drivers MINIMUM_PT_TIME scalar: minimum time person spends public transport MODERATE_PA_CONTRIBUTION scalar: proportion contribution moderate PA Leisure MVPA CALL_INDIVIDUAL_SIN logic: whether call safety number coefficients individual vehicles use coefficients modes SCENARIO_NAME name scenarios (currently supports: TEST_WALK_SCENARIO, TEST_CYCLE_SCENARIO, MAX_MODE_SHARE_SCENARIO, LATAM, GLOBAL, AFRICA_INDIA, BOGOTA) SCENARIO_INCREASE increase given mode scenario (currently used GLOBAL, BOGOTA, LATAM AFRICA_INDIA scenarios)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"ithim_object list objects onward use.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/run_ithim_setup.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Run the set up scripts for ITHIM — run_ithim_setup","text":"function used read various input files parameters process harmonise data ready health impact assessment. Input Parameters two options: set constant sampled pre-specified distribution. parameters given argument length 1 2. length 1, parameter usually used constant. parameter length 2, distribution defined sampled NSAMPLE times. function performs following steps: check whether valid scenario name called, get error message set various input parameters global parameters find path local data define fixed parameters air pollution inhalation define mode speeds: set default speeds various modes update default speeds city specific mode speeds given input parameters ensure similar modes speed assigned set-dataframe modes speeds define PM emissions inventory define default emission values update default values city specific values given input parameters define CO2 emissions inventory set default emission values update default values city specific values given input parameters load process data files calling ithim_load_data() call ithim_setup_parameters() set given input parameters global environment running constant mode obtain NSAMPLE samples given distributions input parameters running sample mode set flags cause certain parts model called later stage (ithim_uncertainty()) certain input parameters sampled distribution call complete_trip_distance_duration() add missing stage distance information trip data none corresponding input parameters sampled distribution, call set_vehicle_inventory() create dataframe mode specific speed, distance emission information none corresponding input parameters sampled distribution, call get_synthetic_from_trips() set synthetic trips synthetic population none corresponding input parameters sampled distribution, call get_all_distances() calculate trip distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale trip distances — scale_trip_distances","title":"Scale trip distances — scale_trip_distances","text":"Applies mode-specific distance scalars trips","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale trip distances — scale_trip_distances","text":"","code":"scale_trip_distances(trips)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale trip distances — scale_trip_distances","text":"trips data frame, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale trip distances — scale_trip_distances","text":"data frame, trips scenarios scaled distances","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scale_trip_distances.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Scale trip distances — scale_trip_distances","text":"function used multiply trip stages belonging certain mode city specific scalar. Note walk pt stages counted public transport stages multiplied DISTANCE_SCALAR_PT function performs following steps: define car public transport modes multiply stage distances stage durations corresponding distance scalars","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"Calculate total CO2 exposure mode scenario based CO2 emissions inventory","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"","code":"scenario_co2_calculations(dist)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"dist data frame population travel scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"total CO2 exposure per mode","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_co2_calculations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total CO2 exposure per mode and scenario — scenario_co2_calculations","text":"function performs following steps: calculate emission factors mode dividing total emissions distances travelled calculate CO2 emissions mode scenario multiplying scenario distance times emission factors modes without assigned distance, use CO2 emissions VEHICLE_INVENTORY instead","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total AP exposure per person — scenario_pm_calculations","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"Calculate total AP exposure per person based population personal travel","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"","code":"scenario_pm_calculations(dist, trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"dist total distance travelled mode population scenarios trip_scen_sets trips data frame trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"background PM concentration baseline scenarios total AP exposure per person synthetic population (baseline scenarios)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/scenario_pm_calculations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total AP exposure per person — scenario_pm_calculations","text":"function performs following steps: exposure factor rates activity defined - parameters fixed calculate pm concentration related transport calculate PM emission factors mode dividing total emissions distances travelled calculate PM emissions mode scenario multiplying scenario distance emission factors modes without assigned distance, use PM emissions VEHICLE_INVENTORY instead calculate total PM concentrations scenario add exposure factors trip set stage mode add total scenario PM concentrations trip set calculate ventilation rate stage taking account demographic characteristics exposure factors calculate inhaled air total PM (micro grams) trip set calculate amount time per day spent sleep, moderate vigorous activities add total time spent travelling participant trip set calculate ventilation rate sleep, moderate vigorous activities participant synthetic population (travel component), calculate total air inhaled, total PM inhaled total PM concentration inhaled scenario assign participants synthetic population without travel component, baseline scenario PM concentrations join people without travel synthetic population","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":null,"dir":"Reference","previous_headings":"","what":"Injury summary statistics — set_injury_contingency","title":"Injury summary statistics — set_injury_contingency","text":"Creates summarised injury tables 'hit ' 'vehicle' fatality counts casualty strike mode combination (age sex combination information exists)","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Injury summary statistics — set_injury_contingency","text":"","code":"set_injury_contingency(injuries)"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Injury summary statistics — set_injury_contingency","text":"injuries data frame individual injury events","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_injury_contingency.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Injury summary statistics — set_injury_contingency","text":"function performs following steps using individual fatality injury input file: data split WHW (hit ) matrix casualty strike mode given NOV (vehicle) matrix strike mode set NOV ithim_load_data() vehicle involved accident. age gender information given, counts multiplied proportion injuries relevant proportion population considered model (e.g. 15 - 65 year olds) based GBD data Data aggregated casualty strike mode, age sex information exists Complete whw nov matrices containing casualty strike (age sex) combinations created zero counts combinations fatalities list aggregated whw nov matrices set Global environment","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_scenario_specific_variables.html","id":null,"dir":"Reference","previous_headings":"","what":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","title":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","text":"Set NSCEN, SCEN SCEN_SHORT_NAME","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_scenario_specific_variables.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set scenario specific variables - CURRENTLY NOT CALLED — set_scenario_specific_variables","text":"","code":"set_scenario_specific_variables()"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":null,"dir":"Reference","previous_headings":"","what":"Collate all vehicle information — set_vehicle_inventory","title":"Collate all vehicle information — set_vehicle_inventory","text":"Puts vehicle information one place including speeds emission factors. Writes global environment.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Collate all vehicle information — set_vehicle_inventory","text":"","code":"set_vehicle_inventory()"},{"path":"https://ithim.github.io/ITHIM-R/reference/set_vehicle_inventory.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Collate all vehicle information — set_vehicle_inventory","text":"function performs following operations: Based city specific (default) mode speeds, vehicle inventory initialised PM emissions added city specific (default) PM inventory big_truck mode added distance mode used air pollution modules mode added already exist travel survey (hence mode speeds) CO2 emissions added city specific (default) CO2 inventory car_driver exists, car_driver emissions set PM CO2 car emissions VEHICLE_INVENTORY set global variable","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate total mMETs per person — total_mmet","title":"Calculate total mMETs per person — total_mmet","text":"Calculate total mMETs per person synthetic population based non-travel PA active travel scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate total mMETs per person — total_mmet","text":"","code":"total_mmet(trip_scen_sets)"},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate total mMETs per person — total_mmet","text":"trip_scen_sets data frame trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate total mMETs per person — total_mmet","text":"mmets - total mMETs per week per person scenario","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/total_mmet.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate total mMETs per person — total_mmet","text":"function performs following steps: extract people trip set active travel (walk cycle) stage mode (non-ghost trips ) calculate weekly time spent active travel scenario: scale non-travel mMET value people synthetic population BACKGROUND_PA_SCALAR adjust biases PA data calculate total cycling walking mMET values relevant person trip set scale week add active travel mMET non-travel mMET values person synthetic population create one dataframe total MMET people synthetic population scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":null,"dir":"Reference","previous_headings":"","what":"Add walk to public transport stages — walk_to_pt_and_combine_scen","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"Adds short walk stage public transport (PT) trip required.","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"","code":"walk_to_pt_and_combine_scen(SYNTHETIC_TRIPS)"},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"trip_set list data frames, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"data frame, trips scenarios","code":""},{"path":"https://ithim.github.io/ITHIM-R/reference/walk_to_pt_and_combine_scen.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add walk to public transport stages — walk_to_pt_and_combine_scen","text":"function performs following steps: create list containing dataframes synthetic trips scenario ADD_WALK_TO_PT_TRIPS == T, .e additional 'walk pt' stages added: filter trips public transport stage mode divide public transport trips without 'walk pt' stage add 'walk pt' stage public transport trips without walking stage (add_walk_trips()) combine trips scenarios one dataframe scale stage distances durations calling scale_trip_distances.R function","code":""}] diff --git a/sitemap.xml b/sitemap.xml index 01d002d3..d8b99fdb 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -72,6 +72,9 @@ https://ithim.github.io/ITHIM-R/reference/dist_dur_tbls.html + + https://ithim.github.io/ITHIM-R/reference/extract_data_for_voi.html + https://ithim.github.io/ITHIM-R/reference/gen_ap_rr.html