R/extract_data_drill.R
extract_data_drill.Rd
A modified wrapper version of weatherOz::get_data_drill()
that allows
for fetching many geophysical points or a single geophysical point.
Extracts interpolated weather data from the SILO API
from the gridded data, PatchedPointData, data set.
extract_data_drill(x, start_date, end_date, values = "all", api_key)
List
. An object with names containing vector
pairings of
longitude and latitude values expressed as decimal degree values in that
order, each individual vectors
' items should be named "x" (longitude) and
"y" (latitude), respectively. The list
item names should be descriptive
of the individual vectors
and will be included in a "location" column of
the output.
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.
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.
A character
string with the type of weather data to
return. See Available Values for a full list of valid values.
Defaults to all
with all available values being returned.
A character
string specifying a valid email address to use
for the request. The query will return an error if a valid email address
is not provided.
a data.table::data.table with the weather data queried with the weather variables in alphabetical order. The first eight columns will always be:
longitude
,
latitude
,
elev_m
(elevation in metres),
date
(ISO8601 format, YYYYMMDD),
year
,
month
,
day
,
extracted
(the date on which the query was made)
Which will return all of the following values
Rainfall
Maximum temperature
Minimum temperature
Vapour pressure
Vapour pressure deficit
Class A pan evaporation
Synthetic estimate1
Combination (synthetic estimate pre-1970, class A pan 1970 onwards)
Morton's shallow lake evaporation
Solar exposure, consisting of both direct and diffuse components
Relative humidity at the time of maximum temperature
Relative humidity at the time of minimum temperature
FAO564 short crop
ASCE5 tall crop6
Morton's areal actual evapotranspiration
Morton's point potential evapotranspiration
Morton's wet-environment areal potential evapotranspiration over land
Mean sea level pressure
Solar radiation: total incoming downward shortwave radiation on a horizontal surface, derived from estimates of cloud oktas and sunshine duration3.
Relative humidity: calculated using the vapour pressure measured at 9am, and the saturation vapour pressure computed using either the maximum or minimum temperature6.
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 possible (depending on the file format), the data are supplied with codes indicating how each datum was obtained.
Official observation as supplied by the Bureau of Meteorology
Deaccumulated rainfall (original observation was recorded over a period exceeding the standard 24 hour observation period)
Interpolated from daily observations for that date
Synthetic Class A pan evaporation, calculated from temperatures, radiation and vapour pressure
Interpolated from daily observations using an anomaly interpolation method
Interpolated from the long term averages of daily observations for that day of year
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.
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.
Zajaczkowski, J., Wong, K., & Carter, J. (2013). Improved historical solar radiation gridded data for Australia, Environmental Modelling & Software, Volume 49, 64–77. DOI: doi:10.1016/j.envsoft.2013.06.013 .
Food and Agriculture Organization of the United Nations, Irrigation and drainage paper 56: Crop evapotranspiration - Guidelines for computing crop water requirements, 1998.
ASCE’s Standardized Reference Evapotranspiration Equation, proceedings of the National Irrigation Symposium, Phoenix, Arizona, 2000.
For further details refer to Jeffrey, S.J., Carter, J.O., Moodie, K.B. and Beswick, A.R. (2001). Using spatial interpolation to construct a comprehensive archive of Australian climate data, Environmental Modelling and Software, Volume 16/4, 309-330. DOI: doi:10.1016/S1364-8152(01)00008-1 .
Other weather data:
extract_patched_point()
,
extract_power()
Other SILO:
extract_patched_point()
if (FALSE) {
# Source data from a list of latitude and longitude coordinates in NSW
# and WA
locs <- list(
"Merredin" = c(x = 118.28, y = -31.48),
"Corrigin" = c(x = 117.87, y = -32.33),
"Tamworth" = c(x = 150.84, y = -31.07)
)
wd <- extract_data_drill(
x = locs,
start_date = "20211001",
end_date = "20211201",
values = "all",
api_key = "your_api_key"
)
}