> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eyesotope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Season Analytics

> Cross-field yield and health comparison tools for season-wide performance analysis

# Season Analytics

Season Analytics provides cross-field comparison tools on the Season Detail page. Compare yield potential and health scores across all fields in a season to identify top performers, underperformers, and patterns across your farm.

<CardGroup cols={2}>
  <Card title="Yield Race" icon="ranking-star">
    Compare estimated yields across fields using 3 FAO methods — find top and bottom performers.
  </Card>

  <Card title="Health Race" icon="heart-pulse">
    Compare AI-generated health scores across fields — identify crops that need attention.
  </Card>
</CardGroup>

## Accessing Season Analytics

1. Navigate to **Seasons** and open a season
2. In the season detail sidebar, look for the **Analytics** section
3. Select **Yield Race** or **Health Race**

<Info>
  Analytics require yield estimates and/or AI health analyses to be computed for the fields in the season. Yield estimates are generated automatically via background tasks. Health scores come from the AI Field Analysis feature.
</Info>

***

## Yield Race

The Yield Race compares **Ya/Ym ratios** (actual yield as a fraction of maximum yield) across all fields in the season. Data comes from persisted `YieldEstimate` records computed using the 3 FAO methods.

### Method Selector

Toggle between estimation methods at the top:

| Method | Name          | Description                                            |
| ------ | ------------- | ------------------------------------------------------ |
| **A**  | FAO Paper 33  | Simple single-equation approach                        |
| **B**  | AquaCrop-Lite | Recommended — separates transpiration from evaporation |
| **C**  | Dual Kc       | Advanced — uses satellite NDVI for crop coefficients   |

### Visualizations

<AccordionGroup>
  <Accordion title="Ranked Bar Chart">
    All fields ranked by Ya/Ym ratio for the selected method. Bars are color-coded:

    * 🟢 Green — ≥ 90% (excellent)
    * 🟡 Amber — 75–90% (good)
    * 🟠 Orange — 50–75% (fair)
    * 🔴 Red — \< 50% (poor)

    When there are more than 10 fields, a **Top 5 / Bottom 5** toggle appears with a visual separator showing the omitted middle fields.
  </Accordion>

  <Accordion title="Method Agreement">
    Shows the spread (divergence) between the 3 methods for each field. Fields with narrow agreement across all methods indicate reliable estimates. Wide divergence suggests model uncertainty for that field.

    Only fields with divergence > 0.5% are shown, filtering out noise. Hover over any bar to see individual Method A, B, and C values with color-coded dots.
  </Accordion>

  <Accordion title="Deficit vs. Yield Scatter">
    A scatter plot where each dot represents a field:

    * **X-axis** — Water deficit (mm)
    * **Y-axis** — Ya/Ym ratio
    * **Dot size** — Field area (hectares)

    Reveals whether water is the primary yield-limiting factor. A strong downward trend means water deficit is directly reducing yields.
  </Accordion>

  <Accordion title="Stress Hotspot Table">
    A sortable, interactive table with a **stage-loss sparkline** per field. The sparkline shows tiny V/F/Y/R bars representing yield loss at each phenological stage:

    * **V** (Vegetative) — Canopy establishment losses
    * **F** (Flowering) — Pollination-period losses (most critical)
    * **Y** (Yield Formation) — Grain fill losses
    * **R** (Ripening) — Maturation losses

    Click any row to navigate to that field's detail page.
  </Accordion>

  <Accordion title="Season Summary Cards">
    Aggregate statistics at the top:

    * Average Ya/Ym across all fields
    * Best and worst performing fields
    * Total estimated production
  </Accordion>
</AccordionGroup>

### Export

Download the complete yield comparison data as CSV for external analysis.

***

## Health Race

The Health Race compares **AI-generated health scores** across all fields, providing a quick overview of which parts of your farm need attention.

### Health Tiers

| Tier      | Score Range | Color     |
| --------- | ----------- | --------- |
| Excellent | ≥ 90        | 🟢 Green  |
| Good      | ≥ 70        | 🔵 Blue   |
| Fair      | ≥ 50        | 🟡 Amber  |
| Poor      | ≥ 30        | 🟠 Orange |
| Critical  | \< 30       | 🔴 Red    |

### Visualizations

<AccordionGroup>
  <Accordion title="Ranked Bar Chart">
    Fields ranked by health score with tier-based coloring. Immediately see which fields are struggling.
  </Accordion>

  <Accordion title="Health Distribution Donut">
    A donut chart showing how your fields distribute across the 5 health tiers. Quickly assess overall farm health at a glance.
  </Accordion>

  <Accordion title="Health vs. Yield Scatter">
    A scatter plot correlating AI health scores (X-axis) with modeled Ya/Ym yield ratios (Y-axis). Reveals whether health assessments align with yield models — strong correlation validates both analysis methods.
  </Accordion>

  <Accordion title="Detailed Fields Table">
    Full table with columns for field name, health score, health label, and yield data. Sortable by any column for custom ranking.
  </Accordion>

  <Accordion title="Summary Cards">
    Average health score, count of fields per tier, best and worst performers.
  </Accordion>
</AccordionGroup>

### Data Source

Health scores come from the **AI Field Analysis** feature. The AI synthesizes data from multiple sources — satellite imagery (NDVI), NASA POWER climate data, soil conditions, and weather — to produce a composite health score (0–100) and label for each field.

<Tip>
  Run AI Field Analysis regularly on your fields to keep health scores current. The Health Race always uses the **latest** analysis for each field.
</Tip>

***

## Cross-Feature Integration

Season Analytics brings together data from multiple Eyesotope features:

```
AI Field Analysis ──→ Health Score ──→ Health Race
                                        │
Crop Intelligence ──→ Ya/Ym Ratios ──→ Yield Race
    (3 FAO Methods)                     │
                                        └──→ Health vs. Yield correlation
```

<Note>
  Both Yield Race and Health Race display fields using their **alias** (nickname) when available, falling back to the field name. Set field aliases from the field detail page for cleaner analytics displays.
</Note>