Trazo

A guide to annotating agricultural fields

The standard, protocols, and quality-assurance procedures used to hand-annotate the field boundaries that trained the Trazo models. It covers how a field is defined, how boundaries are drawn, the decision rules for ambiguous cases, and how the annotation procedure itself was validated against ground truth and across annotators.

Adapted from the Trazo technical note (Grupp et al. 2026), Methodology and Appendix A · Read the full note

1 Definition

What is a field?

At the core of these guidelines is a single, shared definition of an agricultural field.

Our definition

A field is a clearly bounded land unit that is actively or recently managed. It is visibly distinct from natural vegetation across multiple time periods and is used in the production of crops, pasture, or other consumable goods. Fields may incorporate some natural features if those features have been subsumed into the production process. Areas overtaken by regrowth, or lacking signs of management, are not included.

A field includes farms, pastures with discernible management, and plantations of tree crops whose pattern is distinguishable in Sentinel-2 imagery.

In manual annotation, the goal is to delineate the idealized boundaries of such fields, in the manner we would want an AI model to automatically delineate them.

Boundaries are produced without concern for crop type. While annotating in the Chiquitania and Mato Grosso, it proved nearly impossible to reliably differentiate among annual crops, and even pasture or cover crops were often hard to separate from annual crops, by visual inspection, even with temporally coincident very-high-resolution imagery. We therefore took a field-inclusive approach: annotators trace every field that shows clear signs of human management.

2 Method

The annotation approach

Annotators trace digital field boundaries on each Sentinel-2 chip, using Planet Labs basemaps as a reference.

Use multi-temporal imagery

Always view at least two Sentinel-2 time windows, typically the start and end of the growing season, and align them with Planet Labs monthly basemaps from the same year. Comparing time windows improves boundary clarity and avoids mislabeling mid-harvest fields.

Annotate the whole field, even beyond the chip

Annotate every field, and the entirety of each field, even if only part of it falls inside the chip (Figure 1a). Capturing the complete boundary, rather than just the portion inside the chip, preserves flexibility for downstream applications and gives an unbiased estimate of field size.

Draw at the visual edge, including mixed pixels

Boundaries should be placed at the visual edge of the field, even where this includes "mixed pixels" that blur the interior and exterior. This ambiguity is important for model learning, because real-world boundaries are rarely crisp.

Zoom out for context

Periodically zoom out to understand the broader landscape. This clarifies whether a patch is part of a managed system or natural regrowth, and avoids creating unnecessary boundaries from subtle color variations seen when inspecting too closely.

Distinguish managed from natural vegetation

Annotate fields with visible boundaries, distinct textures, and signs of active management, even when fallow. This matters especially in regions like the Amazon, where shifting cultivation is common. Tree crowns arranged in rows or other planting structure indicate management. Do not annotate dense regrowth, contiguous natural tree crowns, or randomly distributed vegetation. Label pastures only where there are clear signs of clearing or maintenance.

The two figures below show the core protocol. Click any figure to enlarge it.

Natural vegetation subsumed into a field or serving as a border
Figure 1a. Example fields overlaying sampled chips annotated in the Chiquitania ecoregion. Both the Sentinel-2 chip (model input) and temporally coincident Planet Labs basemaps (annotation reference) are visible. Fields are annotated completely even where they extend outside the chip.
Example fields overlaying sampled chips in the Chiquitania ecoregion, with Sentinel-2 and Planet Labs reference imagery
Figure 1b. Natural vegetation can be subsumed into the field or serve as a border. A useful decision rule: "If you were standing in the middle of the field and this feature was in front of you, could you cross it on foot?"
A fully labeled chip in the Uruguayan Savannah
Figure 1c. A fully labeled chip in the Uruguayan Savannah; the pale polygons are entirely labeled fields.
A partially completed chip in the Uruguayan Savannah showing the annotation process
Figure 1d. A chip in the Uruguayan Savannah with fields partially completed by an annotator, showing the process. This chip contains mixed pasture and annual crops; separating annual crops from pasture is, in many contexts, impossible from the annotator's perspective.

3 Guidelines

Complete annotation guidelines

The full set of guidelines for manually annotating field boundaries.

These protocols were continually refined and augmented throughout the labeling effort to improve consistency and accuracy, with the aim of producing boundaries that are clear, reproducible, and useful to downstream users.

4 Edge cases

Decision rules for ambiguous cases

Additional decision points specified to guide consistent calls on the hard cases.

In general, prioritize inclusivity over exclusivity: if a field has a clear boundary and is visually distinct from surrounding natural areas, consider it for annotation. Our guiding principle was framed this way: "Imagine an end user is viewing the final product of field boundaries generated by Trazo models. Looking at the candidate field you are considering, if its absence in the final product would be perceived as an omission error by the end user, then annotate the field."

Conversely, if the land appears unmanaged, managed for non-cultivation purposes such as urban development, naturally disturbed, or in the process of returning to forest, it should be excluded.

5 Quality assurance

Peer review & quality assurance

Every field boundary annotation passed through three rounds of peer review.

Consensus labeling and quality assurance are key to accelerating performance gains in model development, especially for active learning, where informative but challenging samples are selected for targeted annotation (Estes et al. 2022). Newly onboarded annotators always label the calibration set first, before contributing to the corpus.

6 Conversion

Recent conversion & burned areas

Critical to the EUDR use case is delineating recently converted fields and the practices that cause conversion.

Annotators include fields present in the later time period that were created by the conversion of nature between the planting and harvest windows. These recent conversions are annotated when they have a discernible management pattern and can be represented as a field object, even though they are absent from the earlier window. Trazo models thereby encode recent conversion.

Sample chips where conversion occurred between the planting and harvest time windows, with pink burn scars marking newly opened fields
Figure 2. Samples where conversion occurred between the two time windows. Row 1: two chips from the same area and year, one in planting and one in harvest, from the Mato Grosso low-confidence active-learning set. In the harvest season, new fields were opened by burning, visible as pink burn scars; these are labeled despite their absence in the earlier window. Row 2: a second example. Recent conversions are annotated when they show a discernible management pattern. Imagery: Sentinel-2.

Burned areas

Burned areas are labeled only when they show human-induced regularity, such as burning in rows or other structured management. Burn scars without a distinguishable, managed object are not annotated. Each panel below cycles through four example chips.

Burning with a clear management pattern, frame 1 Burning with a clear management pattern, frame 2 Burning with a clear management pattern, frame 3 Burning with a clear management pattern, frame 4
Figure 3a. Clear, regular burning pattern. Labeled.
Burn pattern with vegetation recovering, frame 1 Burn pattern with vegetation recovering, frame 2 Burn pattern with vegetation recovering, frame 3 Burn pattern with vegetation recovering, frame 4
Figure 3b. Burn pattern with vegetation recovering. These were annotated.
Burning obscured by haze, frame 1 Burning obscured by haze, frame 2 Burning obscured by haze, frame 3 Burning obscured by haze, frame 4
Figure 3c. Burning with haze from clouds and fires. These were annotated.
Burning without a clear management pattern, frame 1 Burning without a clear management pattern, frame 2 Burning without a clear management pattern, frame 3 Burning without a clear management pattern, frame 4
Figure 3d. Burning without a clear pattern. Not annotated.

Figure 3. Examples of regularized burning versus burning without distinguishable objects. Imagery: Sentinel-2.

7 Scope

Agricultural classes

The field-inclusive approach corresponds to the following MapBiomas classes treated as agriculture.

Table A-1. MapBiomas classes included in the agricultural class
CodeClass (English)Group
9Forest plantationSilvicultura
15PasturePastagem
20Sugar caneCana
21Mosaic of usesMosaico de usos
35Palm oilDendê
39SoybeanSoja
40RiceArroz
41Other temporary cropsOutras lavouras temporárias
46CoffeeCafé
47CitrusCitrus
48Other perennial cropsOutras lavouras perenes
62Cotton (beta)Algodão (beta)

8 Validation

Validating the annotation procedure

Two complementary studies tested whether the annotation procedure produces accurate, consistent boundaries: comparison against in-situ-informed ground truth, and an inter-annotator calibration. Click any figure to enlarge it.

8.1 Consistency with ground truth

Manual annotations were compared with the Cerrado in-situ-informed ground-truth dataset of Oldoni et al. (2020), the 1,854 Brazilian fields included in the Fields of The World benchmark. Consistency is defined as similar overall size, object shape, and overlap. A single point was sampled at random within each field, rather than at its center, to avoid biasing annotators with morphology cues; 300 of the 1,854 points were then randomly selected, and annotators were asked whether a field boundary existed at each point and, if so, to draw it.

Examples of manually annotated samples (dotted lines) compared to ground truth samples (orange)
Figure 4. Manually annotated samples (dotted lines) compared to ground-truth samples (orange). Annotators drew a boundary, if a field was present, around random point locations (blue points) within randomly selected ground-truth fields, so not all ground-truth fields have a corresponding manual annotation. Ground truth: Oldoni et al. (2020).
Table 5. Metrics by field-size quartile: manual annotations vs. ground-truth boundaries
QuartileField size (ha)IoU meanIoU medianCentroid mean (m)Centroid median (m)BLR meanBLR median
Q10.5 to 14.00.760.8553.3011.450.940.98
Q214.5 to 35.50.760.8966.6715.190.970.98
Q336.3 to 96.60.780.9391.7116.321.131.00
Q496.8 to 508.40.910.9783.7310.651.061.00

IoU = intersection over union; BLR = boundary length ratio. Source: Oldoni et al. (2020).

Agreement was highest for the largest fields (Q4: median IoU 0.97, median centroid distance 10.65 m). Smaller fields (Q1 and Q2) showed more variability (mean IoU 0.76), with a gap between mean and median indicating a subset of difficult cases. The elevated BLR in Q3 and Q4 suggests annotators traced slightly longer boundaries than the ground truth for larger fields, sometimes subdividing fields the ground truth treats as a single unit.

The 16 best IoU matches between manual annotations and ground truth
Figure 5. The 16 best IoU matches between manual annotations and ground truth.
The 16 worst IoU matches between manual annotations and ground truth
Figure 6. The 16 worst IoU matches between annotations and ground truth.

8.2 Inter-annotator agreement

When new annotators join the project, after completing their training they annotate a fixed calibration set: all fields they identify within 50 chips from one Sentinel-2 tile in Mato Grosso. These first annotations are compared against reference annotations drawn by the project data scientist who developed the criteria, calibrating new annotators to the project standard.

0.91
Median IoU between annotators and reference
0.80
Mean IoU across the four annotator pairs
0.02
Std. dev. of mean IoU across pairs
12.66 m
Median centroid distance across all pairs
Table 6. Each annotator vs. the reference annotator
Annotator pairIoU meanIoU medianHausdorff meanHausdorff medianCentroid meanCentroid medianBLR meanBLR median
Reference vs. Annotator 10.780.91209.2842.8681.0112.091.031.00
Reference vs. Annotator 20.800.91194.3750.2574.4614.611.030.99
Reference vs. Annotator 30.810.91181.0747.1968.2413.261.000.99
Reference vs. Annotator 40.810.92180.8440.7271.3110.691.040.99
Mean0.800.91191.3945.2673.7612.661.030.99
Std. dev.0.020.0113.504.285.461.670.020.01

Polygons were matched via spatial intersection and mutual best-IoU matching, using the reference annotator as the common comparison point. IoU = intersection over union; BLR = boundary length ratio.

Total field counts ranged from 203 to 250 across annotators (reference: 215), differences of up to about 20 percent on a first attempt with only brief training. Even so, a median IoU of 0.91 represents near-perfect polygon overlap. For context, this is well above the 0.786 human inter-annotator benchmark reported for the Cityscapes dataset, and far above the mean IoU of 0.54 observed between expert medical-image annotators; industry standards broadly treat IoU above 0.8 as strong agreement. These results indicate that the annotation rules and guidelines produce consistent boundaries across annotators.

The 16 best IoU matches between the annotator reference and the annotation team
Figure 7. The 16 best IoU matches between the reference annotator and the annotation team, with near-perfect agreement.
The 16 worst IoU matches between the annotator reference and the annotation team on Mato Grosso
Figure 8. The 16 worst IoU matches between the reference annotator and the annotation team (Mato Grosso), illustrating differences in interpretation.