Skip to content

GeneratedSchema12Doc

Jump to bottom Edit New page
Diggory Hardy edited this page Jan 15, 2015 · 7 revisions

Generated schema 12 documentation

This page is automatically generated from the following schema file: scenario_12.xsd. I recommend against editing it because edits will likely be lost later.

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>

Documentation (element)

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>

Documentation (element)

Description of demography

Documentation (type)

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>

Documentation (element)

List of age groups included in demography

Documentation (type)

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>

Documentation (element)

Description of surveys

Documentation (type)

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>

Documentation (element)

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)

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>

Documentation (element)

List of age groups included in demography or surveys

Documentation (type)

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>

Documentation (element)

List of interventions

Documentation (type)

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>

Attributes

vaccineType

vaccineType=int

Units: Code

Type of vaccine

halfLifeYrs

→ scenario → interventions → vaccineDescription → halfLifeYrs

<halfLifeYrs
    value=double
  />

Documentation (element)

Half life of drug effect

Attributes

value

value=double

TODO

efficacyB

→ scenario → interventions → vaccineDescription → efficacyB

<efficacyB
    value=double
  />

Documentation (element)

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>

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>

Attributes

mosquito

mosquito=string

ITNDescription

→ scenario → interventions → anopheles → ITNDescription

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

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)

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)

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)

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>

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)

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)

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>

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)

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

→ scenario → interventions → continuous → vaccine

<vaccine
    targetAgeYrs=double
    coverage=double
  />

Documentation (element)

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)

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)

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>

Documentation (element)

List of timed interventions

Documentation (type)

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>

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>

Documentation (type)

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)

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>

Documentation (element)

Initial cure rate

CQ

→ scenario → healthSystem → initialACR → CQ

<CQ
    value=double
  />

Documentation (element)

Chloroquine

Attributes

value

value=double

TODO

SP

→ scenario → healthSystem → initialACR → SP

<SP
    value=double
  />

Documentation (element)

Sulphadoxine-pyrimethamine

Attributes

value

value=double

TODO

AQ

→ scenario → healthSystem → initialACR → AQ

<AQ
    value=double
  />

Documentation (element)

Amodiaquine

Attributes

value

value=double

TODO

SPAQ

→ scenario → healthSystem → initialACR → SPAQ

<SPAQ
    value=double
  />

Documentation (element)

Sulphadoxine-pyrimethamine/Amodiaquine

Attributes

value

value=double

TODO

ACT

→ scenario → healthSystem → initialACR → ACT

<ACT
    value=double
  />

Documentation (element)

Artemisinine combination therapy

Attributes

value

value=double

TODO

QN

→ scenario → healthSystem → initialACR → QN

<QN
    value=double
  />

Documentation (element)

Quinine

Attributes

value

value=double

TODO

selfTreatment

→ scenario → healthSystem → initialACR → selfTreatment

<selfTreatment
    value=double
  />

Documentation (element)

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>

Documentation (element)

Adherence to treatment

nonCompliersEffective

→ scenario → healthSystem → nonCompliersEffective

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

Documentation (element)

Effectiveness of treatment of non compliers

pSeekOfficialCareUncomplicated1

→ scenario → healthSystem → pSeekOfficialCareUncomplicated1

<pSeekOfficialCareUncomplicated1
    value=double
  />

Documentation (element)

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)

Probability that a patient with uncomplicated disease self-treats

Attributes

value

value=double

TODO

pSeekOfficialCareUncomplicated2

→ scenario → healthSystem → pSeekOfficialCareUncomplicated2

<pSeekOfficialCareUncomplicated2
    value=double
  />

Documentation (element)

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)

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>

Documentation (element)

List of age specific probabilities of sequelae in inpatients

item

→ scenario → healthSystem → pSequelaeInpatient → item

<item
    maxAgeYrs=double
  />

Attributes

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

→ 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>

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)

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)

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)

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)

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)

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)

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)

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>

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>

Documentation (element)

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>

Documentation (element)

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>

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>

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>

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>

Documentation (element)

Description of (old) health system model.

Documentation (type)

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>

Documentation (element)

Description of entomological data

Documentation (type)

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>

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>

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>

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)

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)

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)

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>

Documentation (element)

Drug model parameters

genome

→ scenario → drugDescription → genome

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

content

→ scenario → drugDescription → genome → content

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

gene

→ scenario → drugDescription → genome → content → gene

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

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

→ scenario → drugDescription → genome → distribution → genomeInstance

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

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>

Attributes

synergy

synergy=string

compound

→ scenario → drugDescription → drugs → compound

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

Attributes

acronym

acronym=string

name

name=string

pk

→ scenario → drugDescription → drugs → compound → pk

<pk>
</pk>

ageGroup

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

<ageGroup
    minAge=double
  />

Attributes

minAge

minAge=double

pd

→ scenario → drugDescription → drugs → compound → pd

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

genomeRule

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

<genomeRule>
</genomeRule>

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
    minAge=double
  />

Attributes

minAge

minAge=double

parameters

→ scenario → parameters

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

Documentation (element)

Parameters for mathematical model

Documentation (type)

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.

Add a custom footer

Home GeneratedSchemaDocIndex

Clone this wiki locally