get_data_drill_apsim {weatherOz} | R Documentation |
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 |
latitude |
A single |
start_date |
A |
end_date |
A |
api_key |
A |
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/m1)
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 duration2.
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, rodrigo.pires@dpird.wa.gov.au, and Adam Sparks, adamhsparks@gmail.com
References
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.
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)