tlo.methods.healthseekingbehaviour module

Health Seeking Behaviour Module This module determines if care is sought once a symptom is developed.

The write-up of these estimates is: Health-seeking behaviour estimates for adults and children.docx

class HealthSeekingBehaviour(name=None, resourcefilepath=None, force_any_symptom_to_lead_to_healthcareseeking=None)

This modules determines if the onset of symptoms will lead to that person presenting at the health facility for a HSI_GenericFirstAppointment.

An equation gives the probability of seeking care in response to the “average” symptom. This is modified according to if the symptom is associated with a particular effect.

Construct a new disease module ready to be included in a simulation.

Initialises an empty parameters dictionary and module-specific random number generator.

Parameters:

name – the name to use for this module. Defaults to the concrete subclass’ name.

Bases: tlo.core.Module, tlo.methods.hsi_generic_first_appts.GenericFirstAppointmentsMixin

PARAMETERS:

Item	Type	Description
force_any_symptom_to_lead_to_healthcareseeking	BOOL	Whether every symptom [except those that declare they should not lead to any healthcare seeking] should always lead to healthcare seeking immediately.
prob_non_emergency_care_seeking_by_level	LIST	The probability of going to each facility-level when non-emergency care is sought. The values in the list are the probabilities of going to facility level 0 / 1a / 1b / 2, respectively, and these values must sum to 1.0.
baseline_odds_of_healthcareseeking_children	REAL	odds of health-care seeking (children: 0-14) if male, 0-5 years-old, living in a rural setting in the Northern region, and not in the wealth categories 4 or 5
odds_ratio_children_sex_Female	REAL	odds ratio for health-care seeking (children) if sex is Female
odds_ratio_children_age_5to14	REAL	odds ratio for health-care seeking (children) if aged 5-14
odds_ratio_children_setting_urban	REAL	odds ratio for health-care seeking (children) if setting is Urban
odds_ratio_children_region_Central	REAL	odds ratio for health-care seeking (children) if region is Central
odds_ratio_children_region_Southern	REAL	odds ratio for health-care seeking (children) if region is Southern
odds_ratio_children_wealth_higher	REAL	odds ratio for health-care seeking (children) if wealth is in categories 4 or 5
baseline_odds_of_healthcareseeking_adults	REAL	odds of health-care seeking (adults: 15+) if male, 15-34 year-olds, living in a rural setting in the Northern region, and not in the wealth categories 4 or 5.
odds_ratio_adults_sex_Female	REAL	odds ratio for health-care seeking (adults) if sex is Female
odds_ratio_adults_age_35to59	REAL	odds ratio for health-care seeking (adults) if aged 35-59
odds_ratio_adults_age_60plus	REAL	odds ratio for health-care seeking (adults) if aged 60+
odds_ratio_adults_setting_urban	REAL	odds ratio for health-care seeking (adults) if setting is Urban
odds_ratio_adults_region_Central	REAL	odds ratio for health-care seeking (adults) if region is Central
odds_ratio_adults_region_Southern	REAL	odds ratio for health-care seeking (adults) if region is Southern
odds_ratio_adults_wealth_higher	REAL	odds ratio for health-care seeking (adults) if wealth is in categories 4 or 5
max_days_delay_to_generic_HSI_after_symptoms	INT	Maximum days delay between symptom onset and firstgeneric HSI. Actual delay is sample between 0 and this value.

Class attributes:

ADDITIONAL_DEPENDENCIES : {‘Lifestyle’}

INIT_DEPENDENCIES : {‘HealthSystem’, ‘Demography’, ‘SymptomManager’}

METADATA : {<Metadata.USES_HEALTHSYSTEM: 3>}

__annotations__ : {}

force_any_symptom_to_lead_to_healthcareseeking : <property object at 0x14f590770>

Functions (defined or overridden in class HealthSeekingBehaviour):

__init__(name=None, resourcefilepath=None, force_any_symptom_to_lead_to_healthcareseeking=None)

Construct a new disease module ready to be included in a simulation.

Initialises an empty parameters dictionary and module-specific random number generator.

Parameters:

name – the name to use for this module. Defaults to the concrete subclass’ name.

read_parameters(data_folder)

Read in ResourceFile

initialise_population(population)

Nothing to initialise in the population

initialise_simulation(sim)

• define the linear models that govern healthcare seeking

• set the first occurrence of the repeating HealthSeekingBehaviourPoll

• assemble the health-care seeking information from the registered symptoms

on_birth(mother_id, child_id)

Nothing to handle on_birth

define_linear_models()

Define linear models for health seeking behaviour for children and adults

do_at_generic_first_appt_emergency(person_id: int, symptoms: List[str], schedule_hsi_event: HSIEventScheduler, **kwargs) → None

Actions to take during an emergency generic health system interaction (HSI).

Call signature is identical to the do_at_generic_first_appt() method.

Derived classes should overwrite this method so that they are compatible with the :py:class`~.HealthSystem` module, and can schedule HSI events when a individual presents symptoms indicative of the corresponding illness or condition.

class HealthSeekingBehaviourPoll(module)

This event occurs every day and determines if persons with newly onset symptoms will seek care.

Initialise the HealthSeekingBehaviourPoll :param module: the module that created this event

Bases: tlo.events.RegularEvent, tlo.events.Event, tlo.events.PopulationScopeEventMixin

Class attributes:

__annotations__ : {}

Functions (defined or overridden in class HealthSeekingBehaviourPoll):

__init__(module)

Initialise the HealthSeekingBehaviourPoll :param module: the module that created this event

static _has_any_symptoms(persons, symptoms)

Which rows in persons have non-zero values for columns in symptoms.

apply(population)

Determine if persons with newly onset acute generic symptoms will seek care. This event runs second-to-last every day (i.e., just before the HealthSystemScheduler) in order that symptoms arising this day can lead to FirstAttendance on the same day.

Parameters:

population – the current population