get_data_drill_apsim function

Get DataDrill Weather Data in the APSIM Format From SILO

Fetch APSIM .met file formatted weather data from the weather data from the SILO API of spatially interpolated weather data (DataDrill). The daily climate surfaces have been derived either by splining or kriging the observational data. The returned values contain source columns, which denote how the observations were derived. The grid spans 112° to 154°, -10° to -44° with resolution 0.05° latitude by 0.05° longitude (approximately 5 km × 5 km). UTF-8

get_data_drill_apsim(
  longitude,
  latitude,
  start_date,
  end_date = Sys.Date(),
  api_key = get_key(service = "SILO")
)

Arguments

• longitude: A single numeric value representing the longitude of the point-of-interest.

• latitude: A single numeric value representing the latitude of the point-of-interest.

• start_date: A character string or Date object representing the beginning of the range to query in the format yyyy-mm-dd

  (ISO8601). Data returned is inclusive of this date.

• end_date: A character string or Date object representing the end of the range query in the format yyyy-mm-dd (ISO8601). Data returned is inclusive of this date. Defaults to the current system date.

• api_key: A character string containing your API key, an e-mail address, for the request. Defaults to automatically detecting your key from your local .Renviron, .Rprofile or similar. Alternatively, you may directly provide your key as a string here. If nothing is provided, you will be prompted on how to set up your session so that it is auto-detected.

Returns

An list("apsimx") object of class met with attributes.

Details

Note that when saving, comments from SILO will be included, but these will not be printed as a part of the resulting met object in your session.

Included Values

• rain (mm): Rainfall
• maxt (degrees C): Maximum temperature
• mint (degrees C): Minimum temperature
• vp (hPa): Vapour pressure
• evap_pan (mm): Class A pan evaporation
• radiation (Mj/ ): Solar exposure, consisting of both direct and diffuse components

Value information

Solar radiation: total incoming downward shortwave radiation on a horizontal surface, derived from estimates of cloud oktas and sunshine .

Evaporation and evapotranspiration: an overview of the variables provided by SILO is available here, https://data.longpaddock.qld.gov.au/static/publications/Evapotranspiration_overview.pdf.

Data codes

Where the source code is a 6 digit string comprising the source code for the 6 variables. The single digit code for each variable is:

• 0: an actual observation;
• 1: an actual observation from a composite station;
• 2: a value interpolated from daily observations;
• 3: a value interpolated from daily observations using the anomaly interpolation method for CLIMARC data;
• 6: a synthetic pan value; or
• 7: an interpolated long term average.

Saving objects

To save met objects the apsimx::write_apsim_met() is reexported. Note that when saving, comments from SILO will be included, but these will not be printed as a part of the resulting met object in your session.

Examples

## Not run:

# requires an API key as your email address
# Source data from latitude and longitude coordinates (gridded data) for
# max and minimum temperature and rainfall for Southwood, QLD.
wd <- get_data_drill_apsim(
  latitude = -27.85,
  longitude = 150.05,
  start_date = "20220101",
  end_date = "20221231",
  api_key = "your_api_key"
)
## End(Not run)

References

1. Rayner, D. (2005). Australian synthetic daily Class A pan evaporation. Technical Report December 2005, Queensland Department of Natural Resources and Mines, Indooroopilly, Qld., Australia, 40 pp.
2. Morton, F. I. (1983). Operational estimates of areal evapotranspiration and their significance to the science and practice of hydrology, Journal of Hydrology, Volume 66, 1-76.

See Also

Other SILO: find_nearby_stations(), find_stations_in(), get_data_drill(), get_patched_point(), get_patched_point_apsim(), get_stations_metadata(), silo_daily_values

Other data fetching: get_ag_bulletin(), get_coastal_forecast(), get_data_drill(), get_dpird_apsim(), get_dpird_extremes(), get_dpird_minute(), get_dpird_summaries(), get_patched_point(), get_patched_point_apsim(), get_precis_forecast(), get_radar_imagery(), get_satellite_imagery()

Other APSIM: get_dpird_apsim(), get_patched_point_apsim(), reexports

Author(s)

Rodrigo Pires, [email protected] , and Adam Sparks, [email protected]