sim_transmit: Simulate telemetry transmitter signals along a path

View source: R/sim_transmit.r

sim_transmitR Documentation

Simulate telemetry transmitter signals along a path

Description

'Modified from C. Holbrook by IDJ' Simulate tag signal transmission along a pre-defined path (x, y coords) based on constant movement velocity, transmitter delay range, and duration of signal.

Usage

sim_transmit(path = NA, delayRng = c(60, 180), burstDur = 5)

Arguments

path

A two-column data frame with at least two rows and columns x and y with coordinates that define path.

delayRng

A 2-element numeric vector with minimum and maximum delay (time in seconds from end of one coded burst to beginning of next).

burstDur

A numeric scalar with duration (in seconds) of each coded burst (i.e., pulse train).

vel

A numeric scalar with movement velocity along track; assumed constant.

Details

Delays are drawn from uniform distribution defined by delay range. First, elapsed time in seconds at each node in path is calculated based on path length and velocity. Next, delays are simulated and burst durations are added toeach delay to determine the time of each signal transmission. Location of each signal transmission along the path is linearly interpolated.

Value

A two-column data frame containing:

x

x coordinates for start of each transmission

y

y coordinates for start of each transmission

et

elapsed time to start of each transmission

Note

This function was written to be called before detect_transmissions, which was designed to accept the result as input (trnsLoc).

Author(s)

C. Holbrook cholbrook@usgs.gov

Examples

mypath <- data.frame(x=seq(0,1000,100),y=seq(0,1000,100))
mytrns <- transmit_along_path(mypath,vel=0.5,delayRng=c(60,180),burstDur=5.0)
plot(mypath,type="b")
points(mytrns,pch=20,col="red")


ianjonsen/simsmolt documentation built on July 11, 2022, 12:29 p.m.