Package: tagtools 0.2.0

Stacy DeRuiter

tagtools: Work with Data from High-Resolution Biologging Tags

High-resolution movement-sensor tags typically include accelerometers to measure body posture and sudden movements or changes in speed, magnetometers to measure direction of travel, and pressure sensors to measure dive depth in aquatic or marine animals. The sensors in these tags usually sample many times per second. Some tags include sensors for speed, turning rate (gyroscopes), and sound. This package provides software tools to facilitate calibration, processing, and analysis of such data. Tools are provided for: data import/export; calibration (from raw data to calibrated data in scientific units); visualization (for example, multi-panel time-series plots); data processing (such as event detection, calculation of derived metrics like jerk and dynamic acceleration, dive detection, and dive parameter calculation); and statistical analysis (for example, track reconstruction, a rotation test, and Mahalanobis distance analysis).

Authors:Stacy DeRuiter [aut, cre, cph], Mark Johnson [aut, cph], David Sweeney [aut], Ye Joo McNamara-Oh [aut], Samuel Fynewever [aut], Racheal Tejevbo [aut], Tiago Marques [aut], Yuqian Wang [aut], Su Ogedegbe [aut]

tagtools_0.2.0.tar.gz
tagtools_0.2.0.zip(r-4.5)tagtools_0.2.0.zip(r-4.4)tagtools_0.2.0.zip(r-4.3)
tagtools_0.2.0.tgz(r-4.4-any)tagtools_0.2.0.tgz(r-4.3-any)
tagtools_0.2.0.tar.gz(r-4.5-noble)tagtools_0.2.0.tar.gz(r-4.4-noble)
tagtools_0.2.0.tgz(r-4.4-emscripten)tagtools_0.2.0.tgz(r-4.3-emscripten)
tagtools.pdf |tagtools.html
tagtools/json (API)
NEWS

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

Peer review:

Bug tracker:https://github.com/animaltags/tagtools_r/issues

Datasets:

On CRAN:

4.67 score 6 stars 26 scripts 207 downloads 81 exports 92 dependencies

Last updated 5 months agofrom:4c1a760803. Checks:OK: 7. Indexed: yes.

TargetResultDate
Doc / VignettesOKNov 12 2024
R-4.5-winOKNov 12 2024
R-4.5-linuxOKNov 12 2024
R-4.4-winOKNov 12 2024
R-4.4-macOKNov 12 2024
R-4.3-winOKNov 12 2024
R-4.3-macOKNov 12 2024

Exports:a2prabsorptionacc_wgs84add_ncapply_calblock_acfblock_meanblock_rmsbody_axesbuffercheck_AMclinecol_line3comp_filtcropcrop_allcrop_tocsv2structdecdcdeczdepth_ratedepth2pressuredetect_peaksdive_statsdraw_axisdsfeuler2rotmatextractextract_cuesfind_divesfir_nodelayfit_tracksfix_offset_3dfix_pressurehilbert_envhilbert_transformhtrackimage_irreginclinationinterp_naninterp2lengthinv_axisjulian_daylalo2llfload_ncm_distm2hmake_infomake_specgrammean_absorptionmedian_filtermerge_fieldsmetadata_editormsanjerknorm2ocdrodbaplottplott_baseprh_predictor1prh_predictor2ptrackread_catsrotate_datarotate_vecsrotation_testrotmat2eulerrough_cal_3dsave_ncsens_structsmoothsound_speedspectrum_levelspeed_from_depthspherical_caltag2animaltortuositytrack3Dundo_calzero_crossings

Dependencies:askpassbase64encbitbit64bootbslibcachemCircStatsclicliprcolorspacecowplotcpp11crayoncrosstalkcurldata.tabledigestdplyrevaluatefansifarverfastmapfontawesomefsgenericsggplot2gluegtablehighrhmshtmltoolshtmlwidgetshttrisobandjquerylibjsonliteknitrlabelinglaterlatex2explatticelazyevallifecyclelubridatemagrittrMASSmatlabMatrixmemoisemgcvmimemunsellncdf4nlmeopensslpillarpkgconfigplotlypracmaprettyunitsprogresspromisespurrrR6rappdirsRColorBrewerRcppreadrrlangrmarkdownsassscalessignalstringistringrsystibbletidyrtidyselecttimechangetinytextzdbutf8vctrsviridisLitevroomwithrxfunyamlzoozoom

Readme and manuals

Help Manual

Help pageTopics
Pitch and roll from accelerationa2pr
Calculates the absorption coefficient for sound in seawaterabsorption
Calculate total accelerationacc_wgs84
Save an item to a NetCDF or add one tag sensor or metadata variable to a NetCDF archive file.add_nc
Implement a calibration on tag sensor dataapply_cal
Set of sensor lists for a beaked_whalebeaked_whale
Compute autocorrelation functionblock_acf
Compute mean of sample blocksblock_mean
Compute RMS of sample blocksblock_rms
Generate the cardinal axes of an animalbody_axes
Buffers a signal vector into matrixbuffer
Compute field intensity of tag acceleration and magnetometer data.check_AM
Add colored line segments to a plotcline
Plot coloured line(s) in 3 dimensions with plot_lycol_line3
Complementary filtering of a signal.comp_filt
Interactive data cropping tool.crop
Reduce the time span of a datasetcrop_all
Reduce the time span of datacrop_to
Read tag metadata from csvcsv2struct
Reduce the sampling ratedecdc
Decimate sampling rate recursively.decz
Estimate the vertical velocitydepth_rate
Convert depth to pressuredepth2pressure
Detect peaks in signal vector datadetect_peaks
Compute summary statistics for dives or flightsdive_stats
Draw time axis on plott plot.draw_axis
Estimate the dominant stroke frequencydsf
Make a rotation (or direction cosine) matrixeuler2rotmat
Extract a sub-sample of dataextract
Extract multiple sub-samples of dataextract_cues
Find time cues for divesfind_dives
Delay-free filteringfir_nodelay
Integrate track with reference positionsfit_tracks
Estimate the offset in each axisfix_offset_3d
Correct a depth or altitude profilefix_pressure
Find matching researcher in a list of known tag researchersget_researcher
Find matching species in a list of marine mammalsget_species
Set of sensor lists for a harbor sealharbor_seal
Compute the envelope of X using Hilbert transform. Compute the envelope of the signal matrix X using the Hilbert transform. To avoid long transforms, this function uses the overlap and add method.hilbert_env
Return the Hilbert transform of a signalhilbert_transform
Simple horizontal dead-reckoned trackhtrack
Plot an image with an irregular grid.image_irreg
Estimate the inclination angleinclination
Remove NAs from sensor data and return indices of (rows of) filled valuesinterp_nan
Interpolate regularly sampled data to increase its sampling rate and match its length to another variable.interp2length
Identify invariant axis in triaxial movement measurements.inv_axis
Convert between dates and Julian day numbers.julian_day
Convert latitude-longitude track points into a local level framelalo2llf
Load a tag dataset from a netCDF file.load_nc
Calculate Mahalanobis distancem_dist
Heading from accelerometer and magnetometer datam2h
Make an info structure with tag metadatamake_info
Plot a spectrogram with default settingsmake_specgram
Calculate the mean absorption in salt watermean_absorption
Computes the nth-order median filtermedian_filter
Merge the fields of two listsmerge_fields
Edits a html file from given csv.metadata_editor
Compute MSAmsa
Compute the norm-jerknjerk
Compute the row-wise vector normnorm2
Estimate the forward speedocdr
Compute ODBAodba
Plot tag data time seriesplott
Plot tag data time seriesplott_base
Helper function for plottplott_static_panel
Predict the tag position on a diving animal from depth and acceleration dataprh_predictor1
Predict the tag position on a diving animal from depth and acceleration dataprh_predictor2
Estimate simple dead-reckoned trackptrack
Read a CATS data file and convert to .ncread_cats
Read a CSV file with sensor data from a CATS tagread_cats_csv
Rotate data.rotate_data
Rotate triaxial vector measurementsrotate_vecs
Carry out a rotation randomization test.rotation_test
Decompose a rotation (or direction cosine) matrixrotmat2euler
Estimate scale factors and offsetsrough_cal_3d
Save a tag dataset to a netCDF file.save_nc
Generate a sensor structure from a sensor data vector or matrix.sens_struct
Low pass filter a time seriessmooth
Sound speed estimationsound_speed
Compute the spectrum level of a signal x.spectrum_level
Estimate the forward speed of a diving animalspeed_from_depth
Deduce the calibration constantsspherical_cal
Tag-frame to animal-frame conversiontag2animal
Measure tortuosity indextortuosity
Reconstruct a track from pitch, heading and depth data, given a starting positiontrack3D
Undo calibrations stepsundo_cal
Find zero-crossings in a vectorzero_crossings