/animaltracker

Visualize and analyze GPS data for cows (and other animals).

Primary LanguageHTML

Animal Tracker

Overview

This is a repository for an R package with data management and visualization tools for GPS and accelerometer data for tracking animals (e.g., cows). Includes two Shiny Apps to visualize and analyze the associated spatial-temporal data.

Please refer to the PDF manual for detailed information on function usage.

Core Features

Dynamic User Interface and Data

The Animal Tracker app ships with demo data included. Or, conveniently upload your own .csv or .txt animal data files in a zip folder. There is an option for the app to filter bad data points after files are uploaded.

image

By default, the elevation lookup is bounded by the maximum/minimum latitude and longitude determined from parsing the uploaded data, but the bounds can be modified manually. Similarly, the zoom level defaults to the current map zoom, but can also be changed manually to values from 1-14. Click on the checkboxes to include slope and aspect with elevation.

image

Use the dropdown selections to filter by site, animal, or date range. The app features will dynamically update based on your selections, and the filtered data is also available as a download.

image

Dynamic Map

In addition, Animal Tracker can visualize the terrain from your animal data. Toggle between point and heatmap views, or overlay both. Draw a rectangle to select a particular region.

image

image

Dynamic Plots

Animal Tracker also visualizes and compares your animals' behaviors. Plots include elevation over time by animal and number of points in the sample by animal as well as rate of travel by animal and total time spent by location (not shown).

image

Dynamic Statistics

The app comes with a statistical summary utility to complement the visualizations. Choose between elevation, time difference between GPS measurements, course, course difference between GPS measurements, distance, and rate to summarize. Then, select from sample size, mean, median, standard deviation, variance, minimum value, maximum value, range, interquartile range, first quartile, and third quartile statistics.

image

Additional Features

Validation App

Compare and visualize two datasets side-by-side with the validation app. Try the app with the included demo datasets, or upload your own .csv files (.txt is not yet supported).

image

Outlier detection can also be applied. We currently support modified z-score classification according to Iglewicz and Hoaglin (1993).

image

Furthermore, summary statistics are provided for flagged data from the app's outlier detection or a method already applied to the data before upload.

image

Usage

Installation in R

This app can be installed and run through RStudio (or the basic R console).

devtools

Before installing Animal Tracker, ensure that you have the devtools package installed and loaded:

install.packages("devtools") 
library(devtools)

animaltracker

Install and load animaltracker by running the following:

install_github("mathedjoe/animaltracker")
library(animaltracker) 

Core Shiny App

Launch the core shiny app by running the following :

run_shiny_animaltracker()

Validation Shiny App

Launch the validation shiny app by running the following:

run_validation_app()

Questions

Email joechampion@boisestate.edu.

Contributors