A useful observation programme begins with a decision that somebody can act on. Before selecting imagery or instruments, define the area of interest, the people responsible for inspecting it, and the time available for a response. This planning perspective connects remote measurements with the practical questions that shape a survey or monitoring service. The aim is to identify which observations would change a decision, how supporting evidence would be collected, and what should happen when information is incomplete. A clear plan makes later technical choices easier to assess against an operational purpose.
This working guide considers reading uncertainty in remote sensing products in shaded cocoa agroforestry. The immediate decision is to identify sites for canopy assessment. Useful reference evidence includes cocoa canopy and overstory observations collected separately. The case is an illustrative planning context, with assumptions to check against the actual sensor, landscape and project requirements.
The setting: Shaded cocoa agroforestry
A shaded cocoa farm contains multiple vegetation layers whose contributions cannot always be separated in a satellite image. Large shade trees may dominate the upper canopy, while the cocoa plants of commercial interest occupy a lower layer. The first task is to define what the observation is intended to represent. Monitoring tree-cover change, evaluating shade structure and estimating a cocoa parameter are related objectives, but they should not be treated as interchangeable outputs.
Build a farm register that captures boundaries, management units and known differences in shade arrangement. Compare imagery at suitable dates and exclude contaminated observations, while recognising that stable upper-canopy greenness can conceal changes below it. Canopy openings, recent pruning, intercropping and storm damage may alter the signal for different reasons. Contextual information helps turn these patterns into questions for field investigation instead of unsupported explanations about cocoa health.
A validation visit should record cocoa condition and overstory characteristics separately. Photograph or describe the sampled area consistently, and retain its location and date so that it can be related to the observation footprint. Sampling only accessible farm edges risks overlooking different conditions in the interior. Reports should explain whether they describe whole-farm vegetation or a validated cocoa-specific measurement, and identify the additional evidence needed before a management recommendation can be made.
Identify what the uncertainty describes
A satellite product is the result of a measurement chain, rather than a direct copy of conditions on the ground. Detector noise, calibration, atmospheric correction, geolocation and retrieval assumptions can all affect the final value. Their importance changes with the target. A small location error may matter greatly beside a narrow river, while an imperfect aerosol correction may dominate a water reflectance estimate.
Start by reading the variable definition, units, spatial support and quality documentation. An uncertainty layer may describe an estimated standard deviation, a confidence interval, disagreement among models or another quantity entirely. These measures are not interchangeable. A model's class probability also does not automatically represent a calibrated probability that its label is correct. Check how the quantity was obtained and whether it has been evaluated against independent observations.
Carry uncertainty into the decision
Separate systematic differences from random variation. Averaging many observations can reduce independent random noise, but it does not remove a shared calibration bias. Nearby pixels and repeated observations may share errors, so treating every value as independent can produce confidence intervals that are too narrow. When comparing dates, consider whether the same processing method, sensor characteristics and environmental conditions apply.
Quality flags identify conditions that deserve screening or special treatment. They may indicate clouds, saturation, poor retrieval geometry or inputs outside a method's tested range. Preserve the original flags and record the filtering rule. A strict mask can improve reliability while leaving a sample that overrepresents clear weather or easier terrain. Report missing coverage alongside the measurements that remain.
For a practical assessment, perturb influential inputs within defensible ranges and examine how the result changes. Compare alternative valid processing choices, stratify errors by landscape or season and use independent reference data. Classification summaries should include class specific errors rather than relying on one overall accuracy figure. For continuous estimates, examine bias and the distribution of residuals as well as an aggregate error statistic. A useful final product states the tested domain, describes meaningful limitations and shows whether the uncertainty is small enough for the intended decision.
Preserve a reproducible processing history
A result should be linked to the inputs and processing choices that produced it. Record source identifiers, software versions, configuration values, reference data versions, and the time of processing. The record does not need to expose every internal implementation detail to the end user. It must preserve enough information for the producing team to investigate a result, reproduce a comparison, and explain why a revised product differs from an earlier version.
Version changes that can affect the meaning of the output. Updated boundaries, a new quality mask, revised calibration, different model parameters, or altered aggregation rules can all change results even when the source imagery is unchanged. Avoid overwriting an earlier product without retaining a suitable history. A clear relationship between versions helps users distinguish an improvement in processing from a real change in the observed surface.
Use representative regression cases when modifying the workflow. Select cases that cover ordinary conditions and known failure modes, then compare meaningful outputs before and after the change. Investigate differences against the intended purpose of the revision rather than assuming that a closer visual match is always preferable. Preserve the review decision with the version record. Reproducibility becomes practical when the team can trace a result through a documented sequence of inputs, transformations, tests, and delivery decisions.
Organise imagery and results for reliable retrieval
A useful storage design helps people and software find the right observation without relying on informal knowledge of folder names. Separate immutable source data from temporary processing files and delivered products. Give each observation a stable identifier and preserve its acquisition metadata alongside the file. A predictable organisation reduces the chance that a later analysis accidentally uses a preview, an outdated result, or an intermediate product whose meaning has not been documented.
Choose an indexing scheme that reflects the questions the workflow needs to answer. Location, acquisition time, source, product type, and processing version are often useful search dimensions. The physical arrangement of files can differ from the logical catalogue, provided that the relationship is maintained reliably. Record checksums or other integrity information where appropriate, and test whether an observation can be recovered using the catalogue rather than a particular operator's memory.
Define retention rules for source, intermediate, and delivered information. Some intermediate products are inexpensive to reproduce, while others embody costly preparation or expert review. Keep the inputs and configuration needed to rebuild a result before removing reproducible files. Test backup and recovery procedures with representative products, including their metadata and geographic references. Reliable retrieval is demonstrated by a successful reconstruction of useful information, rather than by the existence of an untested copy.
Bring the evidence back to the decision
The practical outcome should be a short observation plan that another team can follow. It should name the decision, the required evidence, the responsible roles, and the conditions that trigger a field visit or further analysis. Keep the plan small enough to test, then revise it using the results of real inspections. A useful monitoring workflow improves because its assumptions are examined systematically, and its observations remain connected to decisions throughout the process.
Sources & further reading
Explore the bhumisat spacecraft concept and our vision towards 2030, or return to the journal.



