contraceptive_use: Compiled contraceptive use data

In FPRgroup/FPEMcountry: fpemlocal

Compiled contraceptive use data

Description

A dataset containing contraceptive use aggregates compiled by the UNPD: * Prevalence estimates from national surveys | _World Contraceptive Use by Marital Status and Age, 2017_ [@un_desa_pd_WCUMA_2017]. * Number of women by marital status and age | _Estimates and Projections of Women of Reproductive Age Who Are Married or in a Union: 2018 Revision_ [@undesa_pd2018_estim_projec_women_reprod_age]. * Country region information, areas and regions| _Standard Country or Area Codes for Statistical Use (M49)_ [@UN_M49]; sexual activity among unmarried women: [@kantorova18_contr].

Usage

contraceptive_use

Format

A data frame with 31 variables:

division_numeric_code

‘Numeric’ 3-digit M49 country code (United Nations, 2019).

start_date

‘Numeric’ Year, as a decimal (e.g., 1999.24...), marking the start of the reference period.

end_date

‘Numeric’ Year, as a decimal (e.g., 2006.44...), marking the end of the reference period.

is_in_union

‘Character’ taking values “Y” or “N”. Rows with “Y” are observations for married/in-union women; rows with “N” are observations for unmarried/not-in-union women. See also the section “Notes on cohabiting partnerships” below.

age_range

‘Character’ age range, e.g., “15-49”, “15-19”, etc. This is the age range for which the observation can be used to produce estiamtes for, not the age range surveyed.

data_series_type

‘Character’ taking values “DHS”, “MICS”, “National survey”, “PMA”, or “Other”. Indicates the source survey.

group_type_relative_to_baseline

‘Character’ indicating any difference relative to the baseline group, namely married/in-union or unmarried/not-in-union women (according to is_in_union). This field is used to assign mislcassification biases (see appendices to (Alkema, et al., 2013; Wheldon et al., 2018). When is_in_union == "Y", takes values in:

AL

(“all women”) All women, regardless of marital/union status, included in the survey.

BS

(“both sexes”) Men and women included in the survey.

EM

(“ever married”) Ever-married women included in the survey.

HW

(“husbands/wives”) Husbands and wives included in the survey.

MW

(“married women”) Survey population was married women, i.e., no difference relative to baseline group.

SA

(“sexually active”) All sexually active women, regardless of marital status, included in the survey.

When is_in_union == "N", takes values in:

FM

Steriliztion was the only contraceptive method recorded.

PW

(“partnered women”) Only women with a partner were included in the survey. See also the section “Notes on cohabiting partnerships” below.

UW

(“unmarried women”) Survey population was unmarried women, i.e., no difference relative to baseline group.

contraceptive_use_modern

‘Numeric’ Prevalence of modern contraceptive use.

contraceptive_use_traditional

‘Numeric’ Prevalence of traditional contraceptive use.

contraceptive_use_any

‘Numeric’ Prevalence of contraceptive use, any method.

unmet_need_modern

‘Numeric’ Unmet need for modern methods of contraception.

unmet_need_any

‘Numeric’ Unmet need for contraception, any method.

is_pertaining_to_methods_used_since_last_pregnancy

‘Character’ Takes values “N” and “Y”. If “Y”, observation pertains to contraceptive methods used since last pregnancy.

pertaining_to_methods_used_since_last_pregnancy_reason

‘Character’ If is_pertaining_to_methods_used_since_last_pregnancy == "Y", provides an explanation, otherwise blank.

has_geographical_region_bias

‘Character’ Takes values “N” and “Y”. If “Y”, observation is likely biased due to geographical region covered.

geographical_region_bias_reason

‘Character’ If has_geographical_region_bias == "Y", provides an explanation, otherwise blank.

has_non_pregnant_and_other_positive_biases

‘Character’ Takes values “N” and “Y”. If “Y”, observation likely subject to positive biases due to reasons other than pregnancy, geography, or age group.

non_pregnant_and_other_positive_biases_reason

‘Character’ If has_non_pregnant_and_other_positive_biases == “Y”, provides an explanation, otherwise blank.

age_group_bias

‘Character’ One of “+”, “-”, “?”, or “None”. Indicates the direction of likely bias due the survey targeting an age group other than 15-49. “+” and “-” indicate positive and negative bias, respectively. “?” indicates a bias of unknown direction, and “None” indicates no bias.

modern_method_bias

‘Character’ One of “+”, “-”, or “None”. Indicates observations likely to be biased due to the inclusion (“+”) or exclusion (“-”) of sterilization from modern method use.

has_traditional_method_bias

‘Character’ taking values “Y” or “N”. Indicates observations likely to be biased due to the inclusion of folk methods in traditional method use.

traditional_method_bias_reason

This field is not used.

has_absence_of_probing_questions_bias

‘Character’ taking values “Y” or “N”. Indicates observations likely to be biased due to the absense of probing questions in survey about knowledge of specific contraceptive methods.

se_modern

‘Numeric’ Estimated design-based standard error of contraceptive_use_modern.

se_traditional

‘Numeric’ Estimated design-based standard error of contraceptive_use_traditional.

se_unmet_need

‘Numeric’ Estimated design-based standard error of unmet_need_for_any_method.

se_log_r_modern_no_use

‘Numeric’ Estimated design-based standard error of the quantity

    contraceptive_use_modern / (1 - contraceptive_use_any_method)

se_log_r_traditional_no_use

‘Numeric’ Estimated design-based standard error of the quantity

    contraceptive_use_traditional / (1 - contraceptive_use_any_method)

se_log_r_unmet_no_need

‘Numeric’ Estimated design-based standard error of the quantity

    unmet_need_for_any_method / (1 - contraceptive_use_any_method)

se_log_r_modern_no_use_imputed

‘Numeric’ Imputed version of se_log_r_modern_no_use. See impute_se.

se_log_r_traditional_no_use_imputed

‘Numeric’ Imputed version of se_log_r_traditional_no_use.See impute_se.

se_log_r_unmet_no_need_imputed

‘Numeric’ Imputed version of se_log_r_unmet_no_need.See impute_se.

source_id

‘Numeric’ Unique source (i.e., survey) identifer.

record_id

‘Numeric’ Unique record identifier.

Notes on cohabiting partnerships

• The classification into “married/in-union” and “unmarried/not-in-union” encoded in the is_in_union field treats cohabiting partnerships in the first category. That is, women with a cohabiting partner are included in observations with is_in_union == "Y". Observations with is_in_union == "N" include only women with a non-cohabiting partner (in addition to women who are unmarried or not in-union).

• Observations with is_in_union == "N" and group_type_relative_to_baseline == "PW" are from surveys that excluded single women.

Source

UN 2018, 2018.0.1

References

Alkema, L., Kantorova, V., Menozzi, C., Biddlecom, A. (2013). National, regional, and global rates and trends in contraceptive prevalence and unmet need for family planning between 1990 and 2015: A systematic and comprehensive analysis. The Lancet, 381(9878), 1642-1652.

United Nations (2019). Standard Country or Area Codes for Statistical Use (M49). United Nations, Department of Economic and Social Affairs, Statistics Division. https://unstats.un.org/unsd/methodology/m49/ (visited on 2019-10-21).

Wheldon, M. C., Kantorova, V., Ueffing, P., Dasgupta, A. N. Z. (2018). Methods for estimating and projecting key family planning indicators among all women of reproductive age. Technical Paper No. 2018/2, United Nations, Department of Economic and Social Affairs, Population Division. https://www.un.org/en/development/desa/population/publications/pdf/technical/TP2018-2.pdf (visited on 2019-10-21).

FPRgroup/FPEMcountry documentation built on April 24, 2023, 4:32 p.m.