Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Recent Releases of giscoR

giscoR - giscoR 1.0.1

  • Fix a bug that overwrites the internal data base on a new session with the
    cached version. Now the cache should be persistent.
  • Update ?gisco_db.
  • gisco_get_urban_audit() and gisco_get_unit_urban_audit(): Default year
    changed to the latest available: 2024.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v1.0.0...v1.0.1

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan about 2 months ago

giscoR - giscoR 1.0.0

This major release introduces a full overhaul of the codebase and test suite.
Requests now use httr2, and GeoPackage (”gpkg”) becomes the preferred
download format when available. Cached files are reorganized into topic-based
subfolders for easier management.

Because of internal changes, existing caches are not compatible with this
release and must be rebuilt.

Database management has also been improved. Instead of relying on the static
?gisco_db dataset, the package now stores the database in the cache. This
cached database is used for all API calls and can be updated via
gisco_get_cached_db(update_cache = TRUE). In practice, this means that when
GISCO publishes a new yearly release, you can access the new updated data simply
by refreshing the cached database without waiting for a new version of
giscoR.

We have transitioned from rappdirs::user_config_dir() to tools::R_user_dir()
for managing your persistent cache directory. If you are a heavy giscoR user
and already have a cache directory in place, you’ll receive a one-time friendly
message informing you about this migration. Consider it a warm welcome to
giscoR 1.0.0 😉.

The package now requires R ≥ 4.1, and dependency updates improve both
performance and maintainability. All functions return tidy objects (tibbles or
sf objects with tibble data).

Dataset subsetting is now performed at read time using GDAL’s query capabilities
(sf::read_sf()), improving performance and reducing file size. The
geojsonsf dependency is no longer required.

Several new functions and arguments have been added, some functions renamed, and
one deprecated. All bundled datasets have been updated to their latest versions.

We recommend reviewing the updated documentation at
https://ropengov.github.io/giscoR/.

Major changes

  • Refactor code and test suite for improved stability.
  • Switch API requests to httr2.
  • Adopt GeoPackage (”gpkg”) as the preferred download format.
  • Reorganize cache into topic-based subfolders.

Note: Previous caches must be recreated.

Compatibility and performance

  • Require R ≥ 4.1.
  • Update dependencies:
    • Add: cli, httr2, lifecycle, tibble
    • Remove: geojsonsf
  • Return tidy objects consistently.
  • Perform dataset subsetting at read time using GDAL queries via
    sf::read_sf().

New functions

  • Metadata and database utilities:
    • gisco_get_cached_db()
    • gisco_get_metadata()
  • gisco_get_census() for accessing census grid data.
  • New separate functions to access unit data (replacing gisco_get_units()):
    • gisco_get_unit_country()
    • gisco_get_unit_nuts()
    • gisco_get_unit_urban_audit()
  • Functions to access the GISCO ID service
    API
    • gisco_id_api_geonames()
    • gisco_id_api_nuts()
    • gisco_id_api_lau()
    • gisco_id_api_country()
    • gisco_id_api_river_basin()
    • gisco_id_api_biogeo_region()
    • gisco_id_api_census_grid()

Renamed functions

We renamed several functions to improve clarity and consistency:

  • ?gisco_addressapi → ?gisco_address_api
  • gisco_get_coastallines() → gisco_get_coastal_lines()
  • gisco_get_postalcodes() → gisco_get_postal_codes()

Old names remain available as aliases.

Argument updates

  • Add ext argument to control file format (”gpkg”, ”shp”, ”geojson”).
  • Update default year to the latest release (#105).

Dataset updates

We updated all bundled datasets to their latest versions and added new ones:

  • Update ?gisco_db to the newest data.
  • Add ?gisco_countries_2024 (replaces gisco_countries).
  • Add ?gisco_nuts_2024 (replaces gisco_nuts).
  • Add ?gisco_coastal_lines (replaced gisco_coastallines).

The datasets gisco_countries, gisco_nuts, and gisco_coastallines are no
longer available. Any code that accessed them directly (e.g.,
giscoR::gisco_countries) will now fail.\

Please use the updated datasets or, preferably, retrieve them via the
corresponding functions such as gisco_get_countries() with default
parameters.

Deprecations

  • Deprecate gisco_get_units().
    • Functionality is now available through gisco_get_metadata() and the
      ?gisco_get_unit family.
  • Deprecate cache argument in heavy-download functions (gisco_get_lau(),
    gisco_get_communes()).
  • In gisco_bulk_download(), rename id_giscoR → id.

Other updates

  • Add Eurostat as copyright holder.
  • Rewrite the full test suite.
  • Review and improve documentation.
  • Reorganize pkgdown site.
  • Use cli for all messages.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.6.1...v1.0.0

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan 3 months ago

giscoR - giscoR 0.6.1

  • Fix an issue when filtering source on gisco_get_lau().

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.6.0...v0.6.1

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan about 1 year ago

giscoR - giscoR 0.6.0

Update with latest data available

  • gisco_get_education() and gisco_get_healthcare() gains a new year
    argument: years available now are 2020 and 2023 versions of the dataset.
  • gisco_get_nuts() and gisco_get_countries() now can download the 2024
    version of the datasets (#93 @hannesaddec).

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.5.1...v0.6.0

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 1 year ago

giscoR - giscoR 0.5.1

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.5.0...v0.5.1

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 1 year ago

giscoR - giscoR 0.5.0

  • New functions:
    • gisco_get_education().
    • Add access to GISCO Address
      API
      through new functions. See ?gisco_addressapi to know more (#84).
  • New dependency: jsonlite added to 'Imports'.
  • Update gisco_db with the most up-to-date released data.
  • Default year of some functions updated to the latest available data:
    • gisco_get_lau() and gisco_get_urban_audit() default year now is
      "2021".
  • Update urls in documentation.

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan almost 2 years ago

giscoR - giscoR 0.4.2

  • Update of docs to avoid warnings on CRAN (#81).
  • Rebuild datasets.

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.4.2...v0.4.2

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan almost 2 years ago

giscoR - giscoR 0.4.1

  • Improve documentation, stating where the parameters country and region
    applies (#50, #75).
  • Migrate to httr2 instead of httr.
  • Removed tgs00026 dataset, use eurostat::get_eurostat("tgs00026")
    instead.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.4.0...v0.4.1

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan about 2 years ago

giscoR - giscoR 0.4.0

  • gisco_get_nuts(): Add an additional geo column (identical to NUTS_ID)
    for enhanced compatibility with eurostat package (#62).
  • Adjust examples for CRAN.
  • Add dependency httr.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.3.5...v0.4.0

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 2 years ago

giscoR - giscoR 0.3.5

  • Review examples to avoid CRAN errors and notes.

  • New helper function: gisco_detect_cache_dir().

  • Now the functions fail gracefully with an informative message, instead of an
    error, and return NULL.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.3.4...v0.3.5

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 2 years ago

giscoR - giscoR 0.3.4

  • Update tests and documentation.

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.3.3...v0.3.4

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan almost 3 years ago

giscoR - giscoR 0.3.3

  • Fix broken urls on gisco_get_healthcare() (#51).

What's Changed

New Contributors

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.3.2...v0.3.3

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan about 3 years ago

giscoR - giscoR 0.3.2

  • Fix HTML5 issue as requested by CRAN.

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 3 years ago

giscoR - giscoR 0.3.1

  • Add Copyright on DESCRIPTION.

  • Add lwgeom on Suggests.

  • gisco_get_airports() and gisco_get_ports():

    • Only year available is 2013.

    • Now information is downloaded instead of using internal data.

  • New function: gisco_get_postalcodes().

  • Update gisco_db.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.3.0...v0.3.1

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 4 years ago

giscoR - giscoR 0.3.0

  • Now giscoR is part of rOpenGov. Repo has been
    transferred.
  • Caching improvements: new function gisco_set_cache_dir() based on rappdirs::user_cache_dir(). Now the cache_dir path is stored and it is not necessary to set it up again on a new session. Also added gisco_clear_cache().
  • Fix an error when cache = FALSE. Now files are loaded instead throwing an error.
  • New tests with testthat.
  • Update on docs. New examples
  • Refactor documents and codes for the previous gisco_get doc.
  • Add eurostat package to Suggests.
  • lwgeom dependency removed.
  • Update internal grid object.
  • tmap package replaced by ggplot2 on vignettes and examples.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.2.4...v0.3.0

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 4 years ago

giscoR - giscoR 0.2.4

  • New eu field on giscoR::gisco_countrycode.
  • Fix typos on documentation
  • Include vignette on the package
  • Move docs to markdown/roxygen
  • lwgeom moved to Import field.
  • cartography package replaced by tmap on vignettes.

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.2.3...v0.2.4

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan almost 5 years ago

giscoR - DOI release

This release is for getting a DOI

What's Changed

Full Changelog: https://github.com/rOpenGov/giscoR/compare/v0.2.2...v0.2.3

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 5 years ago

giscoR - CRAN release

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 5 years ago

giscoR - CRAN release

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 5 years ago

giscoR - CRAN version

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 5 years ago

giscoR - CRAN version

Initial release

Sustainable Development - Data Catalogs and Interfaces - R
Published by dieghernan over 5 years ago