hf_best_cov: hf_best_cov

hf_best_covR Documentation

hf_best_cov

Description

Select the health facilities that offer the best population coverage using their catchments and a raster of population. This function also offers the possibility to ensure that N facilities are selected for each administrative unit.

Usage

hf_best_cov(
  inputFolder,
  outputFolder,
  catchShp,
  popRaster,
  catchHfColName,
  nTot,
  adminCheck = FALSE,
  hfShp = NULL,
  hfHfColName = NULL,
  npAdmin = NULL,
  adminShp = NULL,
  adminColName = NULL
)

Arguments

inputFolder

character; working directory that contains the inputs

outputFolder

character; the path to the output folder. If NULL, an output folder will be created within the inputFolder.

catchShp

character; name of the catchment shapefile WITHOUT extension

popRaster

character; name of the population raster file WITH extension

catchHfColName

character; name of the health facility name column in the catchment shapefile

nTot

integer; number of health facilities to be selected

adminCheck

logical; whether a minimum of health facilities per administrative unit must be selected. FALSE by default

hfShp

character; name of the health facility shapefile WITHOUT extension

hfHfColName

character; name of the health facility name column in the health facility shapefile

npAdmin

integer; minimum number of health facilities to be selected per administrative unit (required if adminCheck = TRUE)

adminShp

character; name of the administrative unit shapefile WITHOUT extention (required if adminCheck = TRUE)

adminColName

character; name of the administrative unit name column in the administrative unit shapefile (required if adminCheck = TRUE)

Details

The outputs are a table with the selected facilities with their names, the population they cover, and the cumulative sum of the covered population. A bar plot representing the cumulative sum of the covered population for the selected facilities is also generated. The algorithm works recursively. It orders the facility based and the total population located within their catchments, it selects the first facility and removes the population covered in its catchment in case we would have catchments that overlap, to avoid counting the same population multiple times. It repeats the process until the number of facilities to be selected is reached.


ptimoner/inAccMod documentation built on Jan. 27, 2025, 9:34 a.m.