Releases: openair-project/worldmet
worldmet 1.0.0
Dependency Changes
-
arrowhas been added as a suggested dependency. -
leaflethas been downgraded to a suggested dependency. When a user requests a met station map they will be prompted to installleafletif it is not already installed. -
miraiandcarrierhave been upgrade to imported dependencies. This is because they are always required bypurrr::in_parallel()regardless of whether parallelisation is being used or not.
New Features
The Global Historical Climate Network (GHCN) has officially superseded NOAA's Integrated Surface Database (ISD). Many changes in this release are related to this external change.
-
Added
import_ghcn_stations(),import_ghcn_inventory(), andimport_ghcn_countries()to grant access to metadata for the GHCN. -
Added
import_ghcn_hourly(),import_ghcn_daily()andimport_ghcn_monthly()to grant access to the GHCNh, GHCNd and CHCNm services. -
Added
import_isd_stations(),import_isd_hourly()andimport_isd_lite()to provide a consistent API with the newly added GHCN functions. -
Added
write_met(), which allows for hourly ISD and GHCN and daily GHCN data to be easily split into years and sites and written to file. This is a more flexible alternative to usingimportNOAA(path=).
Deprecations
Several functions have been deprecated and replaced due to the updated worldmet API:
-
getMeta()->import_isd_stations() -
getMetaLive()->import_isd_stations_live() -
importNOAA()->import_isd_hourly() -
importNOAAlite()->import_isd_lite() -
exportADMS()->write_adms() -
the
pathargument ->write_met()
Bug Fixes
rlang::%||%is now explicitly imported byworldmetto avoid issues in old version of R.
worldmet 0.10.2
Dependency Changes
worldmetno longer depends onopenair.
New Features
importNOAA()now recommends trying the othersourceif it fails to fetch data (i.e., ifsource = "delim"fails, the user will be prompted to trysource = "fwf").
Bug Fixes
-
Fixed
source = "fwf"failing when importing data from closed stations. -
Fixed
source = "fwf"whenhourly = TRUEand multiple sites are imported. -
Removed present weather condition when
source = "fwf".
worldmet 0.10.1
New Features
-
importNOAAlite()has gained thepathargument, in line withimportNOAA(). -
importNOAAlite()now supports parallel processing using the{mirai}package, in line withimportNOAA().
Bug Fixes
importNOAAlite()can now import data from years other than 2025.
worldmet 0.10.0
New Features
-
Parallel importing of NOAA data is now powered by
{mirai}. This reduces the number of dependencies of{worldmet}, and also allows users to be more flexible with how parallel processing is achieved.- Due to this change, users are recommended to set
mirai::daemons()themselves.n.corewill stil work for back-compatibility, but will give a once-per-session warning.
- Due to this change, users are recommended to set
-
getMeta()has gained thecrsargument to search NOAA ISD stations by coordinates other than latitude and longitude. -
Added
importNOAALite()to access the ISDLite filestore. -
Added the
importNOAA(source=)argument to import ISD data from different file stores. This option can be useful if one of the file stores is not available for whatever reason. -
All error and warning messages are now powered by
{cli}and are more informative.
worldmet 0.9.9
New Features
- The
quietargument ofimportNOAA()now also toggles the progress bar.
Bug Fixes
-
Fixed join problem due to
{dplyr}updates. -
Fixed spelling mistakes in
weatherCodes -
Converted the
{worldmet}vignette to an article. This should ensure it is no longer reliant on NOAA's servers. It can now be accessed at https://openair-project.github.io/worldmet/articles/worldmet.html.