Learn R Programming

provenance

provenance bundles a number of established statistical methods to facilitate the visual interpretation of large datasets in sedimentary geology. Includes functionality for adaptive kernel density estimation, principal component analysis, correspondence analysis, multidimensional scaling, generalised procrustes analysis and individual differences scaling using a variety of dissimilarity measures. Univariate provenance proxies, such as single-grain ages or (isotopic) compositions are compared with the Kolmogorov-Smirnov, Kuiper or Sircombe-Hazelton L2 distances. Categorical provenance proxies such as chemical compositions are compared with the Aitchison and Bray-Curtis distances, and point-counting data with the chi-square distance. Also included are tools to plot compositional and point-counting data on ternary diagrams and point-counting data on radial plots, to calculate the sample size required for specified levels of statistical precision, and to assess the effects of hydraulic sorting on detrital compositions. Includes an intuitive query-based user interface for users who are not proficient in R..

Prerequisites

You must have R installed on your system (see https://www.r-project.org). Additionally, to install provenance from Github, you also need the devtools package. This can be installed by typing the following code at the R command line prompt:

install.packages('devtools')

Installation

The most recent stable version of provenance is available from CRAN at https://cran.r-project.org/package=provenance and can be installed on your system as follows:

install.packages('provenance')

Alternatively, to install the current development version of provenance from Github, type:

library(devtools)
install_github('pvermees/provenance')

Further information

See https://www.ucl.ac.uk/~ucfbpve/provenance/

Vermeesch, P., Resentini, A. and Garzanti, E., 2016, An R package for statistical provenance analysis, Sedimentary Geology, 336, 14-25

Vermeesch, P., 2018, Statistical models for point-counting data. Earth and Planetary Science Letters 501, 1-7

Author

Pieter Vermeesch

License

This project is licensed under the GPL-2 License

Copy Link

Version

Install

install.packages('provenance')

Monthly Downloads

297

Version

4.4

License

GPL-2

Maintainer

Pieter Vermeesch

Last Published

January 12th, 2025

Functions in provenance (4.4)

as.acomp

create an acomp object
densities

A list of rock and mineral densities
get.n

Calculate the number of grains required to achieve a desired level of sampling resolution
indscal

Individual Differences Scaling of provenance data
get.p

Calculate the probability of missing a given population fraction
lines.ternary

Ternary line plotting
botev

Compute the optimal kernel bandwidth
bray.diss

Bray-Curtis dissimilarity
diss.distributional

Calculate the dissimilarity matrix between two datasets of class distributional, compositional, counts or varietal
plot.MDS

Plot an MDS configuration
plot.PCA

Compositional biplot
radialplot.counts

Visualise point-counting data on a radial plot
plot.GPA

Plot a Procrustes configuration
provenance

Menu-based interface for provenance
plot.INDSCAL

Plot an INDSCAL group configuration and source weights
central.counts

Calculate central compositions
combine

Combine samples of distributional data
procrustes

Generalised Procrustes Analysis of provenance data
points.ternary

Ternary point plotting
plot.CA

Point-counting biplot
minsorting

Assess settling equivalence of detrital components
ternary

Define a ternary composition
read.densities

Read a .csv file with mineral and rock densities
read.distributional

Read a .csv file with distributional data
endmembers

Petrographic end-member compositions
read.compositional

Read a .csv file with compositional data
read.varietal

Read a .csv file with varietal data
plot.compositional

Plot a pie chart
plot.distributional

Plot continuous data as histograms or cumulative age distributions
ternary.ellipse

Ternary confidence ellipse
plot.KDE

Plot a kernel density estimate
restore

Undo the effect of hydraulic sorting
plot.KDEs

Plot one or more kernel density estimates
get.f

Calculate the largest fraction that is likely to be missed
text.ternary

Ternary text plotting
read.counts

Read a .csv file with point-counting data
varietal2distributional

Convert varietal to distributional data
subset

Get a subset of provenance data
plot.minsorting

Plot inferred grain size distributions
plot.ternary

Plot a ternary diagram
summaryplot

Joint plot of several provenance datasets
CLR

Centred logratio transformation
GPA

Generalised Procrustes Analysis of configurations
KS.diss

Kolmogorov-Smirnov dissimilarity
Kuiper.diss

Kuiper dissimilarity
PCA

Principal Component Analysis
SH.diss

Sircombe and Hazelton distance
CA

Correspondence Analysis
ALR

Additive logratio transformation
KDE

Create a kernel density estimate
KDEs

Generate an object of class KDEs
as.data.frame

create a data.frame object
SNSM

varietal data example
amalgamate

Group components of a composition
as.varietal

create a varietal object
Wasserstein.diss

Wasserstein distance
as.compositional

create a compositional object
MDS

Multidimensional Scaling
Namib

An example dataset
as.counts

create a counts object