addHydrophoneDepth: Add Hydrophone Depth Data to an AcousticStudy

Description Usage Arguments Details Value Author(s) Examples

View source: R/addHydrophoneDepth.R

Description

Add hydrophone depth to an AcousticStudy or AcousticEvent

Usage

1
addHydrophoneDepth(x, depth = NULL, depthCol = NULL, thresh = 60, ...)

Arguments

x

an AcousticStudy to add depth data to

depth

a data frame of depth values to match to data from x. Must have column UTC, and a column containing depth data to be specified by depthCol. If not provided and x is an AcousticEvent or AcousticStudy object, then the depth data will be read from the databases contained in the files slot of x

depthCol

the name of the column containing depth in the dataframe or database. If left as NULL, will search for a single column containing the word "depth" or "Depth"

thresh

maximum time apart in seconds for matching depth to data, if the closest value is more than thresh apart then the depth value will be set to NA

...

additional arguments for other methods

Details

Depth values will be matched to the data by using data.table's rolling join with roll='nearest'. After the join is done, the time difference between the matched rows is checked and any that are greater than the set threshold are set to NA. This is done to prevent accidentally matching weird things if an incomplete set of depth data is provided.

If x is an AcousticEvent or AcousticStudy, then depth can be omitted and will be read from the databases contained in the files slot of x.

Value

the same data as x, with depth data added. All AcousticEvents will have depth data added to all detector dataframes

Author(s)

Taiki Sakai taiki.sakai@noaa.gov

Examples

1
2
3
4
5
6
data(exStudy)
# need to update database file to local directory
db <- system.file('extdata', 'Example.sqlite3', package='PAMpal')
exStudy <- updateFiles(exStudy, db=db, bin=NA, verbose=FALSE)
exStudy <- addHydrophoneDepth(exStudy)
getClickData(exStudy[1])

PAMpal documentation built on Oct. 10, 2021, 1:06 a.m.