Package: yaps 1.2.5

Henrik Baktoft

yaps: Track Estimation using YAPS (Yet Another Positioning Solver)

Estimate tracks of animals tagged with acoustic transmitters. 'yaps' was introduced in 2017 as a transparent open-source tool to estimate positions of fish (and other aquatic animals) tagged with acoustic transmitters. Based on registrations of acoustic transmitters on hydrophones positioned in a fixed array, 'yaps' enables users to synchronize the collected data (i.e. correcting for drift in the internal clocks of the hydrophones/receivers) and subsequently to estimate tracks of the tagged animals. The paper introducing 'yaps' is available in open access at Baktoft, Gjelland, Økland & Thygesen (2017) <doi:10.1038/s41598-017-14278-z>. Also check out our cookbook with a completely worked through example at Baktoft, Gjelland, Økland, Rehage, Rodemann, Corujo, Viadero & Thygesen (2019) <doi:10.1101/2019.12.16.877688>. Additional tutorials will eventually make their way onto the project website at <https://baktoft.github.io/yaps/>.

Authors:Henrik Baktoft [cre, aut], Karl Gjelland [aut], Uffe H. Thygesen [aut], Finn Økland [aut]

yaps_1.2.5.tar.gz
yaps_1.2.5.zip(r-4.7)yaps_1.2.5.zip(r-4.6)yaps_1.2.5.zip(r-4.5)
yaps_1.2.5.tgz(r-4.6-x86_64)yaps_1.2.5.tgz(r-4.6-arm64)yaps_1.2.5.tgz(r-4.5-x86_64)yaps_1.2.5.tgz(r-4.5-arm64)
yaps_1.2.5.tar.gz(r-4.7-arm64)yaps_1.2.5.tar.gz(r-4.7-x86_64)yaps_1.2.5.tar.gz(r-4.6-arm64)yaps_1.2.5.tar.gz(r-4.6-x86_64)
yaps_1.2.5.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
yaps/json (API)

# Install 'yaps' in R:
install.packages('yaps', repos = c('https://benjaminhlina.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/baktoft/yaps/issues

Pkgdown/docs site:https://baktoft.github.io

Uses libs:
  • c++– GNU Standard C++ Library v3
Datasets:
  • dat_align - Example data for showcasing yaps function alignBurstSeq
  • ssu1 - Test data from Florida Bay

On CRAN:

Conda:

cpp

2.82 score 66 scripts 16 downloads 25 exports 38 dependencies

Last updated from:6a3f3bccba. Checks:11 WARNING, 2 OK. Indexed: no.

TargetResultTimeFilesSyslog
linux-devel-arm64WARNING222
linux-devel-x86_64WARNING258
source / vignettesOK252
linux-release-arm64WARNING216
linux-release-x86_64WARNING241
macos-release-arm64WARNING198
macos-release-x86_64WARNING416
macos-oldrel-arm64WARNING145
macos-oldrel-x86_64WARNING433
windows-develWARNING269
windows-releaseWARNING193
windows-oldrelWARNING200
wasm-releaseOK205

Exports:alignBurstSeqapplySynccheckInpcheckInpSyncfineTuneSyncModelgetBboxgetInpgetInpSyncgetSyncCoveragegetSyncModelgetToaYapsplotBboxplotSyncModelCheckplotSyncModelHydrosplotSyncModelResidsplotYapsprepDetectionsrunTmbrunYapssimHydrossimTelemetryTracksimToasimTrueTracktempToSstestYaps

Dependencies:bootcircularclicowplotcpp11data.tablefarverggplot2ggrepelgluegridExtragtableisobandlabelinglatticelifecyclemagrittrMatrixmvtnormnloptrplyrR6RColorBrewerRcppRcppEigenreshape2rlangS7scalesstringistringrtictocTMBvctrsviridisviridisLitewithrzoo

Readme and manuals

Help Manual

Help pageTopics
Align synced data with known burst sequencealignBurstSeq
Apply sync model to toa matrix to obtain synced dataapplySync
Check consistency of 'inp' object obtained from 'getInp()'checkInp
Check consistency of 'inp_sync' object obtained from 'getInpSync()'checkInpSync
Example data for showcasing yaps function alignBurstSeq()dat_align
Fine-tune an already fitted sync_model Wrapper function to re-run getSyncModel() using the same data, but excluding outliers. Note dimensions of data might change if eps_threshold results in empty rows in the TOA-matrix.fineTuneSyncModel
Get a standard bounding box to impose spatial constraintsgetBbox
Get prepared inp-object for use in TMB-callgetInp
Get object inp for synchronizationgetInpSync
Quick overview to check if all hydros have enough data within each offset period.getSyncCoverage
Get sync model from inp_sync object obtained by 'getInpSync()'getSyncModel
Build TOA matrix from synced data.table - also do some pre-filtering of severe MP, pruning loose ends etcgetToaYaps
Graphical representation of spatial constraintsplotBbox
Plot to check how well the sync model is workingplotSyncModelCheck
Plot hydrophone positions. Especially useful if some hydro re-positioned as part of the sync model.plotSyncModelHydros
Plot residuals of sync_model to enable check of modelplotSyncModelResids
Basic plots of yaps outputplotYaps
Experimental! Prepare detections data.table from raw data - csv-files exported from vendor softwareprepDetections
Function to run TMB to estimate trackrunTmb runYaps
Sim hydrophone array configurationsimHydros
Simulate telemetry track based on known true track obtained using simTrueTracksimTelemetryTrack
Sim TOA matrix for the supplied telemetryTracksimToa
Simulate a known movement track for subsequent estimation using YAPSsimTrueTrack
Test data from Florida Bayssu1
Calculate speed of sound from water temperature, salinity and depth Based on H. Medwin (1975) Speed of sound in water: A simple equation for realistic parameters. (https://doi.org/10.1121/1.380790)tempToSs
Test YAPS core functionalitytestYaps