Skip to content

laser.measles.scenarios

laser.measles.scenarios

laser.measles.scenarios.satellites_scenario(core_population=500000, satellite_population=100000, n_towns=30, max_distance=200, mcv1=0.5, seed=52, population_std=0.3)

Create a cluster of nodes with a single large node in the center (core) surrounded by smaller nodes (satellites).

Parameters:

Name Type Description Default
core_population int

Population of the core city

500000
satellite_population int

Population of the satellite cities

100000
n_towns int

Number of towns to create

30
max_distance float

Maximum distance from center (km)

200
mcv1 float

MCV1 coverage

0.5
seed int

Random seed for reproducibility

52

Returns:

Type Description

pl.DataFrame: Scenario DataFrame.

laser.measles.scenarios.single_patch_scenario(population=100000, mcv1_coverage=0.0)

Generate a synthetic scenario with a single patch.

Parameters:

Name Type Description Default
population int

Population of the patch.

100000
mcv1_coverage float

MCV1 coverage of the patch.

0.0

Returns:

Type Description
DataFrame

pl.DataFrame: Scenario DataFrame.

laser.measles.scenarios.two_cluster_scenario(seed=42, n_nodes_per_cluster=50, cluster_centers=None, cluster_size_std=0.3, mcv1_coverage_range=None)

Generate a synthetic scenario with two clusters of nodes.

Parameters:

Name Type Description Default
seed int

Random seed for reproducibility.

42
n_nodes_per_cluster int

Number of nodes per cluster.

50
cluster_centers list[tuple[float, float]]

List of tuples representing the centers of the clusters.

None
cluster_size_std float

Standard deviation of the Gaussian distribution for cluster size.

0.3
mcv1_coverage_range tuple[float, float]

Range of MCV1 coverage percentages.

None

Returns:

Type Description
DataFrame

pl.DataFrame: Scenario DataFrame.

laser.measles.scenarios.two_patch_scenario(population=100000, mcv1_coverage=0.0)

Generate a synthetic scenario with two patches where one is half the size of the other.

Parameters:

Name Type Description Default
population int

Population of the largest patch.

100000
mcv1_coverage float

MCV1 coverage of the patches.

0.0

Returns:

Type Description
DataFrame

pl.DataFrame: Scenario DataFrame.