naturecounts

R package to access data from the NatureCounts platform by Bird Studies Canada.
https://github.com/birdscanada/naturecounts

Category: Biosphere
Sub Category: Avian Monitoring and Analysis

Keywords from Contributors

transforms measur archiving generic optimize compose animals conversion observation projection

Last synced: about 19 hours ago
JSON representation

Repository metadata

R package to access data from the NatureCounts platform by Bird Studies Canada

• Host: GitHub
• URL: https://github.com/birdscanada/naturecounts
• Owner: BirdsCanada
• Created: 2019-01-24T21:25:11.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-04-07T19:56:06.000Z (about 1 month ago)
• Last Synced: 2025-05-09T02:39:22.626Z (9 days ago)
• Language: R
• Homepage: https://birdscanada.github.io/naturecounts/
• Size: 370 MB
• Stars: 16
• Watchers: 3
• Forks: 4
• Open Issues: 13
• Releases: 4
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md

README.Rmd

          ---
output: github_document
---
 


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


[![lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
[![R-CMD-check](https://github.com/BirdsCanada/naturecounts/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/BirdsCanada/naturecounts/actions/workflows/R-CMD-check.yaml)
![r-universe](https://birdscanada.r-universe.dev/badges/naturecounts)


Access and download data on plant and animal populations from various databases through NatureCounts, a service managed by Birds Canada.

See tutorials, documentation and articles on the [naturecounts package Website](https://birdscanada.github.io/naturecounts)

## Installation

You can install the main version of `naturecounts` from our R-Universe

```{r eval = FALSE}
install.packages("naturecounts", 
                 repos = c(birdscanada = 'https://birdscanada.r-universe.dev',
                           CRAN = 'https://cloud.r-project.org'))
```

## Usage

```{r}
library(naturecounts)
```

### Fetching counts

Use the `nc_count()` function to return collections and the number of observations in each for which you have access (here returns all collections associated with username **sample**).

```{r}
nc_count(username = "sample")
```

Use the `show = "all"` argument to show counts for all collections available (public or otherwise).

```{r}
nc_count(show = "all") %>%
  head()
```

### Fetching data

Fetch all observations of bittern which are available to user **sample** into a local data frame.

First find the species id
```{r}
search_species("American Bittern")
```

Use this id with `nc_data_dl()`. The `info` parameter is a short description of what the data is being downloaded for.
```{r}
bittern <- nc_data_dl(species = 2490, username = "sample", 
                    info = "readme_example")
```

Alternatively, save the downloaded data as a SQLite database (`bittern`).
```{r}
bittern <- nc_data_dl(species = 2490, sql_db = "bittern", username = "sample", 
                    info = "readme_example")
```

```{r cleanup, include = FALSE}
file.remove("bittern.nc")
```

### Authorizations

To access private/semi-public projects/collections you must [sign up](https://www.birdscanada.org/birdmon/default/profile.jsp) for a free NatureCounts account and [register](https://www.birdscanada.org/birdmon/default/projects.jsp) for the projects you'd like to access. Once registered, you can use the `username` argument (you will be prompted for a password) for both `nc_count()` and `nc_data_dl()`, which will then return a different set of records.

```{r, eval = FALSE}
nc_count(username = "my_user_name")
bittern <- nc_data_dl(species = 2490, username = "my_user_name", info = "readme_example")
```

### More advanced options

`nc_count()` and `nc_data_dl()` have a variety of arguments that allow you to filter the counts/data prior to downloading. These options include `collections`, `species`, `years`, `doy` (day-of-year), `region`, and `site_type` (users can specify up to 3 of these). For `nc_data_dl()` you have the additional arguments `fields_set` and `fields` with which you can customize which fields/columns to include in your download.

See the function examples ([`nc_count()`](https://birdscanada.github.io/naturecounts/reference/nc_count.html), [`nc_data_dl()`](https://birdscanada.github.io/naturecounts/reference/nc_data_dl.html)) the following articles for more information on these filters:

- Collections
- [Species Codes](https://birdscanada.github.io/naturecounts/articles/species-codes.html)
- [Regional Codes](https://birdscanada.github.io/naturecounts/articles/region-codes.html)
- [IBAs and BCRs (regions)](https://birdscanada.github.io/naturecounts/articles/region-areas.html)
- [Using spatial data to filter observations](https://birdscanada.github.io/naturecounts/articles/region-spatial.html)

We also have an [article on post-filtering your data](https://birdscanada.github.io/naturecounts/articles/filtering-data.html)

### Metadata

NatureCounts includes a great deal of metadata which can be accessed through the functions with the `meta_` prefix. See the [Meta Documentation](https://birdscanada.github.io/naturecounts/reference/meta.html) for specifics.

        

---

Owner metadata

• Name: Birds Canada
• Login: BirdsCanada
• Email:
• Kind: organization
• Description: Together, we are Canada's voice for birds
• Website: https://www.birdscanada.org
• Location: Canada
• Twitter: birdscanada
• Company:
• Icon url: https://avatars.githubusercontent.com/u/39635484?v=4
• Repositories: 4
• Last ynced at: 2023-03-08T23:42:40.665Z
• Profile URL: https://github.com/BirdsCanada

---

GitHub Events

Total

• Issues event: 7
• Watch event: 1
• Issue comment event: 16
• Push event: 84
• Pull request event: 1
• Create event: 1

Last Year

• Issues event: 7
• Watch event: 1
• Issue comment event: 16
• Push event: 84
• Pull request event: 1
• Create event: 1

---

Committers metadata

Last synced: 7 days ago

Name	Email	Commits
Steffi LaZerte	s****i@s****a	394
Dimitrios Markou	d****u@b****g	26
dependabot[bot]	4****]	2
denislepage	d****e@b****g	2

Committer domains:

• bsc-eoc.org: 1
• birdscanada.org: 1
• steffi.ca: 1

---

Issue and Pull Request metadata

Last synced: 2 days ago

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

---

---

---

Dependencies

Score: 4.7535901911063645