Learn R Programming

⚠️There's a newer version (4.4) of this package.Take me there.

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-3 License

Copy Link

Version

Install

install.packages('provenance')

Monthly Downloads

207

Version

4.2

License

GPL-2

Maintainer

Pieter Vermeesch

Last Published

August 28th, 2023

Functions in provenance (4.2)

endmembers

Petrographic end-member compositions
get.f

Calculate the largest fraction that is likely to be missed
MDS

Multidimensional Scaling
Kuiper.diss

Kuiper dissimilarity
indscal

Individual Differences Scaling of provenance data
ALR

Additive logratio transformation
CA

Correspondence Analysis
Namib

An example dataset
amalgamate

Group components of a composition
as.acomp

create an acomp object
lines.ternary

Ternary line plotting
plot.compositional

Plot a pie chart
GPA

Generalised Procrustes Analysis of configurations
PCA

Principal Component Analysis
plot.distributional

Plot continuous data as histograms or cumulative age distributions
as.data.frame

create a data.frame object
SH.diss

Sircombe and Hazelton distance
read.varietal

Read a .csv file with varietal data
as.compositional

create a compositional object
as.counts

create a counts object
restore

Undo the effect of hydraulic sorting
KDE

Create a kernel density estimate
KDEs

Generate an object of class KDEs
central.counts

Calculate central compositions
SNSM

varietal data example
combine

Combine samples of distributional data
densities

A list of rock and mineral densities
plot.minsorting

Plot inferred grain size distributions
plot.ternary

Plot a ternary diagram
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
as.varietal

create a varietal object
Wasserstein.diss

Wasserstein distance
minsorting

Assess settling equivalence of detrital components
plot.GPA

Plot a Procrustes configuration
text.ternary

Ternary text plotting
plot.INDSCAL

Plot an INDSCAL group configuration and source weights
plot.CA

Point-counting biplot
get.n

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

Joint plot of several provenance datasets
subset

Get a subset of provenance data
plot.MDS

Plot an MDS configuration
read.compositional

Read a .csv file with compositional data
plot.PCA

Compositional biplot
procrustes

Generalised Procrustes Analysis of provenance data
points.ternary

Ternary point plotting
varietal2distributional

Convert varietal to distributional data
plot.KDE

Plot a kernel density estimate
provenance

Menu-based interface for provenance
get.p

Calculate the probability of missing a given population fraction
radialplot.counts

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

Plot one or more kernel density estimates
read.counts

Read a .csv file with point-counting data
read.densities

Read a .csv file with mineral and rock densities
ternary

Define a ternary composition
ternary.ellipse

Ternary confidence ellipse
read.distributional

Read a .csv file with distributional data
CLR

Centred logratio transformation
KS.diss

Kolmogorov-Smirnov dissimilarity