crputils

Miscellaneous R utilities used by cetacean researchers in the PIFSC Protected Species Division.

What?! It’s an R package!!

Note: The name comes from the group formerly known as CRP (Cetacean Research Program) and to avoid immediate usage confusion, I will not be renaming the package (for now).

Installation

R-Universe

https://github.com/r-universe/pifsc-protected-species-division

Binary

install.packages('crputils', 
                 repos=c('https://pifsc-protected-species-division.r-universe.dev','https://cloud.r-project.org')
)

Source

You will need a C++ compiler for R

install.packages('crputils', type='source', 
                 repos=c('https://pifsc-protected-species-division.r-universe.dev','https://cloud.r-project.org')
)

GitHub

You will need a C++ compiler for R

remotes::install_github('pifsc-protected-species-division/crputils')

Components:

FLAC converter

See exampleWorkflows/workflow_flacConversion.R for an example script

Convert a directory of WAV files to FLAC

path_flac <- "" # will prompt to find path. e.g., 'C:/users/user.name/programs/flac-1.5.0-win/Win64/flac.exe'
inDir <- 'F:\\wavFiles'
outDir <- 'F:\\flacFiles\\' # must have final slash!
numCh <- 4 # number of channels. Optional, default is 1
wav2flac(path_flac, inDir, outDir, numCh)

Convert a directory of FLAC files to WAV

path_flac <- "" # will prompt to find path. e.g., 'C:/users/user.name/programs/flac-1.5.0-win/Win64/flac.exe'
inDir <- 'F:\\flacFiles'
outDir <- 'F:\\wavFiles\\' # must have final slash!
numCh <- 4 # number of channels. Optional, default is 1
flac2wav(path_flac, inDir, outDir, numCh)

Acoustic event summary report functions

Everything that starts with er_ is used in event summary creation.

Latitude/longitude format conversions

Functions to convert between different latitude/longitude formats. Includes:

• Decimal degrees (DD) TO degrees decimal seconds (DMM) or degrees minutes seconds (DMS)
• Degrees decimal minutes (DMM) TO decimal degrees (DD) or degrees minutes seconds (DMS)
• Degrees minutes seconds (DMS) TO decimal degrees (DD) or degrees decimal minutes (DMM)

See exampleWorkflows/workflow_latLonCov for example script to use these functions.

GPX creation

Functions to convert tables of lat/lon data to GPX files readable by Coastal Explorer

Disclaimer

This software package is developed and maintained by scientists at the NOAA Fisheries Pacific Islands Fisheries Science Center and should be considered a fundamental research communication. The recommendations and conclusions presented here are those of the authors and this software should not be construed as official communication by NMFS, NOAA, or the U.S. Dept. of Commerce. In addition, reference to trade names does not imply endorsement by the National Marine Fisheries Service, NOAA. While the best efforts have been made to insure the highest quality, tools such as this are under constant development and are subject to change.