tagtools (version 0.2.0)

read_cats: Read a CATS data file and convert to .nc

Description

Read a .csv file with data from a CATS tag deployment, including associated metadata, and store the resulting data in a .nc file.

Usage

read_cats(fname, depid)

Value

A string (constructed by: 'depid_raw.nc'; for example, 'mn12_186a_raw.nc') containing the file name of the netCDF (.nc) file in which the output has been saved. This function generates a netCDF file in the current working directory containing the tag data variables, including:

• A, Accelerometer data structure

• M, Magnetometer data structure

• temp, Temperature sensor data structure

• info Information structure for the deployment

Arguments

fname

is the file name of the CATS CSV file including the complete path name if the file is not in the current working directory or in a directory on the path. The .csv suffix is optional.

depid

is a string containing the deployment identification code assigned to this deployment, for example, 'mn12_186a'.

Examples

if (FALSE) {
nc_filename <- read_cats("my_cats_file.csv", "my_cats_deplyment_name")
load_nc("my_cats_deployment_name_raw.nc")
}