wildlife-dynamics/mep-subject-tracking

Wildlife subject tracking workflow for collared elephant monitoring in Kenya. Generates speed maps, home range (ETD/MCP), and seasonal movement analyses from EarthRanger GPS data. Computes protected area occupancy and outputs per-subject reports and an interactive dashboard. # MEP Subject Tracking — User Guide This guide walks you through configuring and running the MEP Subject Tracking workflow, which ingests GPS telemetry from EarthRanger, derives movement ecology metrics via Google Earth Engine, and produces a comprehensive per-subject tracking report for collared wildlife in the Mara ecosystem. --- ## Overview The workflow delivers, for each subject in the selected group: - **3 maps** — speed map, ETD home range map, and seasonal home range map with MCP overlay - **4 time-series plots** — Net Square Displacement (NSD), speed, collar event timeline, and MCP asymptote - **10 dashboard metrics** — protected area use, agricultural land use, Kenya use, unprotected use, MCP area, ETD area, distance travelled, max displacement, and night/day ratio - **4 CSV tables** — subject info, movement stats, occupancy, and seasonal windows - A **Word mapbook** — cover page plus one fully populated section per subject --- ## Prerequisites Before running the workflow, ensure you have: - Access to an **EarthRanger** instance with subject group observations and MEP collar events logged for the analysis period - Access to a **Google Earth Engine** service account with a private key in JSON format --- ## Step-by-Step Configuration ### Step 1 — Add the Workflow Template In the workflow runner, go to **Workflow Templates** and click **Add Workflow Template**. Paste the GitHub repository URL into the **Github Link** field: ``` github.com ``` Then click **Add Template**. --- ### Step 2 — Configure Connection Navigate to **Data Sources** and click **Connect**. A dialog will appear prompting you to **Select Data Source Type**. This workflow requires two connections: | Data Source Type | Purpose | |-----------------|---------| | **EarthRanger** | Pull subject group observations, metadata, and MEP collar events | | **Google Earth Engine** | Compute NDVI-based wet/dry seasonal windows per subje …