Engineering Editorial draft

Writing requirements from an Earth observation need on highland coffee farms — an interpretation guide

Explore writing requirements from an earth observation need on highland coffee farms. Practical guidance for interpretation and defensible observations.

ShareLinkedInFacebookXWhatsApp

Editorial draft. This generated working guide combines technical guidance with an illustrative context and requires individual editorial review.

Editorial illustration: Writing requirements from an Earth observation need on highland coffee farms — an interpretation guide
Original editorial illustration for this article. Shapes and colours are conceptual, not measured observation data.

Remote observations show patterns, while practical decisions depend on explaining what those patterns could mean. Interpretation therefore requires more than locating a high or low value on a map. A useful analysis considers the timing of the observation, the physical processes that influence the measurement, and the information available from complementary sources. This perspective separates an observed signal from a proposed explanation and from an action recommended to a user. Keeping those stages distinct makes it easier to investigate alternative causes, communicate ambiguity, and choose a proportionate next step.

This working guide considers writing requirements from an earth observation need on highland coffee farms. The immediate decision is to select coffee plots for field review. Useful reference evidence includes shade cover, coffee growth stage and terrain-aware field notes. The case is an illustrative planning context, with assumptions to check against the actual sensor, landscape and project requirements.

The setting: Highland coffee farms

Coffee farms in highland terrain can combine coffee plants, shade trees, paths, soil and other crops within the same image footprint. The observed canopy may therefore describe the wider agroforestry system as much as the coffee itself. Before choosing an analytical method, decide whether the intended output concerns farm-level vegetation, shade management or a coffee-specific variable. These are distinct tasks and require different reference observations and levels of spatial detail.

Slope, aspect and changing illumination complicate comparisons between locations and acquisition dates. A dark patch on a shaded slope should not immediately be classified as stressed vegetation. Inspect terrain and shadow conditions alongside the image quality information, and compare areas with similar observation geometry where possible. Farm boundaries should also be checked carefully because small geolocation differences can move a sampling footprint from coffee into a neighbouring tree canopy or access track.

Field teams should document coffee stage, shade structure, recent pruning and the location of the plants or plots they measure. Samples collected beside a convenient path may not represent the full farm. A practical service could help organise visits or describe changes in farm cover, but claims about coffee condition or production need their own validation. Preserve these distinctions in the report so that a useful landscape observation is not presented as a plant-level diagnosis.

Translate a user decision into measurable behavior

A mission requirement should connect to a decision that someone needs to make with the observations. Begin by defining the target phenomenon, geographic area, relevant season and consequence of delay or error. A request to monitor crops is too broad to guide a spacecraft design. The useful question is which crop condition must be distinguished, at what field scale, how often, and with what confidence.

Translate these needs into product requirements before allocating spacecraft specifications. Consider spatial detail, spectral information, radiometric performance, location accuracy, usable revisit and delivery latency. Geometric revisit describes observation opportunities; clouds and acquisition constraints can make usable observations much less frequent. Define terms carefully so that a requirement for delivered, cloud screened coverage cannot be satisfied merely by showing an orbit access calculation.

Keep traceability through design and verification

Write individual requirements that can be checked using a stated method and acceptance criterion. Identify the conditions under which each applies, such as target brightness, viewing angle or operating temperature. Avoid combining several unrelated promises in one sentence. Retain a rationale and a link to the higher level need, allowing reviewers to understand why the requirement exists and what would change if it were relaxed.

Allocate performance across the payload, spacecraft, ground segment and processing chain. Image sharpness may depend on optics, detector sampling, motion and resampling. Delivery time may depend on acquisition planning, onboard storage, ground contacts and processing queues. Budgets make these contributions visible and expose conflicts between objectives. Preserve margin where uncertainty remains, and record assumptions rather than hiding them inside an optimistic headline specification.

Plan verification while writing the requirement. Inspection, analysis, demonstration and testing each provide different kinds of evidence. Define the test configuration, reference measurement, uncertainty and pass criterion early enough to influence the design. Verification asks whether the implemented system meets its requirements; validation asks whether that system serves the intended use. Representative users and realistic application examples can reveal an inadequate requirement even when every hardware test passes. Manage revisions through a controlled record that describes their consequences for dependent requirements, budgets and tests. This turns requirements into a working design tool rather than a document assembled only before a review.

Deliver quality flags that users can interpret

Quality information should describe the condition of an observation in terms that remain useful through the workflow. A single valid or invalid label may be sufficient for some calculations, but operational users often need to know why an observation was qualified. Distinguish acquisition limitations, processing failures, uncertain reference matches, and conditions that make interpretation ambiguous. These categories point towards different responses and should not be merged without a clear purpose.

Define a small, documented set of flags with stable meanings. Record whether a flag applies to a complete scene, a geographic unit, an individual measurement, or a derived result. A unit containing a mixture of qualified and unqualified observations may also require a coverage measure. Include the rule used to combine flags when summarising data so that a favourable average does not conceal a substantial fraction of unusable input.

Test the flags with the people receiving the product. Ask what they would do differently for each state and whether the terminology supports that choice. Keep the original flags available even if the interface presents a simpler summary. When flag definitions change, version the rules and review their effects on historical comparisons. Useful quality communication makes the condition of the evidence visible at the moment when a user decides how much confidence to place in the result.

Match the timing of reference observations

The value of a reference measurement depends partly on how well its timing matches the observation being evaluated. A surface, crop, water body, or instrument state may change between the two measurements. Start by documenting the acquisition time of every source and the period over which the reference observation applies. Avoid treating a date entered during data upload as though it were necessarily the time when the measurement was collected.

Define an acceptable timing relationship for the application. A slowly changing structural feature may tolerate a broader comparison window than a rapidly changing surface condition. The window should be justified by the process being studied and by any available contextual records. If conditions change within that period, consider separating the observations into suitable groups rather than combining them under a single assumption of comparability.

Preserve information about interventions and events between observations. A management operation, rainfall episode, disturbance, or change in sensor configuration can alter the interpretation of a comparison. Record the event and decide whether the pair remains suitable for evaluation. Where the timing mismatch cannot be resolved, describe the comparison as qualified evidence. This is more informative than allowing an uncertain match to influence a performance statistic without explanation.

Bring the evidence back to the decision

A strong interpretation states what was observed, which explanations remain plausible, and what additional evidence would help distinguish them. Avoid presenting a convenient label as a confirmed cause when the measurements support only a broader pattern. Connect the proposed next step to the significance of the decision and the confidence available. This creates an interpretation that a field team, analyst, or project partner can examine, challenge, and improve as further observations become available.

Sources & further reading

  1. NASA: Systems engineering handbook appendices
  2. NASA: Systems engineering handbook

Explore the bhumisat spacecraft concept and our vision towards 2030, or return to the journal.

ShareLinkedInFacebookXWhatsApp
A CONVERSATION STARTS HERE

Build the next
perspective with us.

Tell the TechnoGIS team where you would like to collaborate.

Opens your email app so you can review and send your enquiry.