collapse: Reduces a vector to a frequency vector

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/collapse.R

Description

This function reduces a vector to a frequency vector.

Usage

1
collapse(D,pos=FALSE, na.rm=TRUE)

Arguments

D

Vector

pos

Optional: position of categories

na.rm

Optional: should NA be removed

Details

This function reduces a vector to a frequency vector. This function is very similar to the way table summarizes vectors, but this function can deal with categories of frequency 0 (if the argument pos is specified). Here we assume a vector with an entry for each individual (sorted in any way). Each entry states the position of an individual. When the number of positions is naturally limited, such as when categorical positions are used, frequency vectors can summarize this information: how many individuals have position 1, how many individuals have position 2, etc. A frequency vector has an entry for each position in the population (sorted in ascending order). Each entry states the number of individuals in the population with this position.

The argument pos is required if certain positions do not occur in the population (or if there is a chance that they do not occur in a specific subpopulation). For example, if we have positions on a 7-point scale, and position 3 never occurs in the population, the argument pos must be specified. In this case, our argument may be pos=1:7. We can also use categories more generally, as in c(-3,-1,0,.5,1,2,5). Specifying the positions of categories when all positions actually occur in the population has no side-effects.

By default, missing values (NA) are removed with as.numeric(na.omit()). This helps with some vectors that include NA that fail otherwise.

Value

A frequency vector

Author(s)

Didier Ruedin

See Also

expand

Examples

1
2
3
4
5
6
7
V <- c(1,1,1,1,1,1,3,3,3,3,4,5,5,5,5)
# summarize using table()
table(V)
# summarize using collapse()
collapse(V)
# assuming possible values (1,2,3,4,5), we get that zero times 2 included:
collapse(V, pos=c(1,2,3,4,5))

agrmt documentation built on July 18, 2021, 1:06 a.m.