https://github.com/PascalIrz/aspe
aspe: An R Package to Analyse and Visualise River Fish Data in France
https://github.com/PascalIrz/aspe
aspe dataset electrofishing fish france freshwater index map plot river sampling wfd
Last synced: 5 months ago
JSON representation
aspe: An R Package to Analyse and Visualise River Fish Data in France
- Host: GitHub
- URL: https://github.com/PascalIrz/aspe
- Owner: PascalIrz
- License: gpl-3.0
- Created: 2020-12-20T19:05:40.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-02-07T10:37:19.000Z (about 1 year ago)
- Last Synced: 2024-04-13T17:17:44.309Z (about 1 year ago)
- Topics: aspe, dataset, electrofishing, fish, france, freshwater, index, map, plot, river, sampling, wfd
- Language: R
- Homepage: https://pascalirz.github.io/aspe/
- Size: 4.66 MB
- Stars: 13
- Watchers: 3
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- open-sustainable-technology - aspe - An R package to analyse and visualise river fish data in France. (Biosphere / Marine Life and Fishery)
README
[](https://github.com/PascalIrz/aspe/actions)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://discourse.jupyter.org/t/should-we-adopt-the-tidyverse-package-lifecycle-badges/1310)
[](https://zenodo.org/record/7458005)
{aspe}: an R package to analyse and visualise river fish data in France
====
{aspe} fournit des outils autorisant simplement la plupart des
traitements de base à partir d’une sauvegarde (dump SQL) de la base de
données ASPE de l’OFB. Ces traitements comprennent les calculs
d’abondances, densités, distribution en tailles et la détection de
tendances à l’échelle de la station. Ces calculs sont accompagnés de
fonctionnalités graphiques.
The goal of {aspe} is to is to provide a suite of tools for most of the
common processing of the ASPE database including importation from a SQL
format dump, calculation of abundances, densities, size distributions,
temporal trends for populations at the station level, along with
graphical output.
La base de données ASPE de l’OFB contient toutes les données
d’inventaire par pêche à l’électricité par le CSP, l’ONEMA, l’AFB, l’OFB
ainsi que par certains partenaires sur les rivières de France. Elle est décrite
dans Irz *et al.* (2022), article produit en visant le respect des principes de la recherche reproductible (Wilkinson *et al.* 2016). Ses fichiers sources - données comprises - sont diffusés sur le dépôt [](https://doi.org/10.5281/zenodo.7099129)
The ASPE database is administrated by the French Office for Biodiversity. It gathers, among others, all the river electrofishing samplings carried out by the former Fisheries Council, National Office for Water and Aquatic Systems and French Agency for Biodiversity. The database is described in Irz *et al.* (2022). This paper was produced to respect the FAIR principles (Wilkinson *et al.* 2016), hence its source files - including the database - are available at [](https://doi.org/10.5281/zenodo.7099129)
- Irz P, Vigneron T, Poulet N, Cosson E, Point T, Baglinière E, Porcher JP. 2022. A long-term monitoring database on fish and crayfish species in French rivers. *Knowl. Manag. Aquat. Ecosyst.* 423, 25, [DOI:10.1051/kmae/2022021](https://doi.org/10.1051/kmae/2022021).
- Wilkinson MD, et al. 2016. The FAIR Guiding Principles for scientific data management and stewardship. *Sci. Data* 3: 160018, [DOI:10.1038/sdata.2016.18](https://doi.org/10.1038/sdata.2016.18).
Installation
------------
Si besoin, commencer par installer le package R {devtools} ainsi que la suite Rtools, puis installer {aspe} au moyen de la commande :
If necessary, first install the {devtools} R package and the Rtools suite, then you can
install the released version of {aspe} from
[Github](https://github.com/PascalIrz/aspe) with:
devtools::install_github("PascalIrz/aspe")
Répertoires Github associés / Associated Github repositories
------------
Plusieurs dépôts Github sont associés au package :
- [aspe_data](https://github.com/PascalIrz/aspe_data) : construction des jeux de données inclus dans le package {aspe}
- [aspe_test](https://github.com/PascalIrz/aspe_test) : Fichiers R Markdown pour tester le package {aspe} et produire les tutos
- [aspe_demo](https://github.com/PascalIrz/aspe_demo) : Fichiers R Markdown pour prétraiter les données pour [un tableau de bord interactif](https://gitlab.ofb.fr/cedric.mondy1/aspedashboard)
- [aspeQual](https://github.com/PascalIrz/aspeQual) : package R destiné à la mise en qualité de la base Aspe
The package comes with a number of associated repos :
- [aspe_data](https://github.com/PascalIrz/aspe_data): building of the datasets included in the {aspe} package
- [aspe_test](https://github.com/PascalIrz/aspe_test): R Markdown files to test the {aspe} package and to build the tutorials
- [aspe_demo](https://github.com/PascalIrz/aspe_demo): R Markdown files to pre-process the fish data for [a dashboard app](https://gitlab.ofb.fr/cedric.mondy1/aspedashboard)
- [aspeQual](https://github.com/PascalIrz/aspeQual) : R package dedicated to the quality control on the Aspe database
Tutoriels / Vignettes
------------
La documentation générale du package est diffusée sur Github pages : https://pascalirz.github.io/aspe/
Une série de tutoriels est en ligne :
- [Traiter des données Indice Poisson Rivière (IPR)](https://rpubs.com/kamoke/713491)
- [Faire des traitements de base à partir des lots](https://rpubs.com/kamoke/715102)
- [Traiter des mesures individuelles](https://rpubs.com/kamoke/715858)
- [Faire des traitements géographiques](https://rpubs.com/kamoke/716322)
- [Construire des relations taille-poids](https://rpubs.com/kamoke/729779)
Several vignettes (in French) are available online:
- [Processing the fish-based river health index](https://rpubs.com/kamoke/713491)
- [Base processing on the fish batches data](https://rpubs.com/kamoke/715102)
- [Processing the individual measurements](https://rpubs.com/kamoke/715858)
- [Geographical analysis](https://rpubs.com/kamoke/716322)
- [Fitting length-weight relationships](https://rpubs.com/kamoke/729779)
Nommage des fonctions / Functions' naming rules
---------------
Les familles de fonctions se distinguent par des préfixes :
- `mef_` : mise en forme des dataframes
- `expl_` : exploration de la base
- `export`: export des dataframes (.csv ou .RData)
- `geo_` : opérations spatiales
- `gg_` : production de graphiques avec `ggplot2`
- `imp_` : importation depuis un dump SQL
- `ipr_` : [indice poisson rivière](https://www.kmae-journal.org/articles/kmae/abs/2002/02/kmae2002365p405/kmae2002365p405.html)
- `misc_` : divers
Functions' names start by group-specific prefixes:
- `mef_`: tidying dataframes
- `expl_`: exploring the database
- `export`: exporting dataframes (.csv or .RData)
- `geo_`: spatial processing
- `gg_`: plots with `ggplot2`
- `imp_`: importing data from a SQL dump
- `ipr_`: [fish-based river health index](https://www.researchgate.net/publication/227818978_Development_and_validation_of_a_fish-based_index_FBI_for_the_assessment_of_river_health_in_France)
- `misc_`: miscellaneous
Nommage des variables / Variables' naming rules
---------------
Dans la quasi-totalité des cas, les variables contenues dans une table sont préfixées en fonction de cette table. Par exemple :
- `sta_` : station
- `pop_` : point_prelevement
- `mei_` : mesure_individuelle
Pour une liste des noms et signification des variables, taper dans la console :
data("data_dictionnaire")
View(data_dictionnaire)
Almost systematically, variables' names start by table-specific prefixes:
- `sta_` : station
- `pop_` : point_prelevement (sampling point)
- `mei_` : mesure_individuelle (individual measurment)
To display a comprehensive list of variables with their meaning (all in French so far, sorry), call:
data("data_dictionnaire")
View(data_dictionnaire)