camtrapdp

R package to read and manipulate Camera Trap Data Packages.
https://github.com/inbo/camtrapdp

Category: Biosphere
Sub Category: Terrestrial Wildlife

Keywords

camtrap-dp oscibio r r-package rstats

Keywords from Contributors

data-access animal-movement animal-tracking biologging fish lifewatch camera-traps frictionlessdata opencpu invasive-species

Last synced: about 10 hours ago
JSON representation

Repository metadata

R package to read and manipulate Camera Trap Data Packages (Camtrap DP)

• Host: GitHub
• URL: https://github.com/inbo/camtrapdp
• Owner: inbo
• License: other
• Created: 2024-03-06T11:21:33.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-04-24T10:32:58.000Z (19 days ago)
• Last Synced: 2026-04-29T06:06:59.048Z (14 days ago)
• Topics: camtrap-dp, oscibio, r, r-package, rstats
• Language: R
• Homepage: https://inbo.github.io/camtrapdp/
• Size: 8.82 MB
• Stars: 14
• Watchers: 5
• Forks: 1
• Open Issues: 21
• Releases: 5
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Citation: CITATION.cff
  • Codemeta: codemeta.json

README.Rmd

          ---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# camtrapdp


[![CRAN status](https://www.r-pkg.org/badges/version/camtrapdp)](https://CRAN.R-project.org/package=camtrapdp)
[![CRAN checks](https://badges.cranchecks.info/worst/camtrapdp.svg)](https://cran.r-project.org/web/checks/check_results_camtrapdp.html)
[![R-CMD-check](https://github.com/inbo/camtrapdp/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/inbo/camtrapdp/actions/workflows/R-CMD-check.yaml)
[![codecov](https://codecov.io/gh/inbo/camtrapdp/branch/main/graph/badge.svg)](https://app.codecov.io/gh/inbo/camtrapdp/)
[![repo status](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11490269.svg)](https://doi.org/10.5281/zenodo.11490269)


Camtrapdp is an R package to read and manipulate Camera Trap Data Packages (Camtrap DP). [Camtrap DP](https://camtrap-dp.tdwg.org) is a data exchange format for camera trap data. With camtrapdp you can read, filter and transform data (including to [Darwin Core](https://dwc.tdwg.org)) before further analysis in e.g. [camtraptor](https://inbo.github.io/camtraptor/) or [camtrapR](https://cran.r-project.org/package=camtrapR).

To get started, see:

- [Function reference](https://inbo.github.io/camtrapdp/reference/index.html): overview of all functions.

## Installation

Install the latest released version from CRAN:

```{r, eval = FALSE}
install.packages("camtrapdp")
```

Or the development version from [GitHub](https://github.com/inbo/camtrapdp):

```{r, eval = FALSE}
# install.packages("devtools")
devtools::install_github("inbo/camtrapdp")
```

## Usage

With camtrapdp you can **read** a Camtrap DP dataset into your R environment:

```{r}
library(camtrapdp, warn.conflicts = FALSE)

file <- "https://raw.githubusercontent.com/tdwg/camtrap-dp/1.0/example/datapackage.json"
x <- read_camtrapdp(file)
x
```

`read_camtrapdp()` will automatically **upgrade** an older version of Camtrap DP to the latest version. It will also make the data easier to use, by assigning taxonomic information (found in the metadata) to the observations and `eventID`s (found in the observations) to the media.

To **access** the data, use one of the [accessor functions](https://inbo.github.io/camtrapdp/reference/index.html#accessor-and-assignment-functions) like `locations()`:

```{r}
locations(x)
```

You can also **filter** data with one of the [filter functions](https://inbo.github.io/camtrapdp/reference/index.html#filter-functions), which automatically filter the related data. For example, here we filter observations on scientific name(s) and return the associated events in that subset:

```{r}
x %>%
  filter_observations(
    scientificName %in% c("Martes foina", "Mustela putorius")
  ) %>%
  events()
```

For more functionality, see the [function reference](https://inbo.github.io/camtrapdp/reference/index.html).

## GBIF pipeline

The Global Biodiversity Information Facility ([GBIF](https://www.gbif.org/)) uses camtrapdp to process Camera Trap Data Packages published with the Integrated Publishing Toolkit ([IPT](https://www.gbif.org/ipt)). Datasets are first read with `read_camtrapdp()` and then converted to Darwin Core with `write_dwc()` and EML with `write_eml()`. See the [Camtrap DP pipeline repository](https://github.com/gbif/camtrap-dp-pipeline/tree/master/docker) for details.

## Meta

- We welcome [contributions](https://inbo.github.io/camtrapdp/CONTRIBUTING.html) including bug reports.
- License: MIT
- Get [citation information](https://inbo.github.io/camtrapdp/authors.html#citation) for camtrapdp in R doing `citation("camtrapdp")`.
- Please note that this project is released with a [Contributor Code of Conduct](https://inbo.github.io/camtrapdp/CODE_OF_CONDUCT.html). By participating in this project you agree to abide by its terms.

        

Citation (CITATION.cff)

# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "camtrapdp" in publications use:'
type: software
license: MIT
title: 'camtrapdp: Read and Manipulate Camera Trap Data Packages'
version: 0.5.0
doi: 10.32614/CRAN.package.camtrapdp
abstract: Read and manipulate Camera Trap Data Packages ('Camtrap DP'). 'Camtrap DP'
  (<https://camtrap-dp.tdwg.org>) is a data exchange format for camera trap data.
  With 'camtrapdp' you can read, filter and transform data (including to Darwin Core)
  before further analysis in e.g. 'camtraptor' or 'camtrapR'.
authors:
- family-names: Desmet
  given-names: Peter
  email: peter.desmet@inbo.be
  orcid: https://orcid.org/0000-0002-8442-8025
  affiliation: Research Institute for Nature and Forest (INBO)
- family-names: Govaert
  given-names: Sanne
  email: sanne.govaert@inbo.be
  orcid: https://orcid.org/0000-0002-8939-1305
  affiliation: Research Institute for Nature and Forest (INBO)
- family-names: Huybrechts
  given-names: Pieter
  email: pieter.huybrechts@inbo.be
  orcid: https://orcid.org/0000-0002-6658-6062
  affiliation: Research Institute for Nature and Forest (INBO)
- family-names: Oldoni
  given-names: Damiano
  email: damiano.oldoni@inbo.be
  orcid: https://orcid.org/0000-0003-3445-7562
  affiliation: Research Institute for Nature and Forest (INBO)
repository: https://CRAN.R-project.org/package=camtrapdp
repository-code: https://github.com/inbo/camtrapdp
url: https://inbo.github.io/camtrapdp/
date-released: '2026-01-13'
contact:
- family-names: Desmet
  given-names: Peter
  email: peter.desmet@inbo.be
  orcid: https://orcid.org/0000-0002-8442-8025
  affiliation: Research Institute for Nature and Forest (INBO)
keywords:
- camtrap-dp
- oscibio
- r
- r-package
- rstats
references:
- type: software
  title: 'R: A Language and Environment for Statistical Computing'
  notes: Depends
  url: https://www.R-project.org/
  authors:
  - name: R Core Team
  institution:
    name: R Foundation for Statistical Computing
    address: Vienna, Austria
  year: '2026'
  version: '>= 3.6.0'
- type: software
  title: cli
  abstract: 'cli: Helpers for Developing Command Line Interfaces'
  notes: Imports
  url: https://cli.r-lib.org
  repository: https://CRAN.R-project.org/package=cli
  authors:
  - family-names: Csárdi
    given-names: Gábor
    email: gabor@posit.co
  year: '2026'
  doi: 10.32614/CRAN.package.cli
- type: software
  title: dplyr
  abstract: 'dplyr: A Grammar of Data Manipulation'
  notes: Imports
  url: https://dplyr.tidyverse.org
  repository: https://CRAN.R-project.org/package=dplyr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
    orcid: https://orcid.org/0000-0003-4757-117X
  - family-names: François
    given-names: Romain
    orcid: https://orcid.org/0000-0002-2444-4226
  - family-names: Henry
    given-names: Lionel
  - family-names: Müller
    given-names: Kirill
    orcid: https://orcid.org/0000-0002-1416-3412
  - family-names: Vaughan
    given-names: Davis
    email: davis@posit.co
    orcid: https://orcid.org/0000-0003-4777-038X
  year: '2026'
  doi: 10.32614/CRAN.package.dplyr
- type: software
  title: EML
  abstract: 'EML: Read and Write Ecological Metadata Language Files'
  notes: Imports
  url: https://docs.ropensci.org/EML/
  repository: https://CRAN.R-project.org/package=EML
  authors:
  - family-names: Boettiger
    given-names: Carl
    email: cboettig@gmail.com
    orcid: https://orcid.org/0000-0002-1642-628X
  - family-names: Jones
    given-names: Matthew B.
    orcid: https://orcid.org/0000-0003-0077-4738
  year: '2026'
  doi: 10.32614/CRAN.package.EML
- type: software
  title: frictionless
  abstract: 'frictionless: Read and Write Frictionless Data Packages'
  notes: Imports
  url: https://docs.ropensci.org/frictionless/
  repository: https://CRAN.R-project.org/package=frictionless
  authors:
  - family-names: Desmet
    given-names: Peter
    email: peter.desmet@inbo.be
    orcid: https://orcid.org/0000-0002-8442-8025
    affiliation: Research Institute for Nature and Forest (INBO)
  - family-names: Oldoni
    given-names: Damiano
    email: damiano.oldoni@inbo.be
    orcid: https://orcid.org/0000-0003-3445-7562
    affiliation: Research Institute for Nature and Forest (INBO)
  - family-names: Huybrechts
    given-names: Pieter
    email: pieter.huybrechts@inbo.be
    orcid: https://orcid.org/0000-0002-6658-6062
    affiliation: Research Institute for Nature and Forest (INBO)
  - family-names: Govaert
    given-names: Sanne
    email: sanne.govaert@inbo.be
    orcid: https://orcid.org/0000-0002-8939-1305
    affiliation: Research Institute for Nature and Forest (INBO)
  year: '2026'
  doi: 10.32614/CRAN.package.frictionless
  version: '>= 1.2.1'
- type: software
  title: memoise
  abstract: 'memoise: ''Memoisation'' of Functions'
  notes: Imports
  url: https://memoise.r-lib.org
  repository: https://CRAN.R-project.org/package=memoise
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@rstudio.com
  - family-names: Hester
    given-names: Jim
  - family-names: Chang
    given-names: Winston
    email: winston@rstudio.com
  - family-names: Müller
    given-names: Kirill
    email: krlmlr+r@mailbox.org
  - family-names: Cook
    given-names: Daniel
    email: danielecook@gmail.com
  year: '2026'
  doi: 10.32614/CRAN.package.memoise
- type: software
  title: purrr
  abstract: 'purrr: Functional Programming Tools'
  notes: Imports
  url: https://purrr.tidyverse.org/
  repository: https://CRAN.R-project.org/package=purrr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
    orcid: https://orcid.org/0000-0003-4757-117X
  - family-names: Henry
    given-names: Lionel
    email: lionel@posit.co
  year: '2026'
  doi: 10.32614/CRAN.package.purrr
- type: software
  title: readr
  abstract: 'readr: Read Rectangular Text Data'
  notes: Imports
  url: https://readr.tidyverse.org
  repository: https://CRAN.R-project.org/package=readr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
  - family-names: Hester
    given-names: Jim
  - family-names: Bryan
    given-names: Jennifer
    email: jenny@posit.co
    orcid: https://orcid.org/0000-0002-6983-2759
  year: '2026'
  doi: 10.32614/CRAN.package.readr
- type: software
  title: rlang
  abstract: 'rlang: Functions for Base Types and Core R and ''Tidyverse'' Features'
  notes: Imports
  url: https://rlang.r-lib.org
  repository: https://CRAN.R-project.org/package=rlang
  authors:
  - family-names: Henry
    given-names: Lionel
    email: lionel@posit.co
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
  year: '2026'
  doi: 10.32614/CRAN.package.rlang
- type: software
  title: stringr
  abstract: 'stringr: Simple, Consistent Wrappers for Common String Operations'
  notes: Imports
  url: https://stringr.tidyverse.org
  repository: https://CRAN.R-project.org/package=stringr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
  year: '2026'
  doi: 10.32614/CRAN.package.stringr
- type: software
  title: uuid
  abstract: 'uuid: Tools for Generating and Handling of UUIDs'
  notes: Imports
  url: https://www.rforge.net/uuid
  repository: https://CRAN.R-project.org/package=uuid
  authors:
  - family-names: Urbanek
    given-names: Simon
    email: Simon.Urbanek@r-project.org
    orcid: https://orcid.org/0000-0003-2297-1732
  - family-names: Ts'o
    given-names: Theodore
    email: tytso@thunk.org
  year: '2026'
  doi: 10.32614/CRAN.package.uuid
- type: software
  title: jsonlite
  abstract: 'jsonlite: A Simple and Robust JSON Parser and Generator for R'
  notes: Suggests
  url: https://jeroen.r-universe.dev/jsonlite
  repository: https://CRAN.R-project.org/package=jsonlite
  authors:
  - family-names: Ooms
    given-names: Jeroen
    email: jeroenooms@gmail.com
    orcid: https://orcid.org/0000-0002-4035-0289
  year: '2026'
  doi: 10.32614/CRAN.package.jsonlite
- type: software
  title: lubridate
  abstract: 'lubridate: Make Dealing with Dates a Little Easier'
  notes: Suggests
  url: https://lubridate.tidyverse.org
  repository: https://CRAN.R-project.org/package=lubridate
  authors:
  - family-names: Spinu
    given-names: Vitalie
    email: spinuvit@gmail.com
  - family-names: Grolemund
    given-names: Garrett
  - family-names: Wickham
    given-names: Hadley
  year: '2026'
  doi: 10.32614/CRAN.package.lubridate
- type: software
  title: testthat
  abstract: 'testthat: Unit Testing for R'
  notes: Suggests
  url: https://testthat.r-lib.org
  repository: https://CRAN.R-project.org/package=testthat
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: hadley@posit.co
  year: '2026'
  doi: 10.32614/CRAN.package.testthat
  version: '>= 3.0.0'
- type: software
  title: tibble
  abstract: 'tibble: Simple Data Frames'
  notes: Suggests
  url: https://tibble.tidyverse.org/
  repository: https://CRAN.R-project.org/package=tibble
  authors:
  - family-names: Müller
    given-names: Kirill
    email: kirill@cynkra.com
    orcid: https://orcid.org/0000-0002-1416-3412
  - family-names: Wickham
    given-names: Hadley
    email: hadley@rstudio.com
  year: '2026'
  doi: 10.32614/CRAN.package.tibble
- type: software
  title: xml2
  abstract: 'xml2: Parse XML'
  notes: Suggests
  url: https://xml2.r-lib.org
  repository: https://CRAN.R-project.org/package=xml2
  authors:
  - family-names: Wickham
    given-names: Hadley
  - family-names: Hester
    given-names: Jim
  - family-names: Ooms
    given-names: Jeroen
    email: jeroenooms@gmail.com
  year: '2026'
  doi: 10.32614/CRAN.package.xml2

---

Owner metadata

• Name: Research Institute for Nature and Forest (INBO)
• Login: inbo
• Email:
• Kind: organization
• Description: Open source, data and science initiatives of the Research Institute for Nature and Forest (INBO)
• Website: http://www.inbo.be/en
• Location: Belgium
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/2735610?v=4
• Repositories: 125
• Last ynced at: 2023-03-24T19:36:08.712Z
• Profile URL: https://github.com/inbo

---

GitHub Events

Total

• Release event: 1
• Delete event: 23
• Member event: 1
• Pull request event: 37
• Issues event: 60
• Watch event: 2
• Issue comment event: 92
• Push event: 185
• Pull request review comment event: 16
• Pull request review event: 35
• Create event: 19

Last Year

• Release event: 1
• Delete event: 15
• Member event: 1
• Pull request event: 14
• Issues event: 28
• Issue comment event: 34
• Push event: 78
• Pull request review event: 18
• Pull request review comment event: 10
• Create event: 8

---

Committers metadata

Last synced: 3 days ago

Name	Email	Commits
Peter Desmet	p****t@i****e	468
Sanne Govaert	4****t	419
Pieter Huybrechts	4****H	106
Damiano Oldoni	d****i@i****e	94
Sanne Govaert	4****e	84
wolfmissotten	w****n@g****m	1
Josiah Parry	j****y@g****m	1

Committer domains:

• inbo.be: 2

---

Issue and Pull Request metadata

Last synced: 6 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/inbo/camtrapdp

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • cran: 603 last-month
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 4
• Total maintainers: 1

---

Dependencies

Score: 11.904832408479542