Skip to content

Historical Potential ScoreΒΆ

πŸ“– OverviewΒΆ

The Historical Potential Score analytic provides an indicator of the average potential score over past years for a selected crop and season, based on cumulative NDVI (Normalized Difference Vegetation Index). It serves as a benchmark to compare field performance across different areas within a region or across different years. A Risk Score is also provided based on the variability of the past seasons.

The figure below illustrates the expected NDVI development for a typical annual grain crop. The analytic transforms the NDVI time series into a potential score, enabling comparisons between fields in the same region or across historical seasons.

Potential Score


πŸ—‚οΈ Baseline DataΒΆ

  • NDVI MR/LR Time Series

βš™οΈ API AccessΒΆ


βš™οΈ Parameters & VariablesΒΆ

General ParametersΒΆ

Parameter Variable Name Description Type
ID id EarthDaily Agro internal ID string
Geometry geometry Geometry of the Area of Interest (WKT format) string
Historical Seasons (Optional) historicalSeasons List of years to compute historical potential and risk scores (e.g., [2022, 2021, 2019]) List[int]

Input ParametersΒΆ

Parameter Variable Name Description Type
Season Duration seasonDuration Duration of the season in days int
Season Start Day seasonStartDay Start day of the season (1–31) int
Season Start Month seasonStartMonth Start month of the season (1–12) int
Threshold Start thresholdStart NDVI threshold (e.g., 0.7) float
Year (Optional) year Reference year for the season. Used to define the 5-year historical window. Example: 2022 int
Data Source (Optional) dataSource Data resolution: LR or MR. Defaults to LR string

OutputΒΆ

Parameter Variable Name Description Type
Potential Scores PotentialScores Array of potential scores and corresponding seasons object
Average Potential Score AveragePotentialScore Mean potential score over the last five years double
Olympic Mean Score OlympicMeanPotentialScore Mean score excluding NaNs and the highest value double
Standard Deviation StandardDeviation Standard deviation of potential scores over the last five years double
Season Breaks SeasonBreaks Array indicating whether a season's score is < 70% of the Olympic mean object
Risk Score RiskScore Calculated as (StandardDeviation / AveragePotentialScore) Γ— 100 double

πŸ“Š Performance and AccuracyΒΆ

  • Tested Crops: Corn and Soybeans
  • Tested Regions: Brazil
  • Average Generation Time: < 1 second

πŸ“œ Rules for Defining Historical PeriodsΒΆ

If historicalSeasons is provided:ΒΆ

  • If 3 or more years are provided:
  • Use them directly to compute potential and risk scores.
  • If fewer than 3 years:
  • If year is provided:
    • start_year = year - 5
    • end_year = year - 1
  • If year is not provided:
    • end_year = max(historicalSeasons)
    • start_year = end_year - 4

If only year is provided:ΒΆ

  • start_year = year - 5
  • end_year = year - 1

If neither is provided:ΒΆ

  • A ValueError is raised.

πŸ’Ό Use Case and Product IntegrationΒΆ

This analytic is used in:


πŸ“š GlossaryΒΆ

Term Description
NDVI (Normalized Difference Vegetation Index) Index that measures vegetation health based on visible and near-infrared light reflectance. Values range from -1 to 1, with higher values indicating denser, healthier vegetation.
MR / LR Image resolutions: MR (Medium Resolution) and LR (Low Resolution). Define the spatial detail level of the NDVI data used.
Season Duration Duration of the crop season, in days, used to calculate cumulative NDVI.
Season Start Day / Month Day and month marking the beginning of the crop season. Define the starting point for NDVI accumulation.
Threshold Start NDVI value used as a threshold to consider the start of relevant vegetative growth.
Potential Score Indicator of the productive potential of an area based on cumulative NDVI during the season.
Average Potential Score Mean of historical potential scores over the last five years.
Olympic Mean Mean calculated by excluding the highest value and NaNs, used to reduce the impact of outliers.
Standard Deviation Measure of variability in historical potential scores. Higher values indicate greater uncertainty.
Risk Score Risk index calculated as: (Standard Deviation / Average) Γ— 100. Indicates the stability of potential over time.
Season Break Boolean indicator showing whether a season's score was significantly below the historical average (less than 70% of the Olympic Mean).
WKT (Well-Known Text) Standard format for representing spatial geometries such as polygons, points, and lines.
AOI (Area of Interest) User-defined area for analysis.