Unmixing Model Framework
Overview
Quantifies the provenance of sediments by applying a mixing model algorithm to end sediment mixtures based on a comprehensive characterization of the sediment sources. The 'fingerPro' model builds upon the foundational concept of using mass balance linear equations for sediment source quantification by incorporating several distinct technical advancements. It employs an optimization approach to normalize discrepancies in tracer ranges and minimize the objective function. Latin hypercube sampling is used to explore all possible combinations of source contributions (0-100%), mitigating the risk of local minima. Uncertainty in source estimates is quantified through a Monte Carlo routine, and the model includes additional metrics, such as the normalized error of the virtual mixture, to detect mathematical inconsistencies, non-physical solutions, and biases. A new linear variability propagation (LVP) method is also included to address and quantify potential bias in model outcomes, particularly when dealing with dominant or non-contributing sources and high source variability, offering a significant advancement for field studies where direct comparison with theoretical apportionments is not feasible. In addition to the unmixing model, a complete framework for tracer selection is included. Several methods are implemented to evaluate tracer behaviour by considering both source and mixture information. These include the Consistent Tracer Selection (CTS) method to explore all tracer combinations and select the optimal ones improving the robustness and interpretability of the model results. A Conservative Balance (CB) method is also incorporated to enable the use of isotopic tracers. The package also provides several graphical tools to support data exploration and interpretation, including box plots, correlation plots, Linear Discriminant Analysis (LDA) and Principal Component Analysis (PCA).
**API Refinement and CRAN Preparation**
This version focuses on standardizing the package for CRAN, refining the public API, and improving data ingestion workflows.
Key Features
- **Parameter Standardization**: The
seedparameter is renamed torng_initacross the entire package (unmix,CR,CTS_explore,CTS_select,CI, etc.) to clearly indicate its role in initializing the random generator. - **Semantic Renaming**:
CTS_seeds()is nowCTS_explore()to better describe the exploration of tracer combinations.CTS_error()is nowCTS_select(), featuring an improved interface that returns a filtered dataset.- **New Utility Functions**:
read_database(): A centralized entry point that handles file reading, validation, mixture selection, and zero-value detection.validate_results(): Diagnostic function for post-unmixing analysis.- **Function Visibility**: Internal validation functions are now hidden from the public API using
@keywords internal.
---
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-09
- ERROR12 OK, 1 ERROR2026-09-04
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
Show 7 earlier changesHide 7 earlier changes
- ERROR12 OK, 1 ERROR2026-06-08
- OK13 OK2026-05-17
- ERROR12 OK, 1 NOTE, 1 ERROR2026-04-17
- NOTE13 OK, 1 NOTE2026-04-16
- OK14 OK2026-04-10
- ERROR13 OK, 1 ERROR2026-04-09
- OK14 OK2026-03-10
Documentation
- Help pages
- 45 (27 internal)includes a package overview page
- Examples that run
- 100%1 run in a plain check
- Exported functions with examples
- 0%
- Documented parameters
- 100%
- Return-value docs
- 69%
- Help pages citing references
- 18%
Downloads
Repository
- PRs merged (all time)
- 75%
- Median days to close, 50 most recently updated closed issues
- 36
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Checks run against github.com/eead-csic-eesa/fingerpro on 2026-10-11.
No development-tooling practices detected in the upstream repository.
Dependencies
Installing fingerPro adds 138 packages (67 with compiled code, 117 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
Code & Tests
Datasets
People & History
Maintainer since 2.0 (2025), previously Ivan Lizaga (1.0 to 1.1)
Show 3 peopleHide 3 people
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 2.1Latest2026-04-15 · current release · diff ↗ ·
removed 2 exports
CTS_error, CTS_seedsadded 4 exports
CTS_explore, CTS_select, validate_results, read_database - 2.02025-08-27 · diff ↗ ·
removed 1 export
pattern:^[[:alpha:]]+added 24 exports
CB_method, CI, CR, CTS_error, CTS_seeds, DFA_test, KW_test, LDA_plot, PCA_plot, box_plot, check_database, correlation_plot, ggbiplot, individual_tracer_analysis, inputMixture, inputSource, plot_results, range_test, raw_dataset, select_tracers, ternary_diagram, unmix, virtual_mixture, write_results - RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- RR 4.3.0 released · 2023-04-21
- RR 4.2.0 released · 2022-04-22
- RR 4.1.0 released · 2021-05-18
- RR 4.0.0 released · 2020-04-24
- RR 3.6.0 released · 2019-04-26
- 1.12018-08-28 · diff ↗
- RR 3.5.0 released · 2018-04-23
- 1.02018-02-20
- RR 3.4.0 released · 2017-04-21
Package metadata
- First published
- 2018-02-20
- Total releases
- 4 / 8 yrs
- License
- GPL-2 OSI
- Minimum R
- ≥ 3.5
- Download size
- 3.3 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("fingerPro")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.32614/cran.package.fingerpro.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.