Subjects in EarthRanger represent the entities being tracked, such as an elephant named Horton or a helicopter identified as Focke-Wulf. This guide outlines how to add, view, edit, and manage subjects effectively within the EarthRanger Administration interface.
Managing Subjects
To manage subjects:
- Navigate to Home > Observations > Subjects in the EarthRanger Administration interface.
- Use this page to view all subjects and their basic details.
Viewing and Editing Subject Details
On the Subjects page, you can view each subject's key attributes. For detailed settings:
- Select a subject name from the list
(e.g., Patrol Boat). - The subject’s details page displays additional editable settings.
Subject Settings Overview
Each subject includes the following settings:
-
ID: A unique, non-editable identifier
(e.g., 000c5333-7e08-4b69-8332-cb9b4ec2460d). -
Name: A custom name for the subject
(e.g., Horton or Fucke-Wulf). -
Subject Subtype: A dropdown of existing descriptive categories
(e.g., Elephant (Wildlife)). - Active: Indicates if the subject is visible on the map and in layers.
-
Common Name: A general name for the subtype
(e.g., White Rhino). - Groups: Lists any existing Subject Groups that can be assigned to the selected subject.
- Subject Attributes: Includes RGB trail color, sex, external ID and External Name.
- Advanced Attributes: Additional data like creation or update timestamps.
- Source Assignments: Shows the source linked to the subject. For more information about Source Assignment visit Managing Sources.
-
Latest Observations: Displays recent data.
Note: To understand more bout the Subject Settings visit Subject Types
Disabling / Deactivating Subjects
When a user, ER Mobile device or animal tracker is no longer in use, a vehicle is decommissioned, or tracking equipment is no longer in use, deactivate the subject rather than deleting it. Deactivation preserves historical tracking data while removing the subject from active views.
Why deactivate instead of delete?
- Maintains complete historical movement data and observations
- Preserves source assignments and data associations
- Prevents data gaps in reports and analytics
- Reversible if you need to restore the subject
How to deactivate a subject:
- Navigate to Home > Observations > Subjects
- Select the subject you want to deactivate
- Uncheck the "Active" checkbox
- Click Save at the bottom of the page
Deactivated subjects will no longer appear on the map, in layers, or in subject selection dropdowns (e.g. “reported by”), but their historical tracking data remains accessible for reports and analysis.
Using the Action Menu
The Action menu on the Subjects page allows you to:
- Export: Save subject data as a .csv file.
-
Delete (Use with Caution)
- ⚠️ Warning: Deleting a subject is permanent and cannot be undone. This action removes all associated tracking data, observations, and source assignments.
- Only delete subjects in exceptional circumstances where complete removal is necessary. In most cases, deactivating subjects is the preferred approach. To delete a subject, select it from the list and choose the delete option from the Action menu.
- Assign Random Trail Color: Generate a random RGB color for the subject’s trail (see more below).
Exporting a Track Data for a Subject
- Select a subject from the list.
- In the Action menu, choose Export as .csv file.
- Click Go to download the file to your local directory.
Assigning a Random Trail Color
- Select a subject from the list.
- In the Action menu, choose Assign a random color.
- Click Go to apply a random RGB value
- The random RGB color will appear in the Subject Attributes
(e.g., 255, 255, 0).
Adding a New Subject
To add a subject:
- Go to Home > Observations > Subjects, then select Add a Subject.
- Enter the required settings: Name and Subtype.
Note: Subjects must be added to a group to appear on the map. You can assign groups during creation or later on the subject details page.