collapse {agrmt} R Documentation

## Reduces a vector to a frequency vector

### Description

Takes a vector and reduces it to a frequency vector.

### Usage

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

### Arguments

 D Vector pos Optional: position of categories na.rm Optional: should NA be removed (TRUE by default)

### 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 (the order of the values is ignored). 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, the argument may be pos=1:7. We can also use categories more generally, as in c(-3, -1, 0, 0.5, 1, 2, 5). Specifying the positions of categories when all positions occur in the population has no side-effects. See the example for an illustration.

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

Didier Ruedin

### See Also

expand

### Examples

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))


[Package agrmt version 1.42.8 Index]