Skip to content

Releases: openair-project/worldmet

worldmet 1.0.0

03 Feb 07:54

Choose a tag to compare

Dependency Changes

  • arrow has been added as a suggested dependency.

  • leaflet has been downgraded to a suggested dependency. When a user requests a met station map they will be prompted to install leaflet if it is not already installed.

  • mirai and carrier have been upgrade to imported dependencies. This is because they are always required by purrr::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(), and import_ghcn_countries() to grant access to metadata for the GHCN.

  • Added import_ghcn_hourly(), import_ghcn_daily() and import_ghcn_monthly() to grant access to the GHCNh, GHCNd and CHCNm services.

  • Added import_isd_stations(), import_isd_hourly() and import_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 using importNOAA(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 path argument -> write_met()

Bug Fixes

  • rlang::%||% is now explicitly imported by worldmet to avoid issues in old version of R.

worldmet 0.10.2

07 Nov 17:16

Choose a tag to compare

Dependency Changes

  • worldmet no longer depends on openair.

New Features

  • importNOAA() now recommends trying the other source if it fails to fetch data (i.e., if source = "delim" fails, the user will be prompted to try source = "fwf").

Bug Fixes

  • Fixed source = "fwf" failing when importing data from closed stations.

  • Fixed source = "fwf" when hourly = TRUE and multiple sites are imported.

  • Removed present weather condition when source = "fwf".

worldmet 0.10.1

26 Aug 15:07

Choose a tag to compare

New Features

  • importNOAAlite() has gained the path argument, in line with importNOAA().

  • importNOAAlite() now supports parallel processing using the {mirai} package, in line with importNOAA().

Bug Fixes

  • importNOAAlite() can now import data from years other than 2025.

worldmet 0.10.0

30 Jul 10:31

Choose a tag to compare

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.core will stil work for back-compatibility, but will give a once-per-session warning.
  • getMeta() has gained the crs argument 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

14 Jan 09:03

Choose a tag to compare

New Features

  • The quiet argument of importNOAA() now also toggles the progress bar.

Bug Fixes