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.

ποΈ 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
yearis provided:start_year = year - 5end_year = year - 1
- If
yearis not provided:end_year = max(historicalSeasons)start_year = end_year - 4
If only year is provided:ΒΆ
start_year = year - 5end_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. |