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

328

Version

4.3

License

GPL-2

Maintainer

Pieter Vermeesch

Last Published

May 4th, 2024

Functions in provenance (4.3)

Wasserstein.diss

Wasserstein distance
densities

A list of rock and mineral densities
diss.distributional

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

Sircombe and Hazelton distance
central.counts

Calculate central compositions
combine

Combine samples of distributional data
plot.GPA

Plot a Procrustes configuration
plot.INDSCAL

Plot an INDSCAL group configuration and source weights
botev

Compute the optimal kernel bandwidth
bray.diss

Bray-Curtis dissimilarity
minsorting

Assess settling equivalence of detrital components
plot.CA

Point-counting biplot
plot.PCA

Compositional biplot
endmembers

Petrographic end-member compositions
get.f

Calculate the largest fraction that is likely to be missed
plot.MDS

Plot an MDS configuration
read.compositional

Read a .csv file with compositional data
read.counts

Read a .csv file with point-counting data
plot.KDEs

Plot one or more kernel density estimates
plot.KDE

Plot a kernel density estimate
plot.ternary

Plot a ternary diagram
plot.minsorting

Plot inferred grain size distributions
procrustes

Generalised Procrustes Analysis of provenance data
points.ternary

Ternary point plotting
plot.distributional

Plot continuous data as histograms or cumulative age distributions
read.densities

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

Read a .csv file with distributional data
plot.compositional

Plot a pie chart
get.n

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

Individual Differences Scaling of provenance data
lines.ternary

Ternary line plotting
get.p

Calculate the probability of missing a given population fraction
summaryplot

Joint plot of several provenance datasets
subset

Get a subset of provenance data
provenance

Menu-based interface for provenance
read.varietal

Read a .csv file with varietal data
restore

Undo the effect of hydraulic sorting
ternary

Define a ternary composition
radialplot.counts

Visualise point-counting data on a radial plot
ternary.ellipse

Ternary confidence ellipse
varietal2distributional

Convert varietal to distributional data
text.ternary

Ternary text plotting
KDE

Create a kernel density estimate
Kuiper.diss

Kuiper dissimilarity
CLR

Centred logratio transformation
KS.diss

Kolmogorov-Smirnov dissimilarity
as.counts

create a counts object
as.compositional

create a compositional object
ALR

Additive logratio transformation
MDS

Multidimensional Scaling
as.data.frame

create a data.frame object
SNSM

varietal data example
Namib

An example dataset
CA

Correspondence Analysis
GPA

Generalised Procrustes Analysis of configurations
KDEs

Generate an object of class KDEs
PCA

Principal Component Analysis
amalgamate

Group components of a composition
as.varietal

create a varietal object
as.acomp

create an acomp object