Schema 12 documentation

Generated from: scenario_12.xsd.

Key:

  abc           required (one)
[ def ]         optional (zero or one)
( ghi )*        any number (zero or more)
( jkl )+        at least one
( mno ){2,inf}  two or more occurrences

scenario

→ scenario

<scenario
    schemaVersion=int
    analysisNo=int
    maximumAgeYrs=double
    name=string
    popSize=int
    modelVersion=int
    wuID=int
    assimMode=("0" or "1")
    mode=("2" or "3" or "4")
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="scenario_12.xsd"
  >
IN THIS ORDER:
|   <demography ... /> 
|   <monitoring ... /> 
|   <interventions ... /> 
| EXACTLY ONE OF:
| |   <EventScheduler ... /> 
| |   <healthSystem ... /> 
|   <entoData ... /> 
| [ <drugDescription ... /> ]
|   <parameters ... /> 
</scenario>

• demography
• monitoring
• interventions
• EventScheduler
• healthSystem
• entoData
• drugDescription
• parameters

Documentation (element)

Units: List of elements

Description of scenario

Attributes

schemaVersion

schemaVersion=int

Version of xml schema. If not equal to the current version an error is thrown. Use SchemaTranslator to update xml files.

analysisNo

analysisNo=int

Units: Number Min: 1 Max: 100000000

Unique identifier of scenario

maximumAgeYrs

maximumAgeYrs=double

Units: Number Min: 0 Max: 100

Maximum age of simulated humans

name

name=string

Units: string

Name of intervention

popSize

popSize=int

Units: Count Min: 1 Max: 100000

Population size

modelVersion

modelVersion=int

Units: Code Min: 0 Max: 100000000

Model Version

wuID

wuID=int

Units: Number Min: 1 Max: 100000000

Work unit ID. Only used to validate checkpointing, to prevent checkpoint cheats.

assimMode

assimMode=("0" or "1")

Units: Code

Assimilator mode. Defines output of simulator as either complete (columns: time,agegroup,measure,value) or minimal (single column: value)

mode

mode=("2" or "3" or "4")

Units: Code

Transmission simulation mode

demography

→ scenario → demography

<demography
    name=string
  [ growthRate=double ]
  >
IN THIS ORDER:
|   <ageGroup ... /> 
</demography>

• ageGroup

Documentation (element)

Units: List of elements

Description of demography

Documentation (type)

Units: List of elements

Description of demography

Attributes

name

name=string

Units: string

Name of demography data

growthRate

growthRate=double

Units: Number Min: 0 Max: 0

Growth rate of human population.

ageGroup

→ scenario → demography → ageGroup

<ageGroup
    lowerbound=double
  >
IN THIS ORDER:
| ( <group ... /> )+
</ageGroup>

• group

Documentation (element)

Units: List of elements

List of age groups included in demography

Documentation (type)

Units: List of elements

List of age groups included in demography or surveys

Attributes

lowerbound

lowerbound=double

Units: Years Min: 0 Max: 100

Lower bound of age group

group

→ scenario → demography → ageGroup → group

<group
    poppercent=double
    upperbound=double
  />

Attributes

poppercent

poppercent=double

upperbound

upperbound=double

monitoring

→ scenario → monitoring

<monitoring
    name=string
  >
IN THIS ORDER:
|   <surveys ... /> 
|   <ageGroup ... /> 
</monitoring>

• surveys
• ageGroup

Documentation (element)

Units: List of elements

Description of surveys

Documentation (type)

Units: List of elements

Description of surveys

Attributes

name

name=string

Units: string

Name of monitoring data

surveys

→ scenario → monitoring → surveys

<surveys
    detectionLimit=double
    summaryOption=int
  >
IN THIS ORDER:
|   <surveyTime ... /> 
</surveys>

• surveyTime

Documentation (element)

Units: List of elements

List of survey times

Attributes

detectionLimit

detectionLimit=double

Units: parasites/micolitre Min: 0 Max: 1000

Detection limit for parasitemia

summaryOption

summaryOption=int

Units: Code

Requested output variables

surveyTime

→ scenario → monitoring → surveys → surveyTime

<surveyTime>
    int
</surveyTime>

Documentation (element)

Units: Number Min: 0

Survey time; 0 means just before start of main sim and is a valid survey-point. Reported data is either from a point-time survey (immediate data) or is collected over the previous year (data from previous timesteps-per-year period). Simulation will end immediately after last survey is taken.

ageGroup

→ scenario → monitoring → ageGroup

<ageGroup
    lowerbound=double
  >
IN THIS ORDER:
| ( <group ... /> )+
</ageGroup>

• group

Documentation (element)

Units: List of elements

List of age groups included in demography or surveys

Documentation (type)

Units: List of elements

List of age groups included in surveys

Attributes

lowerbound

lowerbound=double

Units: Years Min: 0 Max: 100

Lower bound of age group

group

→ scenario → monitoring → ageGroup → group

<group
    upperbound=double
  />

Attributes

upperbound

upperbound=double

interventions

→ scenario → interventions

<interventions
    name=string
  >
IN THIS ORDER:
| ( <vaccineDescription ... /> ){0,3}
| [ <iptiDescription ... /> ]
| ( <anopheles ... /> )*
| [ <continuous ... /> ]
| [ <timed ... /> ]
</interventions>

• vaccineDescription
• iptiDescription
• anopheles
• continuous
• timed

Documentation (element)

Units: List of elements

List of interventions

Documentation (type)

Units: List of elements

List of interventions

Attributes

name

name=string

Units: string

Name of age specific intervention

vaccineDescription

→ scenario → interventions → vaccineDescription

<vaccineDescription
    vaccineType=int
  >
IN THIS ORDER:
|   <halfLifeYrs ... /> 
|   <efficacyB ... /> 
| ( <initialEfficacy ... /> )+
</vaccineDescription>

• halfLifeYrs
• efficacyB
• initialEfficacy

Attributes

vaccineType

vaccineType=int

Units: Code

Type of vaccine

halfLifeYrs

→ scenario → interventions → vaccineDescription → halfLifeYrs

<halfLifeYrs
    value=double
  />

Documentation (element)

Units: Years Min: 0 Max: 100

Half life of drug effect

Attributes

value

value=double

TODO

efficacyB

→ scenario → interventions → vaccineDescription → efficacyB

<efficacyB
    value=double
  />

Documentation (element)

Units: Positive real Min: 0.001 Max: 1.00E+06

Measure of variation in vaccine efficacy

Attributes

value

value=double

TODO

initialEfficacy

→ scenario → interventions → vaccineDescription → initialEfficacy

<initialEfficacy
    value=double
  />

Attributes

value

value=double

TODO

iptiDescription

→ scenario → interventions → iptiDescription

<iptiDescription
    iptiEffect=int
  >
IN THIS ORDER:
| ( <infGenotype ... /> )+
</iptiDescription>

• infGenotype

Attributes

iptiEffect

iptiEffect=int

infGenotype

→ scenario → interventions → iptiDescription → infGenotype

<infGenotype
    name=string
    freq=double
    ACR=double
    proph=int
    tolPeriod=int
    atten=double
  />

Attributes

name

name=string

Units: string

Name of age specific intervention

freq

freq=double

ACR

ACR=double

proph

proph=int

tolPeriod

tolPeriod=int

atten

atten=double

anopheles

→ scenario → interventions → anopheles

<anopheles
    mosquito=string
  >
IN THIS ORDER:
| [ <ITNDescription ... /> ]
| [ <IRSDescription ... /> ]
| [ <VADescription ... /> ]
</anopheles>

• ITNDescription
• IRSDescription
• VADescription

Attributes

mosquito

mosquito=string

ITNDescription

→ scenario → interventions → anopheles → ITNDescription

<ITNDescription
    name=string
  >
IN THIS ORDER:
|   <deterrency ... /> 
|   <preprandialKillingEffect ... /> 
|   <postprandialKillingEffect ... /> 
</ITNDescription>

• deterrency
• preprandialKillingEffect
• postprandialKillingEffect

Attributes

name

name=string

Units: string

Name of Insecticide Treated Net intervention

deterrency

→ scenario → interventions → anopheles → ITNDescription → deterrency

<deterrency
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the host's availability (before decay).

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

preprandialKillingEffect

→ scenario → interventions → anopheles → ITNDescription → preprandialKillingEffect

<preprandialKillingEffect
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the survival rate of mosquitoes attempting to bite a host.

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

postprandialKillingEffect

→ scenario → interventions → anopheles → ITNDescription → postprandialKillingEffect

<postprandialKillingEffect
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the survival rate of mosquitoes attempting to escape after biting a host.

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

IRSDescription

→ scenario → interventions → anopheles → IRSDescription

<IRSDescription
    name=string
  >
IN THIS ORDER:
|   <deterrency ... /> 
|   <killingEffect ... /> 
</IRSDescription>

• deterrency
• killingEffect

Attributes

name

name=string

Units: string

Name of Indoor Residual Spraying intervention

deterrency

→ scenario → interventions → anopheles → IRSDescription → deterrency

<deterrency
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the host's availability.

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

killingEffect

→ scenario → interventions → anopheles → IRSDescription → killingEffect

<killingEffect
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the survival rate of resting mosquitoes.

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

VADescription

→ scenario → interventions → anopheles → VADescription

<VADescription
    name=string
  >
IN THIS ORDER:
|   <deterrency ... /> 
</VADescription>

• deterrency

Attributes

name

name=string

Units: string

Name of mosquito deterrency intervention

deterrency

→ scenario → interventions → anopheles → VADescription → deterrency

<deterrency
    initial=double
    halflife=double
  [ Weibullk=double ]
  />

Documentation (element)

Units: None Min: 0 Max: 1

One minus this multiplies the host's availability.

Documentation (type)

Specification of a proportion with Weibull or exponential decay.

Attributes

initial

initial=double

Units: None Min: 0 Max: 1

The value before any decay.

halflife

halflife=double

Units: Years Min: 0

Half-life in years (more generally, halflife/ln(2) is lambda from the Weibull distribution).

Weibullk

Weibullk=double

Min: 0

The parameter k of the Weibull distribution. If missing, 1.0 is used (equivalent to exponential decay).

continuous

→ scenario → interventions → continuous

<continuous>
IN THIS ORDER:
| ( <vaccine ... /> )*
| ( <ITN ... /> )*
| ( <ipti ... /> )*
</continuous>

• vaccine
• ITN
• ipti

vaccine

→ scenario → interventions → continuous → vaccine

<vaccine
    targetAgeYrs=double
    coverage=double
  />

Documentation (element)

Units: List of elements

List of age groups for vaccination

Attributes

targetAgeYrs

targetAgeYrs=double

Units: Years Min: 0 Max: 100

Target age of intervention

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

ITN

→ scenario → interventions → continuous → ITN

<ITN
    targetAgeYrs=double
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of ITN deployment in the community

Attributes

targetAgeYrs

targetAgeYrs=double

Units: Years Min: 0 Max: 100

Target age of intervention

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

ipti

→ scenario → interventions → continuous → ipti

<ipti
    targetAgeYrs=double
    coverage=double
  />

Documentation (element)

Units: List of elements

List of age groups for IPTi distribution

Attributes

targetAgeYrs

targetAgeYrs=double

Units: Years Min: 0 Max: 100

Target age of intervention

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

timed

→ scenario → interventions → timed

<timed>
IN THIS ORDER:
| ( <intervention ... /> )+
</timed>

• intervention

Documentation (element)

Units: List of elements

List of timed interventions

Documentation (type)

Units: List of elements

List of timed interventions

intervention

→ scenario → interventions → timed → intervention

<intervention
    time=int
  >
IN THIS ORDER:
| [ <changeHS ... /> ]
| [ <changeEIR ... /> ]
| [ <MDA ... /> ]
| [ <vaccinate ... /> ]
| [ <ITN ... /> ]
| [ <IRS ... /> ]
| [ <VectorAvailability ... /> ]
| [ <ipti ... /> ]
| [ <larviciding ... /> ]
</intervention>

• changeHS
• changeEIR
• MDA
• vaccinate
• ITN
• IRS
• VectorAvailability
• ipti
• larviciding

Attributes

time

time=int

Units: Number Min: 1 Max: 10000

Time step of intervention

changeHS

→ scenario → interventions → timed → intervention → changeHS

<changeHS
    name=string
    healthSystemMemory=int
  >
IN THIS ORDER:
|   <drugRegimen ... /> 
|   <initialACR ... /> 
|   <compliance ... /> 
|   <nonCompliersEffective ... /> 
|   <pSeekOfficialCareUncomplicated1 ... /> 
|   <pSelfTreatUncomplicated ... /> 
|   <pSeekOfficialCareUncomplicated2 ... /> 
|   <pSeekOfficialCareSevere ... /> 
|   <pSequelaeInpatient ... /> 
|   <CFR ... /> 
</changeHS>

• drugRegimen
• initialACR
• compliance
• nonCompliersEffective
• pSeekOfficialCareUncomplicated1
• pSelfTreatUncomplicated
• pSeekOfficialCareUncomplicated2
• pSeekOfficialCareSevere
• pSequelaeInpatient
• CFR

Documentation (type)

Units: List of elements

Description of health system

Attributes

name

name=string

Units: string

Name of health system

healthSystemMemory

healthSystemMemory=int

Units: Time steps Min: 1 Max: 100

Follow-up period during which a recurrence is considered to be a treatment failure

drugRegimen

→ scenario → healthSystem → drugRegimen

<drugRegimen
    firstLine=string
    secondLine=string
    inpatient=string
  />

Documentation (element)

Units: List of elements

Description of drug regimen

Attributes

firstLine

firstLine=string

Units: Drug code

Code for first line drug

secondLine

secondLine=string

Units: Drug code

Code for second line drug

inpatient

inpatient=string

Units: Drug code

Code for drug used for treating inpatients

initialACR

→ scenario → healthSystem → initialACR

<initialACR>
IN THIS ORDER:
| [ <CQ ... /> ]
| [ <SP ... /> ]
| [ <AQ ... /> ]
| [ <SPAQ ... /> ]
| [ <ACT ... /> ]
| [ <QN ... /> ]
|   <selfTreatment ... /> 
</initialACR>

• CQ
• SP
• AQ
• SPAQ
• ACT
• QN
• selfTreatment

Documentation (element)

Units: Proportion Min: 0 Max: 1

Initial cure rate

CQ

→ scenario → healthSystem → initialACR → CQ

<CQ
    value=double
  />

Documentation (element)

Units: List of elements

Chloroquine

Attributes

value

value=double

TODO

SP

→ scenario → healthSystem → initialACR → SP

<SP
    value=double
  />

Documentation (element)

Units: List of elements

Sulphadoxine-pyrimethamine

Attributes

value

value=double

TODO

AQ

→ scenario → healthSystem → initialACR → AQ

<AQ
    value=double
  />

Documentation (element)

Units: List of elements

Amodiaquine

Attributes

value

value=double

TODO

SPAQ

→ scenario → healthSystem → initialACR → SPAQ

<SPAQ
    value=double
  />

Documentation (element)

Units: List of elements

Sulphadoxine-pyrimethamine/Amodiaquine

Attributes

value

value=double

TODO

ACT

→ scenario → healthSystem → initialACR → ACT

<ACT
    value=double
  />

Documentation (element)

Units: List of elements

Artemisinine combination therapy

Attributes

value

value=double

TODO

QN

→ scenario → healthSystem → initialACR → QN

<QN
    value=double
  />

Documentation (element)

Units: List of elements

Quinine

Attributes

value

value=double

TODO

selfTreatment

→ scenario → healthSystem → initialACR → selfTreatment

<selfTreatment
    value=double
  />

Documentation (element)

Units: Proportion Min: 0 Max: 1

Probability of self-treatment

Attributes

value

value=double

TODO

compliance

→ scenario → healthSystem → compliance

<compliance>
IN THIS ORDER:
| [ <CQ ... /> ]
| [ <SP ... /> ]
| [ <AQ ... /> ]
| [ <SPAQ ... /> ]
| [ <ACT ... /> ]
| [ <QN ... /> ]
|   <selfTreatment ... /> 
</compliance>

• CQ
• SP
• AQ
• SPAQ
• ACT
• QN
• selfTreatment

Documentation (element)

Units: Proportion Min: 0 Max: 1

Adherence to treatment

nonCompliersEffective

→ scenario → healthSystem → nonCompliersEffective

<nonCompliersEffective>
IN THIS ORDER:
| [ <CQ ... /> ]
| [ <SP ... /> ]
| [ <AQ ... /> ]
| [ <SPAQ ... /> ]
| [ <ACT ... /> ]
| [ <QN ... /> ]
|   <selfTreatment ... /> 
</nonCompliersEffective>

• CQ
• SP
• AQ
• SPAQ
• ACT
• QN
• selfTreatment

Documentation (element)

Units: Proportion Min: 0 Max: 1

Effectiveness of treatment of non compliers

pSeekOfficialCareUncomplicated1

→ scenario → healthSystem → pSeekOfficialCareUncomplicated1

<pSeekOfficialCareUncomplicated1
    value=double
  />

Documentation (element)

Units: Proportion Min: 0 Max: 1

Probability that a patient with newly incident uncomplicated disease seeks official care

Attributes

value

value=double

TODO

pSelfTreatUncomplicated

→ scenario → healthSystem → pSelfTreatUncomplicated

<pSelfTreatUncomplicated
    value=double
  />

Documentation (element)

Units: Proportion Min: 0 Max: 1

Probability that a patient with uncomplicated disease self-treats

Attributes

value

value=double

TODO

pSeekOfficialCareUncomplicated2

→ scenario → healthSystem → pSeekOfficialCareUncomplicated2

<pSeekOfficialCareUncomplicated2
    value=double
  />

Documentation (element)

Units: Proportion Min: 0 Max: 1

Probability that a patient with recurrence of uncomplicated disease seeks official care

Attributes

value

value=double

TODO

pSeekOfficialCareSevere

→ scenario → healthSystem → pSeekOfficialCareSevere

<pSeekOfficialCareSevere
    value=double
  />

Documentation (element)

Units: Proportion Min: 0 Max: 1

Probability that a patient with severe disease seeks official care

Attributes

value

value=double

TODO

pSequelaeInpatient

→ scenario → healthSystem → pSequelaeInpatient

<pSequelaeInpatient>
IN THIS ORDER:
| ( <item ... /> )+
</pSequelaeInpatient>

• item

Documentation (element)

Units: List of elements

List of age specific probabilities of sequelae in inpatients

item

→ scenario → healthSystem → pSequelaeInpatient → item

<item
    value=double
    maxAgeYrs=double
  />

Attributes

value

value=double

TODO

maxAgeYrs

maxAgeYrs=double

Units: Years Min: 0 Max: 100

Upper bound of age group

CFR

→ scenario → healthSystem → CFR

<CFR>
IN THIS ORDER:
| ( <group ... /> )+
</CFR>

• group

group

→ scenario → healthSystem → CFR → group

<group
    cfr=double
    lowerbound=double
  />

Attributes

cfr

cfr=double

Units: Proportion Min: 0 Max: 1

Case fatality rate

lowerbound

lowerbound=double

Units: Years Min: 0 Max: 100

Lower bound of age group

changeEIR

→ scenario → interventions → timed → intervention → changeEIR

<changeEIR
    eipDuration=int
  >
IN THIS ORDER:
| ( <EIRDaily ... /> )+
</changeEIR>

• EIRDaily

Documentation (type)

Parameters for the non-vector transmission model.

Attributes

eipDuration

eipDuration=int

The duration of sporogony in days

EIRDaily

→ scenario → entoData → nonVector → EIRDaily

<EIRDaily
  [ origin=string ]
  >
    double
</EIRDaily>

Documentation (type)

Units: Innoculations per person per day

Value of daily EIR; when multiple values are given for a single timestep they are averaged.

Attributes

origin

origin=string

MDA

→ scenario → interventions → timed → intervention → MDA

<MDA
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of mass drug deployment in the community

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

vaccinate

→ scenario → interventions → timed → intervention → vaccinate

<vaccinate
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of vaccine deployment in the community

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

ITN

→ scenario → interventions → timed → intervention → ITN

<ITN
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of ITN deployment in the community

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

IRS

→ scenario → interventions → timed → intervention → IRS

<IRS
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of IRS deployment in the community

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

VectorAvailability

→ scenario → interventions → timed → intervention → VectorAvailability

<VectorAvailability
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

Description of a mosquito detterent deployment in the community

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

ipti

→ scenario → interventions → timed → intervention → ipti

<ipti
  [ maxAge=double ]
  [ minAge=double ]
    coverage=double
  />

Documentation (element)

Units: List of elements

List of age groups for IPTi distribution

Attributes

maxAge

maxAge=double

Units: Years Min: 0 Max: 100

Maximum age of eligible individuals (defaults to 100)

minAge

minAge=double

Units: Years Min: 0 Max: 100

Minimum age of eligible individuals (defaults to 0)

coverage

coverage=double

Units: Proportion Min: 0 Max: 1

Coverage of intervention

larviciding

→ scenario → interventions → timed → intervention → larviciding

<larviciding>
IN THIS ORDER:
| ( <anopheles ... /> )+
</larviciding>

• anopheles

Documentation (element)

Simple larviciding intervention description.

anopheles

→ scenario → interventions → timed → intervention → larviciding → anopheles

<anopheles
    mosquito=string
    effectiveness=double
    duration=int
  />

Attributes

mosquito

mosquito=string

effectiveness

effectiveness=double

Units: none Min: 0 Max: 1

Proportion to reduce emergence rates by.

duration

duration=int

Units: days Min: 0 Max: inf

Number of days for which the intervention is active.

EventScheduler

→ scenario → EventScheduler

<EventScheduler
    healthSystemMemory=int
  >
IN THIS ORDER:
|   <CaseManagementTree ... /> 
|   <ClinicalOutcome ... /> 
</EventScheduler>

• CaseManagementTree
• ClinicalOutcome

Documentation (element)

Units: List of elements

Description of case management and clinical events.

Attributes

healthSystemMemory

healthSystemMemory=int

Units: Time steps Min: 1 Max: 100

Follow-up period during which a recurrence is considered to be a treatment failure

CaseManagementTree

→ scenario → EventScheduler → CaseManagementTree

<CaseManagementTree
    mask=int
  >
IN THIS ORDER:
| ( <CM_pBranchSet ... /> )*
| ( <CM_leaf ... /> )+
</CaseManagementTree>

• CM_pBranchSet
• CM_leaf

Documentation (element)

Units: List of elements

Partial description of the case management tree. The tree consists of: Probability branches: map an ID to another ID (the outcome) stochastically. Test branches: map an ID with a special flag to another ID; these are hard-coded. Leaf nodes: these map an ID to a list of drug medications.

Test branches are used if a flag requests a test (currently only RESULT_DETERMINE for parasite tests). Otherwise a probability or leaf branch is used by masking the current ID with mask (attribute for this element).

Attributes

mask

mask=int

Units: None Min: 0 Max: 0xFFFFFFFF

Value used to mask decision ids before selecting a branch/leaf.

CM_pBranchSet

→ scenario → EventScheduler → CaseManagementTree → CM_pBranchSet

<CM_pBranchSet
    ID=int
  >
IN THIS ORDER:
| ( <CM_pBranch ... /> )+
</CM_pBranchSet>

• CM_pBranch

Documentation (element)

A probability branch node: contains a list of outcome nodes along with probabilities, which link to another probability/test branch or leaf node.

Attributes

ID

ID=int

Units: ID

Decision identifier.

CM_pBranch

→ scenario → EventScheduler → CaseManagementTree → CM_pBranchSet → CM_pBranch

<CM_pBranch
    outcome=int
    p=double
  />

Attributes

outcome

outcome=int

ID of next probability/test branch or leaf node.

p

p=double

Units: Proportion Min: 0 Max: 1

Probability of this outcome

CM_leaf

→ scenario → EventScheduler → CaseManagementTree → CM_leaf

<CM_leaf
    ID=int
  >
IN THIS ORDER:
| ( <medicate ... /> )*
</CM_leaf>

• medicate

Documentation (element)

End points of the case management tree, listing treatments.

Attributes

ID

ID=int

Units: ID

Decision identifier.

medicate

→ scenario → EventScheduler → CaseManagementTree → CM_leaf → medicate

<medicate
    name=string
    qty=double
    time=int
  />

Attributes

name

name=string

Units: string

Abbreviated name of drug compound

qty

qty=double

Units: mg

Quantity of drug compound

time

time=int

Units: Minutes Min: 0

Number of minutes past start of timestep the drug is medicated at (usually 0).

ClinicalOutcome

→ scenario → EventScheduler → ClinicalOutcome

<ClinicalOutcome
    mask=int
  >
IN THIS ORDER:
| ( <path ... /> )+
</ClinicalOutcome>

• path

Documentation (element)

Tables describing the probability of death and the expected length of hospital stay.

The ID looked up in each table is the final outcome ID of the case-management tree binary or-ed with the mask given here.

Attributes

mask

mask=int

Units: None Min: 0 Max: 0xFFFFFFFF

Value used to mask the final ID from the case-management tree before looking up values here.

path

→ scenario → EventScheduler → ClinicalOutcome → path

<path
    ID=int
    pDeath=double
    hospitalizationDuration=int
  />

Documentation (element)

Parameters for a path through the case-management tree (i.e. table row).

Attributes

ID

ID=int

pDeath

pDeath=double

The probability of death. This probability is applied once-only for each case, irrespective of the branch (thus entries with p=0 for UC cases are probably needed).

hospitalizationDuration

hospitalizationDuration=int

The median length of stay in hospital. (Use median rather than a distribution because data should be more reliable and the effect of heterogeneity should be small.)

healthSystem

→ scenario → healthSystem

<healthSystem
    name=string
    healthSystemMemory=int
  >
IN THIS ORDER:
|   <drugRegimen ... /> 
|   <initialACR ... /> 
|   <compliance ... /> 
|   <nonCompliersEffective ... /> 
|   <pSeekOfficialCareUncomplicated1 ... /> 
|   <pSelfTreatUncomplicated ... /> 
|   <pSeekOfficialCareUncomplicated2 ... /> 
|   <pSeekOfficialCareSevere ... /> 
|   <pSequelaeInpatient ... /> 
|   <CFR ... /> 
</healthSystem>

• drugRegimen
• initialACR
• compliance
• nonCompliersEffective
• pSeekOfficialCareUncomplicated1
• pSelfTreatUncomplicated
• pSeekOfficialCareUncomplicated2
• pSeekOfficialCareSevere
• pSequelaeInpatient
• CFR

Documentation (element)

Units: List of elements

Description of (old) health system model.

Documentation (type)

Units: List of elements

Description of health system

Attributes

name

name=string

Units: string

Name of health system

healthSystemMemory

healthSystemMemory=int

Units: Time steps Min: 1 Max: 100

Follow-up period during which a recurrence is considered to be a treatment failure

entoData

→ scenario → entoData

<entoData
    name=string
  >
IN THIS ORDER:
| EXACTLY ONE OF:
| |   <nonVector ... /> 
| |   <vector ... /> 
</entoData>

• nonVector
• vector

Documentation (element)

Units: List of elements

Description of entomological data

Documentation (type)

Units: List of elements

Data for entomodel

Attributes

name

name=string

Units: string

Name of entomology data

nonVector

→ scenario → entoData → nonVector

<nonVector
    eipDuration=int
  >
IN THIS ORDER:
| ( <EIRDaily ... /> )+
</nonVector>

• EIRDaily

Documentation (type)

Parameters for the non-vector transmission model.

Attributes

eipDuration

eipDuration=int

The duration of sporogony in days

vector

→ scenario → entoData → vector

<vector>
IN THIS ORDER:
| ( <anopheles ... /> )+
</vector>

• anopheles

Documentation (element)

Parameters for the vector transmission model.

anopheles

→ scenario → entoData → vector → anopheles

<anopheles
    mosquito=string
    propInfected=double
    propInfectious=double
  >
IN THIS ORDER:
|   <eir ... /> 
|   <mosq ... /> 
| ( <nonHumanHosts ... /> )*
</anopheles>

• eir
• mosq
• nonHumanHosts

Attributes

mosquito

mosquito=string

propInfected

propInfected=double

Units: Proportion Min: 0 Max: 1

Initial guess of the proportion of mosquitoes which are infected, o: O_v(t) = o*N_v(t). Only used as a starting value.

propInfectious

propInfectious=double

Units: Proportion Min: 0 Max: 1

Initial guess of the proportion of mosquitoes which are infectious, s: S_v(t) = s*N_v(t). Used as a starting value and then fit.

eir

→ scenario → entoData → vector → anopheles → eir

<eir
    a0=double
    a1=double
    b1=double
    a2=double
    b2=double
    EIRRotateAngle=double
  />

Documentation (element)

Units: Innoculations per person per day

Description of target entomological inoculation rate, used to calculate the vector emergence rate. An EIR array is generated from the exponent of the inverse discrete fourier transform of these parameters.

Attributes

a0

a0=double

a1

a1=double

b1

b1=double

a2

a2=double

b2

b2=double

EIRRotateAngle

EIRRotateAngle=double

mosq

→ scenario → entoData → vector → anopheles → mosq

<mosq
    mosqRestDuration=int
    extrinsicIncubationPeriod=int
    mosqSeekingDeathRate=double
    mosqSeekingDuration=double
    mosqEntoAvailability=double
    mosqProbBiting=double
    mosqProbFindRestSite=double
    mosqProbResting=double
    mosqProbOvipositing=double
  />

Documentation (element)

Units: List of elements

Vector species

Attributes

mosqRestDuration

mosqRestDuration=int

extrinsicIncubationPeriod

extrinsicIncubationPeriod=int

mosqSeekingDeathRate

mosqSeekingDeathRate=double

mosqSeekingDuration

mosqSeekingDuration=double

mosqEntoAvailability

mosqEntoAvailability=double

mosqProbBiting

mosqProbBiting=double

mosqProbFindRestSite

mosqProbFindRestSite=double

mosqProbResting

mosqProbResting=double

mosqProbOvipositing

mosqProbOvipositing=double

nonHumanHosts

→ scenario → entoData → vector → anopheles → nonHumanHosts

<nonHumanHosts
    name=string
    mosqEntoAvailability=double
    mosqProbBiting=double
    mosqProbFindRestSite=double
    mosqProbResting=double
  />

Documentation (element)

Units: List of elements

Non human host parameters, per type of host (must match up with non-species-specific parameters).

Attributes

name

name=string

mosqEntoAvailability

mosqEntoAvailability=double

mosqProbBiting

mosqProbBiting=double

mosqProbFindRestSite

mosqProbFindRestSite=double

mosqProbResting

mosqProbResting=double

drugDescription

→ scenario → drugDescription

<drugDescription>
IN THIS ORDER:
|   <genome ... /> 
|   <drugs ... /> 
</drugDescription>

• genome
• drugs

Documentation (element)

Units: List of elements

Drug model parameters

genome

→ scenario → drugDescription → genome

<genome>
IN THIS ORDER:
|   <content ... /> 
|   <distribution ... /> 
</genome>

• content
• distribution

content

→ scenario → drugDescription → genome → content

<content>
IN THIS ORDER:
| ( <gene ... /> )+
</content>

• gene

gene

→ scenario → drugDescription → genome → content → gene

<gene
    name=string
  >
IN THIS ORDER:
| ( <mutation ... /> )+
</gene>

• mutation

Attributes

name

name=string

mutation

→ scenario → drugDescription → genome → content → gene → mutation

<mutation
    cost=double
    position=integer
  />

Attributes

cost

cost=double

position

position=integer

distribution

→ scenario → drugDescription → genome → distribution

<distribution>
IN THIS ORDER:
| ( <genomeInstance ... /> )+
</distribution>

• genomeInstance

genomeInstance

→ scenario → drugDescription → genome → distribution → genomeInstance

<genomeInstance
    proportion=integer
  >
IN THIS ORDER:
| ( <allele ... /> )+
</genomeInstance>

• allele

Attributes

proportion

proportion=integer

allele

→ scenario → drugDescription → genome → distribution → genomeInstance → allele

<allele
    mutations=integer
    name=string
  />

Attributes

mutations

mutations=integer

name

name=string

drugs

→ scenario → drugDescription → drugs

<drugs
  [ synergy=string ]
  >
IN THIS ORDER:
|   <compound ... /> 
</drugs>

• compound

Attributes

synergy

synergy=string

compound

→ scenario → drugDescription → drugs → compound

<compound
    acronym=string
    name=string
  >
IN THIS ORDER:
|   <pk ... /> 
|   <pd ... /> 
</compound>

• pk
• pd

Attributes

acronym

acronym=string

name

name=string

pk

→ scenario → drugDescription → drugs → compound → pk

<pk>
</pk>

• ageGroup

ageGroup

→ scenario → drugDescription → drugs → compound → pk → ageGroup

<ageGroup
    F=integer
    Vd=double
    t12=integer
  [ minAge=double ]
  />

Attributes

F

F=integer

Bioavailability (unsure of the units we will be using)

Vd

Vd=double

Volume of Distribution (l/kg)

t12

t12=integer

Units: Number

Half-life (days)

minAge

minAge=double

pd

→ scenario → drugDescription → drugs → compound → pd

<pd>
IN THIS ORDER:
| ( <genomeRule ... /> )+
</pd>

• genomeRule

genomeRule

→ scenario → drugDescription → drugs → compound → pd → genomeRule

<genomeRule>
</genomeRule>

• matchMutation
• ageGroup

matchMutation

→ scenario → drugDescription → drugs → compound → pd → genomeRule → matchMutation

<matchMutation
    present=boolean
    gene=string
    pos=integer
  />

Attributes

present

present=boolean

gene

gene=string

pos

pos=integer

ageGroup

→ scenario → drugDescription → drugs → compound → pd → genomeRule → ageGroup

<ageGroup
    c50=integer
    k1=double
    n=integer
  [ minAge=double ]
  />

Attributes

c50

c50=integer

Half maximal effect concentration (mg/l)

k1

k1=double

Units: Proportion Min: 0 Max: 1

Maximal parasite killing rate (per day)

n

n=integer

Slope of the concentration effect curve (no units)

minAge

minAge=double

parameters

→ scenario → parameters

<parameters
    interval=int
    iseed=int
    delta=double
    latentp=int
  >
IN THIS ORDER:
| ( <parameter ... /> )+
</parameters>

• parameter

Documentation (element)

Units: List of elements

Parameters for mathematical model

Documentation (type)

Units: List of elements

Parameter vector

Attributes

interval

interval=int

Units: Days

Simulation step

iseed

iseed=int

Units: Number

Seed for RNG

delta

delta=double

Units: ? Redundant

this no longer seems to be used

latentp

latentp=int

Units: Time steps Min: 0 Max: 20

pre-erythrocytic latent period, in time steps

parameter

→ scenario → parameters → parameter

<parameter
    name=string
    number=int
    value=double
  [ include=boolean ]
  />

Attributes

name

name=string

Units: string

Name of parameter

number

number=int

Units: Number Min: 1 Max: 100

Reference number of input parameter

value

value=double

Units: Number Min: 0

Parameter value

include

include=boolean

Units: Number Min: 0 Max: 1

True if parameter is to be sampled in optimization runs. Not used in simulator app.