Module 1
1.1 Overview
The Cattle Asset Map is the primary spatial visualization module of the L-PRES Cattle Dashboard. It provides an interactive map for viewing, querying, filtering, and analysing cattle-related assets and infrastructure.
The module enables users to:
- Visualize cattle routes and associated livestock assets on an interactive map.
- Filter mapped features based on their attributes.
- View statistical summaries of mapped cattle assets.
- Examine the spatial distribution and condition of cattle routes.
- Identify grazing areas and assess their accessibility.
- Display or hide individual map layers.
- Perform spatial measurements and analyses.
- Export spatial data and generate map outputs.
- Explore the map using different basemaps and analytical tools.
The module consists principally of the Layer Panel, Interactive Map, Statistical Dashboard, Map Legend, and Map Analysis Toolbar.
1.2 Accessing the Cattle Asset Map
From the dashboard’s main navigation menu:
- Open the L-PRES Cattle Dashboard.
- Select Cattle Asset Map from the navigation menu.
- The Cattle Asset Map interface will open.
- The map displays the available cattle-related spatial datasets together with the associated statistical dashboard.
Figure 1.1: Cattle Asset Map Interface
The Cattle Asset Map interface is divided into the following major sections:
| Interface Component | Description |
|---|---|
| Layer Panel | Displays available spatial layers and provides filtering and layer visibility controls. |
| Interactive Map | Displays the geographical location and distribution of cattle assets. |
| Statistical Dashboard | Presents charts, indicators and summaries derived from the mapped data. |
| Legend | Explains the symbols and graphical representations used on the map. |
| Map Navigation Controls | Allows users to zoom, return to the home extent and navigate the map. |
| Analysis Toolbar | Provides spatial analysis, measurement, export, printing and other GIS functions. |
1.3 Layer Panel
The Layer Panel is located on the left side of the map interface.
It contains the available cattle asset layers and provides users with tools for searching, filtering and controlling the visibility of the layers.
1.3.1 Layer Visibility
Each layer has a toggle switch that allows the user to turn the layer ON or OFF.
To display a layer:
- Locate the required layer in the Layer Panel.
- Click the toggle switch beside the layer.
- When enabled, the layer’s features will appear on the map.
To hide a layer:
- Locate the layer.
- Click the toggle switch again.
- The layer will be removed from the map display without deleting the underlying data.
Important: Turning a layer off only changes its visibility. It does not remove or delete the dataset.
1.4 Searching for Layers
The Layer Panel contains a Search box.
Users can use the search box to quickly locate a particular layer or dataset.
To search for a layer:
- Click inside the Search field.
- Enter the name or keyword associated with the desired layer.
- The layer list will be narrowed to matching results.
- Select or activate the required layer.
This is particularly useful where the dashboard contains a large number of spatial datasets.
1.5 Filtering Spatial Data
The Cattle Asset Map provides attribute-based filtering functionality.
The Filter button is available beside the layer controls.
Filters allow users to display only features that meet selected criteria.
For example, cattle routes can be filtered according to:
Status
- Closed
- Open
- Restricted
Route Condition
- Excellent
- Good
- Fair
- Poor
Accessibility
- Seasonal
- Year round
Additional filter categories may be available depending on the dataset.
To apply a filter:
- Select the relevant layer.
- Click the Filter icon.
- Select the desired attribute or category.
- Tick the required option(s).
- The map will update to display the features matching the selected criteria.
- The statistical dashboard will also reflect the filtered dataset where applicable.
To remove a filter:
- Open the filtering panel.
- Click Reset.
- All previously applied filters will be cleared.
Tip: Filtering can be used to quickly identify priority routes, such as restricted routes, poor-condition routes, or routes with difficult accessibility.
1.6 Statistical Dashboard
The statistical dashboard is displayed on the right side of the interface.
It provides summarized information derived from the spatial datasets and allows users to understand the characteristics of cattle assets without manually examining every mapped feature.
The statistics may include:
- Total cattle route length.
- Route condition.
- Route accessibility.
- Grazing types.
- Grazing accessibility.
- Other cattle-related indicators.
1.6.1 Total Route Kilometres
The Total Routes Kilometer indicator provides the total length of the cattle routes currently represented in the dataset.
In the example shown in Figure 1.1, the dashboard displays:
6,206.64 km
This indicator provides a quick overview of the total mapped cattle route network.
The value displayed may change when filters are applied.
1.7 Route Condition Chart
The Route Condition chart provides a graphical summary of the condition of mapped cattle routes.
The categories include:
- Excellent
- Good
- Fair
- Poor
The chart enables users to quickly understand the overall condition of the cattle route network.
Using the chart
Users can move the cursor over individual sections of the chart to view additional information associated with that category.
This allows users to identify the relative distribution of routes according to their physical condition.
1.8 Grazing Types
The Grazing Types chart presents the spatial data on grazing areas according to their type.
The example shown contains:
- Communal
- Natural
- Ranch
The chart displays the corresponding area associated with each grazing type.
Users can hover over individual bars to obtain additional information, including the grazing type and area.
For example, selecting or hovering over a bar may display:
Type: Ranch
Area: 252,645.73
Values shown in the dashboard are derived from the available spatial dataset.
1.9 Grazing Accessibility
The Grazing Accessibility chart provides information on the accessibility of grazing areas.
The categories shown include:
- Easy
- Moderate
- Difficult
The horizontal bar chart enables users to compare the area associated with each accessibility category.
This information can support planning and prioritisation of livestock infrastructure and interventions.
1.10 Dashboard Controls
Individual dashboard cards and charts may contain an Expand/Full-screen control.
To expand a chart:
- Locate the chart or indicator.
- Click the Expand icon in the upper-right corner of the card.
- The selected chart will expand for easier viewing.
- Close or minimise the expanded view to return to the normal dashboard layout.
This is particularly useful when examining detailed charts or presenting information to stakeholders.
1.11 Map Legend
The Legend identifies the symbols, lines, points and other graphical representations used to display spatial features on the map.
For example, different symbols may represent:
- Cattle routes
- Water points
- Grazing areas
- Markets
- Veterinary facilities
- Holding/resting facilities
- Other livestock-related assets
The legend allows users to correctly interpret the information displayed on the map.
To view the legend:
- Locate the Legend panel on the map.
- Review the symbols and their corresponding feature descriptions.
- Use the information to interpret the mapped features.
The legend can be moved or accessed depending on the map interface configuration.
1.12 Map Navigation
The interactive map provides standard navigation controls.
Users can:
Zoom In
Click the + button to increase the map scale.
Zoom Out
Click the – button to decrease the map scale.
Return to Home Extent
Click the Home icon to return to the default map extent.
Pan the Map
Click and hold the mouse button while moving the cursor to move around the map.
Search/Locate
The map search function can be used to locate a specific geographical feature or location where supported.
1.13 Map Analysis and Utility Toolbar
A toolbar is located at the bottom-left section of the map.
It provides several GIS and analytical functions.
The available tools include:
| Tool | Function |
|---|---|
| Base Map | Changes the background map used for spatial visualization. |
| Dashboard | Opens or displays the statistical dashboard associated with the map. |
| Elevation Profile | Provides an elevation profile along a selected line or route. |
| Export Layer | Allows spatial data from a selected layer to be exported. |
| iFrame | Provides an option for embedding the map or selected view into another web page or application, where enabled. |
| Isoline | Performs distance/time-based spatial analysis around a location or feature, where configured. |
| Layer Comparison | Allows users to compare selected spatial layers or datasets. |
| Measure Area | Calculates the area of a selected polygon or user-drawn area. |
| Measure Distance | Calculates the distance between points or along a user-drawn line. |
| My Location | Identifies and displays the user’s current geographical location where location services are enabled. |
| Generates a printable map output. | |
| Selection | Allows users to select spatial features on the map for further inspection or analysis. |
| Storybook | Provides access to configured map-based stories or guided spatial presentations. |
| Time Slider | Allows users to view spatial information according to time/date where temporal data is available. |
| Transport Analysis | Supports transport/network-based analysis where the required network data and analysis configuration are available. |
1.14 Base Map
The Base Map tool allows users to change the background map used for displaying spatial information.
A basemap provides geographical context for the cattle assets.
Depending on the available configuration, users may select from different basemap types such as:
- Satellite imagery
- Street/road maps
- Terrain
- Other available reference maps
To change the basemap:
- Click Base Map on the toolbar.
- Select the preferred basemap.
- The map background will update while the cattle asset layers remain available.
1.15 Elevation Profile
The Elevation Profile tool can be used to examine changes in elevation along a selected route or line.
This functionality can be useful for assessing terrain characteristics along cattle routes.
General procedure:
- Select Elevation Profile.
- Draw or select the route/line to be analysed.
- The system generates an elevation profile.
- Review changes in elevation along the selected route.
This information may support assessment of route accessibility and terrain-related constraints.
1.16 Export Layer
The Export Layer tool allows users to export selected spatial information for further analysis or reporting.
General procedure:
- Select Export Layer.
- Select the layer to be exported.
- Select the available output format.
- Confirm the export.
- Save the resulting file to the required location.
Export options depend on the configuration and permissions of the dashboard.
1.17 iFrame
The iFrame function provides a mechanism for embedding the map or selected dashboard view into another web page or application.
This functionality is particularly useful where a project team wants to display a map component within another web-based information system.
Where enabled, users can obtain the appropriate embed information from the iFrame tool.
1.18 Isoline Analysis
The Isoline tool supports spatial accessibility analysis around a selected location.
Depending on the configuration, an isoline can represent an area that can be reached within a specified:
- Distance; or
- Travel time.
This can be useful for analysing accessibility to livestock infrastructure such as:
- Water points
- Veterinary facilities
- Markets
- Grazing areas
- Holding facilities
1.19 Layer Comparison
The Layer Comparison tool enables users to compare two or more spatial datasets.
This can help users identify spatial relationships and differences between cattle assets.
For example, users may compare:
- Cattle routes and water points.
- Cattle routes and grazing areas.
- Cattle routes and veterinary facilities.
- Cattle routes and administrative boundaries.
1.20 Measure Area
The Measure Area tool calculates the area of a user-defined polygon.
To measure an area:
- Select Measure Area.
- Click on the map to define the boundary of the area.
- Continue clicking around the area.
- Complete the polygon.
- The system displays the calculated area.
The tool can be useful for estimating the size of grazing areas and other spatial features.
1.21 Measure Distance
The Measure Distance tool calculates the distance between two or more locations.
To measure a distance:
- Select Measure Distance.
- Click the starting point.
- Click additional points along the desired route.
- Double-click or complete the measurement.
- The system displays the calculated distance.
This can be used to estimate distances along cattle routes or between livestock assets.
1.22 My Location
The My Location tool identifies the user’s current geographical position.
To use My Location:
- Click My Location.
- Allow location access when prompted by the browser/device.
- The map will zoom to the user’s current position.
Location accuracy depends on the GPS/location services available on the user’s device.
1.23 Print Map
The Print tool allows users to generate a printable map.
A printed map may be useful for:
- Reports
- Field planning
- Meetings
- Technical presentations
- Project documentation
General procedure:
- Configure the map to show the required area and layers.
- Click Print.
- Select the required print/output options.
- Generate the map.
- Save or print the resulting output.
1.24 Feature Selection
The Selection tool allows users to select one or more spatial features displayed on the map.
Selected features can be used for further inspection or analysis depending on the available configuration.
To select a feature:
- Click Selection.
- Select the required selection method.
- Click or draw around the feature(s) on the map.
- The selected feature(s) will be highlighted.
- Review the associated information or perform the available analysis.
1.25 Storybook
The Storybook function provides a guided presentation of selected spatial information.
It can be used to present maps, locations and project information in a structured sequence.
This functionality may be useful during:
- Stakeholder presentations
- Project review meetings
- Field planning
- Awareness activities
- Management briefings
1.26 Time Slider
The Time Slider allows users to visualize spatial information according to time where temporal datasets are available.
For example, it can potentially be used to examine how selected cattle assets, incidents or routes change over different dates or periods.
General procedure:
- Activate Time Slider.
- Select or move to the required date/time period.
- The map updates to display the relevant temporal information.
- Move the slider to compare different periods.
The Time Slider is only applicable to datasets configured with temporal information.
1.27 Transport Analysis
The Transport Analysis tool provides network-based analysis capabilities for transportation or movement along available road/network datasets.
Depending on the configuration, it can support analysis such as:
- Route selection
- Travel distance
- Accessibility
- Movement between locations
- Network-based connectivity
This functionality can support planning and assessment of movement along cattle routes and related infrastructure.
1.28 Recommended Workflow for Users
For routine analysis of cattle assets, users are encouraged to follow this workflow:
1. Open Cattle Asset Map
↓
2. Select the required layer
↓
3. Turn the layer ON
↓
4. Apply appropriate filters
↓
5. Examine the mapped features
↓
6. Review the statistical dashboard
↓
7. Use the Legend to interpret symbols
↓
8. Perform spatial analysis where required
↓
9. Export or print results where necessary
1.29 Example Use Case
Identifying Poor-Condition Cattle Routes
A user wants to identify cattle routes that require attention because of poor physical condition.
Step 1: Open Cattle Asset Map.
Step 2: Ensure the Cattle Routes layer is active.
Step 3: Open the Filtering panel.
Step 4: Under Condition, select Poor.
Step 5: The map updates to display the cattle routes classified as poor.
Step 6: Review the Route Condition statistics.
Step 7: Use the Selection tool to inspect individual routes where necessary.
Step 8: Use Measure Distance to examine route distances where required.
Step 9: Export or print the resulting map for reporting or further analysis.
This workflow demonstrates how the spatial and statistical components of the dashboard can be used together for evidence-based decision-making.
Module 2
OTHER RESOURCES MAP
2.1 Overview
The Other Resources Map is a supplementary spatial visualization module within the L-PRES Cattle Dashboard. It provides access to additional vector and raster datasets that can support the analysis, planning and interpretation of cattle routes and livestock-related activities.
The module enables users to visualize other relevant environmental, demographic, physical and geographic resources alongside the cattle route network.
These datasets provide additional context for understanding factors that may influence cattle movement, accessibility, resource availability and potential areas of interaction or conflict.
The module currently provides access to resources including:
- Cattle Routes
- Rivers
- Points of Interest
- Protected/Conserved Areas
- Burnt Areas
- Population
The available datasets may be expanded as additional relevant spatial information becomes available.
2.2 Accessing the Other Resources Map
To access the module:
- Open the L-PRES Cattle Dashboard.
- Locate the main navigation menu at the top of the dashboard.
- Click Other Resources Map.
- The Other Resources Map interface will open.
- The map will display the available resource layers in the Layer Panel.
Figure 2.1: Other Resources Map – Main Interface
2.3 Components of the Other Resources Map
The interface consists of several major components.
| Component | Function |
|---|---|
| Layer Panel | Displays available resource datasets and provides controls for displaying and managing them. |
| Search Box | Allows users to search for available layers. |
| Interactive Map | Displays the selected spatial datasets. |
| Layer Controls | Allow individual layers to be turned on or off. |
| Filter | Allows users to filter applicable vector datasets. |
| Layer Analysis/Options | Provides additional functions for applicable layers. |
| Map Navigation Controls | Provides zoom and map navigation functions. |
| Map Analysis Toolbar | Provides additional GIS analysis and utility functions. |
| Coordinate Display | Displays the geographical coordinates of the cursor/location on the map. |
| Scale Bar | Provides an indication of map distance. |
2.4 Layer Panel
The Layer Panel is located on the left side of the interface.
It contains a list of the spatial datasets available within the module.
The layers shown in the current configuration include:
2.4.1 Cattle Routes
The Cattle Routes layer displays mapped cattle movement routes.
Although cattle routes are the primary dataset in the Cattle Asset Map, they are also available here so that users can compare the routes with other environmental and geographic resources.
2.4.2 Rivers
The Rivers layer provides information on mapped rivers and watercourses.
This layer can provide important geographical context when analysing cattle routes, particularly where cattle movement may be associated with access to water resources.
Users can overlay the Rivers layer with Cattle Routes to examine the spatial relationship between routes and watercourses.
2.4.3 Points of Interest
The Points of Interest (POI) layer contains mapped locations that may be relevant to users when examining the cattle route network.
Depending on the dataset configuration, points of interest may represent locations such as:
- Settlements
- Facilities
- Markets
- Important landmarks
- Other relevant locations
The layer provides contextual information that can support spatial planning and field activities.
2.4.4 Protected/Conserved Areas
The Protected/Conserved Areas layer displays areas that have been designated for conservation or protection.
This information can be used to examine the relationship between cattle routes and protected or conserved areas.
For example, users may use the layer to identify:
- Cattle routes passing near protected areas.
- Potential areas of interaction between livestock movement and conservation zones.
- Routes that may require additional management consideration.
2.4.5 Burnt Areas
The Burnt Areas dataset provides spatial information on areas affected by fire or burning.
This is particularly useful for understanding environmental conditions that may affect grazing resources and cattle movement.
Users can overlay Burnt Areas with cattle routes to identify areas where livestock movement may intersect with recently or historically affected areas.
2.4.6 Population
The Population layer provides spatial information on population distribution.
Population information can be used as contextual data when assessing cattle movement and potential interactions between livestock routes and human settlements or populated areas.
For example, users may compare:
Cattle Routes + Population
to identify areas where cattle movement occurs within or close to highly populated areas.
2.5 Turning Layers On and Off
The visibility of each dataset can be controlled independently.
A toggle switch is provided beside each layer.
To turn a layer ON:
- Locate the required layer.
- Click the toggle switch beside the layer.
- The switch changes to the active state.
- The selected dataset appears on the map.
To turn a layer OFF:
- Locate the active layer.
- Click the toggle switch.
- The layer is removed from the map display.
Note: Turning a layer off does not delete the dataset. It only hides the layer from the current map view.
2.6 Combining Multiple Layers
One of the key functions of the Other Resources Map is the ability to display multiple datasets simultaneously.
For example, a user can activate:
Cattle Routes + Rivers + Population + Protected Areas
This allows users to visually examine relationships between cattle movement and the surrounding environment.
To display multiple layers:
- Turn on the Cattle Routes layer.
- Turn on the required supporting layer.
- Repeat the process for additional datasets.
- Examine the resulting spatial relationships on the map.
This multi-layer approach is particularly useful for spatial planning and decision-making.
2.7 Vector and Raster Data
The Other Resources Map contains both vector and raster datasets.
Understanding the difference helps users interpret how information is displayed.
Vector Data
Vector data represents geographic features using:
- Points
- Lines
- Polygons
Examples within the dashboard include:
- Cattle Routes – lines
- Rivers – lines
- Points of Interest – points
- Protected/Conserved Areas – polygons
Vector datasets generally represent discrete geographical features.
Raster Data
Raster data represents information as a grid of cells or pixels.
Examples within the module include:
- Population data
- Burnt Areas data
Raster datasets are particularly useful for representing continuous or spatially distributed phenomena across large areas.
2.8 Searching for a Layer
The Search box at the top of the Layer Panel allows users to quickly locate a particular dataset.
To search:
- Click inside the Search box.
- Enter the name or keyword of the desired layer.
- The Layer Panel will display matching results.
- Select the required layer and turn it on.
This is useful where the number of available datasets increases over time.
2.9 Filtering Layers
Some vector datasets provide a Filter function.
The filter icon appears beside applicable layers.
Filtering enables users to limit the displayed features according to available attributes or categories.
To apply a filter:
- Identify a layer with the Filter icon.
- Click the Filter icon.
- Select the required filtering criteria.
- Apply the filter.
- The map updates to display the features meeting the selected criteria.
To remove a filter:
- Open the layer’s filter controls.
- Clear the selected criteria or use the available reset option.
- The full dataset will be displayed again.
Note: Filtering functionality depends on the attributes available in the underlying dataset.
2.10 Layer Options
The three-dot menu displayed beside some layers provides additional layer-specific options.
The available options depend on the type and configuration of the dataset.
Users should open the menu to view the functions available for a particular layer.
These options may support activities such as:
- Layer management
- Data inspection
- Analysis
- Export
- Visualization settings
Important: Not every layer will necessarily have the same options because vector and raster datasets have different characteristics and capabilities.
2.11 Map Navigation
The map provides standard navigation controls on the right-hand side.
Zoom In
Click the + button to zoom into the map.
Zoom Out
Click the – button to zoom out.
Home Extent
Click the Home icon to return to the default map extent.
Pan
Click and drag the map to move to another geographical area.
2.12 Map Scale
A scale bar is displayed at the bottom-left portion of the map.
The scale bar provides an approximate relationship between map distance and actual ground distance.
For example, the screenshot displays a 200 km scale.
The scale changes automatically as the user zooms in or out.
2.13 Coordinate Display
The map interface provides a coordinate display at the lower-right portion of the map.
As the user moves around the map, the displayed coordinates provide the geographical position associated with the current map location.
This can assist users with:
- Identifying locations.
- Recording approximate coordinates.
- Supporting field planning.
- Interpreting the spatial location of resources.
2.14 Map Analysis Toolbar
The Other Resources Map also provides the GIS analysis and utility toolbar located at the bottom-left of the map.
The tools available include:
| Tool | Function |
|---|---|
| Base Map | Changes the background/reference map. |
| Dashboard | Opens or displays the dashboard/statistical view where configured. |
| Elevation Profile | Examines elevation along a selected line or route. |
| Export Layer | Exports available spatial data. |
| iFrame | Provides embedding functionality where enabled. |
| Isoline | Performs distance/time-based accessibility analysis where configured. |
| Layer Comparison | Compares selected spatial layers. |
| Measure Area | Calculates the area of a user-defined polygon. |
| Measure Distance | Calculates distance between selected locations. |
| My Location | Identifies the user’s current location where location services are available. |
| Produces a printable map output. | |
| Selection | Selects features on the map. |
| Storybook | Provides guided map-based presentations where configured. |
| Time Slider | Displays temporal datasets over selected time periods where available. |
| Transport Analysis | Supports network/transport-related spatial analysis where configured. |
These tools operate in conjunction with the selected resource layers and can therefore be used to perform more advanced spatial analysis.
2.15 Comparing Cattle Routes with Other Resources
A major purpose of this module is to allow users to examine cattle routes alongside other geographic information.
For example:
Cattle Routes + Rivers
Can be used to examine the relationship between cattle movement and watercourses.
Cattle Routes + Population
Can help identify areas where cattle movement may occur close to populated areas.
Cattle Routes + Protected Areas
Can help identify cattle routes that are close to or intersect conservation areas.
Cattle Routes + Burnt Areas
Can help assess the relationship between cattle movement and fire-affected areas.
Cattle Routes + Points of Interest
Can help identify important facilities or locations along or near cattle routes.
2.16 Example Use Case: Identifying Cattle Routes Near Population Areas
A user wants to identify cattle routes located in areas with significant population concentrations.
Procedure
- Open Other Resources Map.
- Turn ON Cattle Routes.
- Turn ON Population.
- Zoom to the area of interest.
- Examine the relationship between the cattle route network and population distribution.
- Use the Layer Comparison or Selection tools where necessary for further analysis.
- Use Print or Export Layer where an output is required.
This analysis can provide useful information for planning, livestock movement management and identifying areas that may require closer monitoring.
2.17 Example Use Case: Assessing Cattle Routes and Protected Areas
A user wants to determine whether cattle routes are located near protected or conserved areas.
Procedure
- Open Other Resources Map.
- Activate Cattle Routes.
- Activate Protected/Conserved Areas.
- Zoom into the area of interest.
- Examine areas where the cattle routes and protected areas overlap or occur in close proximity.
- Select individual features where further information is required.
- Use the appropriate measurement or analysis tool where necessary.
This can support environmental planning and livestock route management.
2.18 Example Use Case: Assessing Burnt Areas Along Cattle Routes
The Burnt Areas dataset can be used to provide additional environmental context for cattle route planning.
Procedure
- Activate Cattle Routes.
- Activate Burnt Areas.
- Zoom to the area of interest.
- Examine the relationship between the cattle routes and burnt areas.
- Identify areas where cattle routes pass through or near fire-affected areas.
- Use the available analytical tools for further assessment.
2.19 Recommended Workflow
For general use of the Other Resources Map, the following workflow is recommended:
1. Open Other Resources Map
↓
2. Identify the resource of interest
↓
3. Turn ON Cattle Routes
↓
4. Turn ON the supporting resource layer
↓
5. Adjust the map extent/zoom
↓
6. Apply filters where applicable
↓
7. Examine spatial relationships
↓
8. Use GIS analysis tools where required
↓
9. Export or print the results where necessary
2.20 Key Considerations for Users
- The Other Resources Map is primarily a contextual analysis module; it provides supporting datasets rather than replacing the detailed cattle asset information in Module 1.
- Multiple layers can be displayed simultaneously to support comparative spatial analysis.
- Users should avoid activating too many layers simultaneously where this makes the map difficult to interpret.
- Raster layers may appear differently from vector layers because they are represented as continuous grids or pixel-based surfaces.
- The availability of filtering and other layer functions depends on the characteristics of the dataset.
- Spatial analysis results should be interpreted in conjunction with the underlying project data and, where appropriate, field information.
Module 3
INCIDENT REPORTING
3.1 Overview
The Incident Reporting Module provides a digital platform for reporting, recording, reviewing and analysing livestock-related incidents within the L-PRES Cattle Dashboard.
The module supports the collection of incident information from the field and provides authorized users with access to submitted reports for monitoring, review and analysis.
The system provides two main reporting channels:
- Mobile Incident Reporting – enables field personnel and other authorized reporters to submit incidents using mobile devices, including in locations with limited network connectivity.
- Dashboard Incident Reporting – enables users to submit incident reports directly through the web-based dashboard.
Submitted reports can subsequently be accessed through the View Incident Reports function by authorized users.
The incident reporting system is built around KoboToolbox, which provides the underlying electronic data collection and data management functionality.
3.2 Accessing the Incident Reporting Module
To access the Incident Reporting module:
- Open the L-PRES Cattle Dashboard.
- Locate the main navigation menu.
- Click Incident Reporting.
- The Livestock Incident Reporting page will open.
The landing page provides two principal options:
- View Incident Reports
- Report a Livestock Incident
Figure 3.1: Livestock Incident Reporting Landing Page
3.3 Incident Reporting Landing Page
The Incident Reporting landing page provides access to both incident submission and incident review functions.
The page contains:
View Incident Reports
The VIEW INCIDENT REPORTS button provides access to the incident reporting database and analytical interface.
This function is intended primarily for authorized users who have been granted access to the incident reporting system.
Report via Mobile
The REPORT VIA MOBILE button provides access to the mobile-friendly incident reporting form.
This option is designed particularly for field personnel who need to capture incidents while working in the field.
3.4 Reporting Channels
The system provides two methods of submitting livestock incident reports.
| Reporting Channel | Primary Use |
|---|---|
| Report via Mobile | Field-based incident reporting using mobile phones or other mobile devices. |
| Web/Dashboard Reporting | Submission of an incident directly through the dashboard using a web browser. |
Both channels feed incident information into the same incident reporting system.
3.5 Reporting an Incident via Mobile
The Report via Mobile function provides a mobile-accessible form for field reporting.
This is particularly useful for field workers who may be operating in locations where network connectivity is limited or intermittent.
To report an incident via mobile:
- Open the L-PRES Cattle Dashboard.
- Select Incident Reporting.
- Click REPORT VIA MOBILE.
- The system opens the mobile reporting form through a new link.
- Complete the Livestock Incident Report.
- Provide the required incident information.
- Review the information entered.
- Submit the completed report.
The mobile reporting workflow allows information to be captured closer to the location where an incident occurs.
Field Reporting Consideration
Field users should complete the report as soon as practical after an incident occurs and provide accurate information based on observations and available evidence.
3.6 Web-Based Incident Reporting
Users can also submit an incident directly through the Incident Reporting page.
The web-based reporting form is integrated into the dashboard and is powered by KoboToolbox.
The form is displayed under the Report a Livestock Incident Below section.
To submit a report through the dashboard:
- Open Incident Reporting.
- Scroll to the Report a Livestock Incident Below section.
- Complete the electronic Livestock Incident Report.
- Expand each relevant section.
- Enter the required information.
- Review the completed information.
- Click Submit.
3.7 Livestock Incident Report Form
The electronic form is titled:
Livestock Incident Report
The form is divided into three major sections:
- Reporter Information
- Incident Type and Impact
- Incident Response and Remedy
This sectional structure makes it easier for users to enter information in a logical sequence.
Figure 3.2: Livestock Incident Report Form
The sections can be expanded or collapsed using the arrow beside each section heading.
3.8 Section 1 – Reporter Information
The Reporter Information section captures information about the person or organization submitting the incident report.
The fields shown include:
Reporter Name
Enter the name of the person reporting the incident.
The name should be entered accurately to facilitate follow-up or verification where necessary.
Date of Report
Enter the date and time when the incident report is being submitted.
The date is entered using the provided date field, while the time is entered in the corresponding time field.
Organisation/Agency
Enter the name of the organization, agency or institution associated with the reporter.
For example, the organization may be a:
- Government institution
- Project implementation unit
- Security agency
- Livestock-related institution
- Community organization
- Other relevant organization
Note: Fields marked with an asterisk (*) are required fields and must be completed before the form can be submitted.
3.9 Section 2 – Incident Type and Impact
The Incident Type and Impact section captures information about the nature and consequences of the reported livestock incident.
Users should expand this section by clicking the arrow beside the section title.
The information entered in this section enables the system to characterize the incident and document its effect on livestock, infrastructure, people, land or other relevant resources.
Where applicable, users should provide accurate information regarding:
- Type/category of incident
- Location of the incident
- Livestock affected
- Infrastructure or assets affected
- Nature and extent of damage or impact
- Other relevant incident information
Users should provide as much accurate information as available rather than making assumptions about an incident.
3.10 Section 3 – Incident Response and Remedy
The Incident Response and Remedy section records actions taken or planned in response to the incident.
This section is important for monitoring how reported incidents are addressed.
Depending on the information requested by the form, users can document:
- Immediate response actions
- Ongoing actions or remedies
- Response agencies
- Assistance provided
- Other relevant interventions
The information helps project managers and other authorized users monitor the response to livestock incidents.
3.11 Submitting an Incident Report
After completing the three sections, the user should review the information entered before submission.
To submit the report:
- Expand each relevant section.
- Review the information entered.
- Confirm that required fields have been completed.
- Verify the accuracy of the incident information.
- Click the Submit button at the bottom of the form.
The Submit button is displayed below the three main sections.
Important: Users should verify the information before submission because submitted records become part of the incident reporting database.
3.12 Viewing Submitted Incident Reports
The View Incident Reports button provides access to submitted incident records.
This function opens the incident reporting review environment through a separate link.
The reporting environment allows authorized users to review and analyse submitted incidents.
The available views include:
- Table
- Reports
- Gallery
- Downloads
- Map
Figure 3.3: Incident Reporting Data Management and Review Interface
3.13 User Authentication and Access Control
Access to submitted incident reports is controlled.
Users must have:
- A registered account; and
- Appropriate permission/access to the incident reporting system.
Therefore, not every dashboard visitor can access the submitted incident database.
Authorized Users
Only users who have been added and permitted to access the reporting system should be provided with the required login credentials.
This access-control arrangement helps protect incident information and restricts data management functions to authorized personnel.
3.14 Incident Reports – Table View
The Table view provides a structured list of submitted incident records.
The table displays individual submissions as rows and the associated data fields as columns.
The interface may include fields such as:
- Reporter Name
- Date of Report
- Organisation/Agency
- Incident information
- Validation status
- Other submitted fields
The screenshot shows multiple submitted records and provides controls for inspecting individual records.
Table Functions
Users can use available controls to:
- View individual records.
- Edit records where permission allows.
- Search records.
- Filter records.
- Review field values.
- Navigate through submitted records.
3.15 Searching Incident Records
The table interface provides search fields beneath the column headings.
Users can search for records based on specific fields.
To search for an incident:
- Identify the relevant column.
- Click the Search field beneath the column heading.
- Enter the required search term.
- The table displays matching records.
For example, a user can search using information such as:
- Reporter name
- Organisation/Agency
- Date
- Other available incident attributes
This makes it easier to locate specific reports in a large database.
3.16 Viewing an Individual Incident Record
Each submitted record contains controls for inspecting the record.
The View icon can be used to open and inspect the information associated with an individual submission.
Where appropriate permissions are provided, users may also have access to an Edit function.
To view a record:
- Locate the required incident in the table.
- Click the View icon.
- The record details will be displayed.
- Review the information contained in the submission.
3.17 Incident Reports – Reports and Charts
The Reports section provides analytical and reporting capabilities for the submitted incident data.
Users can use this section to summarize and visualize incident information.
Depending on the configured reports, information can be presented using:
- Tables
- Charts
- Graphs
- Statistical summaries
This allows users to move beyond individual incident records and identify broader patterns in reported livestock incidents.
3.18 Incident Reports – Gallery
The Gallery view provides access to media or image information associated with incident submissions, where photographs or other media have been captured through the reporting form.
This can be useful for reviewing visual evidence submitted with incident reports.
Users can inspect available images associated with reported incidents.
3.19 Incident Reports – Downloads
The Downloads section provides access to data download functionality.
Authorized users can use this function to obtain incident data for further analysis, reporting or record keeping, subject to their access permissions.
Downloaded data may subsequently be analysed using appropriate statistical, spreadsheet, GIS or reporting software.
3.20 Incident Reports – Map View
The Map view provides a geographical representation of incidents where location information has been captured.
This enables users to examine the spatial distribution of livestock incidents.
The map view can support analysis such as:
- Where incidents are occurring.
- Concentration of incidents in particular areas.
- Spatial relationships between incidents and cattle routes.
- Identification of areas requiring closer monitoring.
- Planning of response and intervention activities.
3.21 Incident Data Review Workflow
Authorized users can follow this workflow when reviewing incident reports:
1. Open Incident Reporting
↓
2. Click View Incident Reports
↓
3. Log in using an authorized account
↓
4. Open the Table/Reports/Map view
↓
5. Search or filter incident records
↓
6. Review individual incidents
↓
7. Analyse charts and statistics
↓
8. Examine the spatial distribution on the map
↓
9. Download or export data where required
3.22 Example Use Case – Field Incident Reporting
Scenario
A field officer encounters a livestock-related incident while conducting field activities in an area with limited network connectivity.
Procedure
- The officer opens the Incident Reporting link on a mobile device.
- Selects Report via Mobile.
- The mobile incident form opens.
- The officer enters the Reporter Information.
- The officer records the Incident Type and Impact.
- The officer records the Incident Response and Remedy, where applicable.
- The officer reviews the information.
- The report is submitted through the mobile reporting workflow.
The submitted information becomes available within the incident reporting system for authorized users to review and analyse.
3.23 Example Use Case – Incident Monitoring
A project manager wants to understand the distribution and characteristics of reported livestock incidents.
Procedure
- Open Incident Reporting.
- Click View Incident Reports.
- Log in using an authorized account.
- Review the incident records in the Table view.
- Use search/filter functions to identify specific incident categories or locations.
- Open Reports to examine charts and statistical summaries.
- Open Map to examine the spatial distribution of incidents.
- Download relevant data where further analysis is required.
This provides a combined database, statistical and spatial approach to incident monitoring.
3.24 Key Benefits of the Incident Reporting Module
The module provides several important benefits to L-PRES stakeholders:
Centralized Incident Database
All submitted incident reports are stored within a structured digital system.
Mobile Field Reporting
Field personnel can submit reports using mobile devices.
Web-Based Reporting
Users can submit reports directly from the dashboard.
Spatial Incident Monitoring
Incidents with location information can be visualized geographically.
Evidence-Based Response
Incident information can support response planning and decision-making.
Data Analysis
Submitted reports can be summarized using tables, charts and graphs.
Controlled Access
Access to submitted reports is restricted to authorized users.
3.25 Important User Guidelines
Users should observe the following when submitting incident reports:
- Provide accurate and factual information.
- Complete all required fields before submitting the form.
- Avoid entering unverified information as fact.
- Provide the correct date and time of reporting.
- Clearly identify the reporting organization or agency.
- Provide sufficient information to enable follow-up where necessary.
- Where evidence collection is available, provide appropriate supporting evidence.
- Review the completed form before submission.
- Authorized reviewers should regularly examine submitted reports for completeness and quality.
- Access credentials for the incident reporting database should only be provided to approved users.
3.26 Summary of Incident Reporting Functions
| Function | Purpose |
|---|---|
| Report via Mobile | Enables field-based incident reporting through mobile devices. |
| Web/Dashboard Form | Allows users to submit incidents through the dashboard. |
| Reporter Information | Captures information about the person/organization submitting the report. |
| Incident Type and Impact | Records the nature and impact of the incident. |
| Incident Response and Remedy | Records response actions and remedies. |
| View Incident Reports | Provides access to submitted reports for authorized users. |
| Table | Displays submitted incidents in a structured data table. |
| Reports | Provides charts, graphs and analytical summaries. |
| Gallery | Provides access to submitted media/images where available. |
| Downloads | Provides data download functionality. |
| Map | Displays incidents geographically where location information is available. |
| Search/Filter | Helps users locate specific incident records. |
| View/Edit | Allows authorized users to inspect or modify records where permitted. |
