Skip to contents

suwo: access nature media repositories through R

suwo logo

suwo is intended streamline searching/downloading of nature media files (e.g. audios, photos) from online repositories.

suwo offers functions for critical steps in the acquisition of data necessary to develop methods that require a large amount of data.

The main features of the package are:

  • Obtaining media metadata from online repositories
  • Downloading associated media files
  • Updating data sets with new records

⚠️THE PACKAGE IS ON AN EARLY DEVELOPMENTAL STAGE AND WILL BE MODIFIED FREQUENTLY.⚠️

We are currently searching for new online repositories to be included in the package. Please open a new issue if you want to suggest a new repository.

Installing suwo

Install/load the package from CRAN as follows:

# From CRAN would be
# install.packages("suwo")

# load package
library(suwo)

To install the latest developmental version from github you will need the R package remotes:

remotes::install_github("maRce10/suwo")

#load package
library(suwo)

Intended use and responsible practices

The suwo package is designed exclusively for non-commercial, scientific purposes, including research, education, and conservation. Any commercial use of the data or media retrieved through this package is strictly prohibited unless explicit, separate permission is granted directly from the original source platforms and content creators. Users are obligated to comply with the specific terms of service and data use policies of each source database, which often mandate attribution and similarly restrict commercial application. The package developers assume no liability for misuse of the retrieved data or violations of third-party terms of service.

Take a look at the package vignette for an overview of the main features of the packages.

Citation

Please cite suwo as follows:

Araya-Salas, M., & Elizondo-Calvo, J. 2023. suwo: access nature media repositories through R. R package version 0.1.0.