plot.qlifetable {qlifetable}

Graphical representation in a 4x4 raster of a qlifetable data frame.

Description

Plot method for a data frame of events or time exposed occurring in each Lexis-diagram quarter for a set of ages. This is a plot method for the objects typically obtained using the function count_events_quarter or whatever of the time_exposed_ functions (e.g., time_exposed_outs).

Usage

## S3 method for class 'qlifetable'
plot(
  x,
  ...,
  range.ages = NULL,
  key = "numbers",
  decimal.digits = 2,
  color.palette = "grey",
  alpha.max = 1,
  alpha.min = 0.4,
  color.values = "black",
  big.mark = NULL,
  size.values = 3,
  legend.name = NULL,
  name.labels.age = c("Q1", "Q2", "Q3", "Q4"),
  name.labels.season = c("Winter", "Spring", "Summer", "Autumn"),
  show.plot = TRUE
)

Arguments

x

A data frame of quarterly summary statistics. Typically an output of the function count_events_quarter or whatever of the time_exposed_ functions (e.g., time_exposed_outs).

...

Other arguments passed on to methods. Not currently used.

range.ages

A vector of integers informing the aggregation of ages for which the graphical representation should be plotted. Default, NULL, the agggregation of all ages is shown.

key

Type of statistic to be presented in the plot. Either "numbers" or relative "percentages". Default, "numbers".

decimal.digits

Integer indicating the number of decimal places to be shown. Default, 2.

color.palette

Background base color for cells. Default, "grey".

alpha.max

A number in the interval [0, 1]. Maximum level of transparency to be applied for the background to build the palette. Default, 1.

alpha.min

A number in the interval [0, 1]. Minimum level of transparency to be applied for the background to build the palette. Default, 0.4.

color.values

Base color for numbers printed in each cell. Default, "black".

big.mark

A character string indicating the symbol to be used as thousand separator. Default, NULL.

size.values

A number indicating the font size to be used for inner-cells values. Default, 3.

legend.name

Name to be use as name in the legend. Default, NULL.

name.labels.age

Names to be used for the (y) age axis. Default, c("Q1", "Q2", "Q3", "Q4").

name.labels.season

Names to be used for the (x) season axis. Default, c("Winter", "Spring", "Summer", "Autumn").

show.plot

A TRUE/FALSE indicating if the plot should be displayed as a side-effect. By default, TRUE.

Value

Invisibly returns the (ggplot) description of the plot, which is a list with components that contain the plot itself, the data, information about the scales, panels, etc.

Note

ggplot2 is needed to be installed for this function to work.

Author(s)

Josep Lledo [e-mail]

Jose M. Pavia, [e-mail]

Examples

dates.b <- c("1920-05-13", "1999-04-12", "2019-01-01")
dates.e <- c("2002-03-23", "2009-04-12", "2019-01-01")
x <- quarterly_variables(dates.b, dates.e)
out <- time_exposed_outs(x)
p <- plot(out, show.plot = FALSE)