diff --git a/joss.06717/10.21105.joss.06717.crossref.xml b/joss.06717/10.21105.joss.06717.crossref.xml new file mode 100644 index 0000000000..3d62507dd7 --- /dev/null +++ b/joss.06717/10.21105.joss.06717.crossref.xml @@ -0,0 +1,330 @@ + + + + 20240607093754-2361f81be6e59bcf5f09823cca7067ed1716818d + 20240607093754 + + JOSS Admin + admin@theoj.org + + The Open Journal + + + + + Journal of Open Source Software + JOSS + 2475-9066 + + 10.21105/joss + https://joss.theoj.org + + + + + 06 + 2024 + + + 9 + + 98 + + + + weatherOz: An API Client for Australian Weather and +Climate Data Resources in R + + + + Rodrigo + Pires + https://orcid.org/0000-0001-7384-6849 + + + Anna + Hepworth + https://orcid.org/0000-0003-0204-6347 + + + Rebecca + O’Leary + + + Jonathan + Carroll + https://orcid.org/0000-0002-1404-5264 + + + James + Goldie + https://orcid.org/0000-0002-5024-6207 + + + Dean + Marchiori + https://orcid.org/0000-0002-3430-7225 + + + Paul + Melloy + https://orcid.org/0000-0003-4253-7167 + + + Mark + Padgam + https://orcid.org/0000-0003-2172-5265 + + + Hugh + Parsonage + https://orcid.org/0000-0003-4055-0835 + + + Adam H. + Sparks + https://orcid.org/0000-0002-0061-8359 + + + + 06 + 07 + 2024 + + + 6717 + + + 10.21105/joss.06717 + + + http://creativecommons.org/licenses/by/4.0/ + http://creativecommons.org/licenses/by/4.0/ + http://creativecommons.org/licenses/by/4.0/ + + + + Software archive + 10.5281/zenodo.8191283 + + + GitHub review issue + https://github.com/openjournals/joss-reviews/issues/6717 + + + + 10.21105/joss.06717 + https://joss.theoj.org/papers/10.21105/joss.06717 + + + https://joss.theoj.org/papers/10.21105/joss.06717.pdf + + + + + + Weather data services + Australian Bureau of Meteorology + 2024 + Australian Bureau of Meteorology. +(2024). Weather data services. +http://www.bom.gov.au/catalogue/data-feeds.shtml + + + bomrang: Fetch Australian government Bureau +of Meteorology data in R + Sparks + The Journal of Open Source +Software + 17 + 2 + 10.21105/joss.00411 + 2475-9066 + 2017 + Sparks, A. H., Padgham, M., +Parsonage, H., & Pembleton, K. (2017). bomrang: Fetch Australian +government Bureau of Meteorology data in R. The Journal of Open Source +Software, 2(17), 411. +https://doi.org/10.21105/joss.00411 + + + apsimx: Inspect, read, edit and run ’APSIM’ +"Next Generation" and ’APSIM’ Classic + Miguez + 2024 + Miguez, F. (2024). apsimx: Inspect, +read, edit and run ’APSIM’ "Next Generation" and ’APSIM’ Classic. +https://CRAN.R-project.org/package=apsimx + + + Using spatial interpolation to construct a +comprehensive archive of Australian climate data + Jeffrey + Environmental Modelling & +Software + 4 + 16 + 10.1016/s1364-8152(01)00008-1 + 1364-8152 + 2001 + Jeffrey, S. J., Carter, J. O., +Moodie, K. B., & Beswick, A. R. (2001). Using spatial interpolation +to construct a comprehensive archive of Australian climate data. +Environmental Modelling & Software, 16(4), 309–330. +https://doi.org/10.1016/s1364-8152(01)00008-1 + + + Meteorological data for agricultural +applications + Venäläinen + Physics and Chemistry of the Earth, Parts +A/B/C + 23 + 27 + 10.1016/S1474-7065(02)00140-7 + 1474-7065 + 2002 + Venäläinen, A., & Heikinheimo, M. +(2002). Meteorological data for agricultural applications. Physics and +Chemistry of the Earth, Parts A/B/C, 27(23), 1045–1050. +https://doi.org/10.1016/S1474-7065(02)00140-7 + + + Spatial mapping of renewable energy +potential + Ramachandra + Renewable and Sustainable Energy +Reviews + 7 + 11 + 10.1016/j.rser.2005.12.002 + 1364-0321 + 2007 + Ramachandra, T. V., & Shruthi, B. +V. (2007). Spatial mapping of renewable energy potential. Renewable and +Sustainable Energy Reviews, 11(7), 1460–1480. +https://doi.org/10.1016/j.rser.2005.12.002 + + + Application of climatic guidelines to urban +planning + Alcoforado + Landscape and Urban Planning + 1 + 90 + 10.1016/j.landurbplan.2008.10.006 + 0169-2046 + 2009 + Alcoforado, M.-J., Andrade, H., +Lopes, A., & Vasconcelos, J. (2009). Application of climatic +guidelines to urban planning. Landscape and Urban Planning, 90(1), +56–65. +https://doi.org/10.1016/j.landurbplan.2008.10.006 + + + Diurnal air temperatures in built-up areas in +relation to urban planning + Svensson + Landscape and Urban Planning + 1 + 61 + 10.1016/S0169-2046(02)00076-2 + 0169-2046 + 2002 + Svensson, M. K., & Eliasson, I. +(2002). Diurnal air temperatures in built-up areas in relation to urban +planning. Landscape and Urban Planning, 61(1), 37–54. +https://doi.org/10.1016/S0169-2046(02)00076-2 + + + Risk assessment models for wheat fusarium +head blight epidemics based on within-season weather +data + De Wolf + Phytopathology + 4 + 93 + 10.1094/PHYTO.2003.93.4.428 + 0031-949X + 2003 + De Wolf, E. D., Madden, L. V., & +Lipps, P. E. (2003). Risk assessment models for wheat fusarium head +blight epidemics based on within-season weather data. Phytopathology, +93(4), 428–435. +https://doi.org/10.1094/PHYTO.2003.93.4.428 + + + WINS: Crop stress weather information delivery +system in R + Sparks + 10.5281/zenodo.11363275 + 2017 + Sparks, A., Pembleton, K., & +Grundy, G. (2017). WINS: Crop stress weather information delivery system +in R. https://doi.org/10.5281/zenodo.11363275 + + + Spatial Data Science: With applications in +R + Pebesma + 10.1201/9780429459016 + 2023 + Pebesma, E., & Bivand, R. (2023). +Spatial Data Science: With applications in R (p. 352). Chapman; +Hall/CRC. https://doi.org/10.1201/9780429459016 + + + terra: Spatial data analysis + Hijmans + 2024 + Hijmans, R. J. (2024). terra: Spatial +data analysis. +https://CRAN.R-project.org/package=terra + + + data.table: Extension of +‘data.frame‘ + Barrett + 2024 + Barrett, T., Dowle, M., Srinivasan, +A., Gorecki, J., Chirico, M., & Hocking, T. (2024). data.table: +Extension of ‘data.frame‘. +https://CRAN.R-project.org/package=data.table + + + magick: Advanced graphics and image-processing +in R + Ooms + 2024 + Ooms, J. (2024). magick: Advanced +graphics and image-processing in R. +https://CRAN.R-project.org/package=magick + + + SILO - Australian climate data from 1898 to +yesterday + SILO + 2024 + SILO. (2024). SILO - Australian +climate data from 1898 to yesterday. +https://www.longpaddock.qld.gov.au/silo/about/climate-stations/ + + + + + + diff --git a/joss.06717/10.21105.joss.06717.pdf b/joss.06717/10.21105.joss.06717.pdf new file mode 100644 index 0000000000..b8869c1f5f Binary files /dev/null and b/joss.06717/10.21105.joss.06717.pdf differ diff --git a/joss.06717/paper.jats/10.21105.joss.06717.jats b/joss.06717/paper.jats/10.21105.joss.06717.jats new file mode 100644 index 0000000000..553bf2567a --- /dev/null +++ b/joss.06717/paper.jats/10.21105.joss.06717.jats @@ -0,0 +1,563 @@ + + +
+ + + + +Journal of Open Source Software +JOSS + +2475-9066 + +Open Journals + + + +6717 +10.21105/joss.06717 + +weatherOz: An API Client for Australian Weather and +Climate Data Resources in R + + + +https://orcid.org/0000-0001-7384-6849 + +Pires +Rodrigo + + + + +https://orcid.org/0000-0003-0204-6347 + +Hepworth +Anna + + + + + +O’Leary +Rebecca + + + + +https://orcid.org/0000-0002-1404-5264 + +Carroll +Jonathan + + + + +https://orcid.org/0000-0002-5024-6207 + +Goldie +James + + + + +https://orcid.org/0000-0002-3430-7225 + +Marchiori +Dean + + + + +https://orcid.org/0000-0003-4253-7167 + +Melloy +Paul + + + + +https://orcid.org/0000-0003-2172-5265 + +Padgam +Mark + + + + +https://orcid.org/0000-0003-4055-0835 + +Parsonage +Hugh + + + + +https://orcid.org/0000-0002-0061-8359 + +Sparks +Adam H. + + + + + + + +Department of Primary Industries and Regional Development +of Western Australia, Perth, Western Australia 6000, +Australia + + + + +No affiliation + + + + +360info, Monash University, Australia + + + + +Wave Data Labs, Wollongong, New South Wales, 2500, +Australia + + + + +The University of Queensland, School of Agriculture and +Food Sustainability, Gatton, Queensland 4343, Australia + + + + +rOpenSci + + + + +Grattan Institute, Carlton, Victoria 3053, +Australia + + + + +University of Southern Queensland, Centre for Crop Health, +Toowoomba, Queensland 4350, Australia + + + + +Curtin University, Centre for Crop and Disease Management, +Curtin Biometry and Agricultural Data Analytics, Bentley, Western +Australia 6102, Australia + + + + +25 +3 +2024 + +9 +98 +6717 + +Authors of papers retain copyright and release the +work under a Creative Commons Attribution 4.0 International License (CC +BY 4.0) +2022 +The article authors + +Authors of papers retain copyright and release the work under +a Creative Commons Attribution 4.0 International License (CC BY +4.0) + + + +Australia +weather forecast +meteorology +climatology +weather data +R +API client +xml +json + + + + + + Summary +

Researchers and policy makers use weather data in a variety of + ways. Agriculture applications of the data are used in several types + of models and decision support tools, to estimate leaf wetness, crop + yield, crop growth stage, physiological stress or forecasting crop + disease epidemics or insect pest population levels + (De + Wolf et al., 2003; + A. + Sparks et al., 2017; + Venäläinen + & Heikinheimo, 2002). Other areas of use include mapping + potential renewable energy, e.g., wind or solar + potential for exploration purposes + (Ramachandra + & Shruthi, 2007). The data can also be used by decision + makers for municipalities to help plan for extreme weather events, + energy needs and other infrastructure + (Alcoforado + et al., 2009; + Svensson + & Eliasson, 2002).

+

weatherOz offers R users with a single + interface to access Australian climate and weather data sources + providing a standardised way of easily querying and retrieving + Australian climate and weather data.

+ + + Statement of need +

Australian weather data availability is fragmented and difficult to + easily access repeatedly or programmatically for use in research + activities. Previously the R package, bomrang + (A. + H. Sparks et al., 2017), provided easy access to data available + from the Australian Bureau of Meteorology (BoM) in R. However, + difficulties with accessing the data and restrictive polices caused us + to archive this package. Therefore, we created + weatherOz to replace and at the same time, + improve upon bomrang and provide R users with a + package that allowed for easy of access to multiple sources of + Australian climate and weather data while providing a unified approach + to working with different data sources. There are two sources of + Australia-wide climate and weather station observations and data, BoM + and Queensland Government’s Scientific Information for Landowners + (SILO) + (Jeffrey + et al., 2001) database, hosted by the Queensland Department of + the Environment, Science and Innovation (DESI) and one source for + Western Australia only weather station data, the Department of Primary + Industries and Regional Development of Western Australia’s (DPIRD) + database. BoM provides files through their public anonymous FTP server + (Australian + Bureau of Meteorology, 2024) and data from both the SILO and + DPIRD databases are available through APIs.

+

weatherOz provides access to data from the + SILO database are made available under a Creative Commons Attribution + 4.0 International (CC BY 4.0) licence including the Patched Point data + available “from 1889 to yesterday” for approximately 8,000 weather + station locations located at post-offices, airports, police stations, + national parks and private properties + (SILO, + 2024), and Data Drill data, which are spatially interpolated + data covering Australian land surfaces. The DPIRD weather station + network includes approximately 200 weather stations with data + available from the year 2000 in Western Australia with the majority + being located in the south-western part of the state and are available + in time-steps from minute to annual summaries with the default being + daily values and is made available under a Creative Commons + Attribution Licence 3.0 (CC BY 3.0 AU), though users must register for + a free API key to use the resource. BoM data that are supported + include forecasts, both précis and coastal, agriculture bulletins and + satellite and radar imagery and are available under a Creative Commons + Attribution (CC BY) licence.

+ + + Features +

The package is fully documented with a quick-start vignette that + provides details about how to set up the API keys and go about + frequently conducted tasks, e.g., fetching daily + summary weather data from DPIRD and SILO as well as maps of station + locations in the DPIRD and SILO station networks. Additionally, each + data source has a dedicated vignette that details how to fetch data + from that source and includes greater detail about the functionality + of the package. Most users will likely use + get_patched_point() (station data), + get_data_drill() (spatially interpolated + gridded data) or get_dpird_summaries() to + retrieve summarised weather station data values. Most functions return + a data.table + (Barrett + et al., 2024), with the exception of some specialised functions + discussed later.

+

Weather station metadata available through + weatherOz is richer than what is available from + SILO alone and includes geographic location as longitude, latitude and + state, elevation, dates available, open or closed status and in the + case of DPIRD stations, more detailed information including uptime and + hardware details about the stations themselves is available through + get_stations_metadata().

+

Two specialised functions for data available from BoM, + get_radar_imagery() and + get_satellite_imagery(), return either + terra + (Hijmans, + 2024) or stars + (Pebesma + & Bivand, 2023) native objects or a + magick object + (Ooms, + 2024), respectively. Three other specialised functions are + available for APSIM users providing apsimx + “.met” objects of weather data from both DPIRD and SILO + (Miguez, + 2024) in an R session, e.g., + get_dpird_apsim(), + get_data_drill_apsim() and + get_patched_point_apsim().

+

weatherOz strives to unify the users + experience, this includes the function arguments across the API + requests as much as possible and also renaming the return object + columns such that they follow a common naming scheme no matter which + data source. This does mean that the column names do not match the + data source, but make working with data from the different APIs more + manageable.

+ + + Acknowledgements +

Work on this package was funded as salary for the time of + individuals involved in the writing of this software in part by the + Department of Primary Industries and Regional Development of Western + Australia, Adam H. Sparks and Rebecca O’Leary; Grains Research and + Development Corporation research projects GRI2007-001RTX, Rodrigo + Pires; and DAW2112-002RTX, Anna Hepworth; and Curtin University, Adam + H. Sparks.

+ + + + + + + + + Australian Bureau of Meteorology + + Weather data services + 202402 + http://www.bom.gov.au/catalogue/data-feeds.shtml + + + + + + SparksAdam H. + PadghamMark + ParsonageHugh + PembletonKeith + + bomrang: Fetch Australian government Bureau of Meteorology data in R + The Journal of Open Source Software + The Open Journal + 201709 + 2 + 17 + 2475-9066 + 10.21105/joss.00411 + 411 + + + + + + + MiguezFernando + + apsimx: Inspect, read, edit and run ’APSIM’ "Next Generation" and ’APSIM’ Classic + 2024 + https://CRAN.R-project.org/package=apsimx + + + + + + JeffreyStephen J. + CarterJohn O. + MoodieKeith B. + BeswickAlan R. + + Using spatial interpolation to construct a comprehensive archive of Australian climate data + Environmental Modelling & Software + Elsevier BV + 200106 + 16 + 4 + 1364-8152 + 10.1016/s1364-8152(01)00008-1 + 309 + 330 + + + + + + VenäläinenAri + HeikinheimoMartti + + Meteorological data for agricultural applications + Physics and Chemistry of the Earth, Parts A/B/C + 2002 + 27 + 23 + 1474-7065 + http://www.sciencedirect.com/science/article/pii/S1474706502001407 + 10.1016/S1474-7065(02)00140-7 + 1045 + 1050 + + + + + + RamachandraT. V. + ShruthiB. V. + + Spatial mapping of renewable energy potential + Renewable and Sustainable Energy Reviews + 2007 + 11 + 7 + 1364-0321 + http://www.sciencedirect.com/science/article/pii/S1364032106000050 + 10.1016/j.rser.2005.12.002 + 1460 + 1480 + + + + + + AlcoforadoMaria-João + AndradeHenrique + LopesAntónio + VasconcelosJoão + + Application of climatic guidelines to urban planning + Landscape and Urban Planning + 2009 + 90 + 1 + 0169-2046 + http://www.sciencedirect.com/science/article/pii/S0169204608001746 + 10.1016/j.landurbplan.2008.10.006 + 56 + 65 + + + + + + SvenssonMarie K. + EliassonIngegärd + + Diurnal air temperatures in built-up areas in relation to urban planning + Landscape and Urban Planning + 2002 + 61 + 1 + 0169-2046 + http://www.sciencedirect.com/science/article/pii/S0169204602000762 + 10.1016/S0169-2046(02)00076-2 + 37 + 54 + + + + + + De WolfE. D. + MaddenL. V. + LippsP. E. + + Risk assessment models for wheat fusarium head blight epidemics based on within-season weather data + Phytopathology + Scientific Societies + 200308 + 93 + 4 + 0031-949X + 10.1094/PHYTO.2003.93.4.428 + 428 + 435 + + + + + + SparksAdam + PembletonKeith + GrundyGordon + + WINS: Crop stress weather information delivery system in R + 2017 + https://github.com/ToowoombaTrio/WINS + 10.5281/zenodo.11363275 + + + + + + PebesmaEdzer + BivandRoger + + Spatial Data Science: With applications in R + Chapman; Hall/CRC + London + 2023 + https://r-spatial.org/book/ + 10.1201/9780429459016 + 352 + + + + + + + HijmansRobert J. + + terra: Spatial data analysis + 2024 + https://CRAN.R-project.org/package=terra + + + + + + BarrettTyson + DowleMatt + SrinivasanArun + GoreckiJan + ChiricoMichael + HockingToby + + data.table: Extension of ‘data.frame‘ + 2024 + https://CRAN.R-project.org/package=data.table + + + + + + OomsJeroen + + magick: Advanced graphics and image-processing in R + 2024 + https://CRAN.R-project.org/package=magick + + + + + + SILO + + SILO - Australian climate data from 1898 to yesterday + 202402 + https://www.longpaddock.qld.gov.au/silo/about/climate-stations/ + + + + +