Rasterio

-------------------

I played a lot of One-on-One on the computers of the mid-1980s and dedicate
this release to the best 33 of all time, Larry Bird.

- Bug fix: YCbCr JPEG-in-TIFF files no longer break rio-info (617, 618).
- New feature: the ability to read dataset metadata and imagery from S3 objects
is an extra feature that can be installed like this `pip install -U
rasterio[s3]`. AWS Credentials are handled by boto3 (and botocore) and so can
be provided by environment variables, session arguments, `~/.aws/credentials`
file, or EC2 instance metadata. S3 access is enabled in the following CLI
commands: rio-clip, rio-info, rio-insp, rio-bounds, rio-shapes, rio-sample
and may be expanded in future versions. S3 objects are identified on the
command line and in API functions by URIs following the pattern
`s3://bucket/object`. Extra thanks to Rob Emanuele and Even Rouault for
helping on this one (551, 610).
- New feature: new and improved documentation coming soon to a website near
you (588).
- Refactoring: commands for the rio CLI have been moved to their own
modules so that they're easier to find (594).
- Refactoring: we've changed our primary pattern for checking errors set by
GDAL API functions (600).

-------------------------
- No changes to the library in this post-release version, but there is a
significant change to the distributions on PyPI: to help make Rasterio more
compatible with Shapely on OS X, the GDAL shared library included in the
macosx (only) binary wheels now statically links the GEOS library. See
https://github.com/sgillies/frs-wheel-builds/issues/5.

-------------------
- Bug fix: geometry factories and warp operations are properly deallocated
in normal and error situations (494, 568).
- Bug fix: a code block in rio-merge's help has been better formatted (535).
- Bug fix: the rasterio.vfs module is imported in __init__.py to assist
cx_Freeze (536).
- Bug fix: old usage of `read_band()` has been replaced by `read()` throughout
the docs (537).
- Bug fix: accidental overwriting of existing files is now prevented by the
`resolve_inout()` function in `rasterio.rio.helpers`. Commands that take
one or more input files plus an output file should use this helper and force
overwrite either by using a `--force-overwrite` option or by using the
`-o output` option, which implicitly forces overwriting (539, 540).
- Bug fix: missing support for NaN nodata value in rio-warp added (542, 544).
- Bug fix: missing documentation of `rasterize()`'s `fill` parameter added
(543).
- Bug fix: raster dataset bounds are densified before transforming so that
the projected output of rio-bounds is correct (556, 557).
- Bug fix: add 'line' to the `Interleaving` enum (560).
- Bug fix: convert `matplotlib` import errors to a `RuntimeWarning` (562).
- Bug fix: deallocate CPL strings in error cases (573).
- Bug fix: non-invertable affine transforms are prevented using
`__future__.division` *580).
- Bug fix: rio-warp clips output regions to the limits of the destination
CRS unless disabled with `--no-check-invert-proj` (597).
- New feature: the functionality previously available only in rio-mask is now
available as `rasterio.tools.mask.mask()` (552).
- New feature: raster bounds are used to label axes in `rasterio.tool.show()`
(553).
- New feature: GDAL's suggested warp bounds algorithm is wrapped and exposed
for use in `warp()` and rio-warp (574).
- Breaking change: align rio-warp's `--bounds` option with rio-merge's: these
are in destination CRS units (541, 545).

-------------------
- Warn when rasters have no georeferencing and when the default identity
transform will be applied by GDAL (524, 527).
- Build OS X wheels using numpy>=1.10.2 (529).
- When reading image windows in previous versions, given a window with
((row_start, row_stop), (col_start, col_stop)) if the stop index is greater
than the width/height the start index effectively shifts as well. This can
manifest itself in pixel misalignment if, e.g. you read block windows with
a bit of padding to avoid edge effects. Now the window offsets are determined
solely by row_start and col_start.(532, 533).

-------------------
- Added window utilities: get_data_window(), window_union(),
window_intersection(), windows_intersect() (496, 506).
- Warn when an alpha band that might provide a dataset mask is shadowed by a
nodata attribute (508, 523).
- IPython is not the default interpreter for rio-insp and the documentation
saying it is has been corrected (518).
- Guard against creating datasets with block sizes larger than the dataset
width and height. Such datasets are semi-broken and are likely to be
mangled when read (521).
- Refactor of the `rasterio.features` tests (522).

-------------------
- Fill masked arrays in rio-calc when using Numpy 1.10.x as well as with 1.8.x
(500).
- When a raster dataset is not tiled, blockxsize and blockysize items are no
longer included in its `profile` property. This prevents meaningless block
size parameters from stripped, not tiled, datasets from being used when
creating new datasets (503).