Package: aniMotum 1.3-0

aniMotum: Fit Continuous-Time State-Space and Latent Variable Models for Quality Control of Argos Satellite (and Other) Telemetry Data and for Estimating Changes in Animal Movement

Fits continuous-time random walk, correlated random walk and move persistence state-space models for location estimation and behavioural inference from animal tracking data ('Argos', processed light-level 'geolocation', 'GPS'). Template Model Builder ('TMB') is used for fast random-effects estimation. The 'Argos' data can be: (older) least squares-based locations; (newer) Kalman filter-based locations with error ellipse information; or a mixture of both. The models estimate two sets of location states corresponding to: 1) each observation, which are (usually) irregularly timed; and 2) user-specified time intervals (regular or irregular). A track re-routing function is provided to adjust location estimates for known movement barriers. Track simulation functions are provided. Latent variable models are also provided to estimate move persistence from track data not requiring state-space model filtering.

Authors:Ian Jonsen [aut, cre, cph], W. James Grecian [aut, ctb], Toby Patterson [aut, ctb]

aniMotum_1.3-0.tar.gz
aniMotum_1.3-0.zip(r-4.7-x86_64)aniMotum_1.3-0.zip(r-4.7-arm64)aniMotum_1.3-0.zip(r-4.6-x86_64)aniMotum_1.3-0.zip(r-4.6-arm64)aniMotum_1.3-0.zip(r-4.5-x86_64)
aniMotum_1.3-0.tgz(r-4.6-x86_64)aniMotum_1.3-0.tgz(r-4.6-arm64)aniMotum_1.3-0.tgz(r-4.5-x86_64)aniMotum_1.3-0.tgz(r-4.5-arm64)
aniMotum_1.3-0.tar.gz(r-4.7-arm64)aniMotum_1.3-0.tar.gz(r-4.7-x86_64)aniMotum_1.3-0.tar.gz(r-4.6-arm64)aniMotum_1.3-0.tar.gz(r-4.6-x86_64)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
aniMotum/json (API)

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

Bug tracker:https://github.com/ianjonsen/animotum/issues

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

Uses libs:
  • c++– GNU Standard C++ Library v3
Datasets:
  • ellie - Southern elephant seal Argos satellite data
  • sese - Southern elephant seal Argos satellite data
  • sese2 - Southern elephant seal Argos satellite data
  • sese2_n - Southern elephant seal Argos satellite data
  • wese_sb - Weddell seal Argos satellite data

On CRAN:

Conda:

animal-movementanimal-trackingrandom-effects-modelstate-space-modelstmbcpp

8.07 score 50 stars 1 packages 81 scripts 23 exports 86 dependencies

Last updated from:cfe0b6755e. Checks:14 OK, 1 FAIL. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK428
linux-devel-x86_64OK557
source / vignettesOK495
linux-release-arm64OK406
linux-release-x86_64OK489
macos-release-arm64OK445
macos-release-x86_64OK742
macos-oldrel-arm64OK455
macos-oldrel-x86_64OK563
windows-devel-arm64OK681
windows-devel-x86_64OK654
windows-release-arm64OK669
windows-release-x86_64OK459
windows-oldrel-x86_64OK497
wasm-releaseFAIL239

Exports:aes_lstauto_crsemffit_mpmfit_ssmfmapformat_datagrabjoinmapmpm_controlosarroute_pathshare_controlsimsim_filtersim_fitsim_jcrwsim_postsimilarity_flagsimilarity_varsmru_hauloutssm_control

Dependencies:abindaskpassbootCircStatsclassclassIntclicpp11crsmetacurlDBIdeldirdplyre1071farvergenericsgeodistgeographiclibggplot2gluegmmgoftestgridExtragtablehttrisobandjsonliteKernSmoothlabelinglatticelifecyclemagrittrMASSMatrixmimemvtnormnlmeopensslpatchworkpillarpkgconfigpolyclipPROJproxypurrrR6rasterRColorBrewerRcppRcppEigenreprojrlangrnaturalearths2S7sandwichscalessfspspatstat.dataspatstat.explorespatstat.geomspatstat.randomspatstat.sparsespatstat.univarspatstat.utilsstringistringrsystensorterratibbletidyrtidyselectTMBtmvtnormtraipsetripunitsutf8vctrsviridisviridisLitewithrwkzoo

Map projections and your results
The short version | What aniMotum does by default | Why that reaches the parameter estimates | A worked example | Move persistence is affected too | Does this matter for my data? | What to do about it | Let fit_ssm() choose | Or choose one yourself | What this does not change

Last update: 2026-11-03
Started: 2026-11-03

Mapping
map() | Map an SSM fit to data, using default settings | Control track components | Change projection

Last update: 2024-02-06
Started: 2022-05-19

Move_persistence_models

Last update: 2024-02-06
Started: 2022-05-03

Overview
Disclaimer | Models | Data | Argos Least-Squares (LS) location data | Argos Kalman Filter (KF) location data | GPS location data | Light-level geolocation data | Projected location data | A mixture of location data types | Fitting a model | Custom data formats | Access results | Visualising a model fit | References

Last update: 2024-02-06
Started: 2022-05-19

SSM_fitting
Processing data | Fit an SSM | emf: specifying error multiplication factors | map: fixing model parameters | control: controlling the optimization | References

Last update: 2024-02-06
Started: 2022-04-26

SSM_validation
References

Last update: 2024-02-06
Started: 2022-04-26

Track_simulation
sim() | Simulate tracks from each of the 3 process models | Plot simulated tracks | Fit SSM to simulated lon,lat locations (with Argos error) | sim_fit() | Simulate tracks from an SSM fit and plot: | Simulate tracks with a potential function to help avoid land: | Simulate central place foraging tracks | sim_filter() | route_path() | Simulate tracks from the posterior of SSM fit(s) - sim_post() | References

Last update: 2024-02-06
Started: 2022-05-19

Path_rerouting
Example | route_path() | re-route Weddell seal SSM-predicted locations

Last update: 2022-12-09
Started: 2022-05-19

Readme and manuals

Help Manual

Help pageTopics
'aniMotum'aniMotum-package aniMotum
aes_lstaes_lst
Choose a projection from the extent of the dataauto_crs
Roxygen commandsdummy
Southern elephant seal Argos satellite data (1 individual, sub-sampled for testing speed)ellie
emfemf
fit a *Move Persistence Model* ('mpm')fit_mpm
Fit Continuous-Time State-Space Models to filter Argos satellite geolocation datafit_ssm
fmapfmap
Coerce input data into expected 'aniMotum' formatformat_data
grab 'tibble''s by name from a 'aniMotum' model objectgrab
join an mpm-estimated behavioural index to ssm-predicted locationsjoin
mapmap
Control Values for 'fit_mpm'.mpm_control
calculate one-step-ahead (prediction) residuals from a 'aniMotum' 'ssm' fitosar
plotplot.mpm_df
plotplot.osar
plotplot.sim
plotplot.sim_fit
plotplot.sim_post
plotplot.ssm_df
print one individual's part of a joint crw fitprint.jcrw_ssm
print one individual's part of a joint ssm fitprint.jmp_ssm
print 'aniMotum' fit object summary informationprint print.ssm
print a joint ssm fit summaryprint.summary.jssm_df
Re-route a movement path around land using the 'pathroutr' packageroute_path
Southern elephant seal Argos satellite data (3 individuals)sese
Southern elephant seal Argos satellite data (2 highly sub-sampled individuals)sese2
Southern elephant seal Argos satellite data (2 highly sub-sampled individuals)sese2_n
Specify which parameters are shared among individualsshare_control
simulate animal trackssim
Filter 'sim_fit' simulationssim_filter
simulate animal tracks from a 'ssm' fitsim_fit
Simulate tracks from the joint correlated random walksim_jcrw
simulate from the posterior of a 'ssm' fit.sim_post
Add a haulout indicator to tracking data from an SMRU haulout filesmru_haulout
Control Values for 'fit_ssm'.ssm_control
summarise a joint (hierarchical) ssm fitsummary.jssm_df
object summariessummary.ssm_df
Weddell seal Argos satellite data (1 individual)wese_sb