tabula (version 1.0.0)

plotBar: Bar plot

Description

Plots a Bertin or a Ford (battleship curve) diagram.

Usage

plotBar(object, ...)
# S4 method for CountMatrix
plotBar(object, level = 0.05, EPPM = FALSE,
  center = TRUE, horizontal = FALSE)
# S4 method for FrequencyMatrix
plotBar(object, level = 0.05, EPPM = FALSE,
  center = TRUE, horizontal = FALSE)

Arguments

object

An object to be plotted.

...

Further arguments passed to other methods.

level

A length-one numeric vector giving the confidence level to be drawn.

EPPM

A logical scalar: should the EPPM be drawn (see details)?

center

A logical scalar: should the bar plot be centered? The default, TRUE, produces a Ford diagram, otherwise it produces a Bertin diagram.

horizontal

A logical scalar: should the bar plot be horizontal? The default, FALSE, means variables in rows and cases in columns (i.e. Bertin diagram). Only used if center is FALSE.

Details

If EPPM is TRUE and if a relative abundance is greater than the mean percentage of the type, the exceeding part is highlighted. This positive difference from the column mean percentage (in french "<U+00E9>cart positif au pourcentage moyen", EPPM) represents a deviation from the situation of statistical independence. As independence can be interpreted as the absence of relationships between types and the chronological order of the assemblages, EPPM is a usefull graphical tool to explore significance of relationship between rows and columns related to seriation.

References

Bertin, J. (1977). La graphique et le traitement graphique de l'information. Paris: Flammarion. Nouvelle Biblioth<U+00E8>que Scientifique.

Desachy, B. (2004). Le s<U+00E9>riographe EPPM: un outil informatis<U+00E9> de s<U+00E9>riation graphique pour tableaux de comptages. Revue arch<U+00E9>ologique de Picardie, 3(1), 39-56. DOI: 10.3406/pica.2004.2396.

Ford, J. A. (1962). A quantitative method for deriving cultural chronology. Washington, DC: Pan American Union. Technical manual 1.

See Also

Other plot: plotMatrix, plotRank, plotSpot

Examples

# NOT RUN {
# Coerce dataset to abundance matrix
# Data from Desachy 2004
count <- as(compiegne, "CountMatrix")
freq <- as(boves, "FrequencyMatrix")

# Plot Ford diagram...
## ...without threshold
plotBar(count)
plotBar(freq)

## ...with EPPM (i.e. Bruno Desachy's s<U+00E9>riographe)
plotBar(count, EPPM = TRUE)
plotBar(freq, EPPM = TRUE)

# Plot Bertin diagram...
## ...without EPPM...
plotBar(count, center = FALSE, horizontal = TRUE)
## ...and confidence intervals
plotBar(freq, level = FALSE, center = FALSE, horizontal = FALSE)

## ...with EPPM (i.e. Bruno Desachy's s<U+00E9>riographe)
plotBar(count, EPPM = TRUE, center = FALSE, horizontal = TRUE)
# }