n2khab 0.12.0

Support for new data source versions

The following new data source versions are now supported by the corresponding functions (#192):

• watersurfaces_2024 (read_watersurfaces())
• watersurfaces_hab_v6 (read_watersurfaces_hab())

n2khab 0.11.0

Support for new data source versions

The following new data source versions are now supported by the corresponding functions (#184):

• habitatmap_2023 (read_habitatmap())
• habitatmap_stdized_2023_v1 (read_habitatmap_stdized())
• habitatmap_terr_2023_v1 (read_habitatmap_terr())
• habitatstreams_2023 (read_habitatstreams())
• watersurfaces_hab_v5 (read_watersurfaces_hab())

Function documentation was updated accordingly.

Drop rbbvos+ from built-in data sources

• Type rbbvos+ has been considered too loosely defined, as an intermediate between rbbvos and 6510_hua, and it has not been mapped consistently.
  Hence this type is considered obsolete and it has been dropped from the types and namelist data sources (#182).
  However do note that it exists in versions of habitatmap and derived data sources.
• expand_types() has been adjusted accordingly (#182).

Other updates

Including:

• the fix_geom implementation in read_watersurfaces() is now more efficient (#185);
• read_habitatmap() also gained a fix_geom argument (#184);
• read_habitatsprings() now returns integer IDs as integers (#180);
• expand_types() with a grouped data frame is now more efficient (13d05ec);
• several fixes (#186, 88f0e19).

n2khab 0.10.1

• Silently ignore errors from package {remotes} during package loading (56e9c06).

n2khab 0.10.0

Breaking change

read_GRTSmh(), read_GRTSmh_base4frac(), read_GRTSmh_diffres() and read_raster_runif() now return a SpatRaster object from {terra} by default (#173). Previous behaviour using {raster} can still be restored; see below. However do note that {raster} is a legacy package and {terra} is its successor.

New feature

The package can be configured using options() or corresponding environment variables. Current configuration state is returned by n2khab_options(). See ?n2khab_options for information on package configuration.

Two settings are now available:

• optionally use {raster} instead of {terra} (#173);
• optionally set a custom n2khab_data path, affecting all functions that need this path (#174).

Deprecated functions

read_schemes() and read_scheme_types() were moved to a new package {n2khabmon}. In {n2khab} they are still functional but deprecated, and will eventually disappear (#175). The accompanying data sources schemes and scheme_types have moved to {n2khabmon}. {n2khab} 0.10.0 will be the minimum version required by {n2khabmon}.

n2khab 0.9.1

• Added workaround for a note during package installation (d300e4a).
• Package startup message: improve recommended code to update package (793e303).

n2khab 0.9.0

• download_zenodo() has been improved (#169):
  • fixes in order to use the renewed Zenodo website;
  • speedup the initiation of a multi-file download;
  • set concurrent (parallel) downloading as default for multi-file records;
  • add unit tests to regularly check that the function still works.
• read_watersurfaces() gained extra capabilities (#168):
  • data source version watersurfaces_v1.2 is now supported;
  • a new fix_geom argument allows to fix invalid or corrupt geometries on the fly.
    This behaviour is turned off by default (see #60).
• Package startup messages have been updated, including a check whether the latest release is being used (#170, 502c3a2).
• Internally, an update has been applied (9691ec2) to googlesheets authentication, used in updating the built-in textual data sources.
  These data sources have not changed since previous release.

n2khab 0.8.0

• Reference list namelist has been updated with improved type names (#163; thanks @jeroenvdborre).
• Paper by De Saeger et al. (2017) is now referred in documentation of read_habitatmap() and derived functions (#165).
• Git repository: branch master is replaced by main (#164).

n2khab 0.7.0

• Upgrade most vc-formatted data sources to the format of git2rdata version 0.4.0. In this version, files not optimized for version control (but rather for readability), are saved as csv instead of tsv files. For n2khab, this applies to the types and env_pressures data sources. Since it is expected that this upgrade is not compatible with older git2rdata versions, the version dependency for git2rdata has been updated (#161).
• scheme_types data source: update typegroup membership of type 7210 in scheme GW_03.3 (#161).

n2khab 0.6.0

New features

• Function read_shallowgroundwater() to return the shallowgroundwater data source (#156).
  • The raw data source shallowgroundwater represents the areas in
    the Flemish region of Belgium where the mean lowest groundwater level is estimated to be less than approximately 2 m below soil surface (inbo/n2khab-preprocessing/pull/61; https://doi.org/10.5281/zenodo.5902880).
• Reference lists types, schemes, scheme_types, namelist were updated (#150, #151, #154, #158):
  • a few type name updates (thanks S. De Saeger);
  • updated value of groundw_dep for type 91F0;
  • environmental pressures ep_07.2 and ep_07.4 received updated (Dutch) explanations;
  • scheme HQ2190 has been replaced by two schemes HQ2190_terr and HQ2190_aq;
  • typegroups were defined for scheme GW_05.1_aq (with contributions from L. Denys & A. Leyssen).
• Readme (homepage): a new installation method using inbo.r-universe.dev has been added and is recommended (#153, 746fb81).

n2khab 0.5.0

Support for new data source versions

The following new data source versions are now supported by their associated reading functions:

• habitatmap_2020 (read_habitatmap() - #139)
• habitatmap_stdized_2020_v1 (read_habitatmap_stdized() - #139, #140)
• habitatmap_terr_2020_v1 (read_habitatmap_terr() - #139, #140)
• habitatstreams_v1.7 (read_habitatstreams() - #114)
• watersurfaces_v1.1 (read_watersurfaces() - #118)
• watersurfaces_hab_v4 (read_watersurfaces_hab() - #142)

Function documentation was updated accordingly and refined.

New functions

• Function read_raster_runif() to return the raster_runif data source (#136, #138)
  • The raw data source raster_runif is a raster with cells matching those of GRTSmaster_habitats.
    Their values are uniformly distributed random numbers between 0 and 1
    (inbo/n2khab-preprocessing/pull/55 and following pull requests; https://doi.org/10.5281/zenodo.4745983).
• Function checksum() and associated shortcut functions to calculate file checksums (#122)

Other updates & internal changes

Including:

• scheme_types data source: updates in typegroup memberships of MNE scheme GW_05.1_terr (#116)
• expand_types() now also supports expanding 5130_hei to 5130 (#143)