FishGlob_data
An integrated database of fish biodiversity sampled with scientific bottom trawl survey.
https://github.com/AquaAuma/FishGlob_data
Category: Biosphere
Sub Category: Marine Life and Fishery
Last synced: about 18 hours ago
JSON representation
Repository metadata
Database and methods related to the manuscript "An integrated database of fish biodiversity sampled with scientific bottom trawl surveys"
- Host: GitHub
- URL: https://github.com/AquaAuma/FishGlob_data
- Owner: AquaAuma
- License: cc-by-4.0
- Created: 2022-12-19T19:59:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-16T06:22:13.000Z (15 days ago)
- Last Synced: 2025-04-17T08:22:06.832Z (14 days ago)
- Language: R
- Homepage:
- Size: 3.09 GB
- Stars: 23
- Watchers: 5
- Forks: 7
- Open Issues: 11
- Releases: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
README.md
FishGlob_data
This repository contains the FishGlob database, including the methods to load, clean, and process the public bottom trawl surveys in it. The database is described in the manuscript, "An integrated database of fish biodiversity sampled with scientific bottom trawl surveys" by Aurore A. Maureaud, Juliano Palacios-Abrantes, Zoë Kitchel, Laura Mannocci, Malin L. Pinsky, Alexa Fredston, Esther Beukhof, Daniel L. Forrest, Romain Frelat, Maria L.D. Palomares, Laurene Pecuchet, James T. Thorson, P. Daniël van Denderen, and Bastien Mérigot.
This database is a product of the CESAB working group, FishGlob: Fish biodiversity under global change – a worldwide assessment from scientific trawl surveys.
Main contacts: Aurore A. Maureaud, Juliano Palacios-Abrantes, Zoë J. Kitchel, and Malin L. Pinsky
Anyone interested in reusing this data or its outputs should read this readme as well as our Data Disclaimer in full.
This work is licensed under a
Creative Commons Attribution 4.0 International License.
Structure of the repository
- cleaning_codes includes all scripts to process and perform quality control on the trawl surveys.
- data_descriptor_figures contains the R script to construct figures 2-4 for the data descriptor manuscript.
- functions contains useful functions used in other scripts
- length_weight contains the length-weight relationships for surveys where weights have to be calculated from abundance at length data (including NOR-BTS and DATRAS)
- metadata_docs has a README with notes about each survey. This is a place to document changes in survey methods, quirks, etc. It is a growing list. If you have information to add, please open an Issue.
- outputs contains all survey data processed .RData files and flagging outputs
- QAQC contains the additional QAQC performed on surveys that required supplementary checks (DATRAS-sourced surveys)
- standard_formats includes definitions of file formats in the FishGlob database, including survey ID codes.
- standardization_steps contains the R codes to run a full survey standardization and a cross-survey summary of flagging methods
- summary contains the quality check plots for each survey
Survey data processing steps
Data processing and cleaning is done on a per survey basis unless formats are similar across a group of surveys. The current repository can process 29 scientific bottom-trawl surveys, according to the following steps.
Steps
- Merge the data files for one survey
- Clean & homogenize column names following the format described in standard_formats/fishglob_data_columns.xlsx
- Create missing columns and standardize units using the standard format standard_formats/fishglob_data_columns.xlsx
- Integrate the cleaned taxonomy by applying the function clean_taxa() and apply expert knowledge on taxonomic treatments
- Perform quality checks, including the output in the summary folder and specific QAQC for other surveys detailed in the QAQC folder
Survey data standardization and flags
Data standardization and flags are done on a per survey basis and per survey_unit basis (integrating seasons and quarters). Flags are performed both on the temporal occurrence of taxa and the spatio-temporal sampling footprint according to the following steps.
Steps
- Taxonomic quality control: run flag_spp() for each survey region
- Apply methods to identify a standard spatial footprint through time for each survey-season/quarter (the survey_unit column). Use the functions apply_trimming_per_survey_unit_method1() and apply_trimming_per_survey_unit_method2()
- Display and integrate results in the summary files
Final data products
Options
Users can either use the single survey data products in outputs/Cleaned_data/ and work with survey .RData files including flags or not (inclusion of flags is specified by XX_std_clean.RData), or generate their own compiled version of the data by running the cleaning_codes/merge.R which will write local versions of the database in outputs/Compiled_data/
Author contributions
Contributors to code
- Cleaning taxonomy: Juliano Palacios-Abrantes
- Cleaning surveys: Juliano Palacios-Abrantes, Aurore Maureaud, Zoë Kitchel, Dan Forrest, Daniël van Denderen, Laurene Pecuchet, Esther Beukhof
- Summary of surveys: Juliano Palacios-Abrantes, Aurore Maureaud, Zoë Kitchel, Laura Mannocci
- Merge surveys: Aurore Maureaud
- Standardize surveys: Laura Mannocci, Malin Pinsky, Aurore Maureaud, Zoë Kitchel, Alexa Fredston
- QAQC of DATRAS surveys: Aurore Maureaud, Daniël van Denderen, Esther Beukhof, Laurene Pecuchet
- QAQC of the Barents Sea surveys: Laurene Pecuchet
- QAQC of North American surveys: Zoë Kitchel, Malin Pinsky, Daniel Forrest
Credit and citation
Our full citation policy is described in the Fishglob_data disclaimer. Briefly, users should cite Maureaud et al. 2021, Maureaud et al. 2024, and relevant primary SBTS sources referenced in the FISHGLOB data files and source data tables of the two Maureaud et al. papers. Users integrating multiple surveys are encouraged to cite additional studies on data integration.
⚠️ Important updates ⚠️
5/06/2024: A warning about CSVs
Datasets are available for download in outputs/Cleaned_data/ as .Rdata files. We do not recommend saving FishGlob data in .csv format. For at least some surveys, thehaul_id
column is composed of a long string of numerics, which is incorrectly rounded if loaded from a .csv programmatically in R (withread_csv()
orread.csv()
). As documented in issue #49, this leads to errors in thehaul_id
column, and may occur regardless of the "class" assigned to this column. The most robust way to prevent this error is to write to / read from other data types such as .Rdata or .rds. Packages exist for users to import these into Python and other programming languages.
23/11/2023: FishGlob_data v2.0
05/09/2023: Norwegian survey is erroneous and will be replaced with a Barents Sea centered survey over 2004-onwards which will change the spatio-temporal coverage of the region (coordinated by Laurene Pecuchet with IMR), see issue #29
Owner metadata
- Name: Aurore Maureaud
- Login: AquaAuma
- Email:
- Kind: user
- Description:
- Website: https://auroremaureaud.weebly.com/
- Location: New Brunswick, US
- Twitter:
- Company: Rutgers University
- Icon url: https://avatars.githubusercontent.com/u/46930001?u=07fe5b03174b5d28164b868c117afb68b92add69&v=4
- Repositories: 3
- Last ynced at: 2023-03-03T08:51:11.782Z
- Profile URL: https://github.com/AquaAuma
GitHub Events
Total
- Issues event: 8
- Watch event: 4
- Issue comment event: 18
- Push event: 8
- Pull request event: 4
Last Year
- Issues event: 8
- Watch event: 4
- Issue comment event: 18
- Push event: 8
- Pull request event: 4
Committers metadata
Last synced: 9 days ago
Total Commits: 244
Total Committers: 6
Avg Commits per committer: 40.667
Development Distribution Score (DDS): 0.283
Commits in past year: 17
Committers in past year: 4
Avg Commits per committer in past year: 4.25
Development Distribution Score (DDS) in past year: 0.471
Name | Commits | |
---|---|---|
Aurore Maureaud | a****a@g****m | 175 |
Juliano Palacios Abrantes | j****s@o****a | 35 |
Zoë Kitchel | 3****l | 14 |
Malin Pinsky | m****y@u****u | 12 |
Laurene Pecuchet | l****t@g****m | 5 |
Alexa Fredston | a****n@g****m | 3 |
Committer domains:
- ucsc.edu: 1
- oceans.ubc.ca: 1
Issue and Pull Request metadata
Last synced: 2 days ago
Total issues: 46
Total pull requests: 13
Average time to close issues: 3 months
Average time to close pull requests: 1 day
Total issue authors: 11
Total pull request authors: 2
Average comments per issue: 3.61
Average comments per pull request: 0.0
Merged pull request: 13
Bot issues: 0
Bot pull requests: 0
Past year issues: 9
Past year pull requests: 4
Past year average time to close issues: 11 days
Past year average time to close pull requests: 1 day
Past year issue authors: 7
Past year pull request authors: 2
Past year average comments per issue: 2.56
Past year average comments per pull request: 0.0
Past year merged pull request: 4
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- AquaAuma (30)
- zoekitchel (4)
- edwardlavender (3)
- eshdb (2)
- mpinsky (1)
- afredston (1)
- federico-maioli (1)
- IleanaF (1)
- shahar710 (1)
- LaurenePecuchet (1)
- jepa (1)
Top Pull Request Authors
- mpinsky (10)
- afredston (3)
Top Issue Labels
- cpue (7)
- gear (6)
- invalid (5)
- survey (5)
- QAQC (5)
- taxonomy (3)
- summary (3)
- documentation (2)
- duplicates (2)
- lengths (2)
- flags (1)
- survey_unit (1)
- enhancement (1)
Top Pull Request Labels
Score: 5.318119993844217