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

read_cats(fname, depid)

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'.

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

  • T, Temperature sensor data structure

  • info Information structure for the deployment

Note

CATS loggers can produce very large csv files which are slow to process. This function is (somewhat) optimised for speed and memory use so will tolerate large files. But processing could be slow.

Examples

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