get_data_drill_apsim {weatherOz}

Get DataDrill Weather Data in the APSIM Format From SILO

Description

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

Usage

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 R session so that it is auto-detected.

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 R session.

Value

An apsimx object of class ‘met’ with attributes.

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/m¹)

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 duration².

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 R session.

Author(s)

Rodrigo Pires, [e-mail], and Adam Sparks, [e-mail]

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

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)