{"id":27160493,"url":"https://github.com/ropensci/bomrang","last_synced_at":"2025-04-09T00:01:33.399Z","repository":{"id":52822115,"uuid":"89690315","full_name":"ropensci-archive/bomrang","owner":"ropensci-archive","description":":warning: ARCHIVED :warning: Australian government Bureau of Meteorology (BOM) data client for R","archived":true,"fork":false,"pushed_at":"2024-05-14T06:49:09.000Z","size":51930,"stargazers_count":109,"open_issues_count":1,"forks_count":26,"subscribers_count":21,"default_branch":"main","last_synced_at":"2024-05-21T01:05:40.771Z","etag":null,"topics":["australia","australia-bureau-of-meteorology","bom","meteorological-data","meteorology","peer-reviewed","r","r-package","rstats","weather","weather-data","weather-forecast"],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci-archive.png","metadata":{"files":{"readme":"README-old.md","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2017-04-28T09:23:20.000Z","updated_at":"2024-07-31T19:55:21.370Z","dependencies_parsed_at":"2024-07-31T19:55:15.748Z","dependency_job_id":"0ae4a943-9f1e-49ad-9a4a-bd37d9c53096","html_url":"https://github.com/ropensci-archive/bomrang","commit_stats":{"total_commits":1699,"total_committers":11,"mean_commits":"154.45454545454547","dds":0.08946439081812829,"last_synced_commit":"22f42e0f687eb054f33c3bc240df873dd22444c0"},"previous_names":["ropensci/bomrang"],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci-archive%2Fbomrang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci-archive%2Fbomrang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci-archive%2Fbomrang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci-archive%2Fbomrang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci-archive","download_url":"https://codeload.github.com/ropensci-archive/bomrang/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247947842,"owners_count":21023065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["australia","australia-bureau-of-meteorology","bom","meteorological-data","meteorology","peer-reviewed","r","r-package","rstats","weather","weather-data","weather-forecast"],"created_at":"2025-04-09T00:01:02.755Z","updated_at":"2025-04-09T00:01:33.366Z","avatar_url":"https://github.com/ropensci-archive.png","language":"R","funding_links":[],"categories":["Climate, Environment and Weather"],"sub_categories":[],"readme":"_bomrang_: Australian Government Bureau of Meteorology (BOM) Data Client \u003cimg align=\"right\" src=\"man/figures/logo.png\"\u003e\n================\n![tic](https://github.com/ropensci/bomrang/workflows/tic/badge.svg)\n[![codecov](https://codecov.io/gh/ropensci/bomrang/branch/master/graph/badge.svg)](https://codecov.io/gh/ropensci/bomrang) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.598301.svg)](https://doi.org/10.5281/zenodo.598301)\n[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/bomrang)](https://cran.r-project.org/package=bomrang)\n[![](https://badges.ropensci.org/121_status.svg)](https://github.com/ropensci/software-review/issues/121)\n[![status](https://joss.theoj.org/papers/10.21105/joss.00177/status.svg)](https://joss.theoj.org/papers/10.21105/joss.00177)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\nProvides functions to interface with Australian Government Bureau of Meteorology (BOM) data, fetching data and returning a tidy data frame of précis forecasts, current weather data from stations, ag information bulletins, historical weather data and downloading and importing radar or satellite imagery.\n\nCredit for the name, _bomrang_, goes to [Di Cook](http://dicook.org/), who suggested it while attending the rOpenSci AUUnconf in Brisbane, 2016.\n\nNOTE\n-----------\nBOM have decided that the data that they provide should not all be easily available.\nTherefore, some portions of this package (any that depend on HTTP requests) are now broken.\nThese include:\n\n * `get_historical_weather()`,\n * `get_weather_bulletins()`, and\n * `get_current_weather()`\n\nAll other functions in the package work as advertise assuming server availability as they rely on FTP requests.\n\nBOM's official statement\n\n\u003e Website notification of change\nScheduled Release Date: 3 March 2021\nA web application firewall policy has been implemented for www.bom.gov.au which will block screen scraping activity.\nThe Bureau is monitoring screen scraping activity on the site and will commence interrupting, and eventually blocking, this activity on www.bom.gov.au from Wednesday, 3 March 2021. This is aimed at protecting infrastructure, system access and security, intellectual property and server/service load.\nWeb or screen scraping is the act of copying information that shows on a digital display so it can be used for another purpose. This activity has always been at odds with the Bureau's terms and conditions.\nWe understand www.bom.gov.au contributes significantly to the work of many individuals and organisations and we are committed to continuing to provide access through our registered user’s channel.\nFor further information, or to discuss the ongoing use of our materials, please make contact with us via weatherquestions@bom.gov.au.\n\nQuick Start\n-----------\n\n_bomrang_ has been archived from CRAN for reasons beyond _bomrang_ actually being broken.\nAs such at this time I've declined to \"fix\" the package.\nIt can still be installed using the following commands.\n\n``` r\nif (!require(\"remotes\")) {\n  install.packages(\"remotes\", repos = \"http://cran.rstudio.com/\")\n  library(\"remotes\")\n}\n\ninstall_github(\"ropensci/bomrang\", build_vignettes = TRUE)\n```\n\nUsing *bomrang*\n---------------\n\nSeveral functions are provided by *bomrang* to retrieve Australian Bureau of Meteorology (BOM) data. A family of functions retrieve weather data and return tidy data frames;\n\n  - `get_precis_forecast()`, which retrieves the précis (short) forecast;\n\n  - `get_current_weather()`, which fetches the current weather for a given station;\n\n  - `get_ag_bulletin()`, which retrieves the agriculture bulletin;\n  \n  - `get_weather_bulletin()`, which retrieves the BOM 0900 or 1500 bulletins;\n  \n  - `get_coastal_forecast()`, which returns coastal waters forecasts;\n  \n  - `get_historical_weather()`, which retrieves historical daily observations for a given station; and\n  \nA second group of functions retrieve information pertaining to satellite and radar imagery,\n  \n  - `get_available_imagery()`;\n  \n  -  the satellite imagery itself, `get_satellite_imagery()`;\n  \n  - `get_available_radar()`; and \n  \n  - the radar imagery itself, `get_radar_imagery()`.\n  \n[Vignettes are provided illustrating examples](https://docs.ropensci.org/bomrang/articles/bomrang.html)\nof all functions and a [use case](https://docs.ropensci.org/bomrang/articles/use_case.html).\n\nMeta\n----\n\n-   Please [report any issues or bugs](https://github.com/ropensci/bomrang/issues).\n\n-   License:\n\n    - All code is licensed MIT\n\n    - All data is copyright Australia Bureau of Meteorology, BOM Copyright Notice \u003cbr /\u003e\u003chttp://reg.bom.gov.au/other/copyright.shtml\u003e\n\n- To cite *bomrang*, please use the output from `citation(\"bomrang\")`\n\n- Please note that the *bomrang* project is released with a\n[Contributor Code of Conduct](https://github.com/ropensci/bomrang/blob/master/CONDUCT.md).\nBy participating in the *bomrang* project you agree to abide by its terms.\n\nReferences\n----------\n\n[Australian Bureau of Meteorology (BOM) Weather Data Services](http://www.bom.gov.au/catalogue/data-feeds.shtml)\n\n[Australian Bureau of Meteorology (BOM) FTP Public Products](http://www.bom.gov.au/catalogue/anon-ftp.shtml)\n\n[Australian Bureau of Meteorology (BOM) Weather Data Services Agriculture Bulletins](http://www.bom.gov.au/catalogue/observations/about-agricultural.shtml)\n\n[Australian Bureau of Meteorology (BOM) Weather Data Services Observation of Rainfall](http://www.bom.gov.au/climate/how/observations/rain-measure.shtml)\n\n[Australian Bureau of Meteorology (BOM) High-definition satellite images](http://www.bom.gov.au/australia/satellite/index.shtml)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fbomrang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Fbomrang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fbomrang/lists"}