get_lab_tissue_histology {cancerscreening}

Retrieves the Tissue Histology Laboratory Data

Description

get_lab_tissue_histology() retrieves tissue histology lab data for a specified period from the KHIS API server.

Usage

get_lab_tissue_histology(
  start_date,
  end_date = NULL,
  level = c("country", "county", "subcounty", "ward", "facility"),
  organisations = NULL,
  ...
)

Arguments

start_date

The start date to retrieve data. It is required and in the format YYYY-MM-dd.

end_date

The ending date for data retrieval (default is the current date).

level

The desired data granularity: "country" (the default), "county", "subcounty", "ward", or "facility".

organisations

A list of organization units ids to be filtered.

...

Other options that can be passed onto KHIS API.

Value

A tibble containing tissue histology lab data with the following columns:

• country - Name of the country.

• county - Name of the county. Optional if the level is county, subcounty, ward or facility.

• subcounty - Name of the subcounty. Optional if the level is subcounty, ward or facility.

• ward - Name of the ward. Optional if the level is ward or facility.

• facility - Name of the health facility. Optional if the level facility.

• period - The month and year of the data.

• fiscal_year- The financial year of the report(July-June Cycle).

• year - The calendar year of the report.

• month - The month name of the report.

• category - The age group category of the report

• element - The data element.

• value - The number reported.

Examples

# Download data from February 2023 to current date
data <- get_lab_tissue_histology(start_date = '2023-02-01')
data