API

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 (1). It serves as a benchmark to compare field performance across different areas within a region or across different years. A Risk Score (2) is also provided based on the variability of the past seasons.

1. 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.

2. Risk Score🔗

   Risk index calculated as: (Standard Deviation / Average) × 100. Indicates the stability of potential over time.

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 (1), enabling comparisons between fields in the same region or across historical seasons.

1. Potential Score🔗

   Indicator of the productive potential of an area based on cumulative NDVI during the season.

🗂️ Baseline Data🔗

The analytic uses NDVI time series data available at both MR (1) and LR (2) resolutions to calculate historical potential and risk scores for agricultural fields.

1. MR images🔗

   Medium Resolution imagery are satellite optical images with a resolution ranging from 10m to 30m.

2. LR images🔗

   Image resolutions: MR (Medium Resolution) and LR (Low Resolution). Define the spatial detail level of the NDVI data used.

⚙️ API Access🔗

⚙️ Parameters & Variables🔗

General Parameters🔗

Input Parameters🔗

Output🔗

📊 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.

Here is the chart explaining historical periods:

flowchart TD
    Start([Start]) --> CheckHistorical{historicalSeasons<br/>provided?}

    CheckHistorical -->|Yes| CheckCount{3 or more<br/>years?}
    CheckHistorical -->|No| CheckYearOnly{year<br/>provided?}

    CheckCount -->|Yes| UseDirect[Use historicalSeasons directly<br/>to compute potential and risk scores]
    CheckCount -->|No| CheckYear{year<br/>provided?}

    CheckYear -->|Yes| CalcWithYear1[start_year = year - 5<br/>end_year = year - 1]
    CheckYear -->|No| CalcWithMax[end_year = max historicalSeasons<br/>start_year = end_year - 4]

    CheckYearOnly -->|Yes| CalcWithYear2[start_year = year - 5<br/>end_year = year - 1]
    CheckYearOnly -->|No| NoData[No valid input]

    UseDirect --> End([End])
    CalcWithYear1 --> End
    CalcWithMax --> End
    CalcWithYear2 --> End
    NoData --> End

    style UseDirect fill:#90EE90
    style CalcWithYear1 fill:#87CEEB
    style CalcWithMax fill:#87CEEB
    style CalcWithYear2 fill:#87CEEB
    style NoData fill:#FFB6C6

💼 Use Case and Product Integration🔗

This analytic is used in:

• Portfolio