Ecoscope is a modular data analysis platform designed for conservation and environmental applications. It enables technical users like data analysts, researchers, and advanced field teams to build and run visual, repeatable workflows for understanding animal movements, patrol activities, and events across landscapes.
At its core, Ecoscope provides ready-to-use workflow templates that automatically pull data from data sources like EarthRanger and generate dashboards filled with maps, graphs, and key insights by simply filling out a form.
Before you can use any workflows, you must configure at least one data source. See Data Sources below.
Overview
When you log into Ecoscope you’ll see a navigation bar with three key sections:
- My Workflows (default view)
- Workflow Templates
- Data Sources
My Workflows
This is your personalized workspace. Here you'll find any workflows you've created or configured.
Each row in the table represents a saved workflow. The following columns are displayed:
| Name | |
| Template |
The base workflow type (e.g., Subject Tracking, Events, Patrols). Also shows the template version (e.g., v1.2). Important: If a workflow was created with an older major version (e.g., v1.x) and the template is upgraded to a new major version (e.g., v2.0), that workflow may no longer be runnable or “Run Again”-able. However, its existing results will still be viewable.
|
| Status | Operational status (e.g., Ready, Running, Failed). |
| Last Run Start | |
| Last Run Duration |
Duration of the most recent run.
|
When a workflow is ready to execute, a Run button will appear. Clicking it will launch the workflow and generate results according to its configuration.
Workflow Options Menu
Each workflow has a dropdown menu with the following options:
- Run Again – Re-runs the workflow exactly as configured. Useful for retrying failed workflows due to intermittent issues, or re-processing with the same parameters.
- View Metadata – Opens a full JSON view of the configuration and parameters used to generate the workflow. This is particularly helpful for debugging or submitting support tickets.
- Duplicate – Copies the workflow to use as a base for a new one.
-
Edit – Opens the configuration panel to modify the workflow setup.
Editing a workflow that has previously run successfully will overwrite its results upon saving. You will be asked to confirm the edit to prevent accidentally overwriting older results. - Delete – Permanently removes the workflow from your list.
- Advanced Run – Opens expert-level execution settings (e.g., async modes, timeout configs). Only recommended for advanced users who understand system-level parameters.
Advanced Run (For Experts Only)
The Advanced Run panel allows configuration of underlying execution logic. Use with caution.
- Execution Mode:
sequentialorasync - Trigger Mode:
apiorpubsub - Timeout: Specify timeout settings manually (e.g.,
Mockiofor test runs)
These settings are intended for expert users. Misconfiguration may cause workflow failure or data inconsistencies.
Workflow Templates
Navigate to the Workflow Templates tab to start a new workflow from a predefined structure.
Reminder: You must configure a data source before you can create a new workflow.
Available Templates
- Subject Tracking – For analyzing GPS movement and telemetry data.
- Events – For reviewing incidents, alerts, and automated triggers.
- Patrols – For visualizing ranger activity, route coverage, and operational patterns.
Click a template to begin customizing your workflow.
Data Sources
Before you can create and run any workflow in Ecoscope, you must first configure at least one data source.
Data sources provide the underlying data used by your workflows—such as GPS tracks, event logs, or patrol records. Currently, EarthRanger is the only data source supported in Ecoscope, with additional integrations planned.
If you haven’t connected a data source yet, workflow creation will be disabled. For a complete walkthrough, see: Configuring Data Sources in Ecoscope