This guide walks you through how to create, configure, run, and view an Event Details – Numeric Field Workflow in Ecoscope. This workflow is designed to analyze numeric values captured within events — such as herd size, group size, or quantities reported — rather than simply counting the number of events.
Instead of visualizing how often events occur, this workflow helps you understand how large, how intense, or how much was reported across events over time and space.
 

Results Dashboard

When an Event Details – Numeric Field Workflow is successfully run, it produces a dashboard with multiple components tailored to your configuration choices. The dashboard helps you visualize and analyze numeric event attributes, including totals, distributions, and spatial patterns.
The dashboard is the full results page generated by your workflow. It’s made up of widgets, individual panels such as maps, charts, tables, or filters  that update based on the data you selected during configuration.

The Dashboard May Display (depending on configuration):

• Map Widgets
  • Group Size by Category Locations – Displays event locations, with point size scaled by the numeric field value and colors representing category choices (if configured).
  • Numeric Field Density Map – Displays a heatmap where events are binned into grid cells, and each cell represents the sum of the numeric field values for all events within that cell, rather than simply the count of events.

•  
• Chart Widgets
  • Group Size Over Time – A bar chart showing the sum of the numeric field over time (by month). If a category field was selected, bars are stacked by category, allowing you to compare how each category contributes to the total over time.
  • Proportion of Group Size by Category – A pie chart showing how the numeric field is distributed across category choices (if configured).

• Tables
  • Event Count – Displays the total number of events included in the workflow.
  • Group Size Summary Table – Displays summary statistics for the numeric field across all events:
    • Sum
    • Minimum
    • Maximum
    • Median
    • Mean
  • Events Table – A detailed table including:
    • Reported To
    • Reported At
    • Reported By
    • Latitude
    • Longitude
    • Priority
    • Numeric Field Value (e.g., Group Size)
    • Category Field Value (e.g., Herd Type)
       

• Dashboard Features
  • Filter results based on grouping criteria defined during configuration.
  • Toggle between grouping views (when applicable).
  • Rearrange dashboard widgets to suit your preferred layout.
  • Download individual widgets (maps and charts) as PNG images using the camera icon on each panel.
     

Configure New Workflow

To create an Event Details – Numeric Field Workflow, go to Workflow Templates from the top navigation and select Event Details – Numeric Field Workflow.

Data Source

Select the data source that provides your events.
If only one data source is configured, it will be selected automatically and cannot be changed.
If no data source is configured, you will not be able to proceed.

Select Event Type

Unlike other workflows, this workflow includes an additional configuration step.
After selecting a data source, you must select a specific Event Type to analyze.

• The selected event type will appear pre-selected and greyed out in the main configuration form.
• This workflow can only analyze one event type at a time, as the available numeric and category fields depend on the event schema.
• If you need to analyze a different event type, you can return to this step Select Event Type) and make a new selection before continuing.

Workflow Details

This section allows you to name and describe your workflow so it’s easy to identify later.

• Workflow Name – Must be unique. Duplicate names will trigger a validation error.
• Workflow Description – Optional. Displayed on the dashboard to provide context for the analysis.

Time Range

This section defines the time window of the data you want to analyze. The selected time range determines how much data will be pulled from your data source and directly impacts what’s displayed on your dashboard. 
You will configure: 

• Since – Start date and time
• Until – End date and time
• Timezone – Required to provide fidelity over precise time selection

Tip: Very large time ranges will pull more data and may increase processing time. Consider breaking long periods into smaller workflows for faster results and clearer dashboards.

Event Type Details

This section defines what numeric data will be analyzed from the selected event type.

Numeric Field to Analyze
Select the numeric field the workflow will use for calculations.

• The workflow will calculate the sum of this field across all events.
• This field is also used to scale map point sizes and generate summary statistics.

Label for Analysis Data
Provide a label that will be used across the dashboard to describe the numeric field. This label appears in:

• Chart titles and axes
• Table column headers
• Map legends and tooltips

Units
Specify what the numeric values represent (for example: individuals, animals, kilograms).
Units are displayed in the following places:

• Map legends, including:
  • The Numeric Field Density Map
  • The Events Map when no category field is selected
• Chart and map tooltips, when hovering over data points

Units are not displayed in:

• Summary or events tables
• Widget titles or headers

Providing clear units helps ensure numeric values are interpreted correctly when exploring maps and interactive visualizations.

This helps clarify results across the dashboard.

Category Field (Optional)

If the selected event type uses a v2 schema and includes one or more choice fields, you can optionally categorize events.

Category Field

Select a choice field to differentiate events by category (for example: herd type).

• Each choice will be represented by a different color in maps and charts.
• If the event type uses a v1 schema, or contains no choice fields, this section will be hidden.
   

Label for Category Data
Provide a label that will be used to describe category values in dashboard outputs.
 

Include Events Without Geometry

Enable this option to include events that do not have a point or polygon geometry.

• These events will be included in tables and summary statistics.
• They will not appear on maps.
   

Advanced Configuration Options

The following sections appear after the core workflow settings. Ecoscope provides sensible defaults, and you do not need to adjust these options to generate a complete dashboard.

Adjust these settings if you want to:

• Fine-tune map appearance
• Customize the density map behavior
   

Map Base Layers (Advanced)

Control which basemaps are displayed in map widgets.

• Multiple basemaps can be layered.
• The first basemap is drawn first; the last is drawn on top.
• Adjust opacity to control visibility.

Default: Terrain basemap with Satellite overlay at 50% opacity.

Available options include:

• OpenStreetMap
• Roadmap
• Satellite
• LandDx
• USGS Hillshade
• Custom Layer
   

Numeric Field Density Map (Advanced)

This section controls how the density map is calculated and displayed.

• Auto Scale (default) – Ecoscope automatically selects the grid resolution.
• Custom – Manually define the grid cell size.

Unlike the Events Workflow, this density map:

• Sums the numeric field value within each grid cell
• Does not count the number of events

For example, the map may show the total number of animals observed in an area, rather than the number of sightings.
 

Submit the Workflow

When all required fields are complete, click Submit.

If any inputs are missing or invalid, the form will indicate what needs to be corrected.

Run the Workflow

After submission, you’ll be returned to the My Workflows view. Your new workflow will appear in the list with:

In the table, your workflow will show:

• Status: Ready
• No values yet for Last Run Start or Last Run Duration
• A Run button will be available

Click Run to begin processing. The status will change to Running.

Note: Processing time depends on the time range and the amount of event data. Large queries may take up to 10 minutes. 

If the workflow fails, the status will show Failed. Refer to the Common Errors and Causes in case this happens to you. 

View the Dashboard

Once the workflow finishes (status: Success), click the workflow name to open the dashboard.

Explore your maps, toggle between grouped views, and download PNGs of any map or chart for reports or presentations.