Technical Guide

A deeper look at how the BL PCF Report workflow is built: the dual current/previous-period pipeline, colour mapping, every chart and map, and Word report and dashboard generation.

Download the full Technical Guide (PDF) v2.1

Version 2.1 removes the gee_client connection field, which was dropped from spec.yaml — this workflow never used it. Version 2.0 rewrote the guide against the then-current spec.yaml: it corrected the dependency list (migrated to ecoscope-platform plus the Big Life, WWF-Virunga, STE, and MNC extension packages actually declared), the real chart/task names (several task names in the original version matched nothing in spec.yaml), the previous-period mechanism (a flexible Custom/Preset/Calendar offset, not a simple integer), the Word report's fixed "Ecoscope" author field and overall_report.docx filename, and the dashboard, which wires up 24 widgets rather than an empty list.

Contents

1. Overview
   1. Output summary
2. Dependencies
   1. Python packages
   2. External data — static Amboseli layers
   3. Base map tiles
   4. EarthRanger connection
   5. Grouper
   6. Time frequency
3. Data Ingestion and Processing
   1. Dual pipeline — current and previous period
   2. Previous period calculation
   3. Field normalisation
   4. Filtering
   5. Livestock-kill totals
4. Summary Tables
5. Colour Mapping
6. Charts
   1. Pie charts
   2. Stacked bar charts
   3. Time-of-day bar chart
   4. Multi-line time-series charts
   5. Multi-bar time-series chart
   6. Historic comparison chart (per ranch)
7. Maps
8. Word Report & Dashboard
9. Output Files
10. Workflow Execution Logic
    1. Skip conditions
    2. mapvalues / map fan-out
    3. Screenshot timing
    4. Geometry cleaning
11. Software Versions

Read it here

The guide is embedded below. If it doesn't render in your browser, use the download link above.