# collapse: Reduces a vector to a frequency vector In agrmt: Calculate Concentration and Dispersion in Ordered Rating Scales

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

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