freq.pol: Plot a Cumulative Frequency Polygon

In LearningStats: Elemental Descriptive and Inferential Statistics

Description

The function freq.pol computes a cumulative frequency polygon of a given sample.

Usage

freq.pol(x, freq = FALSE, col = "black", lwd = 2, main = "autom",
  xlab = "", ylab = "autoy", bar = TRUE, fill = TRUE,
  col.fill = "pink")

Arguments

x	a numeric vector containing the sample to compute the cumulative polygon.
freq	logical value; if TRUE, the cumulative polygon uses absolute frequencies; if FALSE, relative frequencies are used.
col	colour to be used in the polygon line; default to black.
lwd	a single numeric value corresponding with the width to be used in the polygon line; default to 2
main	main title; by default to "Polygon of cumulative absolute frequencies" or "Polygon of cumulative relative frequencies" depending on the value of the argument freq, TRUE or FALSE respectively.
xlab	x-axis label; by default to empty .
ylab	y-axis label; by default to "Cumulative absolute frequencies" or "Cumulative relative frequencies" depending on the value of the argument freq, TRUE or FALSE respectively.
bar	logical value; if TRUE (default), bars are plotted underneath the polygon line.
fill	logical value; if TRUE bars are filled with colour set in col.fill (if not given pink is chosen); FALSE (default) unless col.fill is given.
col.fill	colour to be used to fill the bars; if not given and fill=TRUE, set to pink.

Details

The sample must be numeric and coming from a continuous variable.

The procedure used to define the intervals for the frequency table and the bars (if plotted) is the same as used for the histogram performed in this package (see ?Histogram).

Value

A list containing the following components:

ni	a numeric vector containing the absolute frequencies.
fi	a numeric vector containing the relative frequencies.
Ni	a numeric vector containing the absolute cumulative frequencies.
Fi	a numeric vector containing the relative cumulative frequencies.
tab	the frequency table.

Independently on the user saving those values, the function provides the frequency table on the console.

Examples

x=rnorm(10)
freq.pol(x)

freq.pol(x,freq=TRUE,fill=TRUE,col.fill="yellow")

LearningStats documentation built on April 21, 2021, 9:06 a.m.