allow the passing of options to RasterBand

[scottstanie]

These get passed to rasterio.open(...)

See https://github.com/rasterio/rasterio/blob/5e001a08beb747fef0b60b5ccdbf2e5a08da7e05/docs/topics/image_options.rst#creation-options, or the driver specific options on the GDAL documentation (e.g. https://gdal.org/drivers/raster/gtiff.html)

Example usage:

In dolphin, I've got default creation options for the GTiff and ENVI drivers. These would get converted to rasterio-compatible ones with something like

gtiff_options = dict(opt.lower().split("=") for opt in io.DEFAULT_TIFF_OPTIONS)`
#  {'compress': 'deflate', 'zlevel': '4', 'tiled': 'yes', 'blockxsize': '128', 'blockysize': '128'}

then my RasterBand creation could be

unw_rb = RasterBand(
    unw_filename,
    height=height,
    width=width,
    dtype=np.float32,
    crs=crs,
    transform=transform,
    **gtiff_options,
)

[codecov]

Codecov Report

Merging #36 (e0de066) into main (d583e6d) will not change coverage.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main      #36   +/-   ##
=======================================
  Coverage   97.86%   97.86%           
=======================================
  Files           9        9           
  Lines         797      797           
=======================================
  Hits          780      780           
  Misses         17       17           

Files	Coverage Δ
src/tophu/_io.py	96.93% <100.00%> (ø)
src/tophu/_multiscale.py	96.36% <ø> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[gmgunter]

Thanks, this seems like a very useful addition

[gmgunter]

LGTM, thanks!