R: Simulate Tobacco Smoke Exposure in Homes

mrd {ResSmoke}

R Documentation

Simulate Tobacco Smoke Exposure in Homes

Description

Function to execute an exposure simulation model (ESM) for exposure to environmental tobacco smoke (ETS) in multi-room dwellings (MRD).

Usage

mrd(n, scenario, sa.tact, ra.tact, sa.index, ra.index,
    sleep.code, loc.codes, emission.rate, cigs.perday,
    cig.dur, deposition.rate, hvac.dutycycle,
    hvac.ontime, footage, airexchange, flow.door.closed,
    flow.door.open, flow.win.open, force, inlets, outlets,
    strat.vars = NULL, silent = TRUE, ...)
mrd2(n, scenario, sa.tact, ra.tact, sa.index, ra.index,
    sleep.code, loc.codes, emission.rate, cigs.perday,
    cig.dur, deposition.rate, hvac.dutycycle,
    hvac.ontime, footage, airexchange, flow.door.closed,
    flow.door.open, flow.win.open, force, inlets, outlets,
    strat.vars = NULL, silent = TRUE, ...)

Arguments

`n`	the number of individuals to simulate
`scenario`	an 18-digit vector containing 0's, 1's or 2's (for "off", "on", or "random") giving the scenario specification, defaulting to no exposure controls, except for disallowing smoking in bathrooms and laundry rooms (digit 4 = 0), and a full multi-zone treatment where forced ventilation is not active; digit 13 is also deactivated so that any controls would apply to entire smoking episodes (time segments where smoker is present in a smoking room) and not just when a cigarette happens to be active.
`sa.tact`	a list of time-activities for source persons, defaulting to those in `nhaps.whr.ract.smk.tact.sub2`
`ra.tact`	a list of time-activities for receptor persons, defaulting to those in `nhaps.whr.ract.smk.tact.sub2`
`sa.index`	a list of index factors for source persons, defaulting to those in `nhaps.indices.sub2`
`ra.index`	a list of index factors for receptor persons, defaulting to those in `nhaps.indices.sub2`
`sleep.code`	the code(s) in each time-activity that corresponds to time spent sleeping, see `mrd.codes` for the default
`loc.codes`	the codes in each time-activity corresponding to different locations, see `mrd.codes` for defaults
`emission.rate`	a `distrib` object giving the distribution of cigarette emission rates, see `mrd.em` for the default
`cigs.perday`	a `distrib` object giving the number of cigarettes each source person smokes in a single day, see `mrd.em` for the default
`cig.dur`	a `distrib` object giving the duration of a single cigatte in minutes, see `mrd.em` for the default
`deposition.rate`	a `distrib` object giving the deposition rate in units of inverse hours, see `mrd.en` for the default
`hvac.dutycycle`	a `distrib` object giving the percentage of time the HVAC system over a single day, see `mrd.en` for the default
`hvac.ontime`	a `distrib` object giving the amount of continous time the HVAC system spends active before shutting off, e.g., due to a temperature control sensor, see `mrd.en` for the default
`footage`	a 3-way array containing a frequency table by number of house rooms, number of floors, and square footage, used to sample footage for a given house and, ultimately, determine the house volume, defaulting to `ahs.2001.footage.xtab`
`airexchange`	a `distrib` object containing the base house air exchange for air leakage to the outdoors when all windows are closed and no forced ventilation is active, defaulting to 0.6 1/h
`flow.door.open`	a `distrib` object containing the base flow rate across an open door, defaulting to 100 m^3/h
`flow.door.closed`	a `distrib` object containing the flow across a closed door, defaulting 1o 1 m^3/h
`flow.win.open`	a `distrib` object containing the flow through an open window, defaulting to 150 m^3/h
`force`	a list containing the driving forces for flow for each simulated individual, either "temp" for temperature-driven flow or "wind" for wind-driven flow
`inlets`	a list of character vectors one for each individual, each containing the basic room types acting as inlets for wind-driven flow
`outlets`	a list of character vectors one for each individual, each containing the basic room types acting as outlets for wind-driven flow
`strat.vars`	a list of indices or variables names, corresponding to each index component, for stratifying variables containing factors that will be used to generate equal probability weights for each factor combination; the selected variables must be a subset of those in the matching index component.
`silent`	logical, whether to suppress simulation-specific warning messages or not, warning messages for language or programming errors will be generated regardless of this argument's value
`...`	options to be passed to the `esm` function

Details

This function is a convenience wrapper function for the esm function in the heR.Simulation package, providing reasonable defaults for data input values, and automatically passing the esm.MRD.input, esm.MRD.expos, and esm.MRD.output component functions as esm arguments.

Only the number of individuals to simulate, n, is a required mrd argument. The other arguments will be assigned automatically if not given.

mrd executes the simulation with a wider range of input parameters and for source and receptor activities for both nonsmokers and smokers.

mrd2 executes the simulation for point estimates of each input paramter and for source and receptor activities limited to nonsmokers.

Value

An esm output object containing the results of a multi-room dwelling exposure simulation model run.

Author(s)

Neil E. Klepeis
http://klepeis.net