Skip to content

Commit

Permalink
Merge pull request #382 from tdwg/readme_citation
Browse files Browse the repository at this point in the history
Add CITATION.cff + update homepage
  • Loading branch information
peterdesmet authored Jun 11, 2024
2 parents 188d285 + aefde5b commit b089447
Show file tree
Hide file tree
Showing 4 changed files with 37 additions and 28 deletions.
22 changes: 22 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
cff-version: 1.2.0
message: 'To cite "Camtrap DP" in publications use:'
type: software
license: MIT
title: Camera Trap Data Package (Camtrap DP)
version: 1.0
authors:
- given-names: Peter
family-names: Desmet
email: peter.desmet@inbo.be
affiliation: Research Institute for Nature and Forest (INBO)
orcid: https://orcid.org/0000-0002-8442-8025
- family-names: Bubnicki
given-names: Jakub W.
email: kbubnicki@ibs.bialowieza.pl
affiliation: Mammal Research Institute, Polish Academy of Sciences & Open Science Conservation Fund
orcid: https://orcid.org/0000-0002-2064-3113
- name: Camtrap DP Development Team
repository-code: https://github.com/tdwg/camtrap-dp
url: https://camtrap-dp.tdwg.org/
date-released: '2023-11-03'
doi: 10.5281/zenodo.10068760
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10068759.svg)](https://doi.org/10.5281/zenodo.10068759)

**Camera Trap Data Package** (or **Camtrap DP** for short) is a community developed data exchange format for camera trap data.
**Camera Trap Data Package** (Camtrap DP) is a community-developed data exchange format for camera trap data.

## Usage

Expand Down
13 changes: 0 additions & 13 deletions citation.bib

This file was deleted.

28 changes: 14 additions & 14 deletions pages/home.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ permalink: /
description: Data exchange format for camera trap data
---

**Camera Trap Data Package** (or **Camtrap DP** for short) is a community developed data exchange format for camera trap data. A Camtrap DP is a [Frictionless Data Package](https://specs.frictionlessdata.io/data-package/) that consists of:
**Camera Trap Data Package** (Camtrap DP) is a community-developed data exchange format for camera trap data. A Camtrap DP is a [Frictionless Data Package](https://specs.frictionlessdata.io/data-package/) that consists of:

File | Description
--- | ---
Expand All @@ -14,12 +14,21 @@ File | Description
`media.csv` | Table with [media](data/#media) files recorded during deployments.
`observations.csv` | Table with [observations](data/#observations) derived from the media files.

[Read our paper](https://doi.org/10.1002/rse2.374) to learn more about Camtrap DP.
## Context

See [Bubnicki et al. (2023)](https://doi.org/10.1002/rse2.374) to learn more about Camtrap DP.

## Example

See the [example dataset](example/).

## Software

- [camtrapdp](https://inbo.github.io/camtrapdp): R package to read and manipulate Camtrap DP.
- [Agouti](https://agouti.eu): Data management platform, uses Camtrap DP as export format.
- [TRAPPER](https://os-conservation.org/projects/trapper): Data management platform, uses Camtrap DP as export format.
- [Integrated Publishing Toolkit (IPT)](https://www.gbif.org/ipt) (v3): Online software tool to publish biodiversity datasets to the Global Biodiversity Information Facility (GBIF). See the [2022 webinar](https://www.gbif.org/composition/4fZGV2vrXjo3rNxySz41sj/exploring-camera-trap-data) for context and [Reyserhove et al. (2023)](https://doi.org/10.35035/doc-0qzp-2x37) for publication guidelines.

## Validation

To allow validation, the `datapackage.json` of your dataset should reference the used version of Camtrap DP, both in `profile` and the resources' `schema`:
Expand Down Expand Up @@ -52,25 +61,16 @@ pip install frictionless
frictionless validate path/to/your/datapackage.json
```

## Implementations

- [camtraptor](https://inbo.github.io/camtraptor): R package to read, explore and visualize Camtrap DP.
- [Agouti](https://agouti.eu): Data management platform, uses Camtrap DP as export format.
- [TRAPPER](https://os-conservation.org/projects/trapper): Data management platform, uses Camtrap DP as export format.
- [Integrated Publishing Toolkit (IPT)](https://www.gbif.org/ipt) (version 3.0): Online software tool to publish biodiversity datasets to the Global Biodiversity Information Facility (GBIF). See the [November 2022 webinar](https://www.gbif.org/composition/4fZGV2vrXjo3rNxySz41sj/exploring-camera-trap-data) for context and [Reyserhove et al. (2023)](https://doi.org/10.35035/doc-0qzp-2x37) for publication guidelines.

## Contribute

Questions? Suggestions? Contribute to the development of Camtrap DP by watching the [repository](https://github.com/tdwg/camtrap-dp) and participating in [issue discussions](https://github.com/tdwg/camtrap-dp/issues).

## Recommended citation
## Citation

To cite Camtrap DP in general, use the preprint ([bibtex](citation.bib)):
To cite the Camtrap DP paper:

> Bubnicki JW, Norton B, Baskauf SJ, Bruce T, Cagnacci F, Casaer J, Churski M, Cromsigt JPGM, Farra SD, Fiderer C, Forrester TD, Hendry H, Heurich M, Hofmeester TR, Jansen PA, Kays R, Kuijper DPJ, Liefting Y, Linnell JDC, Luskin MS, Mann C, Milotic T, Newman P, Niedballa J, Oldoni D, Ossi F, Robertson T, Rovero F, Rowcliffe M, Seidenari L, Stachowicz I, Stowell D, Tobler MW, Wieczorek J, Zimmermann F, Desmet P (2023). Camtrap DP: an open standard for the FAIR exchange and archiving of camera trap data. Remote Sensing in Ecology and Conservation. <https://doi.org/10.1002/rse2.374>
To cite version 1.0 of Camtrap DP, use:

> Desmet P, Bubnicki JW, Camtrap DP Development Team (2023). Camtrap DP (1.0). Biodiversity Information Standards (TDWG). <https://doi.org/10.5281/zenodo.10068760>
To cite the Camtrap DP standard, use the [citation provided by GitHub](https://github.com/tdwg/camtrap-dp), which is generated from a `CITATION.cff` file. See [About CITATION files](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files) for more info.

Camtrap DP is managed by the [Machine Observations Interest Group](https://www.tdwg.org/community/mobs/) of Biodiversity Information Standards (TDWG).

0 comments on commit b089447

Please sign in to comment.