Skip to content

ctmm-initiative/ctmmMoveApp_akde

Repository files navigation

Autocorrelated Kernel Density Estimate (aKDE)

MoveApps

Github repository: https://github.com/ctmm-initiative/ctmmMoveApp_ctmm_akde/

Description

Calculate an autocorrelated kernel density estimate of your tracked animals' home-ranges from a fitted continuous time movement model (ctmm).

Documentation

This app is part of a ctmm-workflow. It requires that a fitted ctmm model is calculated using the Fit a Continuous-Time Movement Model (ctmm) App before running it.

Autocorrelacted kerned density estmates (aKDEs) are estimates of resident animals' range distribution that take into account the autocorrelation of telemetry/tracking data via autocorrelated kernel density estimation. Please see the AKDE vignette or the publication about the ctmm pacakge and aKDEs for further details.

ATTENTION: The preceding App Fit a Continuous-Time Movement Model (ctmm) can have a long run time (hours). Consider pinning this app for further workflow runs. Subsequent apps like Autocorrelated Kernel Density Estimate (aKDE) and Estimate Occurrence Distribution (Kriging) with interactive user interface (once the app has run a button "OPEN APP UI" appears) can only be accessed for 8 hours (afterwards the "OPEN APP UI" is not visible anymore). To get again access to it, the workflow has to be run again. BUT before doing this, pin the workflow to the Fit a Continuous-Time Movement Model (ctmm) (menu at the top right corner of the App - "Pin to this App") to avoid the long run time again. An app can only be pinned once it has run and produced results.

Input data

The app requires a ctmm model with data as input.

Output data

ctmm UD with Data and Model including the akde UD for all tracks

Artefacts

homerange.gpkg: A geopackage with the calculated akde home ranges.

akde_summary.csv: Summary of the calculated home ranges. The table contains the following columns: id the name of the animal, level the isopleth level, unit the unit of the home-range area, the estimated home-range area (est) at a given isopleth level (as chosen above, the default is 0.95) and the lower (low) and upper (high) 95 % confidence interval.

uds.zip: A zipped archive of individual utilization distributions (UDs).

Settings

Isopleth level: Coverage level of the utilization distribution area. I.e., the 50% core home range would be given by level of 0.50.

What do you want to see?: Allows the user to select if only the estimated home-range or also lower and upper confidence interval should be displayed.

Opacity: The opacity of the estimated home range on the map.

Remove all animals from map: This button will remove all home-ranges from the map. They can be added individually again.

Store settings: click to store the current settings of the app for future workflow runs.

Most common errors

Please make an issue here if you repeatedly encounter a specific error.

Null or error handling