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 Harvest Modeling

last updated 11/7/18

Crop Harvest Modeling delivers precise and relevant data and modeling to improve the management of harvest activities and grain drydown costs. Specifically, ClearAg harvest modeling estimates grain drydown rates using field-level analysis of weather conditions and user-supplied measurements of grain crop conditions, and estimates mechanical drydown cost through robust modeling. 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.

In-Field Drydown

Barley In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and spring barley growth model, the Barley In-Field Drydown endpoint simulates the drying process of spring barley grain in the field after the crop achieves full maturity, and provides daily grain moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/barley/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

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. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

description

Text description for a stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/barley/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Growth model based on a model presented by the North Dakota Agricultural Weather Network, but substantially modified."
    ],
    "data":{
        "39,-103":{
            "2016-06-05":{
                "agdd":1721.0,
                "air_temp_max":80.0,
                "air_temp_min":52.0,
                "equilibrium_moisture_content":"n/a",
                "feedback_id":"abc-def",
                "gdd":36.0,
                "grain_moisture_content":"n/a",
                "grain_moisture_content_change":"n/a",
                "last_stage":"11.0",
                "new_stage":"11.5"
            },
            "2016-06-06":{
                "agdd":1757.0,
                "air_temp_max":82.0,
                "air_temp_min":54.0,
                "equilibrium_moisture_content":"n/a",
                "field_activity_id":"abd-cef",
                "gdd":36.0,
                "grain_moisture_content":"11.81",
                "grain_moisture_content_change":"n/a",
                "last_stage":"11.5",
                "new_stage":"n/a"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-07-29",
        "start":"2016-07-08"
    },
    "stage_descriptions":{
        "11.5":{
            "advisor":"Harvest",
            "description":"Kernel width and length are set; not much dry matter has accumulated.",
            "images":[{
                "attribution":"Courtesy of David L. Hansen, University of Minnesota.",
                "caption":"Watery ripe",
                "url":".../Watery_ripe.png"
            },...],
            "name":"11.5 - Kernel Watery Ripe",
            "order":"14"
        },...
    }
}

Canola In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and canola growth model, the Canola In-Field Drydown endpoint simulates the drying process of canola seed in the field after the crop achieves full maturity, and provides daily seed moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/canola/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

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. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

description

Text description for a stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/canola/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Growth model based on a model presented by the North Dakota Agricultural Weather Network, but substantially modified."
    ],
    "data":{
        "39,-103":{
            "2016-04-14":{
                "agdd":392.5,
                "air_temp_max":75.0,
                "air_temp_min":42.0,
                "equilibrium_moisture_content":"8.61",
                "feedback_id":"abc-def",
                "gdd":17.5,
                "grain_moisture_content":"n/a",
                "grain_moisture_content_change":"n/a",
                "last_stage":"S",
                "new_stage":"n/a"
            },
            "2016-04-14":{
                "agdd":410.0,
                "air_temp_max":75.0,
                "air_temp_min":42.0,
                "equilibrium_moisture_content":"8.60",
                "field_activity_id":"abd-cef",
                "gdd":17.5,
                "grain_moisture_content":"12.89",
                "grain_moisture_content_change":"n/a",
                "last_stage":"S",
                "new_stage":"R3"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-07-27",
        "start":"2016-07-07"
    },
    "stage_descriptions":{
        "S":{
            "advisor":"Nutrient",
            "description":"Emergence occurs when the seedling pushes through the soil surface.",
            "images":[{
                "attribution":"Courtesy of the Canola Council of Canada.",
                "caption":"Seedling (cotyledon)",
                "url":".../cotyledon_150.jpg"
            },...],
            "name":"Emergence",
            "order":"1"
        },...
    }
}

Corn In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and corn growth model, the Corn In-Field Drydown endpoint simulates the drying process of corn grain in the field after the crop achieves full maturity, and provides daily grain moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

Please note that due to the nature of corn, full maturity may not always be attained in a growing season. In these cases, the in-field drydown model for corn will start when the simulation reaches the stage prior to physiological maturity.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/corn/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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.

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

agdd

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

air_temp_max

Maximum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

description

Text description for a stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/corn/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[],
    "data":{
        "45,-97":{
            "2016-10-01":{
                "agdd":2300.0,
                "air_temp_max":58,
                "air_temp_min":40,
                "equilibrium_moisture_content":7.43,
                "feedback_id":"abc-def",
                "gdd":3.5,
                "grain_moisture_content":31.92,
                "grain_moisture_content_change":-1.0,
                "last_stage":"r6",
                "new_stage":"n/a"
            },
            "2016-10-02":{
                "agdd":2303.5,
                "air_temp_max":62,
                "air_temp_min":40,
                "equilibrium_moisture_content":7.43,
                "field_activity_id":"abd-cef",
                "gdd":6.0,
                "grain_moisture_content":30.92,
                "grain_moisture_content_change":-0.51,
                "last_stage":"r6",
                "new_stage":"n/a"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-10-19",
        "start":"2016-09-17"
    },
    "stage_descriptions":{
        "ve":{
            "advisor":"Nutrient",
            "description":"Emergence - VE (emergence) occurs when the coleoptile (spike) pushes through the soil surface. Corn plants can emerge within five days in ideal heat and moisture conditions. But in practice, due to early planting under seasonably cool conditions, at least two weeks are normally required from planting to emergence.",
            "images":[{
                "attribution":"Courtesy of Agronomy Extension, Iowa State University.",
                "caption":"Emergence",
                "url":".../Figure_12_ISUE300.jpg"
            },...],
            "name":"VE - Emergence",
            "order":"1"
        },...
    }
}

Sorghum In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and sorghum growth model, the Sorghum In-Field Drydown endpoint simulates the drying process of sorghum grain in the field after the crop achieves full maturity, and provides daily grain moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

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, in Fahrenheit. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date, in Fahrenheit. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

Expected end date for harvest operations.

harvest_window/start

Expected start date for harvest operations.

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 the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Descriptions courtesy of Kansas State University (Sorghum Growth and Development. MF3234. Dr. Ciampitti, Crop Production & Cropping Systems Specialist, Dept. of Agronomy, Kansas State University. Ciampitti@ksu.edu; Twitter @KSUCROPS) and Texas A&M University."
    ],
    "data":{
        "47,-97":{
            "2016-10-15":{
                "agdd":2746.5,
                "air_temp_max":70.0,
                "air_temp_min":42.0,
                "equilibrium_moisture_content":11.54,
                "feedback_id":"abc-def",
                "gdd":11.0,
                "grain_moisture_content":29.56,
                "grain_moisture_content_change":"n/a",
                "last_stage":"11",
                "new_stage":"12"
            },
            "2016-10-15":{
                "agdd":2757.5,
                "air_temp_max":72.0,
                "air_temp_min":44.0,
                "equilibrium_moisture_content":11.54,
                "field_activity_id":"abd-cef",
                "gdd":11.0,
                "grain_moisture_content":27.76,
                "grain_moisture_content_change":-1.8,
                "last_stage":"12",
                "new_stage":"n/a"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-11-17",
        "start":"2016-10-22"
    },
    "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 Kansas State University (Sorghum Growth and Development. MF3234. Dr. Ciampitti, Crop Production & Cropping Systems Specialist, Dept. of Agronomy, Kansas State University. Ciampitti@ksu.edu; Twitter @KSUCROPS).",
                "caption":"Physiological Maturity",
                "url":".../Physiological+Maturity.png"
            }],
            "name":"Physiological Maturity",
            "order":"12"
        },...
    }
}

Soybean In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and soybean growth model, the Soybean In-Field Drydown endpoint simulates the drying process of soybean seed in the field after the crop achieves full maturity, and provides daily seed moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/soybean/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&maturity_group={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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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.

maturity_group

string

no

 — 

Classification indicating how early a variety matures. Valid values fall into the following range bins: 000.0 to 000.9, 00.0 to 00.9, and 0.0 to 10.9. Multi-zero range bins indicate the earliest maturities, with values near 10.9 indicating the latest maturities. Default is 3.0.

plant_depth

float

no

 — 

The depth (in cm) that the crop was planted. Valid values range from 0.1 to 7.5 cm. Default is 3.5.

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

agdd

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

air_temp_avg

Average daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_max

Maximum daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

last_reproductive_stage

The last known reproductive stage. If no valid stage has been reached, this value will be "n/a."

last_stage

The last known growth stage. If no valid stage has been reached, this value will be "n/a." This variable will contain vegetative stages until the beginning of flowering is reached, after which only new reproductive stages will be listed.

last_vegetative_stage

The last known vegetative stage. If no valid stage has been reached, this value will be "n/a."

new_reproductive_stage

The crop may have entered a new reproductive stage between the current date and the previous date. If new_reproductive_stage is "n/a," the crop is somewhere between the previous reproductive stage and the next reproductive stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is "n/a," the crop is somewhere between the previous growth stage and the next growth stage. This variable will contain vegetative stages until the beginning of flowering is reached, after which only new reproductive stages will be listed.

new_vegetative_stage

The crop may have entered a new vegetative stage between the current date and the previous date. If new_vegetative_stage is "n/a," the crop is somewhere between the previous vegetative stage and the next vegetative stage.

relative_humidity_avg

Average daily relative humidity provided as a percentage.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

description

Text description for a stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/soybean/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Growth model based on DSSAT / CROPGRO / Soybean."
    ],
    "data":{
        "47,-97":{
            "2016-08-10":{
                "agdd":1546.09,
                "air_temp_avg":71.0,
                "air_temp_max":86.0,
                "air_temp_min":57.0,
                "equilibrium_moisture_content":7.22,
                "feedback_id":"abc-def",
                "gdd":16.58,
                "grain_moisture_content":11.62,
                "grain_moisture_content_change":1.33,
                "last_reproductive_stage":"R6",
                "last_stage":"R6",
                "last_vegetative_stage":"V1",
                "new_reproductive_stage":"n/a",
                "new_stage":"n/a",
                "new_vegetative_stage":"n/a",
                "relative_humidity_avg":54.0
            },
            "2016-08-11":{
                "agdd":1562.67,
                "air_temp_avg":69.0,
                "air_temp_max":84.0,
                "air_temp_min":55.0,
                "equilibrium_moisture_content":7.22,
                "field_activity_id":"abd-cef",
                "gdd":16.58,
                "grain_moisture_content":12.95,
                "grain_moisture_content_change":-1.33,
                "last_reproductive_stage":"R6",
                "last_stage":"R6",
                "last_vegetative_stage":"V1",
                "new_reproductive_stage":"n/a",
                "new_stage":"n/a",
                "new_vegetative_stage":"n/a",
                "relative_humidity_avg":54.0
            },...
        }
    },
    "harvest_window":{
        "end":"2016-10-12",
        "start":"2016-09-17"
    },
    "stage_descriptions":{
        "R6":{
            "advisor":"Harvest",
            "description":"Full Seed - pod containing a green seed that fills the pod cavity at one of the four uppermost nodes on the main stem with a fully developed trifoliate leaf node",
            "images":[{
                "attribution":"Courtesy of Agronomy Extension, Iowa State University.",
                "caption":"R6 - Full seed",
                "url":".../R6.jpg"
            },...],
            "name":"R6 - Full Seed",
            "order":"12"
        },...
    }
}

Spring Wheat In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and spring wheat growth model, the Spring Wheat In-Field Drydown endpoint simulates the drying process of spring wheat grain in the field after the crop achieves full maturity, and provides daily grain moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&relative_maturity={string}&scale={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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

scale

string

no

no

Specifies which growth scale the response will display. Valid values include "feekes," "haun," and "zadoks." Default behavior is to utilize a unified scale and display the equivalent stages from all three scales in the response.

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

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. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

applicable_scales

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

description

Text description for a stage.

images/attribution

Credit for image.

images/caption

Image description.

images/url

Image URL.

name

Growth stage name.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Model based on a model presented by the North Dakota Agricultural Weather Network, but substantially modified."
    ],
    "data":{
        "39.26628442213066,-103.1396484375":{
            "2016-08-10":{
                "agdd":4451.5,
                "air_temp_max":84.0,
                "air_temp_min":56.0,
                "equilibrium_moisture_content":6.65,
                "feedback_id":"abc-def",
                "gdd":40.0,
                "grain_moisture_content":6.55,
                "grain_moisture_content_change":0.02,
                "last_stage":"20",
                "new_stage":"n/a"
            },
            "2016-08-11":{
                "agdd":4491.5,
                "air_temp_max":86.0,
                "air_temp_min":58.0,
                "equilibrium_moisture_content":6.68,
                "field_activity_id":"abd-cef",
                "gdd":40.0,
                "grain_moisture_content":6.57,
                "grain_moisture_content_change":0.03,
                "last_stage":"20",
                "new_stage":"n/a"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-10-12",
        "start":"2016-09-17"
    },
    "stage_descriptions":{
        "101":{
            "advisor":"Nutrient",
            "applicable_scales":{
                "feekes":"1",
                "haun":"0.5",
                "zadoks":"10"
            },
            "description":"The first leaf is at half of its final length.",
            "images":[{
                "attribution":"Courtesy of David L. Hansen, University of Minnesota.",
                "caption":"Emergence",
                "url":".../Coleoptile.jpg"
            },...],
            "name":"Emergence",
            "order":"1"
        },...
    }
}

Sunflower In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and sunflower growth model, the Sunflower In-Field Drydown endpoint simulates the drying process of sunflower seed in the field after the crop achieves full maturity, and provides daily seed moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

attribution

Various model attributions.

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, in Fahrenheit. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date, in Fahrenheit. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

Expected end date for harvest operations.

harvest_window/start

Expected start date for harvest operations.

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 the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "attribution":[
        "Growth model based on...",...
    ],
    "data":{
        "47,-97":{
            "2016-08-30":{
                "agdd":2886.0,
                "air_temp_max":81.0,
                "air_temp_min":50.0,
                "equilibrium_moisture_content":5.8,
                "gdd":21.5,
                "grain_moisture_content":30.99,
                "grain_moisture_content_change":"n/a",
                "last_stage":"30",
                "new_stage":"31"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-10-08",
        "start":"2016-09-13"
    },
    "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 In-Field Drydown - v1.0

Drawing from the ClearAg Field Weather API and winter wheat growth model, the Winter Wheat In-Field Drydown endpoint simulates the drying process of winter wheat grain in the field after the crop achieves full maturity, and provides daily grain moisture estimates during the drydown period. If Accounts API integration is used, any available moisture measurements are used to improve model results.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/infield_drydown?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&plant_date={timestamp}&account_id={string}&user_id={string}&growth_id={string}
&relative_maturity={string}&scale={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.

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. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].""

plant_date, emergence_date

timestamp

yes

 — 

Epoch timestamp valid near the time that the 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."

scale

string

no

no

Specifies which growth scale (feekes, haun, or zadoks) the response will display. Default behavior is to utilize a unified scale and display the equivalent stages from all three scales in the response.

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.

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

Response Object (JSON)

Field Description

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. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures. Note that wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

field_activity_id

If this field is present in the output it indicates a confirmed or observed moisture sample on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

harvest_window/end

The end of typical harvest operations.

harvest_window/start

The beginning of typical harvest operations.

advisor

Suggested field properties to check.

applicable_scales

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

description

Text description for a stage.

order

Relative position of the stage within the growth scale.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/infield_drydown?
app_id=123&app_key=321&location=47,-97&plant_date=1462060800

Example Response

{
    "data":{
        "39.26628442213066,-103.1396484375":{
            "2016-08-10":{
                "agdd":4439.61,
                "air_temp_max":80.0,
                "air_temp_min":65.0,
                "equilibrium_moisture_content":6.48,
                "feedback_id":"abc-def",
                "gdd":22.97,
                "grain_moisture_content":5.62,
                "grain_moisture_content_change":-0.10,
                "last_stage":"13",
                "new_stage":"n/a"
            },
            "2016-08-11":{
                "agdd":4462.58,
                "air_temp_max":81.0,
                "air_temp_min":66.0,
                "equilibrium_moisture_content":6.44,
                "gdd":22.97,
                "field_activity_id":"abd-cef",
                "grain_moisture_content":5.52,
                "grain_moisture_content_change":0.14,
                "last_stage":"13",
                "new_stage":"n/a"
            },...
        }
    },
    "harvest_window":{
        "end":"2016-08-26",
        "start":"2016-08-08"
    },
    "stage_descriptions":{
        "0":{
            "advisor":"Nutrient",
            "applicable_scales":{
                "feekes":"n/a",
                "haun":"n/a",
                "zadoks":"05"
            },
            "description":"Germination",
            "order":"1"
        },...
    }
}

Mechanical Drying

Barley Mechanical Drying - v1.0

The Barley Mechanical Drying endpoint simulates the drydown process of spring barley using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the spring barley in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available grain moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if grain moisture estimates are unable to be obtained from the spring barley in-field drying model. This may occur if one of the following conditions are met:

  • The spring barley growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/barley/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units_per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/barley/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"02:38",
                    "driest_moisture_content_db":16.95,
                    "driest_moisture_content_wb":14.49,
                    "dryer_throughput_grain_units_per_hour":537.0,
                    "drying_time":9505,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.233,
                        "burner_fuel_units_consumed":0.259,
                        "burner_kwh_consumed":6.39,
                        "electricity_cost":0.209,
                        "electricity_kwh_consumed":0.42,
                        "total_cost":0.442
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.023
                    },
                    "sample_datetime":"2016-07-07",
                    "sample_moisture_content_wb":33.77,
                    "simulation_length":9505,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Barley Dryer"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-07-07":{
                "agdd":2208.0,
                "air_temp_max":78.0,
                "air_temp_min":64.0,
                "equilibrium_moisture_content":12.18,
                "gdd":39.0,
                "grain_moisture_content":33.77,
                "grain_moisture_content_change":"n/a",
                "last_stage":13.0,
                "new_stage":15.0
            },...
        }
    }
}

Canola Mechanical Drying - v1.0

The Canola Mechanical Drying endpoint simulates the drydown process of canola using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the canola in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available seed moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if seed moisture estimates are unable to be obtained from the canola in-field drying model. This may occur if one of the following conditions are met:

  • The canola growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/canola/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units_per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/canola/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"01:32",
                    "driest_moisture_content_db":16.96,
                    "driest_moisture_content_wb":14.5,
                    "dryer_throughput_grain_units_per_hour":922.0,
                    "drying_time":5540,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.168,
                        "burner_fuel_units_consumed":0.186,
                        "burner_kwh_consumed":4.6,
                        "electricity_cost":0.395,
                        "electricity_kwh_consumed":0.79,
                        "total_cost":0.563
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.031
                    },
                    "sample_datetime":"2016-07-16",
                    "sample_moisture_content_wb":32.87,
                    "simulation_length":5540,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Canola Dryer"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-07-16":{
                "agdd":1894.0,
                "air_temp_max":77.0,
                "air_temp_min":58.0,
                "equilibrium_moisture_content":6.32,
                "gdd":26.5,
                "grain_moisture_content":32.87,
                "grain_moisture_content_change":"n/a",
                "last_stage":"ER",
                "new_stage":"R"
            },...
        }
    }
}

Corn Mechanical Drying - v1.0

The Corn Mechanical Drying endpoint simulates the drydown process of corn using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the corn in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available grain moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if grain moisture estimates are unable to be obtained from the corn in-field drying model. This may occur if one of the following conditions are met:

  • The corn growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/corn/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units _per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely; and "n/a" when high-temperature drying is in use.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates that it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present in the output it indicates a confirmed or observed growth stage on that date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/corn/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"03:16",
                    "driest_moisture_content_db":16.9,
                    "driest_moisture_content_wb":14.46,
                    "dryer_throughput_grain_units_per_hour":433.0,
                    "drying_time":11790,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.265,
                        "burner_fuel_units_consumed":0.294,
                        "burner_kwh_consumed":7.27,
                        "electricity_cost":0.186,
                        "electricity_kwh_consumed":0.37,
                        "total_cost":0.451
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.027
                    },
                    "sample_datetime":"2016-09-12",
                    "sample_moisture_content_wb":31.02,
                    "simulation_length":11790,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Neco 24180"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-09-12":{
                "agdd":2392.5,
                "air_temp_max":72.0,
                "air_temp_min":50.0,
                "equilibrium_moisture_content":10.39,
                "gdd":11.0,
                "grain_moisture_content":31.02,
                "grain_moisture_content_change":"n/a",
                "last_stage":"r5",
                "new_stage":"r6"
            },...
        }
    }
}

Sorghum Mechanical Drying - v1.0

The Sorghum Mechanical Drying endpoint simulates the drydown process of sorghum using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the sorghum in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available grain moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if grain moisture estimates are unable to be obtained from the sorghum in-field drying model. This may occur if one of the following conditions are met:

  • The sorghum growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units _per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sorghum/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"09:50",
                    "driest_moisture_content_db":16.96,
                    "driest_moisture_content_wb":14.5,
                    "dryer_throughput_grain_units_per_hour":176.0,
                    "drying_time":35430,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.412,
                        "burner_fuel_units_consumed":0.458,
                        "burner_kwh_consumed":11.3,
                        "electricity_cost":0.025,
                        "electricity_kwh_consumed":0.2,
                        "total_cost":0.438
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.031
                    },
                    "sample_datetime":"2016-08-13",
                    "sample_moisture_content_wb":28.7,
                    "simulation_length":35430,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Sorghum Dryer"
        }
    ],
    "infield_drydown_data":{
        "32,-100":{
            "2016-08-13":{
                "agdd":2765.5,
                "air_temp_max":87.0,
                "air_temp_min":66.0,
                "equilibrium_moisture_content":11.38,
                "gdd":26.5,
                "grain_moisture_content":28.7,
                "grain_moisture_content_change":"n/a",
                "last_stage":"11",
                "new_stage":"12"
            },...
        }
    }
}

Soybean Mechanical Drying - v1.0

The Soybean Mechanical Drying endpoint simulates the drydown process of soybean using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the soybean in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available seed moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if seed moisture estimates are unable to be obtained from the soybean in-field drying model. This may occur if one of the following conditions are met:

  • The soybean growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/soybean/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units_per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates that it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_avg

Average daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_max

Maximum daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature in degrees Fahrenheit, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures

last_reproductive_stage

The last known reproductive stage. If no valid stage has been reached, this value will be "n/a."

last_stage

The last known growth stage. If no valid stage has been reached, this value will be "n/a." This variable will contain vegetative stages until the beginning of flowering is reached, after which only new reproductive stages will be listed.

last_vegetative_stage

The last known vegetative stage. If no valid stage has been reached, this value will be "n/a."

new_reproductive_stage

The crop may have entered a new reproductive stage between the current date and the previous date. If new_reproductive_stage is "n/a," the crop is somewhere between the previous reproductive stage and the next reproductive stage.

new_stage

The crop may have entered a new growth stage between the current date and the previous date. If new_stage is "n/a," the crop is somewhere between the previous growth stage and the next growth stage. This variable will contain vegetative stages until the beginning of flowering is reached, after which only new reproductive stages will be listed.

new_vegetative_stage

The crop may have entered a new vegetative stage between the current date and the previous date. If new_vegetative_stage is "n/a," the crop is somewhere between the previous vegetative stage and the next vegetative stage.

relative_humidity_avg

Average daily relative humidity provided as a percentage.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/soybean/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"04:14",
                    "driest_moisture_content_db":16.9,
                    "driest_moisture_content_wb":14.46,
                    "dryer_throughput_grain_units_per_hour":335.0,
                    "drying_time":15240,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.359,
                        "burner_fuel_units_consumed":0.399,
                        "burner_kwh_consumed":9.85,
                        "electricity_cost":0.148,
                        "electricity_kwh_consumed":0.3,
                        "total_cost":0.507
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.031
                    },
                    "sample_datetime":"2016-09-28",
                    "sample_moisture_content_wb":31.09,
                    "simulation_length":15240,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Soybean Dryer"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-09-28":{
                "agdd":2135.94,
                "air_temp_avg":52.0,
                "air_temp_max":65.0,
                "air_temp_min":39.0,
                "equilibrium_moisture_content":7.54,
                "gdd":8.0,
                "grain_moisture_content":31.09,
                "grain_moisture_content_change":"n/a",
                "last_reproductive_stage":"R7",
                "last_stage":"R7",
                "last_vegetative_stage":"V15",
                "new_reproductive_stage":"R8",
                "new_stage":"R8",
                "new_vegetative_stage":"n/a",
                "relative_humidity_avg":62.0
            },...
        }
    }
}

Spring Wheat Mechanical Drying - v1.0

The Spring Wheat Mechanical Drying endpoint simulates the drydown process of spring wheat using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the spring wheat in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available grain moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if grain moisture estimates are unable to be obtained from the spring wheat in-field drying model. This may occur if one of the following conditions are met:

  • The spring wheat growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units_per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/springwheat/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"04:11",
                    "driest_moisture_content_db":16.96,
                    "driest_moisture_content_wb":14.5,
                    "dryer_throughput_grain_units_per_hour":339.0,
                    "drying_time":15075,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.431,
                        "burner_fuel_units_consumed":0.479,
                        "burner_kwh_consumed":11.8,
                        "electricity_cost":0.499,
                        "electricity_kwh_consumed":1.0,
                        "total_cost":0.93
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.051
                    },
                    "sample_datetime":"2016-07-13",
                    "sample_moisture_content_wb":32.88,
                    "simulation_length":15075,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Spring Wheat Dryer"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-07-13":{
                "agdd":2432.5,
                "air_temp_max":74.0,
                "air_temp_min":64.0,
                "equilibrium_moisture_content":10.0,
                "gdd":37.0,
                "grain_moisture_content":32.88,
                "grain_moisture_content_change":"n/a",
                "last_stage":"20",
                "new_stage":"21"
            },...
        }
    }
}

Sunflower Mechanical Drying - v1.0

The Sunflower Mechanical Drying endpoint simulates the drydown process of sunflower using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the sunflower in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available seed moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if seed moisture estimates are unable to be obtained from the sunflower in-field drying model. This may occur if one of the following conditions are met:

  • The sunflower growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units _per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel _units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner _kwh_consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity _kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

air_temp_min

Minimum daily air temperature valid for the current date. Obtained from historical, forecast, or climatological data, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/sunflower/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"03:10",
                    "driest_moisture_content_db":16.95,
                    "driest_moisture_content_wb":14.49,
                    "dryer_throughput_grain_units_per_hour":546.0,
                    "drying_time":11430,
                    "grain_storability":"n/a",
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.252,
                        "burner_fuel_units_consumed":0.28,
                        "burner_kwh_consumed":6.91,
                        "electricity_cost":0.008,
                        "electricity_kwh_consumed":0.07,
                        "total_cost":0.26
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.015
                    },
                    "sample_datetime":"2016-08-30",
                    "sample_moisture_content_wb":31.63,
                    "simulation_length":11430,
                    "target_moisture_reached":1
                },...
           ],
           "name":"Sunflower Dryer"
       }
   ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-08-30":{
                "agdd":2886.0,
                "air_temp_max":81.0,
                "air_temp_min":50.0,
                "equilibrium_moisture_content":5.8,
                "gdd":21.5,
                "grain_moisture_content":30.99,
                "grain_moisture_content_change":"n/a",
                "last_stage":"30",
                "new_stage":"31"
            },...
        }
    }
}

Winter Wheat Mechanical Drying - v1.0

The Winter Wheat Mechanical Drying endpoint simulates the drydown process of winter wheat using either fan-powered low-temperature drying or burner-driven high-temperature drying facilities to provide drying statistics and cost projections. The mechanical drying process is simulated using up to 10 future days of grain moisture estimates. Results from the winter wheat in-field drying model are also returned for comparison.

Note that a field, growth, and drying facility are required to utilize this feature. Any available grain moisture measurements are used to improve model results.

Please be aware that mechanical drying data will not be returned if grain moisture estimates are unable to be obtained from the winter wheat in-field drying model. This may occur if one of the following conditions are met:

  • The winter wheat growth model simulation does not bring the crop to maturity. This is more likely to occur for certain location (e.g., cooler climates) and relative maturity combinations.

  • The crop planting date or emergence date are too far in the past. The models are designed for future planning; users can utilize the "current_date" argument to determine what model results could have been on a past date. These results can be different than what would have been seen on the emulated date, as the forecast timeframes are now represented by historical data.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/mechanical_drying?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&growth_id={string}&drying_facility_ids={string}&grain_unit={string}
&target_moisture_content_wb={float}&current_date={timestamp}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Accounts API ID.

user_id

string

yes

User ID provided by and used with the Accounts API. The user must have read privileges for the field in which the growth is assigned.

growth_id

string

yes

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

target_moisture_ content_wb

float

yes

Numeric representation of the desired moisture level for safe storage, measured in percent on a wet basis. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

grain_unit

string

yes

Units to use when returning unit costs of drying. Valid values are “bu” (bushel) and “mt” (metric ton).

drying_facility_ids

string

no

Comma-delimited list of drying facility IDs to be used. Currently, only the most recently created facility in the list will be used. Default behavior is to use the most recently created facility overall. Note that the calling user must have at least read privileges for the asset (drying facility).

current_date

timestamp

no

Emulate model results as if viewed on this date. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris definition of Epoch/Unix timestamp. Useful for viewing approximate model results for historical timeframes greater than one year in the past. There can be differences in results due to what would have been forecasted weather data now being replaced with historical or climatological data used in the calculations.

Response Object (JSON)

Field Description

asset_id

The ID given to a particular drying facility.

name

The user-provided name of the drying facility. If this is not supplied, a generic name of "Drying Facility" followed by a number is used.

burner_fuel_type

Type of fuel consumed by the burner, as provided by the Accounts API.

burner_fuel_unit

Unit of measure associated with the fuel type, as provided by the Accounts API.

driest_datetime

Time that the grain reached its lowest moisture content of the model run. Represented by a date string in the case of low-temperature drying or hours and minutes in the case of high-temperature drying. Note that the simulation will stop when the user-specified target moisture content is reached, in which case this will indicate the timing of the grain reaching that threshold.

driest_moisture_content_db

Driest dry-basis grain moisture content of the simulation, in percent. Dry-basis moisture content is defined as the ratio of the mass of water to the dry mass of a sample of grain.

driest_moisture_content_wb

Driest wet-basis grain moisture content of the simulation, in percent. Wet-basis moisture content is defined as the ratio of the mass of water to the total mass of a sample of grain.

dryer_throughput_grain_units_per_hour

Amount of grain dried per hour. Applicable only in high-temperature drying facilities.

drying_time

Amount of time, in seconds, that elapsed for the grain to reach its lowest moisture content.

grain_storability

Likelihood of spoilage. Possible values include "0," indicating that grain is not likely to spoil; "1," indicating a marginal risk; and "2," warning that spoilage is likely. When high-temperature drying is in use, "n/a" will be used.

grain_unit

Unit of measure associated with the volume of grain as provided by the user.

per_grain_unit/burner_fuel_cost

Expected burner fuel cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/burner_fuel_ units_consumed

Expected amount of fuel consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/burner_kwh_ consumed

Expected amount of fuel energy, in kilowatt-hours, consumed by the burner per unit of grain, in the grain unit provided by the user.

per_grain_unit/electricity_cost

Expected electricity cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit/electricity_kwh_consumed

Expected amount of electrical energy, in kilowatt-hours, consumed by the fan per unit of grain, in the grain unit provided by the user.

per_grain_unit/total_cost

Expected total drying cost per unit of grain, in the user’s local currency, and in the grain unit provided by the user.

per_grain_unit_per_percent_ moisture/total_cost

Expected total drying cost per unit of grain per percent moisture change, in the user’s local currency, and in the grain unit provided by the user.

sample_datetime

Valid time of the grain moisture sample provided by the in-field drydown model.

sample_moisture_content_wb

Starting wet-basis moisture content of the grain sample, in percent, provided by the in-field drydown model.

simulation_length

Total length of time, in seconds, over which the drydown process was modeled.

target_moisture_reached

Flag indicating whether the target storage moisture content is reached in the simulation, where "1" indicates that the storage moisture is reached and "0" indicates it is not. Primarily applicable in low-temperature drying facilities, where ambient environmental conditions may not permit an adequate amount of drying.

agdd

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

air_temp_max

Maximum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

air_temp_min

Minimum daily air temperature, which may be a historical, forecast, or climatological value, depending on the timeframe.

equilibrium_moisture_content

The wet-basis moisture content, in percent, at which the grain is neither gaining nor losing moisture. Changes with relative humidity and air temperature. Provided after the crop fully matures.

feedback_id

If this field is present, it indicates a confirmed or observed growth stage on the current date.

gdd

Growing degree days accumulated on the current date.

grain_moisture_content

Percent wet-basis moisture content of the grain at the end of the day. Provided after the crop fully matures.

grain_moisture_content_change

The change in the amount of wet-basis moisture in the grain since the previous day, in percent. Positive values indicate that the moisture content has increased, and negative values indicate that the moisture content has decreased. Provided after the crop fully matures.

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.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/winter_wheat/mechanical_drying?
app_id=123&app_key=321&account_id=abc&user_id=cba
&growth_id=xyz&grain_unit=bu&target_moisture_content_wb=14.5

Example Response

{
    "drying_facilities":[
        {
            "asset_id":"abc-123",
            "data":[
                {
                    "burner_fuel_type":"liquid_propane",
                    "burner_fuel_unit":"gallon",
                    "driest_datetime":"03:31",
                    "driest_moisture_content_db":16.96,
                    "driest_moisture_content_wb":14.5,
                    "dryer_throughput_grain_units_per_hour":402.0,
                    "drying_time":12710,
                    "grain_storability":"n/a"
                    "grain_unit":"bu",
                    "per_grain_unit":{
                        "burner_fuel_cost":0.381,
                        "burner_fuel_units_consumed":0.423,
                        "burner_kwh_consumed":10.4,
                        "electricity_cost":0.421,
                        "electricity_kwh_consumed":0.8,
                        "total_cost":0.801
                    },
                    "per_grain_unit_per_percent_moisture":{
                        "total_cost":0.047
                    },
                    "sample_datetime":"2016-07-12",
                    "sample_moisture_content_wb":31.39,
                    "simulation_length":12710,
                    "target_moisture_reached":1
                },...
            ],
            "name":"Winter Wheat Dryer"
        }
    ],
    "infield_drydown_data":{
        "47,-97":{
            "2016-07-12":{
                "agdd":2126.41,
                "air_temp_max":84.0,
                "air_temp_min":61.0,
                "equilibrium_moisture_content":9.88,
                "gdd":22.56,
                "grain_moisture_content":31.39,
                "grain_moisture_content_change":"n/a",
                "last_stage":"11",
                "new_stage":"12"
            },...
        }
    }
}

Create Low Temperature Drying Facility - v1.0

This endpoint allows a user to create a low temperature drying facility asset (type 0).

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/low_temp/create?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&electricity_cost={float}&electricity_cost_unit={string}
&fan_distribution_area={float}&fan_distribution_area_unit={string}
&grain_thickness={float}&grain_thickness_unit={string}
&name={string}&fan_efficiency={float}&latitude={float}
&longitude={float}&location={lat, lon coordinates}
&field_id={string}&fan_power={float}
&fan_power_unit={string}&airflow={float}
&airflow_unit={float}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Your Accounts API account ID.

user_id

sting

yes

User ID provided by and used with the Accounts API.

electricity_cost

float

yes

The cost to supply energy to the drying facility. Entry must be greater than zero.

electricity_cost_unit

string

yes

The unit denoting electricity cost ("kwh").

fan_distribution_area

float

yes

The area to which the drying fan impacts. Entry must be greater than zero.

fan_distribution_area_unit

string

yes

The unit denoting the fan distribution ("m^2" or "ft^2").

grain_thickness

float

yes

The thickness of the grain being dryed in the given facility. Entry must be greater than zero.

grain_thickness_unit

string

yes

The unit denoting the thickness of grain being dried ("m" or "ft").

name

string

no

Defaults to "unnamed."

fan_efficiency

float

no

If fan_efficiency is not provided, the default will be a value of 0.47. If fan_efficiency is provided, but a value of "null" is used, the property will be stored as "null."

latitude

float

no

The range varies from -90 to 90. Longitude is required but if location or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

longitude

float

no

The range varies from -360 to 360. Latitude is required but if location or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

location

lat, lon coordinates

no

In the form of "{latitude},{longitude}." If latitude, longitude, or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

field_id

string

yes3

Used to get latitude and longitude. If latitude, longitude, or field_id are provided a 400 response is returned.

fan_power

float

yes3

The value of the entry must be greater than zero and requires fan_power_unit. If airflow or airflow_unit are provided a 400 response is returned.

fan_power_unit

string

yes3

The units include "kw" or "hp" and requires fan_power. If airflow or airflow_unit are provided a 400 response is returned.

airflow

float

yes3

This entry must be greater than zero and requires airflow_unit. If fan_power or fan_power_unit are provided a 400 response is returned.

airflow_unit

float

yes3

The units include "m^3/s" or "ft^3/min," and requires airflow. If fan_power or fan_power_unit are provided a 400 response is returned.

3 Denotes special rules for if a parameter is required or not.

Response Object

Returns asset ID.

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/low_temp/create?
app_id=123&app_key=321&account_id=123&user_id=xyz-123
&electricity_cost=10&electricity_cost_unit=kwh
&fan_distribution_area=15&fan_distribution_area_unit=ft^2
&grain_thickness=2&grain_thickness_unit=f
t&location=47.279229,-101.381836&fan_power=12
&fan_power_unit=kw

Example Response

fgh-567

Create High Temperature Drying Facility - v1.0

This endpoint allows users to create a high temperature drying facility asset (type 1).

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/high_temp/create?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&electricity_cost={float}&electricity_cost_unit={string}
&fan_distribution_area={float}&fan_distribution_area_unit={string}
&grain_thickness={float}&grain_thickness_unit={string}
&fuel_type={string}&fuel_unit={string}&fuel_cost_per_unit={float}
&plenum_temperature={float}&plenum_temperature_unit={float}
&name={string}&fan_efficiency={float}&latitude={float}
&longitude={float}&location={lat, lon coordinates}&field_id={string}
&fan_power={float}&fan_power_unit={string}
&airflow={float}&airflow_unit={float}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Your Accounts API account ID.

user_id

sting

yes

User ID provided by and used with the Accounts API.

electricity_cost

float

yes

The cost to supply energy to the drying facility. Entry must be greater than zero.

electricity_cost_unit

string

yes

The unit denoting electricity cost ("kwh").

fan_distribution_area

float

yes

The area to which the drying fan impacts. Entry must be greater than zero.

fan_distribution_area_unit

string

yes

The unit denoting the fan distribution ("m^2" or "ft^2").

grain_thickness

float

yes

The thickness of the grain being dryed in the given facility. Entry must be greater than zero.

grain_thickness_unit

string

yes

The unit denoting the thickness of grain being dried ("m" or "ft").

fuel_type

string

yes

This is either liquid_propane or natural_gas. If a fuel type of "liquid_propane" is provided, then the following fuel_unit values are valid: "l, "gal," "lb," or "kg." If a fuel type of "natural_gas" is provided, then the following fuel_unit values are valid: "lb" or "kg."

fuel_unit

string

yes

If a fuel type of "liquid_propane" is provided, then the following fuel_unit values are valid: "l, "gal," "lb," or "kg." If a fuel type of "natural_gas" is provided, then the following fuel_unit values are valid: "lb" or "kg."

fuel_cost_per_unit

float

yes

This entry must be greater than zero.

plenum_temperature

float

yes

Temperature output in drying facility.

plenum_temperature_unit

string

yes

Unit can be either "c" or "f," and is required if plenum_temperature is provided.

name

string

no

Defaults to "unnamed."

fan_efficiency

float

no

If fan_efficiency is not provided, the default will be a value of 0.47. If fan_efficiency is provided, but a value of "null" is used, the property will be stored as "null."

latitude

float

no

The range varies from -90 to 90. Longitude is required but if location or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

longitude

float

no

The range varies from -360 to 360. Latitude is required but if location or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

location

lat, lon coordinates

no

In the form of "{latitude},{longitude}." If latitude, longitude, or field_id are provided a 400 response is returned. Please verify that latitude/longitude coordinates are over soil representative of your field.

field_id

string

yes3

Used to get latitude and longitude. If latitude, longitude, or field_id are provided then a 400 response is returned.

fan_power

float

yes3

The value of the entry must be greater than zero and requires fan_power_unit. If airflow or airflow_unit are provided then a 400 response is returned.

fan_power_unit

string

yes3

The units include "kw" or "hp" and requires fan_power. If airflow or airflow_unit are provided then a 400 response is returned.

airflow

float

yes3

This entry must be greater than zero and requires airflow_unit. If fan_power or fan_power_unit are provided then a 400 response is returned.

airflow_unit

float

yes3

The units include "m^3/s" or "ft^3/min," and requires airflow. If fan_power or fan_power_unit are provided then a 400 response is returned.

3 Denotes special rules for if a parameter is required or not.

Response Object

Returns asset ID.

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/high_temp/create?
app_id=123&app_key=321&account_id=123&user_id=xyz-123
&electricity_cost=10&electricity_cost_unit=kwh
&fan_distribution_area=15&fan_distribution_area_unit=ft^2
&grain_thickness=2&grain_thickness_unit=ft&
&fuel_type=liquid_propane&fuel_unit=l&fuel_cost_per_unit=20
&plenum_temperature=20&plenum_temperature_unit=c
&name=unnamed&fan_efficiency=0.47
location=47.279229,-101.381836&field_id=321-abc&
fan_power=12&fan_power_unit=kw

Example Response

fgh-567

Get Drying Facility by Asset ID - v1.0

This endpoint allows a user (with read or write privileges) to retrieve information pertaining to either a low temperature facility (type 0) or high temperature facility (type 1).

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/get/
{asset_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.

asset_id

string

yes

Specifies ID of the asset to be retreived.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Calling user must have at least read privileges on the target asset.)

Response Object (JSON)

In addition to the listed keys, please refer to the high/low temperature (depending on drying facility type being listed) creation documentation for additional keys.

Field Description

asset_id

Specifies ID of the asset.

created

Epoch timestamp in seconds. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

modified

Epoch timestamp in seconds. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

type

Enumeration value of the type of asset.

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/get/
fgh-567?app_id=123&app_key=321&account_id=def-345
&user_id=bcd-678

Example Response

{
    "asset_id":"fgh-567",
    "electricity_cost":4,
    "airflow":99,
    "fan_power_unit":null,
    "name":"Drying facility 1",
    "fan_distribution_area_unit":"m^2",
    "fan_efficiency":0.47,
    "fan_power":null,
    "modified":1464727035,
    "longitude":4,
    "grain_thickness_unit":"m",
    "created":1464726969,
    "latitude":12,
    "airflow_unit":"m^3/s",
    "electricity_cost_unit":"kwh",
    "type":0,
    "fan_distribution_area":99,
    "grain_thickness":4
}

Get Drying Facility Asset by User Access - v1.0

This endpoint allows a user to obtain information pertaining to a target user’s access level to all drying facility assets to which the calling user has rights.

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/get/by_access/
{target_user_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.

target_user_id

string

yes

Specifies ID of the asset to be retreived.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Calling user must have at least read privileges on the target asset.)

Response Object (JSON)

Field Description

airflow

The value of airflow in the drying facility.

airflow_unit

Unit can be "m^3/s" or "ft^3/min."

asset_id

Specifies ID of the asset.

calling_user_privs

Enumeration value of the privileges (read or write) that the calling user has on the facility.

created

Epoch timestamp in seconds. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

electricity_cost

The cost to supply energy to the drying facility. Entry must be greater than zero.

electricity_cost_unit

The unit denoting electricity cost ("kwh").

fan_distribution_area

The area to which the drying fan impacts. Entry must be greater than zero.

fan_distribution_area_unit

Unit provided can be either "m2" or "ft^2," and is required if fan_distribution is provided.

fan_efficiency

The efficiency of the fan being used to dry the given crop.

fan_power

The value of fan power.

fan_power_unit

Unit provided can be either "kw" or "hp."

grain_thickness

The thickness of the grain being dried in the given facility. Entry must be greater than zero.

grain_thickness_unit

The unit denoting the thickness of grain being dried ("m" or "ft").

latitude

The range varies from -90 to 90. Please verify that latitude/longitude coordinates are over soil representative of your field.

longitude

The range varies from -360 to 360. Please verify that latitude/longitude coordinates are over soil representative of your field.

modified

Epoch timestamp in seconds. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

name

The name of the facility.

target_user_privs

Enumeration value of the privileges (read or write) that the target user has on the facility.

type

Enumeration value of the type of asset.

plenum_temperature

Temperature output in drying facility.

plenum_temperature_unit

Unit can be either "c" or "f," and is required if plenum_temperature is provided.

fuel_type

This is either liquid_propane or natural_gas.

fuel_unit

The unit of fuel. For liquid_propane: "gal," "l," "lb," or "kg." For natural_gas: "lb," "l," or "gal."

fuel_cost_per_unit

This entry must be greater than zero.

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/get/by_access/
xyz-123?app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

{
    "asset_id":"fgh-567",
    "electricity_cost":4,
    "airflow":99,
    "fan_power_unit":null,
    "name":"Drying facility 1",
    "fan_distribution_area_unit":"m^2",
    "fan_efficiency":0.47,
    "fan_power":null,
    "modified":1464727035,
    "longitude":4,
    "grain_thickness_unit":"m",
    "created":1464726969,
    "latitude":12,
    "airflow_unit":"m^3/s",
    "electricity_cost_unit":"kwh",
    "fan_distribution_area":99,
    "grain_thickness":4
}

Modify Drying Facility (Low or High Temperature) - v1.0

This endpoint allows for the modification of a low (type 0) or high (type 1) temperature drying facility asset.

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/modify/{target_asset_id}?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&electricity_cost={float}&electricity_cost_unit={string}
&fan_distribution_area={float}&fan_distribution_area_unit={string}
&grain_thickness={float}&grain_thickness_unit={string}
&fuel_type={string}&fuel_unit={string}&fuel_cost_per_unit={float}
&plenum_temperature={float}&plenum_temperature_unit={string}
&name={string}&fan_efficiency={float}&latitude={float}
&longitude={float}&location={lat, lon coordinates}&field_id={string}
&fan_power={float}&fan_power_unit={string}
&airflow={float}&airflow_unit={float}

Request Parameters

Please note that all valid properties for low and high temperature drying facilities are also described in the associated drying facility creation endpoints.

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Your Accounts API account ID.

user_id

sting

yes

User ID provided by and used with the Accounts API.

target_asset_id

string

yes

Drying facility that is being modified.

electricity_cost

float

no3

Entry must be greater than zero and is required if electricity_cost_unit is provided.

electricity_cost_unit

string

no3

This unit is required if electricity_cost is provided and must be in the form of "kwh."

fan_distribution_area

float

no3

Entry must be greater than zero and is required if fan_distribution_unit is provided.

fan_distribution_area_unit

string

no3

Unit provided can be either "m^2" or "ft^2," and is required if fan_distribution is provided.

grain_thickness

float

no3

Entry must be greater than zero and is required if grain_thickness_unit is provided.

grain_thickness_unit

string

no3

Unit provided can be either "m" or "ft," and is required if grain_thickness is provided.

fuel_type

string

no3

Fuel type can be either liquid_propane or natural_gas, and is required if fuel_unit and/or fuel_cost_per_unit is provided. Only a valid parameter if the target drying facility is of type 1 (high temperature)

grain_thickness_unit

string

no3

Unit provided can be either "m" or "ft," and is required if grain_thickness is provided.

fuel_unit

string

no3

Required if fuel_type and/or fuel_cost_per_unit is provided. If a fuel type of "liquid_propane" is provided, then the following fuel_unit values are valid: "l," "gal," "lb," or "kg." If a fuel type of "natural_gas" is provided, then the following fuel_unit values are valid: "lb" or "kg." Only a valid parameter if the target drying facility is of type 1 (high temperature)

fuel_cost_per_unit

float

no3

Entry must be greater than zero and is required if fuel_unit and/or fuel_type is provided. Only a valid parameter if the target drying facility is of type 1 (high temperature)

plenum_temperature

float

no3

Required if plenum_temperature_unit is provided. Only a valid parameter if the target drying facility is of type 1 (high temperature)

plenum_temperature_unit

string

no3

Unit can be either "c" or "f," and is required if plenum_temperature is provided. Only a valid parameter if the target drying facility is of type 1 (high temperature)

name

string

no

Defaults to "unnamed."

fan_efficiency

float

no

If fan_efficiency is not provided, the default will be a value of 0.47. If fan_efficiency is provided, but a value of "null" is used, the property will be stored as "null."

latitude

float

no3

Range is -90 to 90. This is required if longitude is provided, but is invalid if location or field_id are provided. Please verify that latitude/longitude coordinates are over soil representative of your field.

longitude

float

no3

Range is -360 to 360. This is required if latitude is provided, but is invalid if location or field_id are provided. Please verify that latitude/longitude coordinates are over soil representative of your field.

location

lat, lon coordinates

no3

In the form of "{latitude},{longitude}." This is invalid if latitude, longitude, or field_id are provided. Please verify that latitude/longitude coordinates are over soil representative of your field.

field_id

string

no3

Used to get latitude and longitude. This is invalid if latitude, longitude or field_id are provided.

fan_power

float

no3

Entry must be greater than zero and is required if fan_power_unit is provided. This is invalid if airflow and/or airflow_unit are provided.

fan_power_unit

string

no3

Unit provided can be either "kw" or "hp." This is required if fan_power is provided, but is invalid if airflow or airflow_unit are provided.

airflow

float

no3

Entry must be greater than zero. This is required if airflow_unit is provided, but is invalid if fan_power and/or fan_power_unit are provided.

airflow_unit

float

no3

Unit can be "m^3/s" or "ft^3/min." This is required if airflow is provided, but is invalid if fan_power and/or fan_power_unit are provided.

3 Denotes special rules for if a parameter is required or not.

Response Object

Returns "true" if the field drying facility asset was updated.

All valid properties for low and high temperature drying facilities are also described in the associated drying facility creation endpoints.

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/modify/
fgh-567?app_id=123&app_key=321&account_id=123&user_id=xyz-123
&airflow=99&airflow_unit=m^3/s&fuel_type=liquid_propane
&fuel_unit=l&fuel_cost_per_unit=44

Example Response

{
    "asset_id":"fgh-567",
    "electricity_cost":4,
    "airflow":99,
    "fan_power_unit":null,
    "name":"Drying facility 1",
    "fan_distribution_area_unit":"m^2",
    "fan_efficiency":0.47,
    "fan_power":null,
    "modified":1464727035,
    "longitude":4,
    "grain_thickness_unit":"m",
    "created":1464726969,
    "latitude":12,
    "airflow_unit":"m^3/s",
    "electricity_cost_unit":"kwh",
    "type":0,
    "fan_distribution_area":99,
    "grain_thickness":4
}

Delete Drying Facility Asset - v1.0

This endpoint allows a user (with write privileges) to delete a drying facility asset and all permissions pertaining to that asset.

URL Description

https://ag.us.clearapis.com/v1.0/asset/drying_facility/delete/{asset_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.

asset_id

string

yes

Specifies ID of the asset to be deleted

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Must have write access on the asset in order to assign privileges.)

Response Object

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

Example Request

https://ag.us.clearapis.com/v1.0/asset/drying_facility/delete/fgh-567?
app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

true

Add Asset Permissions - v1.0

This endpoint allows a user (with write privileges) to add read or write privileges to an asset.

URL Description

https://ag.us.clearapis.com/v1.0/asset/permissions/add/{asset_id}/{target_user_ids}/
{privilege}?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.

asset_id

string

yes

Specifies ID of the asset to which the target user is being given privileges.

target_user_ids

string

yes

Specifies a comma-delimited list of IDs of user_ids to grant privileges.

privilege

string

yes

Specifies what type of privilege the target user(s) will be given. Valid options are "read" or "write."

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Must have write access on the asset in order to assign privileges.)

Response Object

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

Example Request

https://ag.us.clearapis.com/v1.0/asset/permissions/add/fgh-567/xyz-123/
read?app_id=123&app_key=321&account_id=def-345&user_id=bcd-678

Example Response

true

Modify Asset Permissions - v1.0

This endpoint allows a user (with write privileges) to modify privileges of other users on an asset.

URL Description

https://ag.us.clearapis.com/v1.0/asset/permissions/modify/{asset_id}/
{target_user_ids}/{privilege}?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.

asset_id

string

yes

Specifies ID of the asset to which the given target user is being given privileges.

target_user_ids

string

yes

Specifies a comma-delimited list of IDs of user_ids to grant privileges.

privilege

string

yes

Specifies what type of privilege the target user(s) will be given. Valid options are "read" or "write."

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Must have write access on the asset in order to assign privileges.)

Response Object

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

Example Request

https://ag.us.clearapis.com/v1.0/asset/permissions/modify/fgh-567/
xyz-123/write?app_id=123&app_key=321&account_id=def-345
&user_id=bcd-678

Example Response

true

Delete Asset Permissions - v1.0

This endpoint allows a user (with write privileges) to delete privileges on an asset.

URL Description

https://ag.us.clearapis.com/v1.0/asset/permissions/delete/{asset_id}/
{target_user_ids}?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.

asset_id

string

yes

Asset for which privileges are to be modified.

target_user_ids

string

yes

Comma-delimited list of user id’s for which privileges are to be removed.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database. (Must have write access on the asset in order to assign privileges.)

Response Object

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

Example Request

https://ag.us.clearapis.com/v1.0/asset/permissions/delete/fgh-567/
xyz-123?app_id=123&app_key=321&account_id=def-345
&user_id=bcd-678

Example Response

true

Add Harvest Activity - v1.0

This endpoint is to be used for the recording of harvest activities for a growth.

URL Description

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/add/{growth_id}?
app_id={string}&app_key={string}&account_id={string}&user_id={string}
&unit={string}&value={float}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

account_id

string

yes

Your Accounts API account ID.

user_id

string

yes

User ID provided by and used with the Accounts API.

growth_id

string

yes

Growth ID provided after successful growth creation.

unit

string

yes

Measurement of "value" parameter. Valid values include "kg/ha," "lb/ac," and "bu/ac."

value

float

yes

Numeric indicator of activity. Value must be a float greater than 0.0.

Response Object

Returns UUID of created harvest activity.

Example Request

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/add/321?
app_id=456&app_key=789&account_id=123&user_id=xyz-123&unit=lb/ac&value=2

Example Response

8888888-4444-4444-4444-cccccccccccc

Get Harvest Activity - v1.0

This endpoint allows a user (with read or write privileges) to receive information pertaining to a harvest activity by using an activity ID.

URL Description

https://ag.clearapis.com/v1.0/crop_health/growth/activity/
harvest/get/{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.

account_id

string

yes

Your Accounts API account ID.

user_id

string

yes

User ID provided by and used with the Accounts API.

activity_id

string

yes

Harvest activity ID for which to retrieve information.

Response Object (JSON)

Field Description

field_activity_id

ID of the harvest activity.

created

Epoch timestamp in seconds. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

modified

Returns "null" if not modified; otherwise, an Epoch timestamp in seconds will be provided.

subtype

Enumeration value of the type of this harvest activity (integer).

value

Provided quantity of harvest.

activity_time

Epoch timestamp. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

unit

Applicable unit can be "kg/ha," "lb/ac," or "bu/ac."

activity_type

A valid entry is 302 (harvest).

Example Request

https://ag.clearapis.com/v1.0/crop_health/growth/activity/
harvest/get/123-5813?app_id=456&app_key=789&account_id=321&user_id=456

Example Response

{
    "field_activity_id":"7f012b65-d773-4274-a993-a3f389540143",
    "created":1470240044,
    "modified":null,
    "subtype":0,
    "value":2.3,
    "activity_time":1470240044,
    "unit":"kg/ha",
    "activity_type":302
}

Modify Harvest Activity - v1.0

This endpoint allows the user to modify a harvest activity.

URL Description

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/modify/
{activity_id}?app_id={string}&app_key={string}&activity_time={timestamp}
&unit={string}&value={float}&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

Target harvest activity to modify.

activity_time

timestamp

no

Time the activity took place.

unit

string

yes

Unit of measurement for harvest. Valid values include "kg/ha," "lb/ac," and "bu/ac."

value

float

yes

Quantity of harvest. Value must be greater than zero.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by and used with the Accounts API. Must have write privileges.

Response Object

Returns "true" on success.

Example Request

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/modify/12345f?
app_id=456&app_key=789&activity_time=1469134178&unit=lb/Ac&value=99
&account_id=124&user_id=xyz-123

Example Response

true

Delete Harvest Activity - v1.0

This endpoint allows for an existing harvest activity to be deleted.

URL Description

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/delete/
{activity_id}?app_id={string}&app_key={string}&user_id={string}
&account_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

UUID

yes

Specifies ID of the harvest activity that is to be deleted.

account_id

string

yes

A unique account ID provided by your Iteris account representative.

user_id

string

yes

User ID provided by the Create User endpoint as a result of adding a new user to the user information database.

Response Object

Returns "true" on success.

Example Request

https://ag.clearapis.com/v1.0/crop_health/growth/activity/harvest/delete/
321?app_id=456&app_key=789&account_id=123&user_id=xyz-123

Example Response

true

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.