addind {PopulateR}R Documentation

Add a variable indicating whether the person is in education, or has left education

Description

Creates a data frame with a variable indicating whether the person is a student, or is not in education. This is an factor with two levels. Pre-cleaning so that only people inside the student age range is not required. Three data frames are required. The first is the data frame that contains the people ("people") to whom the indicator will be applied. The other two data frames are counts: school leaver counts ("leavers"), and the sex/age pyramid counts ("pyramid") that apply to the school leaver counts. As cumulative proportions of school leavers are calculated, the leavers data frames must contain multiple years of data. For example, if the minimum school leaving age is 17 and the maximum age is 18, then there must be two years of data in the leavers data frame. The pyramid data frame contains the sex/age counts for the relevant year. For example, if the people data frame is based on 2021 data frame, then the pyramid data frame should be the counts for 2021, and the value for pplyear would be 2021. The variables specifying sex can be numeric, character, or factor. The sole requirement is that the same code is used in all three data frames. For example, if "F" and "M" are used in the adolescents data frame to denote sex, then "F" and "M" are the codes required in both the leavers and pyramid data frames. Any number of values can be used, so long as they are unique.

Usage

addind(
  people,
  pplid,
  pplsx,
  pplage,
  pplyear,
  minedage = NULL,
  maxedage = NULL,
  leavers,
  lvrsx,
  lvrage,
  lvryear,
  lvrcount,
  pyramid,
  pyrsx,
  pyrage,
  pyrcount,
  stvarname = "Status",
  verbose = FALSE,
  userseed = NULL
)

Arguments

people

A data frame containing individual people.

pplid

The variable containing the unique identifier for each person, in the people data frame

pplsx

The variable containing the codes for sex, in the people data frame.

pplage

The variable containing the ages, in the people data frame.

pplyear

The year associated with the people data frame.

minedage

The minimum age that a person, normally a child, can enter education.

maxedage

The maximum age that a person, normally an adolescent, can leave education.

leavers

A data frame containing the counts, by sex, age, and year, of the people who have left education.

lvrsx

The variable containing the codes for sex, in the leavers data.

lvrage

The variable containing the codes for sex, in the leavers data.

lvryear

The variable containing the year for the lvrcount.

lvrcount

The variable containing the counts for each sex/age combination in the leavers data.

pyramid

A data frame containing the sex/age pyramid to be used.

pyrsx

The variable containing the codes for sex, in the pyramid data.

pyrage

The variable containing the ages, in the pyramid data.

pyrcount

The variable containing the counts for each sex/age combination, in the pyramid data

stvarname

The name of the variable to contain the education status. The output is "Y" for those still in education and "N" for those not in education.

verbose

If TRUE, the proportion of students who have left school by age and sex will be printed to the console. Default is FALSE

userseed

If specified, this will set the seed to the number provided. If not, the normal set.seed() function will be used.

Details

The proportion of people, by age and sex, who have left school is printed to the console.

Value

A data frame of an observations, with an added column that contains the education status of each person.

Examples

WithInd <- addind(Township, pplid = "ID", pplsx = "Sex", pplage = "Age", pplyear = 2018,
                  minedage = 5, maxedage = 18, LeftSchool, lvrsx = "Sex", lvrage = "Age",
                  lvryear = "YearLeft", lvrcount = "Total", RegionalStructure,
                  pyrsx = "Sex", pyrage = "Age", pyrcount = "Value", stvarname = "Status",
                  verbose = TRUE, userseed = 4)

[Package PopulateR version 1.13 Index]