Skip to content

Latest commit

 

History

History
321 lines (245 loc) · 13.2 KB

NEWS.md

File metadata and controls

321 lines (245 loc) · 13.2 KB
Raw

bcmaps (development version)

bcmaps 2.2.1

  • In the cded_() functions, the ask argument, which controls if the user is asked to store data in the cache, was ignored. It is now respected (#147).
  • utm_convert() now respects tibble classes (#143, #148).
  • Fixed a bug in utm_convert() where new coordinates could be mismatched with the wrong rows from the input data frame. (#146, #148)

bcmaps 2.2.0

  • Added function utm_convert() to convert tabular data with X and Y coordinates in (possibly multiple) UTM zones to a single CRS.

bcmaps 2.1.0

  • Added function cded_terra()
  • Deprecated function cded_raster() - this will be removed in a future version.

bcmaps 2.0.0

Removal of sp and raster support

We've removed support for the sp and raster packages, especially those parts that require the use of the rgdal and rgeos packages, which will be retired in October 2023. See the r-spatial blog for details of this evolution.

  • Removed the class argument in all of the data download functions: get_layer() and all of the wrapper shortcuts such as bc_bound(), census_tract(), etc. These functions will now only return sf objects.
  • The Spatial method of transform_bc_albers() is removed.
  • fix_geo_problems() is removed. For sf objects simply use sf::st_make_valid()
  • self_union() is removed. Use raster::union() for SpatialPolygonsDataFrames, or sf::st_union() with sf objects instead.
  • get_poly_attribute() is removed.
  • raster_by_poly() is retained for now as it does not rely on rgdal or rgeos, just sp and raster, which are still being maintained.

Documentation improvements

  • Added a pkgdown site for bcmaps https://bcgov.github.io/bcmaps/ (#63)
  • Moved the detailed user documentation from the README to a Get Started with bcmaps article/vignette (#42)
  • Better documentation for bc_bound_hres() (#124)

bcmaps 1.2.0

Deprecation of sp and raster support

We've started the process of removing support for the sp and raster packages, especially those parts of that require the use of the rgdal and rgeos packages, which will be retired in October 2023. See the r-spatial blog for details of this evolution. We will fully remove support for Spatial classes (from package sp) in the next release in Summer 2023.

  • Added deprecation warnings for the class argument in all of the data download functions: get_layer() and all of the wrapper shortcuts such as bc_bound(), census_tract(), etc. This argument will be removed in the next version of bcmaps as these functions will only return sf objects.
  • The Spatial method of transform_bc_albers() is deprecated.
  • fix_geo_problems() is deprecated and will be removed completely in Summer
  1. For sf objects simply use sf::st_make_valid()
  • self_union() is deprecated and will be removed in Summer 2023. Use raster::union() for SpatialPolygonsDataFrames, or sf::st_union() with sf objects instead.
  • get_poly_attribute() is deprecated because it had a very niche application for calculating attributes on a SpatialPolygonsDataFrame, which we are removing support for. It will be removed completely in Summer 2023.

bcmaps 1.1.0

  • bec and tsa layers are now downloaded directly from the BC Data Catalogue. This ensures that these are up-to-date and means that we do not rely on the manual updating of these layers at https://github.com/bcgov/bcmapsdata. (#62, #115)
  • Package startup message about no longer needing the bcmapsdata package has been removed.

bcmaps 1.0.3

  • New behaviour of shortcut functions ensures that all spatial objects (sf or Spatial) returned are topologically valid and in the standard CRS of "EPSG:3005" (BC Albers). #96
  • More robust behaviour of getting and checking cache of cded files.

bcmaps 1.0.2

  • New helper function show_cached_files() to show the files that you have cached (and how much space they're taking up on your computer). (#92, #93)

bcmaps 1.0.1

  • When R version is >= 4.0, bcmaps will use tools::R_user_dir("bcmaps", "cache") to determine the cache directory, while when R version is < 4.0, it will use rappdirs::user_cache_dir("bcmaps"). This is to align with CRAN's storage policy using the tools approach while maintaining backwards compatibility with older R versions. Unfortunately this will require users who updated to version 1.0 to re-download layers because we are caching layers in a different location on your file system from that version. Users wishing to clear the old cache location could run bcmaps::delete_cache() before updating to bcmaps 1.0.1. (#83)
  • cded_raster and cded_stars directly accepts a bounding box generated by sf::st_bbox as an aoi. (#87)
  • Fixed a bug where bundled datasets (e.g., mapsheets_50K(), mapsheets_250K()) would not work if sf was linked to older GDAL/PROJ libraries due to different formats of coordinate reference systems. (#85)
  • Added new census boundary layers: census_dissemination_area(), census_metropolitan_area(), census_tract() (#82).
  • Add missing layers to available_layers

bcmaps 1.0

  • Drop dependency on {bcmapsdata} in favour of directly retrieving layers (where present) from the B.C. Data Catalogue (via {bcdata}) and storing in a local cache. Some additional layers are retrieved from Statistics Canada.
  • Some layers may not be identical to what was previously in {bcmaps}. For example bc_neighbours previously used data from Natural Earth. The availability of a Hi-Res B.C. boundaries over WFS from the B.C. Data Catalogue means that the layer can now be created directly by {bcmaps}.
  • Added forward sortation area (fsa), health boundaries (health_*) and some census boundaries (census_*).
  • Added ability to retrieve and cache CDED (BC Digital Elevation Model data, returning either stars or raster objects (#73)
  • Use of parallelism in functions that allow it (raster_by_poly() & summarize_raster_list()) is now reliant on users setting up their own future::plan() to specify strategy and number of workers, rather than setting defaults (this is the best practice according to the author of the future package @HenrikBengtsson, #69)
  • Fixed bug where errors would occur if a user's system GEOS was a development version (e.g., 3.9.0dev; #71)

bcmaps 0.18.1

  • Fixed an error where fix_geo_problems() would fail depending on the version of GEOS upon which sf was built.
  • raster_by_poly() fails informatively when there are NA values in the column on which the polygons are to be split (#48, thanks @j-galloway)
  • raster_by_poly() (and summarize_raster_list()) now uses the future.apply package for parallelism, enabling easy parallelization across platforms (#49)
  • get_layer() (and in turn, any of the individual layer functions) now sets the crs so the crs representation will always be up to date with the user's sf version (#51, r-spatial/sf#1225)

bcmaps 0.18.0

  • Added bc_neighbours() function to call layers containing adjacent jurisdictions.
  • Ensured the geometry column in all layers is consistently named "geometry" (Thanks @boshek)
  • Moving sf package to Depends to take advantage of sf print methods.
  • Added bc_bbox() to get a bounding box for British Columbia (#40).
  • All references to external data package now point to bcmapsdata because of this R bug (https://bugs.r-project.org/bugzilla/show_bug.cgi?id=17520)

bcmaps v0.17.1

  • Fixed an issue where self_union() would fail due to a change in the raster package (30cef3438)

bcmaps 0.17.0

  • Output of available_layers() has changed: shortcut_function column is now logical, uses better column names, and has a custom print function that gives more information. (#34)
  • Add links to combine_nr_rd() function from regional_districts() and municipalities(). This function combines Regional Districts with the Northern Rockies Regional Municipalities to create a full provincial layer of 'Regional-District-like' polygons.
  • Added Timber Supply Areas and BC cities shortcut function and to available_layers()
  • bec (and other large downloadable layers) show up in the output of available_layers(), bec() works, and get_layer("bec") works so that getting downloadable datasets is indistinguishable from getting local datasets. (#32)
  • Some utility functions use sf functions that have been moved to the lwgeom package. They now use the lwgeom function (Fixes CRAN CHECK NOTE; #33).
  • Added new layer: bc_cities() which is a point layer of B.C.'s major cities.

bcmaps 0.16.0

  • First release to CRAN
  • Added two new functions: raster_by_poly to overlay a SpatialPolygonsDataFrmae or sf polygons layer on a raster layer and clip the raster to each polygon, and summarize_raster_list to summarize the results of raster_to_poly

bcmaps 0.15.1

  • get_layer() now only accepts characters (#31)
  • Fixes bug in check_write_to_data_dir where it was not creating data directory
  • Update README installation instructions so that vignettes aren't built before bcmaps.rdata is installed (#29)

bcmaps 0.15.0

  • Added the ability to download Biogeoclimatic Zone map - as it was too big to fit in the bcmaps.rdata package, it is hosted as an asset on a GitHub release of bcmaps.rdata, and downloaded via the function bec(), which uses the new function get_big_data() (#28).
  • Added function bec_colours() (and alias bec_colors()) to generate a vector of colours that match the standard colours used to colour Biogeoclimatic Zone maps.

bcmaps 0.14.0

  • Changed the lookup for exported objected to getNamespaceExports("bcmaps") so that you can call layers without loading the package via bcmaps::
  • Removed watersheds layer from package
  • Added ecosections to package

bcmaps 0.13.0

This is a major new release with breaking changes.

All data has been removed from the bcmaps package and moved to the bcmaps.rdata package, which is hosted on the bcgov drat repository: https://github.com/bcgov/drat. That package must be installed in order for bcmaps to access the data. It can be installed with: install.packages('bcmaps.rdata', repos='https://bcgov.github.io/drat/')

In previous versions of bcmaps, data was stored in the package and loaded by calling data("layername") or simply layername (e.g., data("bc_bound") or bc_bound).

Now loading data requires a function call - either using a shortcut function that is the same name as the dataset (e.g., bc_bound() whereas previously one would simply use bc_bound). Alternatively, one can use the get_layer() function (e.g., get_layer("bc_bound")).

Another major change is that all the layers are now returned as sf classes by default, rather than Spatial classes. Spatial versions of the data can still be obtained by setting the class argument to "sp" in get_layer() and the shortcut functions (E.g., bc_bound(class = "sp") or get_layer("bc_bound", class = "sp")).

bcmaps 0.12.0

  • Added wsc_drainages

bcmaps 0.11.0

  • Added hydrozones dataset.

bcmaps 0.10.1

  • Fixed ring self-intersections in bc_bound_hres and airzones (#13)

bcmaps 0.10.0

  • Added water_districts and water_precincts datasets.

bcmaps 0.9.0

  • Added gw_aquifers dataset.

bcmaps 0.8.2

  • Added a tries argument to fix_geo_problems function to set the maximum number of iterations it should go through in attempting to repair topological issues.

bcmaps 0.8.1

  • Set character encoding of watercourses_15M and watercourses_5M datasets to UTF-8.

bcmaps 0.8.0

  • Added watercourses_15M and watercourses_5M datasets.

bcmaps 0.7.1

  • fix_geo_problems and transform_bc_albers are Generic functions with methods for sf objects as well as Spatial objects
  • fix_self_intersect is now defunct

bcmaps 0.6.2

  • fix_self_intersect has been renamed to fix_geo_problems (but kept as an alias for now)
  • fix_geo_problems can often also fix orphaned holes in addition to self-intersections.

bcmaps 0.6.0

  • Added watersheds dataset (#15, @markjohnsonubc)
  • Added a NEWS.md file to track changes to the package.

bcmaps 0.5.0

Added two new functions to create and work with SpatailPolygonsDataFrames with nested data frames:

  • self_union performs a union on a single SpatialPolygons* object to take into account overlaps. Polygon attributes are combined in a nested dataframe.
  • get_poly_attribute allows you to easily parse a nested data frame column (created by self_union) to extract or calculate the attributes you want

bcmaps 0.4.0

Added a couple of convenience functions:

  • transform_bc_albers() transforms a Spatial object to BC Albers projection
  • fix_self_intersect() checks for and repairs self-intersecting polygons

bcmaps 0.3.0

Added 3 Natural Resource layers (areas, regions and districts)

bcmaps 0.2.0

Added high resolution BC boundaries (bc_bound_hres)

bcmaps 0.1.0

Added bc_area function