Terrainr Versions Save

Get DEMs and orthoimagery from the USGS National Map, georeference your images and merge rasters, and visualize with Unity 3D

v0.7.5

7 months ago
  • More tests are flagged to skip on CRAN, or when run offline

  • georeference_overlay should give fewer useless warnings

v0.7.4

1 year ago
  • New query method is dramatically faster and less-error prone.

v0.7.3

1 year ago
  • Updated contours URL to new location
  • Removing dependencies on raster and rgdal
  • Fixed infinite loop when following two-stage APIs
  • Removed HRO, as the endpoint appears to have disappeared

v0.7.2

1 year ago
  • New features:
    • Two new endpoints are available: HRO, which provides orthoimagery for non-CONUS US domains, and USGSNAIPImagery, which only returns NAIP (whereas USGSNAIPPlus, the default for ortho, will use HRO where appropriate).
  • Improvements and bug fixes:
    • Updated NAIP URL to its new home, which should reenable NAIP downloads.
    • Fixed warning in geom_spatial_rgb() about "dropped aesthetics".
    • Fixed govunits test.
  • Dependency changes:
    • ggplot2 now requires a minimum of 3.4.0

v0.7.1

1 year ago
  • Improvements and bug fixes:
    • Redocumented package to stay on CRAN.
    • merge_rasters no longer warns that options aren't respected when using the fallback method before immediately passing said options to gdalwarp.
    • Starting to move error messages into rlang with string interpolation via glue.
  • Dependency changes:
    • rlang and glue have been added to Imports
    • raster now requires a minimum version of 3.5-19.

v0.7.0

2 years ago

terrainr 0.7.0

  • New features:
    • make_unity is a new function which uses the new unifir package to automatically create Unity scenes, no clicking necessary.
    • Internally, all calls to functions from {raster} have been replaced with calls to {terra}. This future-proofs the package against any coming deprecations and takes advantage of newer, faster terra code. This is not intended to be a breaking change; any methods that previously took {raster} objects should still work (and silently convert to {terra} under the hood). If you have any workflows impacted by this change, please file a bug report!
  • Improvements and bug fixes:
    • make_manifest, transform_elevation, and transform_overlay no longer error when providing non-standard side lengths; they now warn as intended.
    • make_manifest, transform_elevation, and transform_overlay should no longer give warnings about nodata values in most cases. being clamped to 0.
    • Fixed some documentation, unused objects, restyled and removed lints.
    • transform_overlay (and by extension, every Unity overlay importer) now tries to automatically guess the scale of the input raster. Values under 1 are scaled from 0-1, integers under 255 are scaled 0-255, and integers under 65535 are scaled 0-65536. The main effect of this is more realistic coloring when importing terrain. Floats above 1 won't be affected.
  • Dependency changes:
    • terra is now included as an Import (had been recursively imported through raster previously).
    • raster and rgdal are now in Suggests (used temporarily in Raster* methods for get_tiles and add_bbox_buffer, until the new version of raster hits CRAN).
  • Internal changes:
    • raster_to_raw_tiles is now a thin wrapper around the functions transform_overlay and transform_elevation. It is no longer tested; it will be removed entirely in the next release (see deprecation notice in terrainr 0.5.0).

v0.6.0

2 years ago

terrainr 0.6.0

  • New features:
    • Two new functions, transform_elevation and transform_overlay, should now provide raster transformation functions that were possible with raster_to_raw_tiles but not with make_manifest. As an added bonus, the internal code to handle tiling is now dramatically simpler.
  • Improvements and bug fixes:
    • make_manifest will now overwrite any file at importer_path, in line with documented behavior. Previous versions would never overwrite importer_path.
    • merge_rasters' fallback method now runs much faster
  • Dependency changes:
    • gdalUtils has been removed from dependencies following CRAN directions
    • rgdal is now an explicit dependency (had previously been imported via gdalUtils)

v0.5.1

2 years ago

terrainr 0.5.1

  • New features:
    • A new endpoint, ecosystems, has been added to get_tiles and hit_national_map_api.
  • Improvements and bug fixes:
    • merge_rasters gains an argument, overwrite, which allows you to specify whether or not to overwrite output_raster if it exists. Previous versions expected you to pass "-overwrite" to options. If a file exists at output_raster and overwrite is FALSE, merge_rasters will throw an error.
  • Dependency changes:
    • sf now has a minimum dependency of 1.0-5, to take advantage of an upstream bug fix (relating to merge_rasters overwrite)

v0.5.0-r

2 years ago

(This time for real -- this release matches the one published to CRAN)

  • New features:
    • A new function, make_manifest, now helps automate the import of terrain and imagery to Unity. It fully replaces raster_to_raw_tiles (see Deprecations below). Documentation updates are forthcoming.
  • Deprecations:
    • raster_to_raw_tiles is now deprecated and will be removed in a future release (no earlier than 2022). Use make_manifest instead.
    • The method get_tiles.list is now deprecated and will be removed in a future release (unexported in Fall 2021, removed no earlier than 2022). Convert your list to an sf object instead.
    • The bbox argument to hit_national_map_api is now documented as "An object from [sf::st_bbox]." This is a change from the earlier options of a length 2 list or terrainr_bounding_box object. Those methods are currently still supported, but undocumented; they will be removed in a future release (no earlier than 2022).
  • Improvements and bug fixes:
    • get_tiles no longer mangles data with projected coordinates (via a fix to the internal function split_bbox). If for some reason you want the old behavior back, set the new argument projected to FALSE while providing projected data.
    • The documentation for add_bbox_buffer and set_bbox_side_length now specifies that they should only be used with geographic coordinate systems. If you use these functions with projected data, they will warn; this may be upgraded to an error in future versions.
    • The README images are now of beautiful Hyampom, California, a somewhat more appealing vista than the original Mt Marcy scene.
    • The "Import to Unity" vignette has been rewritten to use make_manifest, as has the overview vignette and other documentation.
    • Typos in the message merge_rasters gives when using the fallback method have been fixed.
    • merge_rasters gains an argument force_fallback which, if TRUE, will use the older, slower method for merging tiles. This is not recommended, but is useful for testing.
  • Internal changes:
    • The slow removal of all terrainr_* custom classes marches on! These classes should no longer be present in any user-facing, non-deprecated code; the only functions still relying on custom classes are internal utilities and the split_bbox function responsible for tiling get_tiles requests.
    • split_bbox should now run faster, particularly for large tile sets, as some nested loops have been vectorized.
    • Improvements to test coverage and CI.

v0.5.0-p

2 years ago

(Note: this is a pre-release to get a Zenodo DOI; it may not match the version published to CRAN)

  • New features:
    • A new function, make_manifest, now helps automate the import of terrain and imagery to Unity. It fully replaces raster_to_raw_tiles (see Deprecations below). Documentation updates are forthcoming.
  • Deprecations:
    • raster_to_raw_tiles is now deprecated and will be removed in a future release (no earlier than 2022). Use make_manifest instead.
    • The method get_tiles.list is now deprecated and will be removed in a future release (unexported in Fall 2021, removed no earlier than 2022). Convert your list to an sf object instead.
    • The bbox argument to hit_national_map_api is now documented as "An object from [sf::st_bbox]." This is a change from the earlier options of a length 2 list or terrainr_bounding_box object. Those methods are currently still supported, but undocumented; they will be removed in a future release (no earlier than 2022).
  • Improvements and bug fixes:
    • get_tiles no longer mangles data with projected coordinates (via a fix to the internal function split_bbox). If for some reason you want the old behavior back, set the new argument projected to FALSE while providing projected data.
    • The documentation for add_bbox_buffer and set_bbox_side_length now specifies that they should only be used with geographic coordinate systems. If you use these functions with projected data, they will warn; this may be upgraded to an error in future versions.
    • The README images are now of beautiful Hyampom, California, a somewhat more appealing vista than the original Mt Marcy scene.
    • The "Import to Unity" vignette has been rewritten to use make_manifest, as has the overview vignette and other documentation.
    • Typos in the message merge_rasters gives when using the fallback method have been fixed.
    • merge_rasters gains an argument force_fallback which, if TRUE, will use the older, slower method for merging tiles. This is not recommended, but is useful for testing.
  • Internal changes:
    • The slow removal of all terrainr_* custom classes marches on! These classes should no longer be present in any user-facing, non-deprecated code; the only functions still relying on custom classes are internal utilities and the split_bbox function responsible for tiling get_tiles requests.
    • split_bbox should now run faster, particularly for large tile sets, as some nested loops have been vectorized.
    • Improvements to test coverage and CI.