MigConnectivity package

Jeffrey A. Hostetler, Michael T. Hallworth

2024-03-25

Welcome to the MigConnectivity package! We hope you find it helpful. A growing number of tools are available for studying the seasonal distributions of migratory animals across the annual cycle including individual tracking, assignments quantifying range-wide migratory connectivity patterns. However, integrating data types requires methods that account for the differences in sampling and differences in the precision and bias inherent to each data type. The MigConnectivity package provides tools for estimating the pattern and strength of migratory connectivity between two or more phases of the annual cycle. We developed methods to integrate intrinsic marker, tracking, and band reencounter data collected from the same or different individuals. We added functionality to integrate analyses that account for differences among seasonal assignment from different data types (banding reencounter, light-level geolocator, stable isotopes in tissues, genetics, and GPS) in precision, bias, reencounter probability, and directionality (i.e., combining breeding to nonbreeding and nonbreeding to breeding).

The MigConnectivity package allows the user to estimate or calculate transition probabilities for migratory animals between any two phases of the annual cycle, using a variety of different data types, with the function estTransition. The user can also estimate or calculate the strength of migratory connectivity (MC), a standardized metric to quantify the extent to which populations co-occur between two phases of the annual cycle. MC is independent of data type and accounts for the relative abundance of populations distributed across a seasonal range. The package includes functions to estimate MC (estStrength) and the more traditional metric of migratory connectivity strength (Mantel correlation; rM; estMantel) incorporating uncertainty from multiple sources of sampling error. We have several vignettes to help you navigate the package:

  1. Worked examples of processing data
  2. The estTransition function estimates migratory connectivity patterns (ψ, transition probabilities) from seasonal movement data (Hostetler et al. n.d.)
  3. The estStrength function estimates the strength of migratory connectivity (MC) from transition probabilities and relative abundances (Cohen et al. 2018, Roberts et al. 2023)
  4. The diffMC function compares MC for two or more taxa (Cohen et al. 2019)
  5. Simulating and working with isotope data can be tough, so check out this vignette if you need to do one of those (Cohen et al. 2019)
  6. Finally, we have an older vignette that this master vignette replaces, which includes lots of examples, but doesn’t include the more recent functions. See our older functionality vignette

Literature Cited

Cohen, E. B., J. A. Hostetler, M. T. Hallworth, C. S. Rushing, T. S. Sillett, and P. P. Marra. 2018. Quantifying the strength of migratory connectivity. Methods in Ecology and Evolution 9:513–524.
Cohen, E. B., C. R. Rushing, F. R. Moore, M. T. Hallworth, J. A. Hostetler, M. G. Ramirez, and P. P. Marra. 2019. The strength of migratory connectivity for birds en route to breeding through the Gulf of Mexico. Ecography 42:658–669.
Hostetler, J. A., E. B. Cohen, C. M. Bossu, A. L. Scarpignato, K. C. Ruegg, A. J. Contina, C. S. Rushing, and M. T. Hallworth. (n.d.). Challenges and opportunities for data integration to improve estimation of migratory connectivity.
Roberts, A., A. L. Scarpignato, A. Huysman, J. A. Hostetler, and E. B. Cohen. 2023. Migratory connectivity of North American waterfowl across administrative flyways. Ecological Applications 33:e2788.