Growth

Crop Growth & Health APIs

Iteris’ Crop Growth APIs include crop-specific growth models, including Crop Growth Model Feedback, Crop Harvest Modeling, and Crop Nutrient (Nitrogen) Decision Support.

Crop Nutrient Decision

last updated 11/12/18

The ClearAg Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to the crops. This model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. It allows for the provision of several types of field-level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity and planting date via the Crop Growth Models. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs. Please refer to the Appendix for a list of Supported Crops by Feature.

This bundle requires and includes the Accounts API and the Crop Growth Model bundle.

Multiple data center regions are available to meet users’ legal and performance needs. Currently, data centers exist within the United States (ag.us.clearapis.com) and the European Union (ag.eu.clearapis.com). Account and related information such as fields and growths are not shared between these regions. Data resolution and availability also vary by region, and each region requires a unique set of credentials. Please contact your account representative for account creation, data segregation, and data coverage information.

Please note that API responses are currently only provided in English.

Iteris requires the use of https when working within the ClearAg APIs.

Additional API information is available in the Appendix.

Nitrogen Advisor

Barley Nitrogen Advisor - v1.0

The ClearAg Barley Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to barley crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Barley Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/barley/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "late" relative maturity are expected to mature relatively slowly. Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/barley/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        }
    },
    "data":{
        "2016-07-25":{
            "agdd":2584.0,
            "air_temp_max":91.0,
            "air_temp_min":59.0,
            "gdd":43.0,
            "last_stage":"13.0",
            "new_stage":"15.0",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":77.6,
                "nitrate_0to2":0.6,
                "nitrate_100to200":0.1,
                "nitrate_10to20":9.4,
                "nitrate_20to40":35.1,
                "nitrate_2to5":1.3,
                "nitrate_40to70":28.4,
                "nitrate_5to10":2.1,
                "nitrate_70to100":0.7,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":-0.9,
                "immobilized_0to2":-0.3,
                "immobilized_100to200":-0.1,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":-0.5,
                "immobilized_40to70":0.0,
                "immobilized_5to10":0.0,
                "immobilized_70to100":0.0,
                "leached":0.0,
                "leached_0to2":-5.1,
                "leached_100to200":0.0,
                "leached_10to20":-13.0,
                "leached_20to40":13.4,
                "leached_2to5":-7.1,
                "leached_40to70":22.5,
                "leached_5to10":-11.4,
                "leached_70to100":0.7,
                "leached_below_current_root_depth":0.0,
                "leached_below_maximum_root_depth":0.0,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":41.2,
                "realized_from_soil_organic_matter_0to2":4.4,
                "realized_from_soil_organic_matter_100to200":0.2,
                "realized_from_soil_organic_matter_10to20":14.1,
                "realized_from_soil_organic_matter_20to40":6.5,
                "realized_from_soil_organic_matter_2to5":6.4,
                "realized_from_soil_organic_matter_40to70":0.2,
                "realized_from_soil_organic_matter_5to10":9.4,
                "realized_from_soil_organic_matter_70to100":0.1,
                "uptaken_by_crop":0.0,
                "uptaken_by_crop_0to2":0.0,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":0.0,
                "uptaken_by_crop_20to40":0.0,
                "uptaken_by_crop_2to5":0.0,
                "uptaken_by_crop_40to70":0.0,
                "uptaken_by_crop_5to10":0.0,
                "uptaken_by_crop_70to100":0.0,
                "uptaken_by_crop_optimal":0.0,
                "uptaken_by_crop_optimal_0to2":0.0,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":0.0,
                "uptaken_by_crop_optimal_20to40":0.0,
                "uptaken_by_crop_optimal_2to5":0.0,
                "uptaken_by_crop_optimal_40to70":0.0,
                "uptaken_by_crop_optimal_5to10":0.0,
                "uptaken_by_crop_optimal_70to100":0.0,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":120.0,
                "current_root_depth_unit":"cm",
                "indigenous_use_efficiency":0.0,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":120.0,
                "maximum_root_depth_unit":"cm",
                "nitrogen_available_unit":"kg/ha",
                "nitrogen_budget_unit":"kg/ha",
                "notes":{},
                "uptake_score":"n/a",
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "15.0":{
            "advisor":"Harvest",
            "description":"Dry weight of the kernels stops increasing.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"This stage is between Hard Dough (left) and Harvest Ripe (right)",
                    "url":".../Physiological_maturity.png"
                },...
            ],
            "name":"15.0 - Physiological Maturity",
            "order":"16"
        },...
    }
}

Canola Nitrogen Advisor - v1.0

The ClearAg Canola Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to canola crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Canola Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/canola/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," and "medium." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "medium" relative maturity are expected to mature relatively slowly. Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/canola/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        }
    },
    "data":{
        "2016-08-01":{
            "agdd":2125.5,
            "air_temp_max":79.0,
            "air_temp_min":65.0,
            "gdd":31.0,
            "last_stage":"ER",
            "new_stage":"R",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":8.4,
                "nitrate_0to2":0.0,
                "nitrate_100to200":2.5,
                "nitrate_10to20":0.5,
                "nitrate_20to40":0.7,
                "nitrate_2to5":0.0,
                "nitrate_40to70":1.1,
                "nitrate_5to10":0.1,
                "nitrate_70to100":3.4,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":-2.8,
                "immobilized_0to2":-2.1,
                "immobilized_100to200":-0.2,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":0.0,
                "immobilized_40to70":-0.2,
                "immobilized_5to10":0.0,
                "immobilized_70to100":-0.3,
                "leached":0.0,
                "leached_0to2":-2.3,
                "leached_100to200":0.7,
                "leached_10to20":-6.0,
                "leached_20to40":-0.6,
                "leached_2to5":-6.1,
                "leached_40to70":11.9,
                "leached_5to10":-4.8,
                "leached_70to100":7.3,
                "leached_below_current_root_depth":-0.6,
                "leached_below_maximum_root_depth":-0.6,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":29.2,
                "realized_from_soil_organic_matter_0to2":3.7,
                "realized_from_soil_organic_matter_100to200":2.3,
                "realized_from_soil_organic_matter_10to20":5.5,
                "realized_from_soil_organic_matter_20to40":6.0,
                "realized_from_soil_organic_matter_2to5":5.3,
                "realized_from_soil_organic_matter_40to70":1.9,
                "realized_from_soil_organic_matter_5to10":3.7,
                "realized_from_soil_organic_matter_70to100":0.8,
                "uptaken_by_crop":-37.1,
                "uptaken_by_crop_0to2":-0.1,
                "uptaken_by_crop_100to200":-0.2,
                "uptaken_by_crop_10to20":-3.2,
                "uptaken_by_crop_20to40":-12.5,
                "uptaken_by_crop_2to5":-0.4,
                "uptaken_by_crop_40to70":-15.4,
                "uptaken_by_crop_5to10":-0.8,
                "uptaken_by_crop_70to100":-4.5,
                "uptaken_by_crop_optimal":-523.5,
                "uptaken_by_crop_optimal_0to2":-8.5,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-143.9,
                "uptaken_by_crop_optimal_20to40":-201.3,
                "uptaken_by_crop_optimal_2to5":-59.7,
                "uptaken_by_crop_optimal_40to70":-45.1,
                "uptaken_by_crop_optimal_5to10":-58.0,
                "uptaken_by_crop_optimal_70to100":-6.9,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":44.0,
                "current_root_depth_unit":"in",
                "indigenous_use_efficiency":126.9,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":44.0,
                "maximum_root_depth_unit":"in",
                "nitrogen_available_unit":"lb/ac",
                "nitrogen_budget_unit":"lb/ac",
                "notes":{},
                "uptake_score":1.0,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "R":{
            "advisor":"Harvest",
            "description":"About one third of the seeds on the main stem have changed color; the crop is ready to swath.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"Mature",
                    "url":".../ripening4.png"
                },...
            ],
            "name":"Ripe",
            "order":"9"
        }
    }
}

Corn Nitrogen Advisor - v1.1

The ClearAg Corn Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to corn crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Corn Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.1/crop_health/corn/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={integer}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

integer

no

 — 

Classification indicating how early a variety matures. Valid values range from 70 to 130, with lower values indicating an "early" relative maturity and higher values indicating a "late" relative maturity. Default is 100.

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date.3

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues.3

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.1/crop_health/corn/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        },
    "data":{
        "2016-05-24":{
            "agdd":533.0,
            "air_temp_max":73.0,
            "air_temp_min":50.0,
            "gdd":11.5,
            "last_stage":"v3",
            "new_stage":"n/a",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":0.0,
                "nitrate":53.3,
                "nitrate_0to2":0.0,
                "nitrate_100to200":0.0,
                "nitrate_10to20":12.9,
                "nitrate_20to40":26.1,
                "nitrate_2to5":0.1,
                "nitrate_40to70":11.0,
                "nitrate_5to10":1.4,
                "nitrate_70to100":1.7,
                "nitrate_in_last_sample_depth":0.0
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":-2.3,
                "immobilized_0to2":-0.8,
                "immobilized_100to200":-0.1,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":-1.2,
                "immobilized_40to70":-0.1,
                "immobilized_5to10":0.0,
                "immobilized_70to100":-0.1,
                "leached":0.0,
                "leached_0to2":-3.9,
                "leached_100to200":0.1,
                "leached_10to20":-0.3,
                "leached_20to40":4.5,
                "leached_2to5":-3.5,
                "leached_40to70":7.6,
                "leached_5to10":-6.2,
                "leached_70to100":1.7,
                "leached_below_current_root_depth":-8.1,
                "leached_below_maximum_root_depth":0.0,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":7.0,
                "realized_from_soil_organic_matter_0to2":0.8,
                "realized_from_soil_organic_matter_100to200":0.0,
                "realized_from_soil_organic_matter_10to20":1.9,
                "realized_from_soil_organic_matter_20to40":1.8,
                "realized_from_soil_organic_matter_2to5":1.0,
                "realized_from_soil_organic_matter_40to70":0.2,
                "realized_from_soil_organic_matter_5to10":1.4,
                "realized_from_soil_organic_matter_70to100":0.0,
                "uptaken_by_crop":-1.4,
                "uptaken_by_crop_0to2":0.0,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":-0.7,
                "uptaken_by_crop_20to40":-0.2,
                "uptaken_by_crop_2to5":-0.1,
                "uptaken_by_crop_40to70":0.0,
                "uptaken_by_crop_5to10":-0.4,
                "uptaken_by_crop_70to100":0.0,
                "uptaken_by_crop_optimal":-2.1,
                "uptaken_by_crop_optimal_0to2":0.0,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-0.8,
                "uptaken_by_crop_optimal_20to40":-0.2,
                "uptaken_by_crop_optimal_2to5":-0.3,
                "uptaken_by_crop_optimal_40to70":0.0,
                "uptaken_by_crop_optimal_5to10":-0.6,
                "uptaken_by_crop_optimal_70to100":0.0,
                "volatized":-0.6,
                "volatized_0to2":-0.1,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":-0.2,
                "volatized_40to70":0.0,
                "volatized_5to10":-0.3,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":16.7,
                "applied_use_efficiency_unit":"%",
                "current_root_depth":49.0,
                "current_root_depth_unit":"cm",
                "indigenous_use_efficiency":20.2,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":149.0,
                "maximum_root_depth_unit":"cm",
                "nitrogen_available_unit":"kg/ha",
                "nitrogen_budget_unit":"kg/ha",
                "notes":{},
                "uptake_score":99.8,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "v3":{
            "advisor":"Nutrient",
            "description":"The plant has three leaves with visible collars. The stalk hasn't increased much in length. The growing point is still below the surface.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"V3 stage",
                    "url":".../Figure_16_ISUE300.jpg"
                },...
            ],
            "name":"V3 - 3 Leaves",
            "order":"3"
        },...
    }
}

Cotton Nitrogen Advisor - v1.0

The ClearAg Cotton Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to cotton crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Cotton Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/cotton/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac" or "kg/ha".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues.3

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/cotton/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        },
    "data":{
        "2016-08-01":{
            "agdd":2125.5,
            "air_temp_max":79.0,
            "air_temp_min":65.0,
            "gdd":31.0,
            "last_stage":"ER",
            "new_stage":"R",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":8.4,
                "nitrate_0to2":0.0,
                "nitrate_100to200":2.5,
                "nitrate_10to20":0.5,
                "nitrate_20to40":0.7,
                "nitrate_2to5":0.0,
                "nitrate_40to70":1.1,
                "nitrate_5to10":0.1,
                "nitrate_70to100":3.4,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":-2.8,
                "immobilized_0to2":-2.1,
                "immobilized_100to200":-0.2,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":0.0,
                "immobilized_40to70":-0.2,
                "immobilized_5to10":0.0,
                "immobilized_70to100":-0.3,
                "leached":0.0,
                "leached_0to2":-2.3,
                "leached_100to200":0.7,
                "leached_10to20":-6.0,
                "leached_20to40":-0.6,
                "leached_2to5":-6.1,
                "leached_40to70":11.9,
                "leached_5to10":-4.8,
                "leached_70to100":7.3,
                "leached_below_current_root_depth":-0.6,
                "leached_below_maximum_root_depth":-0.6,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":29.2,
                "realized_from_soil_organic_matter_0to2":3.7,
                "realized_from_soil_organic_matter_100to200":2.3,
                "realized_from_soil_organic_matter_10to20":5.5,
                "realized_from_soil_organic_matter_20to40":6.0,
                "realized_from_soil_organic_matter_2to5":5.3,
                "realized_from_soil_organic_matter_40to70":1.9,
                "realized_from_soil_organic_matter_5to10":3.7,
                "realized_from_soil_organic_matter_70to100":0.8,
                "uptaken_by_crop":-37.1,
                "uptaken_by_crop_0to2":-0.1,
                "uptaken_by_crop_100to200":-0.2,
                "uptaken_by_crop_10to20":-3.2,
                "uptaken_by_crop_20to40":-12.5,
                "uptaken_by_crop_2to5":-0.4,
                "uptaken_by_crop_40to70":-15.4,
                "uptaken_by_crop_5to10":-0.8,
                "uptaken_by_crop_70to100":-4.5,
                "uptaken_by_crop_optimal":-523.5,
                "uptaken_by_crop_optimal_0to2":-8.5,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-143.9,
                "uptaken_by_crop_optimal_20to40":-201.3,
                "uptaken_by_crop_optimal_2to5":-59.7,
                "uptaken_by_crop_optimal_40to70":-45.1,
                "uptaken_by_crop_optimal_5to10":-58.0,
                "uptaken_by_crop_optimal_70to100":-6.9,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":44.0,
                "current_root_depth_unit":"in",
                "indigenous_use_efficiency":126.9,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":44.0,
                "maximum_root_depth_unit":"in",
                "nitrogen_available_unit":"lb/ac",
                "nitrogen_budget_unit":"lb/ac",
                "notes":{},
                "uptake_score":1.0,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "R":{
            "advisor":"Harvest",
            "description":"About one third of the seeds on the main stem have changed color; the crop is ready to swath.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"Mature",
                    "url":".../ripening4.png"
                },...
            ],
            "name":"Ripe",
            "order":"9"
        }
    }
}

Sorghum Nitrogen Advisor - v1.0

The ClearAg Sorghum Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to sorghum crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Sorghum Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "late" relative maturity are expected to mature relatively slowly. Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        },
    "data":{
        "2016-10-15":{
            "agdd":2757.5,
            "air_temp_max":72.0,
            "air_temp_min":44.0,
            "gdd":11.0,
            "last_stage":"11",
            "new_stage":"12",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":76.1,
                "nitrate_0to2":0.5,
                "nitrate_100to200":0.0,
                "nitrate_10to20":12.3,
                "nitrate_20to40":35.3,
                "nitrate_2to5":0.9,
                "nitrate_40to70":22.8,
                "nitrate_5to10":2.7,
                "nitrate_70to100":1.6,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":0.0,
                "immobilized_0to2":0.0,
                "immobilized_100to200":0.0,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":0.0,
                "immobilized_40to70":0.0,
                "immobilized_5to10":0.0,
                "immobilized_70to100":0.0,
                "leached":0.0,
                "leached_0to2":-6.9,
                "leached_100to200":0.0,
                "leached_10to20":-11.6,
                "leached_20to40":18.9,
                "leached_2to5":-9.6,
                "leached_40to70":20.1,
                "leached_5to10":-12.7,
                "leached_70to100":1.8,
                "leached_below_current_root_depth":0.0,
                "leached_below_maximum_root_depth":0.0,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":61.0,
                "realized_from_soil_organic_matter_0to2":6.1,
                "realized_from_soil_organic_matter_100to200":0.0,
                "realized_from_soil_organic_matter_10to20":21.7,
                "realized_from_soil_organic_matter_20to40":10.4,
                "realized_from_soil_organic_matter_2to5":9.1,
                "realized_from_soil_organic_matter_40to70":0.0,
                "realized_from_soil_organic_matter_5to10":13.6,
                "realized_from_soil_organic_matter_70to100":0.0,
                "uptaken_by_crop":-22.2,
                "uptaken_by_crop_0to2":-0.3,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":-6.0,
                "uptaken_by_crop_20to40":-9.3,
                "uptaken_by_crop_2to5":-1.0,
                "uptaken_by_crop_40to70":-3.1,
                "uptaken_by_crop_5to10":-2.3,
                "uptaken_by_crop_70to100":-0.2,
                "uptaken_by_crop_optimal":-22.2,
                "uptaken_by_crop_optimal_0to2":-0.5,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-6.0,
                "uptaken_by_crop_optimal_20to40":-9.3,
                "uptaken_by_crop_optimal_2to5":-1.0,
                "uptaken_by_crop_optimal_40to70":-3.1,
                "uptaken_by_crop_optimal_5to10":-2.2,
                "uptaken_by_crop_optimal_70to100":-0.2,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":138.0,
                "current_root_depth_unit":"cm",
                "indigenous_use_efficiency":36.4,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":138.0,
                "maximum_root_depth_unit":"cm",
                "nitrogen_available_unit":"kg/ha",
                "nitrogen_budget_unit":"kg/ha",
                "notes":{
                    "3":"Soil moisture is limiting crop nitrogen uptake."
                },
                "uptake_score":100.0,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "12":{
            "advisor":"Harvest",
            "description":"Grain achieves its maximum dry weight. Mature grain is identified by looking for the dark spot, the black layer, on the bottom of the kernel. Grain moisture ranges from 25 to 35%.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"Physiological Maturity",
                    "url":".../Physiological+Maturity.png"
                },...
            ],
            "name":"Physiological Maturity",
            "order":"12"
        },...
    }
}

Spring Wheat Nitrogen Advisor - v1.0

The ClearAg Spring Wheat Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to spring wheat crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Spring Wheat Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "late" relative maturity are expected to mature relatively slowly. Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

applicable_scales

Container for the equivalent stage within the Feekes, Haun, and Zadoks growth scales.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        },
    "data":{
        "2016-05-24":{
            "agdd":533.0,
            "air_temp_max":73.0,
            "air_temp_min":50.0,
            "gdd":11.5,
            "last_stage":"101",
            "new_stage":"n/a",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":0.0,
                "nitrate":53.3,
                "nitrate_0to2":0.0,
                "nitrate_100to200":0.0,
                "nitrate_10to20":12.9,
                "nitrate_20to40":26.1,
                "nitrate_2to5":0.1,
                "nitrate_40to70":11.0,
                "nitrate_5to10":1.4,
                "nitrate_70to100":1.7,
                "nitrate_in_last_sample_depth":0.0
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "applied_use_efficiency":"n/a",
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":-2.3,
                "immobilized_0to2":-0.8,
                "immobilized_100to200":-0.1,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":-1.2,
                "immobilized_40to70":-0.1,
                "immobilized_5to10":0.0,
                "immobilized_70to100":-0.1,
                "leached":0.0,
                "leached_0to2":-3.9,
                "leached_100to200":0.1,
                "leached_10to20":-0.3,
                "leached_20to40":4.5,
                "leached_2to5":-3.5,
                "leached_40to70":7.6,
                "leached_5to10":-6.2,
                "leached_70to100":1.7,
                "leached_below_current_root_depth":-8.1,
                "leached_below_maximum_root_depth":0.0,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":7.0,
                "realized_from_soil_organic_matter_0to2":0.8,
                "realized_from_soil_organic_matter_100to200":0.0,
                "realized_from_soil_organic_matter_10to20":1.9,
                "realized_from_soil_organic_matter_20to40":1.8,
                "realized_from_soil_organic_matter_2to5":1.0,
                "realized_from_soil_organic_matter_40to70":0.2,
                "realized_from_soil_organic_matter_5to10":1.4,
                "realized_from_soil_organic_matter_70to100":0.0,
                "uptaken_by_crop":-1.4,
                "uptaken_by_crop_0to2":0.0,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":-0.7,
                "uptaken_by_crop_20to40":-0.2,
                "uptaken_by_crop_2to5":-0.1,
                "uptaken_by_crop_40to70":0.0,
                "uptaken_by_crop_5to10":-0.4,
                "uptaken_by_crop_70to100":0.0,
                "uptaken_by_crop_optimal":-2.1,
                "uptaken_by_crop_optimal_0to2":0.0,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-0.8,
                "uptaken_by_crop_optimal_20to40":-0.2,
                "uptaken_by_crop_optimal_2to5":-0.3,
                "uptaken_by_crop_optimal_40to70":0.0,
                "uptaken_by_crop_optimal_5to10":-0.6,
                "uptaken_by_crop_optimal_70to100":0.0,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":16.7,
                "applied_use_efficiency_unit":"%",
                "current_root_depth":49.0,
                "current_root_depth_unit":"cm",
                "indigenous_use_efficiency":20.2,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":149.0,
                "maximum_root_depth_unit":"cm",
                "nitrogen_available_unit":"kg/ha",
                "nitrogen_budget_unit":"kg/ha",
                "notes":{},
                "uptake_score":99.8,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "101":{
            "advisor":"Nutrient",
            "applicable_scales":{
                "feekes":"1.0",
                "haun":"0.5",
                "zadoks":"10"
            },
            "description":"The first leaf is at half of its final length.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"Emergence",
                    "url":".../Coleoptile.jpg"
                },...
            ],
            "name":"Emergence",
            "order":"1"
        },...
    }
}

Sunflower Nitrogen Advisor - v1.0

The ClearAg Sunflower Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to sunflower crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Sunflower Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "late" relative maturity are expected to mature relatively slowly. Default is "medium."

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        }
    },
    "data":{
        "2016-09-07":{
            "agdd":2906.5,
            "air_temp_max":76.0,
            "air_temp_min":52.0,
            "gdd":20.0,
            "last_stage":"30",
            "new_stage":"31",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":64.3,
                "nitrate_0to2":0.0,
                "nitrate_100to200":0.0,
                "nitrate_10to20":18.4,
                "nitrate_20to40":28.6,
                "nitrate_2to5":0.1,
                "nitrate_40to70":14.7,
                "nitrate_5to10":2.3,
                "nitrate_70to100":0.3,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":0.0,
                "denitrified_0to2":0.0,
                "denitrified_100to200":0.0,
                "denitrified_10to20":0.0,
                "denitrified_20to40":0.0,
                "denitrified_2to5":0.0,
                "denitrified_40to70":0.0,
                "denitrified_5to10":0.0,
                "denitrified_70to100":0.0,
                "immobilized":0.0,
                "immobilized_0to2":0.0,
                "immobilized_100to200":0.0,
                "immobilized_10to20":0.0,
                "immobilized_20to40":0.0,
                "immobilized_2to5":0.0,
                "immobilized_40to70":0.0,
                "immobilized_5to10":0.0,
                "immobilized_70to100":0.0,
                "leached":0.0,
                "leached_0to2":-6.9,
                "leached_100to200":0.0,
                "leached_10to20":0.9,
                "leached_20to40":14.5,
                "leached_2to5":-9.5,
                "leached_40to70":11.0,
                "leached_5to10":-10.4,
                "leached_70to100":0.3,
                "leached_below_current_root_depth":0.0,
                "leached_below_maximum_root_depth":0.0,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":53.3,
                "realized_from_soil_organic_matter_0to2":5.7,
                "realized_from_soil_organic_matter_100to200":0.0,
                "realized_from_soil_organic_matter_10to20":18.8,
                "realized_from_soil_organic_matter_20to40":8.1,
                "realized_from_soil_organic_matter_2to5":8.3,
                "realized_from_soil_organic_matter_40to70":0.0,
                "realized_from_soil_organic_matter_5to10":12.4,
                "realized_from_soil_organic_matter_70to100":0.0,
                "uptaken_by_crop":-26.3,
                "uptaken_by_crop_0to2":-0.4,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":-9.5,
                "uptaken_by_crop_20to40":-9.3,
                "uptaken_by_crop_2to5":-1.2,
                "uptaken_by_crop_40to70":-2.1,
                "uptaken_by_crop_5to10":-3.7,
                "uptaken_by_crop_70to100":0.0,
                "uptaken_by_crop_optimal":-26.5,
                "uptaken_by_crop_optimal_0to2":-0.4,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":-9.6,
                "uptaken_by_crop_optimal_20to40":-9.0,
                "uptaken_by_crop_optimal_2to5":-1.2,
                "uptaken_by_crop_optimal_40to70":-2.0,
                "uptaken_by_crop_optimal_5to10":-4.2,
                "uptaken_by_crop_optimal_70to100":0.0,
                "volatized":0.0,
                "volatized_0to2":0.0,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":0.0,
                "volatized_40to70":0.0,
                "volatized_5to10":0.0,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":191.0,
                "current_root_depth_unit":"cm",
                "indigenous_use_efficiency":49.4,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":191.0,
                "maximum_root_depth_unit":"cm",
                "nitrogen_available_unit":"kg/ha",
                "nitrogen_budget_unit":"kg/ha",
                "notes":{},
                "uptake_score":86.3,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "31":{
            "advisor":"Harvest",
            "description":"The back of the head is brown; the bracts turn yellow/brown.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"R9 stage",
                    "url":".../R9.jpg"
                },...
            ],
            "name":"R9 - Physiological Maturity",
            "order":"17"
        },...
    }
}

Winter Wheat Nitrogen Advisor - v1.0

The ClearAg Winter Wheat Nitrogen Advisor simulates the various processes of the nitrogen cycle that impact the availability of nitrogen to winter wheat crops. The model is based on a combination of proven algorithms from several industry models for simulating the nitrogen cycle. When used in combination with the Accounts API, the Winter Wheat Nitrogen Advisor allows provision of several types of field level activities, including fertilizer treatments and soil sample results, containing information such as soil nitrate and organic matter levels, as well as soil pH. Crop growth and the corresponding crop parameters of importance are simulated based on user-specified location, relative maturity, and planting date. Weather and soil information required by the Clear-N model are provided by the ClearAg Field Weather and Soil Conditions APIs, which provide a seamless global dataset of current, forecast, and historical conditions (dating back to 1980) for any arable location globally.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/nutrient/nitrogen?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&location={lat, lon coordinates}&plant_date={timestamp}
&yield_goal={integer}&yield_goal_unit={string}&previous_crop={integer}
&previous_harvest_date={timestamp}&previous_yield={integer}
&previous_yield_unit={string}&output_unit={string}&year_offset={integer}
&use_unconfirmed
&relative_maturity={string}&plant_depth={float}

Request Parameters

Parameter Type Location-based Accounts API Integration Description

app_id

string

yes

yes

API ID provided by Iteris.

app_key

string

yes

yes

API key provided by Iteris.

account_id

string

no

yes

Your Accounts API account ID.

user_id

string

no

yes

User ID provided by and used with the Accounts API. The user must have privileges to view information for the field to which the target growth is assigned.

growth_id

string

no

yes

Specifies the ID given when a growth is successfully added to a field using the create growth endpoint.

location

lat, lon coordinates

yes

 — 

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Limited to a single location per query.

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the current crop was planted or the date of emergence. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

relative_maturity

string

no

 — 

Classification indicating how early a variety matures. Valid values include "early," "medium-early," "medium," "medium-late," and "late." Crops that have an "early" relative maturity are expected to mature relatively fast, and crops having a "late" relative maturity are expected to mature relatively slowly. Default is "medium."

plant_depth

float

no

 — 

The depth in centimeters that the crop was planted. Possible values range from 0.1 to 10.0 cm. The default is 5.0 cm.

yield_goal

integer

yes

yes

Target yield for current crop.

yield_goal_unit

string

yes

yes

Target yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac".

previous_crop

integer

no

no

Enumeration value of previous crop on field. Accepted values are currently 50 (barley), 51 (corn), 57 (spring wheat), 59 (canola), 65 (cotton), 66 (soybean), 68 (winter wheat), 69 (vegetable), 70 (sorghum), 71 (pea), 72 (sunflower), 73 (rice), and 74 (alfalfa).

previous_harvest_date

timestamp

no

no

Epoch timestamp valid near the time that the previous crop was harvested. Required if previous crop is specified. May not predate the planting or emergence date by more than 366 days. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

previous_yield

integer

no

no

Actual yield of the previous crop. Required if previous crop is specified.

previous_yield_ unit

string

no

no

Previous yield unit. Accepted values are "lb/ac," "kg/ha," or "bu/ac." Required if previous crop is specified. Note that "bu/ac" is not a valid yield unit for alfalfa, cotton, or vegetable.

output_unit

string

yes

yes

Specifies the unit of the area density data displayed. Accepted values are "lb/ac" or "kg/ha."

year_offset

integer

no

no

Specifies a number of years by which to adjust model results. Values must be less than 0.

use_unconfirmed

flag

no

no

Results in using all fertilizer treatment activities provided, including those where the application rate is undefined. The nitrogen model generates a recommended application rate in this case, with these activities otherwise ignored by default.

Response Object (JSON)

Field Description

fertilizer_treatment

Structure holding all fertilizer treatment data utilized by the nitrogen model, including the fertilizer type, application rate, and depth. Recommendation property indicates whether or not the application rate is a recommendation calculated by the nitrogen model.

soil_sample

Structure holding all soil sample data utilized by the nitrogen model, including the soil nitrate content, organic matter content, pH level, and sample depth.

tillage

Structure holding all tillage data utilized by the nitrogen model, including the tillage type and depth.

agdd

Aggregate growing degree days from plant or emergence date, including the current date.

air_temp_max

Maximum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. This value is obtained from historical, forecast, or climatological values, depending on the timeframe.

gdd

Growing degree days accumulated on the current date.

last_stage

The last known growth stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is null, the crop is somewhere between the previous growth stage and the next growth stage.

ammonium,
ammonium_XtoY

The amount of nitrogen in the form of ammonium within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

ammonium_in_last_sample_depth

The modeled amount of ammonium above the depth of the previous soil sample.

nitrate,
nitrate_XtoY

The amount of nitrogen in the form of nitrate within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters.

nitrate_in_last_sample_depth

The modeled amount of nitrate above the depth of the previous soil sample.

applied_fertilizers,
applied_fertilizers_XtoY

The amount of nitrogen applied as fertilizer resident within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

denitrified,
denitrified_XtoY

The amount of soil nitrate lost from the entire 2-meter depth of the modeled soil profile, or from within the layer spanning from depth=X to depth=Y centimeters, due to the process of denitrification, whereby nitrate is converted into nitrogen gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

immobilized,
immobilized_XtoY

The amount of nitrogen that has been immobilized within the entire 2-meter depth of the modeled soil profile, or within the layer spanning from depth=X to depth=Y centimeters, in order to support mineralization of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached,
leached_XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning from depth=X to depth=Y centimeters, due to the process of leaching. Only losses will normally be seen when aggregated across the entire depth of the modeled soil profile; otherwise, some layers may gain nitrate at the expense of others, due to the vertical movement of water within the soil profile. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_current_root_depth

The amount of soil nitrate that has been leached below the depth of the current crop’s roots as of the indicated date. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

leached_below_maximum_root_depth

The amount of soil nitrate that has been leached below the maximum depth that the current crop’s roots are expected to reach during the entirety of its growth cycle. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_crop_organic_matter,
realized_from_crop_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of residues associated with the previous crop. This can be either positive or negative, depending on the carbon to nitrogen ratio of the previous crop’s residues. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

realized_from_soil_organic_matter,
realized_from_soil_organic_matter_ XtoY

The amount of soil nitrate that has been gained or lost from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, due to the process of mineralization of soil organic matter. Since the carbon to nitrogen ratio of soil organic matter is typically below that associated with the diet of soil microbes, values will normally be positive. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop,
uptaken_by_crop_XtoY

The amount of nitrogen uptaken by the crop from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. If less than uptaken_by_crop_optimal, this can be indicative of a risk that the crop may be short of nitrogen. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

uptaken_by_crop_optimal,
uptaken_by_crop_optimal_XtoY

The amount of nitrogen the crop would have ideally taken up from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

volatized,
volatized_XtoY

The amount of nitrogen lost by the process of volatization (also referred to as volatilization) from the entire 2-meter depth of the modeled soil profile, or from the layer spanning depth=X to depth=Y centimeters, whereby urea fertilizer is converted into ammonia gas and then escapes into the atmosphere. Positive numeric values indicate that nitrogen has been gained by the soil due to the associated process, whereas negative numeric values indicate that nitrogen has been lost by the soil due to the associated process.

applied_use_efficiency

The crop’s use efficiency of fertilizer-based nitrogen applied since the harvest of the previous crop. Values will be less than or equal to 100%, with higher percentages indicating that the crop has (or will) use a higher percentage of the fertilizers that have been applied.

applied_use_efficiency_unit

Units of "applied_use_efficiency."

current_root_depth

The depth to which the current crop’s roots are assumed to reach as of the indicated date.

current_root_depth_unit

Units of "current_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

indigenous_use_efficiency

The crop’s use efficiency of nitrogen realized through organic matter mineralization since the harvest of the previous crop. Values are in percentages, with higher percentages indicating that the crop has (or will) use a higher percentage of the nitrogen that has been realized through organic matter mineralization. Values in excess of 100% are possible.

indigenous_use_efficiency_unit

Units of "indigenous_use_efficiency."

maximum_root_depth

The maximum depth to which the current crop’s roots are expected to reach during the entirety of its growth cycle.

maximum_root_depth_unit

Units of "maximum_root_depth." Chosen automatically based on the user-provided input value of "output_unit."

nitrogen_available_unit

Units of all data values in the "nitrogen_available" subsection of the returned JSON object.

nitrogen_budget_unit

Units of all data values in the "nitrogen_budget" subsection of the returned JSON object.

notes

A dictionary containing textual descriptions of noteworthy problems or occurrences on the indicated date.

uptake_score

A 0-100 score quantifying the adequacy of crop nitrogen uptake relative to the goals specified in the API call. Higher values indicate better uptake, with values at or near 100 being desirable in order to optimize the crop’s prospects for achieving the caller-specified yield_goal.

uptake_score_unit

Units of "uptake_score."

advisor

Suggested field properties to check.

applicable_scales

Container for the equivalent stage within the Feekes, Haun, and Zadoks growth scales.

description

Text description for a growth stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of a stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/nutrient/nitrogen?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&previous_harvest_date=1450757200&previous_crop=51
&previous_yield=1000&previous_yield_unit=kg/ha&yield_goal=1050
&yield_goal_unit=kg/ha&output_unit=kg/ha

Example Response

{
    "activities":{
        "fertilizer_treatment":{
            "2016-05-20":[{
                "activity_type":308,
                "confirmed":true,
                "created":1494522940,
                "depth":0.1,
                "depth_unit":"m",
                "fertilizer_id":"25",
                "field_activity_id":"123-def",
                "modified":"n/a",
                "rate":0,
                "rate_unit":"gal/ac",
                "recommendation":false,
                "subtype":0
            }]
        }
    },
    "data":{
        "2015-11-17":{
            "agdd":520.74,
            "air_temp_max":74.0,
            "air_temp_min":51.0,
            "gdd":16.86,
            "last_stage":"2",
            "new_stage":"n/a",
            "nitrogen_available":{
                "ammonium":0.0,
                "ammonium_0to2":0.0,
                "ammonium_100to200":0.0,
                "ammonium_10to20":0.0,
                "ammonium_20to40":0.0,
                "ammonium_2to5":0.0,
                "ammonium_40to70":0.0,
                "ammonium_5to10":0.0,
                "ammonium_70to100":0.0,
                "ammonium_in_last_sample_depth":"n/a",
                "nitrate":83.6,
                "nitrate_0to2":0.0,
                "nitrate_100to200":59.5,
                "nitrate_10to20":0.8,
                "nitrate_20to40":2.9,
                "nitrate_2to5":0.0,
                "nitrate_40to70":8.0,
                "nitrate_5to10":0.2,
                "nitrate_70to100":12.1,
                "nitrate_in_last_sample_depth":"n/a"
            },
            "nitrogen_budget":{
                "applied_fertilizers":0.0,
                "applied_fertilizers_0to2":0.0,
                "applied_fertilizers_100to200":0.0,
                "applied_fertilizers_10to20":0.0,
                "applied_fertilizers_20to40":0.0,
                "applied_fertilizers_2to5":0.0,
                "applied_fertilizers_40to70":0.0,
                "applied_fertilizers_5to10":0.0,
                "applied_fertilizers_70to100":0.0,
                "denitrified":-5.1,
                "denitrified_0to2":0.0,
                "denitrified_100to200":-1.9,
                "denitrified_10to20":-0.2,
                "denitrified_20to40":-0.4,
                "denitrified_2to5":-0.1,
                "denitrified_40to70":-1.0,
                "denitrified_5to10":-0.2,
                "denitrified_70to100":-1.4,
                "immobilized":-7.6,
                "immobilized_0to2":-1.8,
                "immobilized_100to200":-0.9,
                "immobilized_10to20":-0.2,
                "immobilized_20to40":-0.4,
                "immobilized_2to5":-3.1,
                "immobilized_40to70":-0.6,
                "immobilized_5to10":-0.1,
                "immobilized_70to100":-0.6,
                "leached":-30.1,
                "leached_0to2":-0.2,
                "leached_100to200":8.9,
                "leached_10to20":-7.4,
                "leached_20to40":-13.8,
                "leached_2to5":0.1,
                "leached_40to70":-8.8,
                "leached_5to10":-5.7,
                "leached_70to100":-3.2,
                "leached_below_current_root_depth":-0.6,
                "leached_below_maximum_root_depth":-32.9,
                "realized_from_crop_organic_matter":0.0,
                "realized_from_crop_organic_matter_0to2":0.0,
                "realized_from_crop_organic_matter_100to200":0.0,
                "realized_from_crop_organic_matter_10to20":0.0,
                "realized_from_crop_organic_matter_20to40":0.0,
                "realized_from_crop_organic_matter_2to5":0.0,
                "realized_from_crop_organic_matter_40to70":0.0,
                "realized_from_crop_organic_matter_5to10":0.0,
                "realized_from_crop_organic_matter_70to100":0.0,
                "realized_from_soil_organic_matter":81.8,
                "realized_from_soil_organic_matter_0to2":1.3,
                "realized_from_soil_organic_matter_100to200":35.0,
                "realized_from_soil_organic_matter_10to20":5.4,
                "realized_from_soil_organic_matter_20to40":11.2,
                "realized_from_soil_organic_matter_2to5":1.9,
                "realized_from_soil_organic_matter_40to70":11.9,
                "realized_from_soil_organic_matter_5to10":3.9,
                "realized_from_soil_organic_matter_70to100":11.2,
                "uptaken_by_crop":0.0,
                "uptaken_by_crop_0to2":0.0,
                "uptaken_by_crop_100to200":0.0,
                "uptaken_by_crop_10to20":0.0,
                "uptaken_by_crop_20to40":0.0,
                "uptaken_by_crop_2to5":0.0,
                "uptaken_by_crop_40to70":0.0,
                "uptaken_by_crop_5to10":0.0,
                "uptaken_by_crop_70to100":0.0,
                "uptaken_by_crop_optimal":-0.1,
                "uptaken_by_crop_optimal_0to2":0.0,
                "uptaken_by_crop_optimal_100to200":0.0,
                "uptaken_by_crop_optimal_10to20":0.0,
                "uptaken_by_crop_optimal_20to40":0.0,
                "uptaken_by_crop_optimal_2to5":0.0,
                "uptaken_by_crop_optimal_40to70":0.0,
                "uptaken_by_crop_optimal_5to10":0.0,
                "uptaken_by_crop_optimal_70to100":0.0,
                "volatized":-0.6,
                "volatized_0to2":-0.1,
                "volatized_100to200":0.0,
                "volatized_10to20":0.0,
                "volatized_20to40":0.0,
                "volatized_2to5":-0.2,
                "volatized_40to70":0.0,
                "volatized_5to10":-0.3,
                "volatized_70to100":0.0
            },
            "nitrogen_metadata":{
                "applied_use_efficiency":"n/a",
                "applied_use_efficiency_unit":"%",
                "current_root_depth":2.0,
                "current_root_depth_unit":"in",
                "indigenous_use_efficiency":0.0,
                "indigenous_use_efficiency_unit":"%",
                "maximum_root_depth":67.0,
                "maximum_root_depth_unit":"in",
                "nitrogen_available_unit":"lb/ac",
                "nitrogen_budget_unit":"lb/ac",
                "notes":{
                    "0":"Some nitrogen leached below the maximum depth the crop roots will reach.",
                    "1":"Some nitrogen leached below the current root depth.",
                    "5":"Crop nitrogen uptake limited by soil location relative to crop roots."
                },
                "uptake_score":0.2,
                "uptake_score_unit":"%"
            }
        },...
    },
    "stage_descriptions":{
        "2":{
            "advisor":"Nutrient",
            "applicable_scales":{
                "feekes":"2",
                "haun":"1.9-2.7",
                "zadoks":"21"
            },
            "description":"The first tiller is visible.",
            "images":[
                {
                    "attribution":"Courtesy of...",
                    "caption":"First tiller",
                    "url":".../Zadoks+21.jpg"
                },...
            ],
            "name":"First Tiller",
            "order":"3"
        },...
    }
}

Add Field Soil Sample - v1.0

Please refer to the ClearAg Focus Soil Conditions

Get Field Soil Sample - v1.0

Please refer to the ClearAg Focus Soil Conditions

Get Field Soil Samples by Field - v1.0

Please refer to the ClearAg Focus Soil Conditions

Modify Field Soil Sample - v1.0

Please refer to the ClearAg Focus Soil Conditions

Delete Field Soil Sample - v1.0

Please refer to the ClearAg Focus Soil Conditions

Add Fertilizer Treatment - v1.0

This endpoint allows the user to add a field activity (fertilizer treatment) to a field. Upon creation, fertilizer treatment activities are automatically added to the target fields' whitelist.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
add/{field_id}/?app_id={string}&app_key={string}&account_id={string}
&user_id={string}&fertilizer_id={integer}&rate={float}&rate_unit={string}
&depth={float}&depth_unit={string}&growth_ids={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

field_id

string

yes

Specifies ID of field in which the activity is being applied.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

This ID is provided as a result of creating a new user.

fertilizer_id

integer

yes

Enumeration value representing the type of fertilizer.4

rate

float or null

no

The amount of fertilizer used in the application. If rate is set to null, the fertilizer treatment activity will be used for the recommendation feature in the nitrogen. Only one fertilizer treatment activity with a rate of “null” exist per day.

rate_unit

string

yes

The unit associated with the rate of application.4

depth

float

yes

The depth at which the application was applied.

depth_unit

string

yes

The unit associated with the depth. Valid options are “m,” “ft,” “cm,” and “in.”

activity_time

timestamp

no

The time the activity was performed. Defaults to current time.2

confirmed

boolean

no

Value of “true” indicates that this activity will be considered during other model runs. A value of “false” indicates that this activity will only be considered during other model runs when a special query string parameter has been set. Default value depends on the value for the query string parameter rate. If rate is a float the default is “true.” If rate is “null” the default is “false.” This can only be set to “false” during the creation of a new fertilizer treatment activity.

growth_ids

string

no

Comma-delimited list of growth IDs. If provided, the fertilizer treatment activity will be added to the whitelist of each growth in the list.

Response Object

Returns the field_activity_id that was created.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
add/abc-123/?app_id=123&app_key=321&account_id=abf-345&user_id=bcd-678
&fertilizer_id=13&rate=1.0&rate_unit=lb/ac&depth=1&depth_unit=in

Example Response

def-345

Modify Fertilizer Treatment - v1.0

This endpoint allows the user to modify an existing fertilizer treatment activity.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/
field/activity/fertilizer_treatment/modify/{field_id}/?
app_id={string}&app_key={string}&account_id={string}
&user_id={string}&rate={float}&rate_unit={string}
&depth={float}&depth_unit={string}
&activity_time={timestamp}&fertilizer_id={integer}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

field_id

string

yes

Specifies ID of field in which to assign crop growth data.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

This ID is provided as a result of creating a new user.

rate

float

no

The amount of fertilizer used in the application.

rate_unit

string

no

The unit associated with the rate of application. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

depth

float

no

The depth at which the application was applied.

depth_unit

string

no

The unit associated with the depth. Valid options are "m," "ft," "cm," and "in."

activity_time

timestamp

no

The time the activity was performed. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

fertilizer_id

integer

no

Enumeration of the fertilizer type used in treatment. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

Response Object

A string representing success ("true") or failure ("false").

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/
fertilizer_treatment/modify/abc-123/?app_id=123&app_key=321
&account_id=def-345&user_id=bcd-678&depth_unit=m

Example Response

true

Delete Fertilizer Treatment - v1.0

This endpoint allows the user to delete a fertilizer treatment from a field. The activity will also be removed from the field whitelist and growth whitelist.

URL Description

https://ag.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
delete/{field_activity_id}?app_id={string}&app_key={string}
&account_id={string}&user_id={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

field_activity_id

string

yes

Specifies ID of field activity that is to be deleted.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

This ID is provided as a result of creating a new user.

Response Object

Returns "true" on success.

Example Request

https://ag.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
delete/abc-123?app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

true

Get All Fertilizer Treatment By Field ID - v1.0

This endpoint allows the user to get all fertilizer treatment activities on a field.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
get/by_field/{field_id}/?app_id={string}&app_key={string}&account_id={string}
&user_id={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

field_id

string

yes

Specifies ID of field in which all fertilizer treatment activities are returned.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

This ID is provided as a result of creating a new user.

Response Object (JSON)

Field Description

activity_time

Timestamp when the activity occurred.

activity_type

Enumeration value representing the type of activity. This will always be 308 for fertilizer treatments (see Appendix for complete listing of coded values and their meanings).

created

Timestamp when the activity was created in the system.

depth

The depth at which the fertilizer was applied.

depth_unit

The unit associated with the depth. Valid options are "m," "ft," "cm," and "in."

fertilizer_id

Enumeration value of the fertilizer used. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

field_activity_id

UUID of the field activity.

modified

Timestamp of when the activity was modified. This is set to "null" by default.

rate

The amount of fertilizer used in the application. Can be a float or "null."

rate_unit

The unit associated with the rate of application. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

subtype

Subtype of activity. Defaults to 0.

whitelist

Boolean denoting membership of the activity in the field’s whitelist.

confirmed

Used during other model runs. "True" denotes that it will always be considered, and "false" denotes that the activity will only be considered when explicitly requested.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
get/by_field/abc-123/?app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

Returns a list of fertilizer_treatment field_activities.

[{
        "field_activity_id":"abc-123",
        "depth_unit":"in",
        "whitelist":true,
        "rate":3.14159,
        "fertilizer_id":25,
        "confirmed":true,
        "created":1494522940,
        "modified":null,
        "rate_unit":"gal/ac",
        "subtype":0,
        "depth":3,
        "activity_time":1494522939,
        "activity_type":308
    },
    {
        "field_activity_id":"456-def",
        "depth_unit":"in",
        "whitelist":true,
        "rate":null,
        "fertilizer_id":25,
        "confirmed":false,
        "created":1494522940,
        "modified":null,
        "rate_unit":"gal/ac",
        "subtype":0,
        "depth":3,
        "activity_time":1494522939,
        "activity_type":308
    }

]

Get Fertilizer Treatment by Field Activity ID - v1.0

This endpoint allows the user to get one specific fertilizer treatment activity on a field.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
get/{field_activity_id}/?app_id={string}&app_key={string}&account_id={string}
&user_id={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

activity_id

string

yes

Specifies ID of target activity to get.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

This ID is provided as a result of creating a new user.

Response Object (JSON)

Field Description

activity_time

Timestamp when the activity occurred.

activity_type

Enumeration value representing the type of activity. This will always be 308 for fertilizer treatments (see Appendix for complete listing of coded values and their meanings).

created

Timestamp when the activity was created in the system.

depth

The depth at which the fertilizer was applied.

depth_unit

The unit associated with the depth. Valid options are "m," "ft," "cm," and "in."

fertilizer_id

Enumeration value of the fertilizer used. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

field_activity_id

UUID of the field activity.

modified

Timestamp of when the activity was modified. This is set to "null" by default.

rate

The amount of fertilizer used in the application. Can be a float or "null."

rate_unit

The unit associated with the rate of application. Please refer to the Fertilizer Types section of the Appendix for a complete listing of coded values and their meanings.

subtype

Subtype of activity. Defaults to 0.

confirmed

Used during other model runs. "True" denotes that it will always be considered, and "false" denotes that the activity will only be considered when explicitly requested.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/field/activity/fertilizer_treatment/
get/abc-123/?app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

{
    "field_activity_id":"abc-123",
    "depth_unit":"in",
    "rate":null,
    "fertilizer_id":25,
    "confirmed":false,
    "created":1494522940,
    "modified":null,
    "rate_unit":"gal/ac",
    "subtype":0,
    "depth":3,
    "activity_time":1494522939,
    "activity_type":308
}

Appendix

Common HTTP response codes

The following are common HTTP response codes and their meanings. These are standard across all API services.

  • 200 OK - The request was successful.

  • 400 Bad Request - The request was invalid. An accompanying error message will be provided if available.

  • 401 Unauthorized - Authentication to the API has failed. Authentication credentials are missing or incorrect.

  • 403 Forbidden - You are trying to access a resource for which you do not have the appropriate privileges.

  • 404 Not found - The requested resource was not found. An accompanying error message will be provided if available.

  • 500 Internal Server Error - An internal server error has occurred while processing the request.

  • 502 Bad Gateway - The service is not reachable.

Null or Empty Values

In some cases values will be represented as "n/a." This indicates that the requested data is not available or is not applicable.

Epoch/Unix Timestamp

Iteris employs Epoch/Unix timestamps for some time-based parameters. Timestamps are defined as the number of seconds since 1970-01-01 00:00 Coordinated Universal Time (UTC).

Note that in daily endpoints, timestamps as URL arguments do not necessarily conform to this definition. In these endpoints, timestamps can be thought of as being relative to the local time zone. For example, a plant_date timestamp corresponding to 2016-05-01 00:00 UTC in the Corn Growth endpoint can be viewed as 2016-05-01 00:00 local time, and the endpoint returns data starting on that date.

Regional-based Account Access

Any data stored by the Account API in one region is not available in another. Each region will require a unique set of credentials. Please contact your account representative if interested in utilizing an additional region. When attempting to use the credentials from one region with the services in another, an 'account not found' error will be returned with HTTP status code 400. See example below:

<title>400 Bad Request</title>
<h1>Bad Request</h1>
<p>Account not found.</p>

Feedback Information

The feedback timestamp, which is the precise time when the feedback was observed, must happen after the plant/emergence date and prior to the current date. Growth feedback is considered (confirmed) if the stage of feedback occurs before the model anticipates. If there are multiple feedbacks for a given stage, the feedback with the most recent feedback timestamp will take precedence. If more than one feedback with the same stage and the same feedback timestamp are present, then the system will use the feedback with the most recent created timestamp.

Supported Crops by Feature

Crop Type Growth Model Growth Model Feedback Growth GDD Envelope Nutrient (Nitrogen) Modeling Harvest (Drydown) Modeling Focus Soil Conditions IMFocus Irrigation

Barley

X

X

X

X

Bermuda Turfgrass

X

X

X

Canola

X

X

X

X

X

X

X

Corn

X

X

X

X

X

X

X

Cotton

X

X

X

X

X

X

Peanut

X

Potato

X

X

X

Sorghum

X

X

X

X

X

Soybean

X

X

X

X

X

X

Spring wheat

X

X

X

X

X

X

X

Sugar Beet

X

X

Sunflower

X

X

X

Winter Wheat

X

X

X

X

X

X

X

Zoysia Turfgrass

X

X

X

Plant Enumerations

Below is a listing of available values for plant_type and plant_name.

Plant Type Plant Name

50

barley

59

canola

51

corn

57

springwheat

65

cotton

76

peanut

75

potato

70

sorghum

66

soybean

60

sugarbeet

72

sunflower

68

winter wheat

Activity and Plant Codes

Activity Type

Coded Value Meaning

300

Planting

301

Spraying

302

Harvesting

303

Row Crop Cultivating

304

Post-harvest Tillage

305

Pre-planting Tillage

306

Cutting

307

Soil Test

308

Fertilizer Treatment

309

Grain Moisture Test

310

Scouting Report

311

Irrigation

Activity Subtype

Activity Type Subtype Code Meaning

Planting

0

Generic

Planting

50

Barley

Planting

51

Corn

Planting

57

Spring Wheat

Planting

59

Canola

Planting

60

Sugar Beets

Planting

65

Cotton

Spraying

0

Generic

Harvesting

0

Generic

Row Crop Cultivating

0

Generic

Post-harvest Tillage

0

Generic

Pre-planting Tillage

0

Generic

Cutting

0

Generic

Cutting

1

Alfalfa

Soil Test

0

Generic

Fertilizer Treatment

0

Generic

Grain Moisture Test

0

Generic

Scouting Report

0

Generic

Irrigation

0

Generic

Variety Enumerations

This section provides the listing of all supported varieties for each applicable crop.

Peanut

Variety Enum Variety Name

0

florunner

1

florigiant

2

valencia

3

tamnut

4

starr

5

marc_i

6

agritech-127

7

sunrunner

8

southern_runner

9

early_bunch

10

georgia_green

11

ga-02c

12

ga-01r

13

c-99

Potato

Variety Enum Variety Name

0

atlantic

1

c14-343

2

desiree

3

king_edward

4

lt-1

5

majestic

6

maris_piper

7

norchip

8

red_lasoda

9

russet_burbank

10

shepody

Fertilizer Types

ID Name Type Units N P K Ca Mg S

1

Ammonium nitrate 34 0 0 0 0 0

solid

kg/ha, lb/ac

0.34

0

0

0

0

0

2

Ammonium phosphate sulfate 16 20 0 0 0 13

solid

kg/ha, lb/ac

0.16

0.2

0

0

0

0.13

3

Ammonium polyphosphate granular 11 57 0 0 0 0

solid

kg/ha, lb/ac

0.11

0.57

0

0

0

0

4

Ammonium sulfate 21 0 0 0 0 24

solid

kg/ha, lb/ac

0.21

0

0

0

0

0.24

5

Ammonium nitrate sulfate 30 0 0 0 0 6.5

solid

kg/ha, lb/ac

0.3

0

0

0

0

0.6

6

Calcium ammonium nitrate 27 0 0 0 0 0

solid

kg/ha, lb/ac

0.27

0

0

0

0

0

7

Calcium carbonate 0 0 0 40 0 0

solid

kg/ha, lb/ac

0

0

0

0.4

0

0

8

Calcium nitrate 15.5 0 0 19 0 0

solid

kg/ha, lb/ac

.15.5

0

0

0.19

0

0

9

Calcium oxide 0 0 0 71.5 0 0

solid

kg/ha, lb/ac

0

0

0

0.715

0

0

10

Diammonium phosphate 18 46 0 0 0 0

solid

kg/ha, lb/ac

0.18

0.46

0

0

0

0

11

Diammonium phosphate 21 53 0 0 0 0

solid

kg/ha, lb/ac

0.21

0.53

0

0

0

0

12

Monoammonium phosphate 11 52 0 0 0 0

solid

kg/ha, lb/ac

0.11

0.52

0

0

0

0

13

Potassium chloride 0 0 60 0 0 0

solid

kg/ha, lb/ac

0

0

0.6

0

0

0

14

Potassium nitrate 13 0 44 0 0 0

solid

kg/ha, lb/ac

0.13

0

0.44

0

0

0

15

Potassium sulfate 0 0 50 0 0 18

solid

kg/ha, lb/ac

0

0

0.5

0

0

0.18

16

Single super phosphate 0 18 0 16 0 8

solid

kg/ha, lb/ac

0

0.18

0

0.16

0

0.8

17

Sodium nitrate 16.5 0 0 0 0 0

solid

kg/ha, lb/ac

.16.5

0

0

0

0

0

18

Triple super phosphate 0 48 0 0 0 0

solid

kg/ha, lb/ac

0

0.48

0

0

0

0

19

Urea 46 0 0 0 0 0

solid

kg/ha, lb/ac

0.46

0

0

0

0

0

20

Ammonium phosphate liquid 10 34 0 0 0 0

liquid

l/ha, gal/ac

0.1

0.34

0

0

0

0

21

Ammonium polyphosphate fluid 10 34 0 0 0 0

liquid

l/ha, gal/ac

0.1

0.34

0

0

0

0

22

Ammonium polyphosphate fluid 10 37 0 0 0 0

liquid

l/ha, gal/ac

0.1

0.37

0

0

0

0

23

Anhydrous ammonia 82 0 0 0 0 0

liquid

kg/ha, lb/ac

0.82

0

0

0

0

0

24

Aqua ammonia 20 0 0 0 0 0

liquid

l/ha, gal/ac

0.2

0

0

0

0

0

25

Calcium ammonium nitrate liquid (17 0 0 8)

liquid

l/ha, gal/ac

0.17

0

0

0.88

0

0

26

Phosphoric acid 0 30 0 0 0 0

liquid

l/ha, gal/ac

0

0.3

0

0

0

0

27

Phosphoric acid 0 54 0 0 0 0

liquid

l/ha, gal/ac

0

0.54

0

0

0

0

28

Phosphoric acid 0 65 0 0 0 0

liquid

l/ha, gal/ac

0

0.65

0

0

0

0

29

Super phosphoric acid liquid 0 68 0 0 0 0

liquid

l/ha, gal/ac

0

0.68

0

0

0

0

30

Urea ammonium nitrate 32 0 0 0 0 0

liquid

l/ha, gal/ac

0.32

0

0

0

0

0

31

Microessentials sz 12 40 0 0 0 10

solid

kg/ha, lb/ac

0.12

0.4

0

0

0

0.1

32

Microessentials s10 12 40 0 0 0 10

solid

kg/ha, lb/ac

0.1

0.12

0.4

0

0

0.1

33

Microessentials s15 13 33 0 0 0 15

solid

kg/ha, lb/ac

0.15

0.13

0.33

0

0

0.15

34

Urea ammonium nitrate 28 0 0 0 0 0

liquid

l/ha, gal/ac

0.28

0

0

0

0

0

35

Urea ammonium nitrate 30 0 0 0 0 0

liquid

l/ha, gal/ac

0.3

0

0

0

0

0

USDA Texture Classes

texture class texture class description

1

Sand

2

Loamy Sand

3

Sandy Loam

4

Silt Loam

5

Silt

6

Loam

7

Sandy Clay Loam

8

Silty Clay Loam

9

Clay Loam

10

Sandy Clay

11

Silty Clay

12

Clay

13

Organic Materials

14

Water

15

Bedrock

16

Other

Crop Coefficients

Note that the following table is largely derived from FAO Irrigation and Drainage Paper No. 56 Crop Evapotranspiration by Allen, Pereira, Raes, and Smith (Tables 11 and 12). IDs on each row correspond to a unique combination of crop, plant date, and region. Stage lengths, plant date, and region correspond to crops in length_crop column, and crop coefficients correspond to crops in kc_crop column. Each row contains a set of two crops since the two tables from which the data are derived do not perfectly map to each other—​for example leading to a pairing of "Crucifers" and "Brussels sprouts", which is a type of crucifer.

ID length_crop length_initial/ length_development/ length_midseason/ length_late Plant Date Region kc_crop kc_initial/ kc_midseason/ kc_end

1.0

Broccoli

35 / 45 / 40 / 15

Sep

Calif. Desert

Broccoli

0.7 / 1.05 / 0.95

1.1

Crucifers

20 / 30 / 20 / 10

Apr

Medit.

Brussels sprouts

0.7 / 1.05 / 0.95

1.2

Crucifers

25 / 35 / 25 / 10

Feb

Medit.

Brussels sprouts

0.7 / 1.05 / 0.95

1.3

Crucifers

30 / 35 / 90 / 40

Oct/Nov

Medit.

Brussels sprouts

0.7 / 1.05 / 0.95

1.4

Cabbage

40 / 60 / 50 / 15

Sep

Calif. Desert

Cabbage

0.7 / 1.05 / 0.95

1.5

Carrots

20 / 30 / 50 / 20

Oct

Arid Region

Carrots

0.7 / 1.05 / 0.95

1.6

Carrots

20 / 30 / 30 / 20

Jan

Arid Region

Carrots

0.7 / 1.05 / 0.95

1.7

Carrots

30 / 40 / 60 / 20

Feb/Mar

Medit.

Carrots

0.7 / 1.05 / 0.95

1.8

Carrots

30 / 50 / 90 / 30

Oct

Calif. Desert

Carrots

0.7 / 1.05 / 0.95

1.9

Cauliflower

35 / 50 / 40 / 15

Sep

Calif. Desert

Cauliflower

0.7 / 1.05 / 0.95

1.10

Celery

25 / 40 / 95 / 20

Oct

Semi-Arid Region

Celery

0.7 / 1.05 / 1

1.11

Celery

25 / 40 / 45 / 15

Apr

Medit.

Celery

0.7 / 1.05 / 1

1.12

Celery

30 / 55 / 105 / 20

Jan

Semi-Arid Region

Celery

0.7 / 1.05 / 1

1.13

Lettuce

20 / 30 / 15 / 10

Apr

Medit.

Lettuce

0.7 / 1 / 0.95

1.14

Lettuce

30 / 40 / 25 / 10

Nov/Jan

Medit.

Lettuce

0.7 / 1 / 0.95

1.15

Lettuce

25 / 35 / 30 / 10

Oct/Nov

Arid Region

Lettuce

0.7 / 1 / 0.95

1.16

Lettuce

35 / 50 / 45 / 10

Feb

Medit.

Lettuce

0.7 / 1 / 0.95

1.17

Onion (dry)

15 / 25 / 70 / 40

Apr

Medit.

Onion (dry)

0.7 / 1.05 / 0.75

1.18

Onion (dry)

20 / 35 / 110 / 45

Oct

Arid Region

Onion (dry)

0.7 / 1.05 / 0.75

1.19

Onion (dry)

20 / 35 / 110 / 45

Jan

California

Onion (dry)

0.7 / 1.05 / 0.75

1.20

Onion (green)

25 / 30 / 10 / 5

Apr/May

Medit.

Onion (green)

0.7 / 1 / 1

1.21

Onion (green)

20 / 45 / 20 / 10

Oct

Arid Region

Onion (green)

0.7 / 1 / 1

1.22

Onion (green)

30 / 55 / 55 / 40

Mar

California

Onion (green)

0.7 / 1 / 1

1.23

Onion (seed)

20 / 45 / 165 / 45

Sep

Calif. Desert

Onion (seed)

0.7 / 1.05 / 0.8

1.24

Spinach

20 / 20 / 15 / 5

Apr

Medit.

Spinach

0.7 / 1 / 0.95

1.25

Spinach

20 / 20 / 25 / 5

Sep/Oct

Medit.

Spinach

0.7 / 1 / 0.95

1.26

Spinach

20 / 30 / 40 / 10

Nov

Arid Region

Spinach

0.7 / 1 / 0.95

1.27

Radish

5 / 10 / 15 / 5

Mar/Apr

Medit.

Radish

0.7 / 0.9 / 0.85

1.28

Radish

5 / 10 / 15 / 5

Mar/Apr

Europe

Radish

0.7 / 0.9 / 0.85

1.29

Radish

10 / 10 / 15 / 5

Winter

Arid Region

Radish

0.7 / 0.9 / 0.85

2.0

Egg plant

30 / 40 / 40 / 20

Oct

Arid Region

Egg plant

0.6 / 1.05 / 0.9

2.1

Egg plant

30 / 45 / 40 / 25

May/Jun

Medit.

Egg plant

0.6 / 1.05 / 0.9

2.2

Sweet peppers (bell)

25 / 35 / 40 / 20

Apr

Europe

Sweet peppers (bell)

0.6 / 1.05 / 0.9

2.3

Sweet peppers (bell)

30 / 35 / 40 / 20

Jun

Europe

Sweet peppers (bell)

0.6 / 1.05 / 0.9

2.4

Sweet peppers (bell)

25 / 35 / 40 / 20

Apr

Medit.

Sweet peppers (bell)

0.6 / 1.05 / 0.9

2.5

Sweet peppers (bell)

30 / 35 / 40 / 20

Jun

Medit.

Sweet peppers (bell)

0.6 / 1.05 / 0.9

2.6

Sweet peppers (bell)

30 / 40 / 110 / 30

Oct

Arid Region

Sweet peppers (bell)

0.6 / 1.05 / 0.9

2.7

Tomato

30 / 40 / 40 / 25

Jan

Arid Region

Tomato

0.6 / 1.15 / 0.8

2.8

Tomato

35 / 40 / 50 / 30

Apr/May

California

Tomato

0.6 / 1.15 / 0.8

2.9

Tomato

25 / 40 / 60 / 30

Jan

Calif. Desert

Tomato

0.6 / 1.15 / 0.8

2.10

Tomato

35 / 45 / 70 / 30

Oct/Nov

Arid Region

Tomato

0.6 / 1.15 / 0.8

2.11

Tomato

30 / 40 / 45 / 30

Apr/May

Medit.

Tomato

0.6 / 1.15 / 0.8

3.0

Cantaloupe

30 / 45 / 35 / 10

Jan

California

Cantaloupe

0.5 / 0.85 / 0.6

3.1

Cantaloupe

10 / 60 / 25 / 25

Aug

California

Cantaloupe

0.5 / 0.85 / 0.6

3.2

Cucumber

20 / 30 / 40 / 15

Jun/Aug

Arid Region

Cucumber (fresh market)

0.6 / 1 / 0.75

3.3

Cucumber

25 / 35 / 50 / 20

Nov/Feb

Arid Region

Cucumber (fresh market)

0.6 / 1 / 0.75

3.4

Cucumber

20 / 30 / 40 / 15

Jun/Aug

Arid Region

Cucumber (machine harvest)

0.5 / 1 / 0.9

3.5

Cucumber

25 / 35 / 50 / 20

Nov/Feb

Arid Region

Cucumber (machine harvest)

0.5 / 1 / 0.9

3.6

Pumpkin

20 / 30 / 30 / 20

Mar/Aug

Medit.

Pumpkin

0.5 / 1 / 0.8

3.7

Pumpkin

25 / 35 / 35 / 25

Jun

Europe

Pumpkin

0.5 / 1 / 0.8

3.8

Winter squash

20 / 30 / 30 / 20

Mar/Aug

Medit.

Winter Squash

0.5 / 1 / 0.8

3.9

Winter squash

25 / 35 / 35 / 25

Jun

Europe

Winter Squash

0.5 / 1 / 0.8

3.10

Squash

25 / 35 / 25 / 15

Apr

Medit.

Squash

0.5 / 0.95 / 0.75

3.11

Squash

25 / 35 / 25 / 15

Dec

Arid Region

Squash

0.5 / 0.95 / 0.75

3.12

Squash

20 / 30 / 25 / 15

May/Jun

Medit.

Squash

0.5 / 0.95 / 0.75

3.13

Squash

20 / 30 / 25 / 15

May/Jun

Europe

Squash

0.5 / 0.95 / 0.75

3.14

Zucchini

25 / 35 / 25 / 15

Apr

Medit.

Zucchini

0.5 / 0.95 / 0.75

3.15

Zucchini

25 / 35 / 25 / 15

Dec

Arid Region

Zucchini

0.5 / 0.95 / 0.75

3.16

Zucchini

20 / 30 / 25 / 15

May/Jun

Medit.

Zucchini

0.5 / 0.95 / 0.75

3.17

Zucchini

20 / 30 / 25 / 15

May/Jun

Europe

Zucchini

0.5 / 0.95 / 0.75

3.18

Sweet melons

25 / 35 / 40 / 20

May

Medit.

Sweet Melons

0.5 / 1.05 / 0.75

3.19

Sweet melons

30 / 30 / 50 / 30

Mar

California

Sweet Melons

0.5 / 1.05 / 0.75

3.20

Sweet melons

15 / 40 / 65 / 15

Aug

Calif. Desert

Sweet Melons

0.5 / 1.05 / 0.75

3.21

Sweet melons

30 / 45 / 65 / 20

Dec/Jan

Arid Region

Sweet Melons

0.5 / 1.05 / 0.75

3.22

Watermelon

20 / 30 / 30 / 30

Apr

Italy

Watermelon

0.4 / 1 / 0.75

3.23

Watermelon

10 / 20 / 20 / 30

May/Aug

Near East Desert

Watermelon

0.4 / 1 / 0.75

4.0

Beets (table)

15 / 25 / 20 / 10

Apr/May

Medit.

Beets (table)

0.5 / 1.05 / 0.95

4.1

Beets (table)

25 / 30 / 25 / 10

Feb/Mar

Medit.

Beets (table)

0.5 / 1.05 / 0.95

4.2

Beets (table)

25 / 30 / 25 / 10

Feb/Mar

Arid Region

Beets (table)

0.5 / 1.05 / 0.95

4.3

Cassava (year 1)

20 / 40 / 90 / 60

Rainy Season

Tropical region

Cassava (year 1)

0.3 / 0.8 / 0.3

4.4

Cassava (year 2)

150 / 40 / 110 / 60

Rainy Season

Tropical region

Cassava (year 2)

0.3 / 1.1 / 0.5

4.5

Potato

25 / 30 / 30 / 30

Jan

Semi-Arid Region

Potato

0.5 / 1.15 / 0.75

4.6

Potato

25 / 30 / 45 / 30

Nov

Semi-Arid Region

Potato

0.5 / 1.15 / 0.75

4.7

Potato

25 / 30 / 45 / 30

May

Continental Region

Potato

0.5 / 1.15 / 0.75

4.8

Potato

30 / 35 / 50 / 30

Apr

Europe

Potato

0.5 / 1.15 / 0.75

4.9

Potato

45 / 30 / 70 / 20

Apr/May

Idaho

Potato

0.5 / 1.15 / 0.75

4.10

Potato

30 / 35 / 50 / 25

Dec

Calif. Desert

Potato

0.5 / 1.15 / 0.75

4.11

Sweet potato

20 / 30 / 60 / 40

Apr

Medit.

Sweet potato

0.5 / 1.15 / 0.65

4.12

Sweet potato

15 / 30 / 50 / 30

Rainy Season

Tropical Region

Sweet potato

0.5 / 1.15 / 0.65

4.13

Crucifers

20 / 30 / 20 / 10

Apr

Medit.

Turnip

0.5 / 1.1 / 0.95

4.14

Crucifers

25 / 35 / 25 / 10

Feb

Medit.

Turnip

0.5 / 1.1 / 0.95

4.15

Crucifers

30 / 35 / 90 / 40

Oct/Nov

Medit.

Turnip

0.5 / 1.1 / 0.95

4.16

Crucifers

20 / 30 / 20 / 10

Apr

Medit.

Rutabaga

0.5 / 1.1 / 0.95

4.17

Crucifers

25 / 35 / 25 / 10

Feb

Medit.

Rutabaga

0.5 / 1.1 / 0.95

4.18

Crucifers

30 / 35 / 90 / 40

Oct/Nov

Medit.

Rutabaga

0.5 / 1.1 / 0.95

4.19

Sugarbeet

30 / 45 / 90 / 15

Mar

California

Sugarbeet

0.35 / 1.2 / 0.7

4.20

Sugarbeet

25 / 30 / 90 / 10

Jun

California

Sugarbeet

0.35 / 1.2 / 0.7

4.21

Sugarbeet

25 / 65 / 100 / 65

Sep

Calif. Desert

Sugarbeet

0.35 / 1.2 / 0.7

4.22

Sugarbeet

50 / 40 / 50 / 40

Apr

Idaho

Sugarbeet

0.35 / 1.2 / 0.7

4.23

Sugarbeet

25 / 35 / 50 / 50

May

Medit.

Sugarbeet

0.35 / 1.2 / 0.7

4.24

Sugarbeet

45 / 75 / 80 / 30

Nov

Medit.

Sugarbeet

0.35 / 1.2 / 0.7

4.25

Sugarbeet

35 / 60 / 70 / 40

Nov

Arid Region

Sugarbeet

0.35 / 1.2 / 0.7

5.0

Beans (green)

20 / 30 / 30 / 10

Feb/Mar

California

Beans (green)

0.5 / 1.05 / 0.9

5.1

Beans (green)

20 / 30 / 30 / 10

Feb/Mar

Medit.

Beans (green)

0.5 / 1.05 / 0.9

5.2

Beans (green)

15 / 25 / 25 / 10

Aug/Sep

California

Beans (green)

0.5 / 1.05 / 0.9

5.3

Beans (green)

15 / 25 / 25 / 10

Aug/Sep

Egypt

Beans (green)

0.5 / 1.05 / 0.9

5.4

Beans (green)

15 / 25 / 25 / 10

Aug/Sep

Lebanon

Beans (green)

0.5 / 1.05 / 0.9

5.5

Beans (dry)

20 / 30 / 40 / 20

May/Jun

Continental Region

Beans (dry)

0.4 / 1.15 / 0.35

5.6

Beans (dry)

15 / 25 / 35 / 20

Jun

California

Beans (dry)

0.4 / 1.15 / 0.35

5.7

Beans (dry)

15 / 25 / 35 / 20

Jun

Pakistan

Beans (dry)

0.4 / 1.15 / 0.35

5.8

Beans (dry)

25 / 25 / 30 / 20

Jun

Idaho

Beans (dry)

0.4 / 1.15 / 0.35

5.9

Cowpea

20 / 30 / 30 / 20

Mar

Medit.

Cowpea (fresh)

0.4 / 1.05 / 0.6

5.10

Cowpea

20 / 30 / 30 / 20

Mar

Medit.

Cowpea (dry)

0.4 / 1.05 / 0.35

5.11

Fababean (dry)

90 / 45 / 40 / 60

Nov

Europe

Fababean (dry)

0.5 / 1.15 / 0.3

5.12

Fababean (green)

15 / 25 / 35 / 15

May

Europe

Fababean (fresh)

0.5 / 1.15 / 1.1

5.13

Fababean (green)

20 / 30 / 35 / 15

Mar/Apr

Medit.

Fababean (fresh)

0.5 / 1.15 / 1.1

5.14

Fababean (green)

90 / 45 / 40 / 0

Nov

Europe

Fababean (fresh)

0.5 / 1.15 / 1.1

5.15

Green gram

20 / 30 / 30 / 20

Mar

Medit.

Green gram (fresh)

0.4 / 1.05 / 0.6

5.16

Green gram

20 / 30 / 30 / 20

Mar

Medit.

Green gram (dry)

0.4 / 1.05 / 0.35

5.17

Groundnut

25 / 35 / 45 / 25

Dry Season

West Africa

Groundnut

0.4 / 1.15 / 0.6

5.18

Groundnut

35 / 35 / 35 / 35

May

High Latitudes

Groundnut

0.4 / 1.15 / 0.6

5.19

Groundnut

35 / 45 / 35 / 25

May/Jun

Medit.

Groundnut

0.4 / 1.15 / 0.6

5.20

Lentil

20 / 30 / 60 / 40

Apr

Europe

Lentil

0.4 / 1.1 / 0.3

5.21

Lentil

25 / 35 / 70 / 40

Oct/Nov

Arid Region

Lentil

0.4 / 1.1 / 0.3

5.22

Pea

15 / 25 / 35 / 15

May

Europe

Pea (fresh)

0.5 / 1.15 / 1.1

5.23

Pea

20 / 30 / 35 / 15

Mar/Apr

Medit.

Pea (fresh)

0.5 / 1.15 / 1.1

5.24

Pea

35 / 25 / 30 / 20

Apr

Idaho

Pea (fresh)

0.5 / 1.15 / 1.1

5.25

Pea

15 / 25 / 35 / 15

May

Europe

Pea (dry)

0.5 / 1.15 / 0.3

5.26

Pea

20 / 30 / 35 / 15

Mar/Apr

Medit.

Pea (dry)

0.5 / 1.15 / 0.3

5.27

Pea

35 / 25 / 30 / 20

Apr

Idaho

Pea (dry)

0.5 / 1.15 / 0.3

5.28

Soybean

15 / 15 / 40 / 15

Dec

Tropics

Soybean

0.4 / 1.15 / 0.5

5.29

Soybean

20 / 35 / 60 / 25

May

Central USA

Soybean

0.4 / 1.15 / 0.5

5.30

Soybean

20 / 25 / 75 / 30

Jun

Japan

Soybean

0.4 / 1.15 / 0.5

6.0

Artichoke

40 / 40 / 250 / 30

Apr (1st yr)

California

Artichoke

0.5 / 1 / 0.95

6.1

Artichoke

20 / 25 / 250 / 30

May (2nd yr)

California

Artichoke

0.5 / 1 / 0.95

6.2

Asparagus

50 / 30 / 100 / 50

Feb

Warm Winter

Asparagus

0.5 / 0.95 / 0.3

6.3

Asparagus

90 / 30 / 200 / 45

Feb

Medit.

Asparagus

0.5 / 0.95 / 0.3

7.0

Cotton

30 / 50 / 60 / 55

Mar/Apr/May

Egypt

Cotton

0.35 / 1.175 / 0.6

7.1

Cotton

30 / 50 / 60 / 55

Mar/Apr/May

Pakistan

Cotton

0.35 / 1.175 / 0.6

7.2

Cotton

30 / 50 / 60 / 55

Mar/Apr/May

California

Cotton

0.35 / 1.175 / 0.6

7.3

Cotton

45 / 90 / 45 / 45

Mar

Calif. Desert

Cotton

0.35 / 1.175 / 0.6

7.4

Cotton

30 / 50 / 60 / 55

Sep

Yemen

Cotton

0.35 / 1.175 / 0.6

7.5

Cotton

30 / 50 / 55 / 45

Apr

Texas

Cotton

0.35 / 1.175 / 0.6

7.6

Flax

25 / 35 / 50 / 40

Apr

Europe

Flax

0.35 / 1.1 / 0.25

7.7

Flax

30 / 40 / 100 / 50

Oct

Arizona

Flax

0.35 / 1.1 / 0.25

8.0

Castorbean

25 / 40 / 65 / 50

Mar

Semi-Arid Region

Castorbean

0.35 / 1.15 / 0.55

8.1

Castorbean

20 / 40 / 50 / 25

Nov

Indonesia

Castorbean

0.35 / 1.15 / 0.55

8.2

Crucifers

20 / 30 / 20 / 10

Apr

Medit.

Rapeseed/Canola

0.35 / 1.15 / 0.35

8.3

Crucifers

25 / 35 / 25 / 10

Feb

Medit.

Rapeseed/Canola

0.35 / 1.15 / 0.35

8.4

Crucifers

30 / 35 / 90 / 40

Oct/Nov

Medit.

Rapeseed/Canola

0.35 / 1.15 / 0.35

8.5

Safflower

20 / 35 / 45 / 25

Apr

California

Safflower

0.35 / 1.15 / 0.25

8.6

Safflower

25 / 35 / 55 / 30

Mar

High Latitudes

Safflower

0.35 / 1.15 / 0.25

8.7

Safflower

35 / 55 / 60 / 40

Oct/Nov

Arid Region

Safflower

0.35 / 1.15 / 0.25

8.8

Sesame

20 / 30 / 40 / 20

Jun

China

Sesame

0.35 / 1.1 / 0.25

8.9

Sunflower

25 / 35 / 45 / 25

Apr/May

Medit.

Sunflower

0.35 / 1.15 / 0.35

8.10

Sunflower

25 / 35 / 45 / 25

Apr/May

California

Sunflower

0.35 / 1.15 / 0.35

9.0

Barley

15 / 25 / 50 / 30

Nov

Central India

Barley

0.3 / 1.15 / 0.25

9.1

Barley

20 / 25 / 60 / 30

Mar/Apr

35-45 °L

Barley

0.3 / 1.15 / 0.25

9.2

Barley

15 / 30 / 65 / 40

Jul

East Africa

Barley

0.3 / 1.15 / 0.25

9.3

Barley

40 / 30 / 40 / 20

Apr

East Africa

Barley

0.3 / 1.15 / 0.25

9.4

Barley

40 / 60 / 60 / 40

Nov

East Africa

Barley

0.3 / 1.15 / 0.25

9.5

Barley

20 / 50 / 60 / 30

Dec

Calif. Desert

Barley

0.3 / 1.15 / 0.25

9.6

Oats

15 / 25 / 50 / 30

Nov

Central India

Oats

0.3 / 1.15 / 0.25

9.7

Oats

20 / 25 / 60 / 30

Mar/Apr

35-45 °L

Oats

0.3 / 1.15 / 0.25

9.8

Oats

15 / 30 / 65 / 40

Jul

East Africa

Oats

0.3 / 1.15 / 0.25

9.9

Oats

40 / 30 / 40 / 20

Apr

East Africa

Oats

0.3 / 1.15 / 0.25

9.10

Oats

40 / 60 / 60 / 40

Nov

East Africa

Oats

0.3 / 1.15 / 0.25

9.11

Oats

20 / 50 / 60 / 30

Dec

Calif. Desert

Oats

0.3 / 1.15 / 0.25

9.12

Wheat

15 / 25 / 50 / 30

Nov

Central India

Spring wheat

0.3 / 1.15 / 0.25

9.13

Wheat

20 / 25 / 60 / 30

Mar/Apr

35-45 °L

Spring wheat

0.3 / 1.15 / 0.25

9.14

Wheat

15 / 30 / 65 / 40

Jul

East Africa

Spring wheat

0.3 / 1.15 / 0.25

9.15

Wheat

40 / 30 / 40 / 20

Apr

East Africa

Spring wheat

0.3 / 1.15 / 0.25

9.16

Wheat

40 / 60 / 60 / 40

Nov

East Africa

Spring wheat

0.3 / 1.15 / 0.25

9.17

Wheat

20 / 50 / 60 / 30

Dec

Calif. Desert

Spring wheat

0.3 / 1.15 / 0.25

9.18

Winter wheat

20 / 60 / 70 / 30

Dec

California

Winter wheat (frozen soils)

0.4 / 1.15 / 0.25

9.19

Winter wheat

30 / 140 / 40 / 30

Nov

Medit.

Winter wheat (frozen soils)

0.4 / 1.15 / 0.25

9.20

Winter wheat

160 / 75 / 75 / 25

Oct

Idaho

Winter wheat (frozen soils)

0.4 / 1.15 / 0.25

9.21

Winter wheat

20 / 60 / 70 / 30

Dec

California

Winter wheat (non-frozen soils)

0.7 / 1.15 / 0.25

9.22

Winter wheat

30 / 140 / 40 / 30

Nov

Medit.

Winter wheat (non-frozen soils)

0.7 / 1.15 / 0.25

9.23

Winter wheat

160 / 75 / 75 / 25

Oct

Idaho

Winter wheat (non-frozen soils)

0.7 / 1.15 / 0.25

9.24

Maize (grain)

30 / 50 / 60 / 40

Apr

East Africa

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.25

Maize (grain)

25 / 40 / 45 / 30

Dec/Jan

Arid Region

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.26

Maize (grain)

20 / 35 / 40 / 30

Jun

Nigeria

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.27

Maize (grain)

20 / 35 / 40 / 30

Oct

India

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.28

Maize (grain)

30 / 40 / 50 / 30

Apr

Spain

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.29

Maize (grain)

30 / 40 / 50 / 30

Apr

California

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.30

Maize (grain)

30 / 40 / 50 / 50

Apr

Idaho

Maize (grain; high harvest moisture)

0.3 / 1.2 / 0.6

9.31

Maize (grain)

30 / 50 / 60 / 40

Apr

East Africa

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.32

Maize (grain)

25 / 40 / 45 / 30

Dec/Jan

Arid Region

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.33

Maize (grain)

20 / 35 / 40 / 30

Jun

Nigeria

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.34

Maize (grain)

20 / 35 / 40 / 30

Oct

India

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.35

Maize (grain)

30 / 40 / 50 / 30

Apr

Spain

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.36

Maize (grain)

30 / 40 / 50 / 30

Apr

California

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.37

Maize (grain)

30 / 40 / 50 / 50

Apr

Idaho

Maize (grain; low harvest moisture)

0.3 / 1.2 / 0.35

9.38

Maize (sweet)

20 / 20 / 30 / 10

Mar

Philippines

Maize (sweet)

0.3 / 1.15 / 1.05

9.39

Maize (sweet)

20 / 25 / 25 / 10

May/Jun

Medit.

Maize (sweet)

0.3 / 1.15 / 1.05

9.40

Maize (sweet)

20 / 30 / 50 / 10

Oct

Arid Region

Maize (sweet)

0.3 / 1.15 / 1.05

9.41

Maize (sweet)

20 / 30 / 30 / 10

Dec

Arid Region

Maize (sweet)

0.3 / 1.15 / 1.05

9.42

Maize (sweet)

30 / 30 / 30 / 10

Apr

Idaho

Maize (sweet)

0.3 / 1.15 / 1.05

9.43

Maize (sweet)

20 / 40 / 70 / 10

Jan

Calif. Desert

Maize (sweet)

0.3 / 1.15 / 1.05

9.44

Millet

15 / 25 / 40 / 25

Jun

Pakistan

Millet

0.3 / 1 / 0.3

9.45

Millet

20 / 30 / 55 / 35

Apr

Central USA

Millet

0.3 / 1 / 0.3

9.46

Sorghum

20 / 35 / 40 / 30

May/Jun

USA

Sorghum (grain)

0.3 / 1.05 / 0.55

9.47

Sorghum

20 / 35 / 40 / 30

May/Jun

Pakistan

Sorghum (grain)

0.3 / 1.05 / 0.55

9.48

Sorghum

20 / 35 / 40 / 30

May/Jun

Medit.

Sorghum (grain)

0.3 / 1.05 / 0.55

9.49

Sorghum

20 / 35 / 45 / 30

Mar/Apr

Arid Region

Sorghum (grain)

0.3 / 1.05 / 0.55

9.50

Sorghum

20 / 35 / 40 / 30

May/Jun

USA

Sorghum (sweet)

0.3 / 1.2 / 1.05

9.51

Sorghum

20 / 35 / 40 / 30

May/Jun

Pakistan

Sorghum (sweet)

0.3 / 1.2 / 1.05

9.52

Sorghum

20 / 35 / 40 / 30

May/Jun

Medit.

Sorghum (sweet)

0.3 / 1.2 / 1.05

9.53

Sorghum

20 / 35 / 45 / 30

Mar/Apr

Arid Region

Sorghum (sweet)

0.3 / 1.2 / 1.05

9.54

Rice

30 / 30 / 60 / 30

Dec

Tropics

Rice

1.05 / 1.2 / 0.75

9.55

Rice

30 / 30 / 60 / 30

May

Medit.

Rice

1.05 / 1.2 / 0.75

9.56

Rice

30 / 30 / 80 / 40

May

Tropics

Rice

1.05 / 1.2 / 0.75

10.0

Alfalfa (total season)

10 / 30 / - / -

-

last -4°C in spring until first -4°C in fall

Alfalfa (averaged cutting effects)

0.4 / 0.95 / 0.9

10.1

Alfalfa (total season)

10 / 30 / - / -

-

last -4°C in spring until first -4°C in fall

Alfalfa (individual cutting periods)

0.4 / 1.2 / 1.15

10.2

Alfalfa (total season)

10 / 30 / - / -

-

last -4°C in spring until first -4°C in fall

Alfalfa (for seed)

0.4 / 0.5 / 0.5

10.3

Alfalfa (1st cutting cycle)

10 / 20 / 20 / 10

Jan

California

Alfalfa (averaged cutting effects)

0.4 / 0.95 / 0.9

10.4

Alfalfa (1st cutting cycle)

10 / 30 / 25 / 10

Apr (last -4°C)

Idaho

Alfalfa (averaged cutting effects)

0.4 / 0.95 / 0.9

10.5

Alfalfa (1st cutting cycle)

10 / 20 / 20 / 10

Jan

California

Alfalfa (individual cutting periods)

0.4 / 1.2 / 1.15

10.6

Alfalfa (1st cutting cycle)

10 / 30 / 25 / 10

Apr (last -4°C)

Idaho

Alfalfa (individual cutting periods)

0.4 / 1.2 / 1.15

10.7

Alfalfa (1st cutting cycle)

10 / 20 / 20 / 10

Jan

California

Alfalfa (for seed)

0.4 / 0.5 / 0.5

10.8

Alfalfa (1st cutting cycle)

10 / 30 / 25 / 10

Apr (last -4°C)

Idaho

Alfalfa (for seed)

0.4 / 0.5 / 0.5

10.9

Alfalfa (other cutting cycles)

5 / 10 / 10 / 5

Mar

California

Alfalfa (averaged cutting effects)

0.4 / 0.95 / 0.9

10.10

Alfalfa (other cutting cycles)

5 / 20 / 10 / 10

Jun

Idaho

Alfalfa (averaged cutting effects)

0.4 / 0.95 / 0.9

10.11

Alfalfa (other cutting cycles)

5 / 10 / 10 / 5

Mar

California

Alfalfa (individual cutting periods)

0.4 / 1.2 / 1.15

10.12

Alfalfa (other cutting cycles)

5 / 20 / 10 / 10

Jun

Idaho

Alfalfa (individual cutting periods)

0.4 / 1.2 / 1.15

10.13

Alfalfa (other cutting cycles)

5 / 10 / 10 / 5

Mar

California

Alfalfa (for seed)

0.4 / 0.5 / 0.5

10.14

Alfalfa (other cutting cycles)

5 / 20 / 10 / 10

Jun

Idaho

Alfalfa (for seed)

0.4 / 0.5 / 0.5

10.15

Bermuda (for hay; several cuttings)

10 / 15 / 75 / 35

-

Calif. Desert

Bermuda (averaged cutting effects)

0.55 / 1 / 0.85

10.16

Bermuda (for seed)

10 / 25 / 35 / 35

Mar

Calif. Desert

Bermuda (spring crop for seed)

0.35 / 0.9 / 0.65

10.17

Grass pasture

10 / 20 / - / -

-

7 days before last -4°C in spring until 7 days after first -4°C in fall

Grazing pasture (rotated grazing)

0.4 / 0.95 / 0.85

10.18

Grass pasture

10 / 20 / - / -

-

7 days before last -4°C in spring until 7 days after first -4°C in fall

Grazing pasture (extensive grazing)

0.3 / 0.75 / 0.75

10.19

Sudan (1st cutting cycle)

25 / 25 / 15 / 10

Apr

Calif. Desert

Sudan grass (averaged cutting effects)

0.5 / 0.9 / 0.85

10.20

Sudan (1st cutting cycle)

25 / 25 / 15 / 10

Apr

Calif. Desert

Sudan grass (individual cutting periods)

0.5 / 1.15 / 1.1

10.21

Sudan (other cutting cycles)

3 / 15 / 12 / 7

Jun

Calif. Desert

Sudan grass (averaged cutting effects)

0.5 / 0.9 / 0.85

10.22

Sudan (other cutting cycles)

3 / 15 / 12 / 7

Jun

Calif. Desert

Sudan grass (individual cutting periods)

0.5 / 1.15 / 1.1

11.0

Sugarcane (virgin)

35 / 60 / 190 / 120

-

Low Latitudes

Sugarcane

0.4 / 1.25 / 0.75

11.1

Sugarcane (virgin)

50 / 70 / 220 / 140

-

Tropics

Sugarcane

0.4 / 1.25 / 0.75

11.2

Sugarcane (virgin)

75 / 105 / 330 / 210

-

Hawaii

Sugarcane

0.4 / 1.25 / 0.75

11.3

Sugarcane (ratoon)

25 / 70 / 135 / 50

-

Low Latitudes

Sugarcane

0.4 / 1.25 / 0.75

11.4

Sugarcane (ratoon)

30 / 50 / 180 / 60

-

Tropics

Sugarcane

0.4 / 1.25 / 0.75

11.5

Sugarcane (ratoon)

35 / 105 / 210 / 70

-

Hawaii

Sugarcane

0.4 / 1.25 / 0.75

12.0

Banana (1st year)

120 / 90 / 120 / 60

Mar

Medit.

Banana (1st year)

0.5 / 1.1 / 1

12.1

Banana (2nd year)

120 / 60 / 180 / 5

Feb

Medit.

Banana (2nd year)

1 / 1.2 / 1.1

12.2

Pineapple

60 / 120 / 600 / 10

-

Hawaii

Pineapple (bare soil)

0.5 / 0.3 / 0.3

12.3

Pineapple

60 / 120 / 600 / 10

-

Hawaii

Pineapple (with grass cover)

0.5 / 0.5 / 0.5

13.0

Grapes

20 / 40 / 120 / 60

Apr

Low Latitudes

Grapes (table or raisin)

0.3 / 0.85 / 0.45

13.1

Grapes

20 / 50 / 75 / 60

Mar

California

Grapes (table or raisin)

0.3 / 0.85 / 0.45

13.2

Grapes

20 / 50 / 90 / 20

May

High Latitudes

Grapes (table or raisin)

0.3 / 0.85 / 0.45

13.3

Grapes

30 / 60 / 40 / 80

Apr

Mid Latitudes

Grapes (table or raisin)

0.3 / 0.85 / 0.45

13.4

Grapes

20 / 40 / 120 / 60

Apr

Low Latitudes

Grapes (wine)

0.3 / 0.7 / 0.45

13.5

Grapes

20 / 50 / 75 / 60

Mar

California

Grapes (wine)

0.3 / 0.7 / 0.45

13.6

Grapes

20 / 50 / 90 / 20

May

High Latitudes

Grapes (wine)

0.3 / 0.7 / 0.45

13.7

Grapes

30 / 60 / 40 / 80

Apr

Mid Latitudes

Grapes (wine)

0.3 / 0.7 / 0.45

13.8

Hops

25 / 40 / 80 / 10

Apr

Idaho

Hops

0.3 / 1.05 / 0.85

14.0

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Almonds (no ground cover)

0.4 / 0.9 / 0.65

14.1

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Almonds (no ground cover)

0.4 / 0.9 / 0.65

14.2

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Almonds (no ground cover)

0.4 / 0.9 / 0.65

14.3

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apple (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.4

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apple (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.5

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apple (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.6

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apple (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.7

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apple (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.8

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apple (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.9

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apple (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.10

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apple (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.11

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apple (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.12

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apple (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.13

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apple (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.14

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apple (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.15

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Cherry (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.16

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Cherry (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.17

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Cherry (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.18

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Cherry (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.19

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Cherry (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.20

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Cherry (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.21

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Cherry (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.22

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Cherry (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.23

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Cherry (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.24

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Cherry (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.25

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Cherry (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.26

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Cherry (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.27

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Pear (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.28

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Pear (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.29

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Pear (no ground cover; killing frost)

0.45 / 0.95 / 0.7

14.30

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Pear (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.31

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Pear (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.32

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Pear (no ground cover; no frost)

0.6 / 0.95 / 0.75

14.33

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Pear (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.34

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Pear (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.35

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Pear (active ground cover; killing frost)

0.5 / 1.2 / 0.95

14.36

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Pear (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.37

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Pear (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.38

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Pear (active ground cover; no frost)

0.8 / 1.2 / 0.85

14.39

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apricot (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.40

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apricot (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.41

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apricot (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.42

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apricot (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.43

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apricot (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.44

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apricot (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.45

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apricot (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.46

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apricot (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.47

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apricot (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.48

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Apricot (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.49

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Apricot (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.50

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Apricot (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.51

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Peach (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.52

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Peach (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.53

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Peach (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.54

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Peach (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.55

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Peach (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.56

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Peach (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.57

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Peach (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.58

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Peach (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.59

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Peach (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.60

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Peach (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.61

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Peach (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.62

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Peach (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.63

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Stone Fruit (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.64

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Stone Fruit (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.65

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Stone Fruit (no ground cover; killing frost)

0.45 / 0.9 / 0.65

14.66

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Stone Fruit (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.67

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Stone Fruit (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.68

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Stone Fruit (no ground cover; no frost)

0.55 / 0.9 / 0.65

14.69

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Stone Fruit (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.70

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Stone Fruit (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.71

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Stone Fruit (active ground cover; killing frost)

0.5 / 1.15 / 0.9

14.72

Deciduous orchard

20 / 70 / 90 / 30

Mar

High Latitudes

Stone Fruit (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.73

Deciduous orchard

20 / 70 / 120 / 60

Mar

Low Latitudes

Stone Fruit (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.74

Deciduous orchard

30 / 50 / 130 / 30

Mar

California

Stone Fruit (active ground cover; no frost)

0.8 / 1.15 / 0.85

14.75

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (no ground cover; 70% canopy)

0.7 / 0.65 / 0.7

14.76

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (no ground cover; 50% canopy)

0.65 / 0.6 / 0.65

14.77

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (no ground cover; 20% canopy)

0.5 / 0.45 / 0.55

14.78

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (active ground cover; 70% canopy)

0.75 / 0.7 / 0.75

14.79

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (active ground cover; 50% canopy)

0.8 / 0.8 / 0.8

14.80

Citrus

60 / 90 / 120 / 95

Jan

Medit.

Citrus (active ground cover; 20% canopy)

0.85 / 0.85 / 0.85

14.81

Olives

30 / 90 / 60 / 90

Mar

Medit.

Olives (40 to 60% ground coverage by canopy)

0.65 / 0.7 / 0.7

14.82

Pistachios

20 / 60 / 30 / 40

Feb

Medit.

Pistachios (no ground cover)

0.4 / 1.1 / 0.45

14.83

Walnuts

20 / 10 / 130 / 30

Apr

Utah

Walnut orchard

0.5 / 1.1 / 0.65

15.0

Wetlands (cattails; bulrush)

10 / 30 / 80 / 20

May

Utah

Cattails (killing frost)

0.3 / 1.2 / 0.3

15.1

Wetlands (cattails; bulrush)

180 / 60 / 90 / 35

Nov

Florida

Cattails (no frost)

0.6 / 1.2 / 0.6

15.2

Wetlands (cattails; bulrush)

10 / 30 / 80 / 20

May

Utah

Bulrush (killing frost)

0.3 / 1.2 / 0.3

15.3

Wetlands (cattails; bulrush)

180 / 60 / 90 / 35

Nov

Florida

Bulrush (no frost)

0.6 / 1.2 / 0.6

15.4

Wetlands (short vegetation)

180 / 60 / 90 / 35

Nov

Frost-free Climate

Short vegetation (no frost)

1.05 / 1.1 / 1.1

Crop Growth Stages

This section provides the listing of all supported growth stages for each crop growth model.

Barley

Stage ID Stage Name Stage - Long Description

0.5

0.5 - Emergence

The first leaf is at half of its final length.

1.0

1.0 - 1 Leaf

Leaf 1 is fully extended, and in its rolled part, the second leaf can just be seen.

2.0

2.0 - 2 Leaves

Leaf 2 is fully extended, and in its rolled part, the third leaf can just be seen.

3.0

3.0 - 3 Leaves

Leaf 3 is fully extended, and in its rolled part, the fourth leaf can just be seen. Tillers begin to emerge.

4.0

4.0 - 4 Leaves

Leaf 4 is fully extended, and in its rolled part, the fifth leaf can just be seen.

5.0

5.0 - 5 Leaves

Leaf 5 is fully extended, and in its rolled part, the sixth leaf can just be seen. Tillering ends.

6.0

6.0 - 6 Leaves

Leaf 6 is fully extended, and in its rolled part, the seventh leaf can just be seen.

7.0

7.0 - 7 Leaves

Leaf 7 is fully extended, and in its rolled part, the eighth leaf can just be seen.

8.0

8.0 - Flag Leaf Emerged

The collar of the flag leaf (leaf 8) can be seen. Lengthening of the flag leaf stem begins.

9.0

9.0 - Boot Swelling Begins

The flag leaf stem has increased in length, raising the flag leaf above the previous leaf. Awns are just coming out of the boot.

9.5

9.5 - Mid Boot

The head is half emerged and flowering begins.

10.0

10.0 - Head Emerged

The head has cleared the flag leaf collar and flowering ends. Lengthening of the head stem begins.

11.0

11.0 - Heading Complete

Lengthening of the head stem ends.

11.5

11.5 - Kernel Watery Ripe

Kernel width and length are set; not much dry matter has accumulated.

13.0

13.0 - Soft Dough

Kernel content is soft and dry; fingernail imprint does not stay.

15.0

15.0 - Physiological Maturity

Dry weight of the kernels stops increasing.

Canola

Stage ID Stage Name Stage - Long Description

S

Emergence

Emergence occurs when the seedling pushes through the soil surface.

R3

Rosette - 3rd Leaf

A rosette is formed: bigger, older leaves at the base and smaller, younger leaves in the center.

R4

Rosette - 4th Leaf

Stem thickness increases but stem length changes very little.

EB

Early Bud

In the center of the rosette, a group of lengthening (bolting) flower buds can be seen.

LB

Late Bud

Buds produce secondary branches which develop one to four leaves and a group of flower buds.

EF

Early Flower

The opening of the lowest bud on the main stem indicates the start of flowering.

LF

Late Flower

About half of the flowers that open will produce pods.

ER

Early Ripening

The ripening process starts when the petals of the last produced flower (on the main stem) drop.

R

Ripe

About one third of the seeds on the main stem have changed color; the crop is ready to swath.

Corn

Stage ID Stage Name Stage - Long Description

ve

VE - Emergence

The seedling pushes through the soil surface. With optimum soil moisture and temperature, corn plants can emerge within a week after planting.

v1

V1 - 1 Leaf

The plant has one leaf with a visible collar, although more leaves are visible. The tip of this first leaf is oval - the others are more pointed. The growing point is below the soil surface.

v3

V3 - 3 Leaves

The plant has three leaves with visible collars. The stalk hasn’t increased much in length. The growing point is still below the surface.

v6

V6 - 6 Leaves

The plant has six leaves with visible collars. The growing point extends above the soil surface around this time, making the plant more susceptible to a killing frost.

v9

V9 - 9 Leaves

The plant has nine leaves with visible collars, although the lowest leaves may no longer be present. The growing point continues to move upward.

vt

VT - Tasseling

All branches of the tassel are fully visible. Plants will not grow much taller. Silking is only a few days away, depending on hybrid and moisture conditions.

r2

R2 - Blister

Kernels look like blisters and are ivory colored on the outside. The liquid inside is clear. The ear has reached its maximum length.

r3

R3 - Milk

Kernels are yellow on the outside. The liquid inside has turned milky white because of increasing starch content. Silks are brown and drying out.

r4

R4 - Dough

Kernels are deep yellow on the outside. The milky liquid inside the kernels thickens, becoming pasty and doughy, because of increasing starch content.

r5

R5 - Dent

Kernels are dented because of decreasing moisture content and increasing starch content. A hard layer of starch starts to form in the kernels.

r6

R6 - Physiological Maturity

A black layer forms at the base of the kernels blocking further dry matter accumulation. All starch in the kernels has hardened at this time.

Cotton

Stage ID Stage Name Stage - Long Description

v1.0

Emergence

Emergence occurs when the seedling pushes through the soil surface.

v2.0

First Square

The first squares (flower buds) are visible. Typically, less than 50% of all squares produce mature bolls.

v3.0

First Flowers

The first flowers are visible. A flower is pollinated on the first day it is open (white bloom stage) and turns pink or red the next day.

v4.0

Peak Blooming

Cotton has an indeterminate growth habit: flowering (blooming) will continue unless terminated by frost, drought, full boll load, insect attack, etc.

v5.0

First Open Boll

The first bolls open (mature). Not every boll will reach maturity - if not enough of the ovules are fertilized, the boll will drop a week or more after flowering.

v7.0

60% Open Boll

Sixty percent of bolls have opened. Harvest aid chemicals can change the time needed to open bolls by few days.

Peanut

Stage ID Stage Name Stage - Long Description

VE

Emergence

Emergence occurs when the seedling pushes through the soil surface.

V1

V1 - 1 Tetrafoliate

Plants have one set of unfolded tetrafoliate leaves.

Vn

Vn - n Tetrafoliates

Plants have n sets of unfolded tetrafoliate leaves.

R1

R1 - First Flower

Plants have at least one flower.

R2

R2 - First Peg

Plants have at least one elongated peg (gynophore).

R3

R3 - First Pod

Plants have at least one peg in the soil with turned, swollen ovary at least twice the width of the peg.

R5

R5 - First Seed

Plants have at least one fully-expanded pod with seeds beginning to grow.

R8

R8 - Harvest Maturity

Peanut crop is ready for harvest.

Potato

Stage ID Stage Name Stage - Long Description

1

Emergence

Emergence occurs when the seedling pushes through the soil surface.

2

Tuber Initiation

Plants have one tuber with a diameter of 1 cm or greater.

3

Beginning Senescence

The first leaves are yellowing.

4

Harvest

Plants are completely dead; potatoes are harvest ready.

Sorghum

Stage ID Stage Name Stage - Long Description

1

Emergence

Emergence occurs when the seedling pushes through the soil surface. The time between planting and emergence depends on soil temperature, residue cover and distribution, soil moisture, planting depth, and seed vigor.

2

3 Leaves

Three leaves are fully expanded with a visible collar. The growing point is under the soil surface.

3

4 Leaves

Four leaves are fully expanded with a visible collar. The growing point is under the soil surface.

4

5 Leaves

Five leaves are fully expanded with a visible collar. The growing point is under the soil surface. The plant begins a rapid growth and nutrient accumulation phase. The root system is expanding rapidly.

5

Panicle (Head) Initiation

Potential leaf number is defined. Maximum plant growth and nutrient uptake rates are achieved. The growing point is above the surface and changes from producing leaves to forming heads.

6

Flag Leaf Visible

The final leaf (flag leaf) is visible in the whorl. Rapid stem elongation and increases in leaf area occur at this stage.

7

Boot

The head has extended into the flag leaf sheath. Maximum leaf area has been achieved. Maximum potential head size and seed number has been set. The upper stalk (the peduncle) begins to elongate.

8

Heading

The head (panicle) emerges from the final (flag) leaf. Heads are visible on 50 percent of the plants in the field.

9

Flowering

Flowering typically begins when yellow anthers appear at the tip 5 to 7 days after head (panicle) exertion. Over the next 4 to 9 days, anthers appear incrementally and develop down the panicle.

10

Soft Dough

Kernels are soft with little or no liquid present when squeezed. Grain fills rapidly. The stem loses weight due to a remobilization process (from stem to grain).

11

Hard Dough

Kernels are hard when squeezed. Grain reaches 75% of its final dry weight and nutrient uptake is almost complete. Lower leaves lose functionality due to remobilization of nutrients to grain or senescence.

12

Physiological Maturity

Grain achieves its maximum dry weight. Mature grain is identified by looking for the dark spot, the black layer, on the bottom of the kernel. Grain moisture ranges from 25 to 35%.

Soybean

Stage ID Stage Name Stage - Long Description

RA

RA - Radicle Appearance

The radicle (primary root) is appearing from the seed. Shortly after radicle appearance, the seed’s hypocotyl starts to grow toward the soil surface.

VE

VE - Emergence

Emergence occurs when the seedling pushes through the soil surface.

VC

VC - Unifoliate

Plants have a completely unrolled leaf at the unifoliate node.

V1

V1 - 1 Trifoliate

Plants have one set of unfolded trifoliate leaves.

Vn

Vn - n Trifoliates

Plants have n sets of unfolded trifoliate leaves.

R1

R1 - First Flower

Plants have at least one flower at any node on the plant.

R2

R2 - Full Flowering

Plants have an open flower at one of the two uppermost nodes on the main stem with a fully developed trifoliate leaf node.

R3

R3 - First Pod

Plants have at least one pod that is 5 mm (0.2 inch) long, and ready to grow.

R3.5

R3.5 - Mid Pod Elongation

Plants have at least one pod that is 10–12 mm (a little less than half an inch) long.

R4

R4 - Full Pod

Plants have at least one fully expanded pod.

R5

R5 - First Seed

Plants have pods with seeds beginning to grow.

R6

R6 - Full Seed

Plants have at least one pod containing a full-sized green seed.

R7

R7 - Physiological Maturity

Plants have at least one pod that is yellowing.

R8

R8 - Harvest Maturity

Plants have at least 95 percent of pods that are brown.

Spring Wheat

Stage (Haun) Stage (Zadoks) Stage (Feekes) Stage ID Stage Name Stage - Long Description

0.5

10

1

101

Emergence

The first leaf is at half of its final length.

1.0

11

1.1

102

1 Leaf

Leaf 1 is fully extended, and in its rolled part, the second leaf can just be seen.

2.0

12

1.2

103

2 Leaves

Leaf 2 is fully extended, and in its rolled part, the third leaf can just be seen. Tillering is initiated.

3.0

13

2

104

3 Leaves

Leaf 3 is fully extended, and in its rolled part, the fourth leaf can just be seen.

4.0

14

n/a

105

4 Leaves

Leaf 4 is fully extended, and in its rolled part, the fifth leaf can just be seen. Tillers are visible.

5.0

30

4-5

106

5 Leaves

Leaf 5 is fully extended, and in its rolled part, the sixth leaf can just be seen. Tillering ends.

n/a

31

6

107

6th Leaf Emerged

The sixth leaf has emerged. Stem extension begins.

6.0

n/a

n/a

108

6 Leaves

Leaf 6 is fully extended, and in its rolled part, the seventh leaf can just be seen.

n/a

32

7

109

7th Leaf Emerged

The seventh leaf has emerged.

7.0

n/a

n/a

110

7 Leaves

Leaf 7 is fully extended, and in its rolled part, the eighth leaf can just be seen.

7.5

3

8

111

Flag Leaf Emerging

The flag leaf (leaf 8) is emerging.

8.0

39

9

112

Flag Leaf Emerged

The collar of the flag leaf (leaf 8) can be seen; the flag leaf is fully developed now.

9.0

43

n/a

113

Boot Swelling Begins

The flag leaf stem increases in length, raising the flag leaf above the previous leaf.

10.0

45

10

114

Boot Swollen

Awns can be observed at the collar of the flag leaf; booting ends.

10.1

49

n/a

115

Awns Emerging

Awns are emerging.

11.0

59

10.5

116

Head Emerged

The head has entirely cleared the flag leaf collar; the head stem continues to grow.

11.4

61

10.51

117

Flowering Begins

Flowering starts in the center of the head, and then advances towards the top and the bottom of the head at the same time.

11.6

69

10.53

118

Flowering Complete

Flowering ends and kernel development begins.

12.1

71

10.54

119

Kernel Watery Ripe

Kernel width and length are set; not much dry matter has accumulated.

15.0

87

n/a

120

Hard Dough

The crop is nearing physiological maturity; kernel development is about to end.

15.6

92

11.3

121

Physiological Maturity

Kernels are hard, but a fingernail can still make an imprint. Plants have lost all green color.

Sugarbeet

Stage ID Stage Name Stage - Long Description

v1.0

Emergence

Emergence occurs when the seedling pushes through the soil surface.

v2.0

2 Leaves

Two true leaves have unfolded and there is no sign of the next leaf stage. These first two leaves develop at the same time.

v3.0

3 Leaves

Three true leaves have unfolded and there is no sign of the next leaf stage.

v4.0

4 leaves

Four true leaves have unfolded and there is no sign of the next leaf stage.

v5.0

5 Leaves

Five true leaves have unfolded and there is no sign of the next leaf stage.

v6.0

6 Leaves

Six true leaves have unfolded and there is no sign of the next leaf stage.

v7.0

7 Leaves

Seven true leaves have unfolded and there is no sign of the next leaf stage.

v8.0

8 Leaves

Eight true leaves have unfolded and there is no sign of the next leaf stage.

v9.0

9 Leaves

Nine true leaves have unfolded and there is no sign of the next leaf stage.

v10.0

10 Leaves

Ten true leaves have unfolded and there is no sign of the next leaf stage.

Sunflower

Stage ID Stage Name Stage - Long Description

1

VE - Emergence

Emergence occurs when the seedling pushes through the soil surface.

3

V2 - 2 Leaves

The plant has 2 true leaves of 4 cm (1.6 inch) or longer.

6

V5 - 5 Leaves

The plant has 5 true leaves of 4 cm (1.6 inch) or longer.

9

V8 - 8 Leaves

The plant has 8 true leaves of 4 cm (1.6 inch) or longer.

12

V11 - 11 Leaves

The plant has 11 true leaves of 4 cm (1.6 inch) or longer.

15

V14 - 14 Leaves

The plant has 14 true leaves of 4 cm (1.6 inch) or longer.

18

V17 - 17 Leaves

The plant has 17 true leaves of 4 cm (1.6 inch) or longer.

22

R1 - Miniature Terminal Bud

The bud forms a miniature floral head. From above, the bracts look like a star with many points.

23

R2 - Bud < 2 cm From Leaf

The distance between bud and nearest leaf (attached to the stem) is less than 2 cm (0.8 inch). Don’t consider leaves attached directly to the back of the bud.

24

R3 - Bud > 2 cm From Leaf

The distance between bud and nearest leaf has increased to more than 2 cm (0.8 inch).

25

R4 - Bud Open

The bud begins to open. Ray flowers can be seen when looked at from above.

26

R5.1 - Early Flower

Ten percent of the head area (disk flowers) is flowering or has finished flowering.

27

R5.5 - 50% Flowered

Fifty percent of the head area (disk flowers) is flowering or has finished flowering.

28

R6 - Flowering Complete

Flowering ends; ray flowers are wilting.

29

R7 - Head Back: Pale Yellow

The back of the head has started to become light (pale) yellow.

30

R8 - Head Back: Yellow

The back of the head is yellow; the bracts are still green.

31

R9 - Physiological Maturity

The back of the head is brown; the bracts turn yellow/brown.

Winter Wheat

Stage (Haun) Stage (Zadoks) Stage (Feekes) Stage ID Stage Name Stage - Long Description

n/a

05

n/a

0

Germination

The radicle (primary root) is appearing from the seed.

0.1

10

1

1

Emergence

Emergence occurs when the seedling pushes through the soil surface.

1.9-2.7

21

2

2

First Tiller

The first tiller is visible.

n/a

n/a

n/a

3

Single Ridge

The shoot apex shape changes from dome to more elongated, and leaf primordia begin to form a ridge around the apex.

n/a

n/a

n/a

4

Double Ridge

The formation of double ridges (bottom ridge = leaf, top ridge = spikelet) around the apex occurs.

n/a

n/a

n/a

5

Flower Primordium

Flower primordium initiation begins.

4.3

30

4

6

Stem Elongation Begins

The first internode within the crown begins to elongate. Spikelet initiation ends.

4.6

31

6

7

Jointing

The first joint (node) is visible above the soil surface. Plant growth changes from prostrate to upright.

6.0-7.0

39

9

8

Booting / Flag Leaf Complete

The flag leaf is fully developed; the flag leaf collar can be seen.

n/a

50

10.1

9

Heading

The first spikelet of the head is visible above the flag leaf collar, or it is coming out the side of the flag leaf sheath.

n/a

61

10.5.1

10

Flowering Begins

Flowering (anthesis) starts in the center of the head, and then advances towards the top and the bottom of the head at the same time.

n/a

69

10.5.4

11

Flowering Complete

Flowering (anthesis) ends and kernel development begins.

n/a

92

11.3

12

Physiological Maturity

Dry weight of the kernel stops increasing. Spike and peduncle have lost their green color entirely.

n/a

93

11.4

13

Harvest Ready

The grain has dried after physiological maturity. The wheat crop is ready to be harvested.

Parameter Units - Crop Growth and Health

Below is a listing of weather parameter units that appear in the Crop Growth and Health API endpoints, including a description of each and a listing of the associated parameter types.

System of units Parameter unit What it stands for Associated parameters

US-std

F

Degrees Fahrenheit

temperature, dew point temperature

SI-std

C

Degrees Celsius

temperature, dew point temperature

US-std & SI-std

%

Percent

cloud cover, forecast confidence, relative humidity

US-std

In

Inch

precipitation accumulation, potential evapotranspiration

SI-std

mm

Millimeter

precipitation accumulation, potential evapotranspiration

US-std

mb

Millibar

atmospheric pressure

SI-std

Pa

Pascal

atmospheric pressure

US-std

mi

Mile

visibility

SI-std

km

Kilometer

visibility

US-std & SI-std

degree

Degree

wind direction

US-std

mph

Miles per Hour

wind speed, wind gust

SI-std

kph

Kilometers per Hour

wind speed, wind gust

US-std & SI-std

W/m^2

Watts per Square Meter

longwave radiation, shortwave radiation

US-std & SI-std

dBZ

Decibel

radar reflectivity

Changelog

This section describes document changes occurring in the two most recent versions.

11-12-18

Added the Barley Nitrogen and Sunflower Nitrogen endpoints.