affine

The single file module affine.py has been moved to affine/__init__.py so that a py.typed file can be distributed in the same directory (#136).

3.0rc1 tagged the wrong commit. The distributions on PyPI have the correct version, but the GitHub release does not. This is fixed by 3.0rc2, which makes no other changes.

This is the first 3.0 release candidate. There are no significant changes since 3.0b1.

The second 3.0 pre-release has a single bug fix. Matrix multiplication with tuples of coordinate matrices, like the output of numpy.meshgrid(), was broken in 3.0a1. It has been restored (#126).

This is the first pre-release of Affine version 3.0. There is one major, potentially breaking change: the Affine class is no longer a named tuple, and is no longer serializable to JSON without an adapter of some kind. That said, Rasterio 1.4 needed only minor changes to work with Affine 3.0, and we hope that other projects are similarly easy to update.

New features

• Type hint annotations for functions and methods are complete (#121).
• Affine raises ValueError if initialized with values for g, h, and i that are not 0.0, 0.0, and 1.0, respectively (#117).
• Python version support was changed to 3.9+ (#110).
• Switch from namedtuple to attrs for implementation of the Affine class and use functools.cached_property(), which absolutely requires Python 3.8 (#111).
• Source was moved to a single-module affine.py in the src directory (#112).
• Add numpy __array__() interface (#108).
• Add support for @ matrix multiplier methods (#122).

• Package is marked as Python 3 only, two instances of "%" string formatting are replaced by f-strings (#96).

• Elimination of Python 2/3 compatibility code in gt (#94).
• Addition of optional keyword arguments for new, solving an issue with Dask (#92).
• Addition of some type hints for float arguments and return types (#87).
• Python version support is now 3.7-3.11 (#82).
• Faster new and from_gdal methods (#78).

Bug fixes:

• Return NotImplemented for both ValueError and TypeError in mul to support fallback to rmul in more cases (gh-71).

Deprecations:

• Right multiplication like vector * matrix is deprecated and will raise AffineError in version 3.0.0.

Bug fixes:

• Change signature of Affine constructor to help users of PyCharm (#45).
• The Affine class docstring has been improved.

• Affine.itransform computed the wrong results for arrays with rotation or shear (#40). This is fixed (#41).

• Docstring improvements (#37).

• Addition of permutation matrix (#35).

• Addition of new eccentricity and rotation_angle properties (#28).

• This is the final 2.0.0 release. The post-release version segment is used because we accidentally uploaded a 2.0.0 to PyPI before the beta releases below.

• Bug fix: restore Affine __rmul__ even though it permits dubious vector * matrix expressions (#27).

• Breaking change: precision used in properties like is_conformal is no longer a global module attribute, but an Affine class or instance attribute (#19, #20).
• Breaking change: is_degenerate property is now exact and not subject to a level of precision (#23).
• Breaking change: we have reversed our sense of rotation, a positive angle now rotates a point counter-clockwise about the pivot point (#25).
• Bug fix: a bug in matrix-vector multiplication had been reversing the direction of rotation and is now fixed (#25).

• is_degenerate predicate is precise, not approximate (#22).

• Enable pickling of Affine objects (#14).
• Sort out the mixed up shearing parameters (#12).

• Add loadsw/dumpsw world file utilities (#6).
• Travis-CI and Coveralls config and web hooks added (#10).

• set_epsilon() now actually sets module EPSILON (#4).
• add AUTHORS.txt.

• Code ported from Casey Duncan's Planar package.
• from_gdal() class method added.