capm (version 0.3)

PlotPopPyramid: Population PlotPopPyramid

Description

Dysplays two opposed horizontal barplots (pyramid).

Usage

PlotPopPyramid(dat = NULL, age.col = NULL, sex.col = NULL,
  str.col = NULL, x.label = "Total", stage.label = "Years",
  inner.color = "Gold2", outer.color = "DarkOliveGreen")

Arguments

dat

data.frame.

age.col

the number or name of dat column which have a numeric vector representing ages or stage categories.

sex.col

the number or name of dat column which have a factor with two levels representing the sex of individuals (see Details).

str.col

the number of dat column which have a factor representing the reproductive status of individuals (see Details).

x.label

a string to be used as a label for x-axis. If non defined, x.label is equal to "Total" (see Details).

stage.label

a string to be used as a label for ages or stages categories. If non defined, stage.label is equal to "Years" (see Details).

inner.color

any valid way to specify colors. When str.col is NULL, inner.color is the color of bars. When str.col is not NULL, innercolor is the inner color of bars. If non defined,

outer.color

any valid way to specify colors. When str.col is NULL, outer.color is ignored. When str.col is not NULL, outer.color is the outer color of bars. If non defined, ou

Value

• Two opposed horizontal barplots.

Details

PlotPopPyramid is mainly intended for companion animals population pyramids, although it can display other types of opposed bar charts with suitable modification of the arguments.

The bars to the left of 0 on the x axis correspond to the minimum value of as.numeric (dat[, sex.col]). If str.col is not NULL, bars will be stacked, with the minimum value of as.numeric(dat[, str.col]) as their base.

On the top of the plot, it is displayed the total number of observations of each level of dat[, sex.col]. The levels of sex.col are used as labels.

The legend title is equal to names(dat[, str.col]) and the legend labels are equal to the levels of dat[, str.col].

Font size of saved plots is usually different to the font size seen in graphic browsers. Before changing font sizes, see the final result in saved (or preview) plots.

Other details of the plot can be modifyed using appropriate functions from ggplot2 package (see examples).

References

http://oswaldosantos.github.io/capm

See Also

pyramid.plot.

Examples

## Load data with information about age, sex and reproductive status of individuals.
data(survey.data)
# Uncomment the following lines:
# PlotPopPyramid(survey.data, age.col = 5, sex.col = 4, str.col = 6)
# PlotPopPyramid(survey.data, age.col = 5, sex.col = 4)