inst/Natality_2014.R

In LSTbook: Data and Software for "Lessons in Statistical Thinking"

#' Medical info on each birth in the US in 2014
#'
#' When using Web-R, load this dataset with `load("https://www.mosaic-web.org/go/datasets/Natality_2014.rda")`
#'
#'
#' The Centers for Disease Control collects data on all births registered
#' in the US (50 states + DC). The
#' full data set, \code{Natality_2014}, contains entries for
#' the full set of births keeping
#' only a subset of variables related to potential risk factors and outcomes.
#' \code{Natality_2014} is a random
#' sample (specifically for the Little Apps) of
#' size  ten thousand. A larger sample of one-million
#' cases, \code{Natality_2014_1000k}, and the complete set of cases in \code{Natality_2014} are also provided by the
#' package, but not through the usual \code{data()} interface. To access those large files,
#' see the instructions given in \code{Larger_natality_data_files}.
#'
#' Variable names are the same as in the original CDC file.
#'
#' Variables have been re-coded to translate markers like 99 into `NA` and to
#' self-document the levels of the variables.
#'
#' Note that the data include only registered births. Fetal deaths are not included.
#' For reference, there were about 24,000 fetal deaths (20 weeks and thereafter) in the US in 2013. (See \url{http://www.cdc.gov/nchs/data/nvsr/nvsr64/nvsr64_08.pdf}.)
#' This corresponds to about 0.6% of the births listed in these data. The CDC also
#' reports about 16,000 infant deaths before age 28 days and another 7500 deaths before age 1 year.
#'
#' @details
#' Larger data files are available by following the instructions in \code{Larger_natality_data_files} in the
#' \code{Natality_2014} package available for R:
#' \code{Natality_2014} with 3.99 million cases and \code{Natality_2014_1000k} with a random sample
#' of one million cases.
#'
#' @docType data
#' @name Natality_2014
#'
#' @keywords datasets
#'
#' @format
#'   A data frame with a random sample of size 100000 from the complete CDC set of 3,998,175 cases, each of which is a birth in the US in 2014.
#'   \itemize{
#'     \item{\code{mager}} {Mother's age at date of birth}
#'     \item{\code{fagecomb}} {Father's age at date of birth}
#'     \item{\code{ubfacil}} {Type of facility where the birth took place}
#'     \item{\code{urf_diab}} {Mother had diabetes before pregnancy}
#'     \item{\code{urf_chyper}} {Mother had chronic hypertension before pregnancy}
#'     \item{\code{urf_phyper}} {Mother developed hypertension during pregnancy}
#'     \item{\code{urf_eclam}} {Mother developed eclampsia}
#'     \item{\code{uop_induc}} {Was labor induced?}
#'     \item{\code{uld_breech}} {Did baby present as breech? See \code{me_pres}.}
#'     \item{\code{ilive}} {Whether the baby was alive at the time of the report.}
#'     \item{\code{ab_aven1}} {Baby put on mechanical ventilator immediately}
#'     \item{\code{ab_aven6}} {Baby still on ventilator after 6 hours}
#'     \item{\code{ab_nicu}} {Baby transferred to intensive care unit.}
#'     \item{\code{ab_surf}} {Surfactant administered to newborn}
#'     \item{\code{ab_anti}} {Antibiotics administered to newborn}
#'     \item{\code{ab_seiz}} {Newborn had seizure}
#'     \item{\code{dbwt}} {Baby's weight (gm)}
#'     \item{\code{combgest}} {Length of gestation}
#'     \item{\code{sex}} {Baby's sex}
#'     \item{\code{dplural}} {Plurality of birth: 2 = twins, 3 = triplets, ...}
#'     \item{\code{apgar5}} {APGAR score at 5 minutes}
#'     \item{\code{apgar10}} {APGAR score at 10 minutes}
#'     \item{\code{mtran}} {Mother transferred. No other description given.}
#'     \item{\code{pay}} {Source of payment for delivery}
#'     \item{\code{mm_mtr}} {Mother received blood transfusion}
#'     \item{\code{mm_plac}} {Perineal laceraction}
#'     \item{\code{mm_rupt}} {Ruptured uterus}
#'     \item{\code{mm_uhyst}} {Unplanned hysterectomy}
#'     \item{\code{mm_aicu}} {Mother transferred to intensive care unit}
#'     \item{\code{me_pres}} {Presentation of baby on delivery. See \code{uld_breech}. It's not clear why "other" corresponds to breech.}
#'     \item{\code{me_rout}} {Method of delivery}
#'     \item{\code{ld_indl}} {Labor induced}
#'     \item{\code{pwgt_r}} {Mother's weight before pregnancy}
#'     \item{\code{dwgt_r}} {Mother's weight at delivery}
#'     \item{\code{m_ht_in}} {Mother's height}
#'     \item{\code{cig_0}} {Number of cigarettes smoked daily before pregnancy}
#'     \item{\code{cig_1}} {Number of cigarettes smoked daily during first trimester}
#'     \item{\code{cig_2}} {Number of cigarettes smoked daily during second trimester}
#'     \item{\code{cig_3}} {Number of cigarettes smoked daily during third trimester}
#'     \item{\code{wic}} {Enrolled in Women, Infants, and Children (WIC) program for supplemental nutrition.}
#'     \item{\code{precare}} {Month started in prenatal care. 15 means never started.}
#'     \item{\code{previs}} {Number of visits to prenatal care.}
#'     \item{\code{priorlive}} {Number of previous live births.}
#'     \item{\code{priordead}} {Number of previous births where baby died.}
#'     \item{\code{priorterm}} {Number of terminations of pregnancy before this birth.}
#'   }
#'
#' @seealso \code{\link{Larger_natality_data_files}}
#'
"Natality_2014"