Scitools-iris

==========================

* Saving multiple cubes to netcdf
https://github.com/SciTools/iris/pull/367

* Rework Coord nearest_neighbour to support circular cases
https://github.com/SciTools/iris/pull/391

* Simplified resource configuration
https://github.com/SciTools/iris/pull/406

* Helper function for regridding that returns x and y coords
https://github.com/SciTools/iris/pull/437

* Added iris.tests.assertArrayAllClose
https://github.com/SciTools/iris/pull/440

* Add bilinear interpolation between rectilinear grids.
https://github.com/SciTools/iris/pull/442

* Added tolerances to Coord.is_contiguous()
https://github.com/SciTools/iris/pull/459

* Pandas interoperability
https://github.com/SciTools/iris/pull/439

* Nimrod level type 12 (below ground)
https://github.com/SciTools/iris/pull/199

* Modified logic in Unit.convert to handle numpy scalars
https://github.com/SciTools/iris/pull/472

* Experimental OPeNDAP functionality.
https://github.com/SciTools/iris/pull/422

* Experimental GeoTiff export functionality:
`iris.experimental.raster.export_geotiff`

* Added a PEP8 test to ensure coding standards
https://github.com/SciTools/iris/pull/476

* Add licence header check to tests
https://github.com/SciTools/iris/issues/454

* Cube merge string coords.
https://github.com/SciTools/iris/pull/475

* Unambiguous season year naming
https://github.com/SciTools/iris/pull/490

* Area weighted regridding
https://github.com/SciTools/iris/pull/464

* Removal of strict constraint in izip().
https://github.com/SciTools/iris/pull/495

* PP save with no time forecast.
https://github.com/SciTools/iris/pull/498

* Load of nimrod files with multiple fields and period of interest
https://github.com/SciTools/iris/pull/507

* Conservative regridding, preserving area sums
https://github.com/SciTools/iris/pull/453

* Handle missing values from grib messages
https://github.com/SciTools/iris/pull/520

* PP export rule to calculate forecast period
https://github.com/SciTools/iris/pull/514

* Preserve masked arrays during aggregation
https://github.com/SciTools/iris/pull/527

* Support for ieee 32bit fieldsfiles to iris.load
https://github.com/SciTools/iris/pull/297

* NetCDF load support for transverse Mercator and climatology
https://github.com/SciTools/iris/pull/521

* Polar stereo grib loading
https://github.com/SciTools/iris/pull/518

* GRIB export of cubes with no vertical information
See https://github.com/SciTools/iris/issues/519 for ongoing discussion

* GRIB2 parameter translation
https://github.com/SciTools/iris/pull/482

* Added depth rules for bounds
https://github.com/SciTools/iris/pull/451

* Added a test for license checking of code files
https://github.com/SciTools/iris/pull/477

* Fixed netcdf save cubelist bug
https://github.com/SciTools/iris/pull/488

* Add an optimisation for single valued coordinate constraints
https://github.com/SciTools/iris/pull/428

* Improved error message within Cube.aggregated_by()
https://github.com/SciTools/iris/pull/504

* Change unit print-out
https://github.com/SciTools/iris/pull/465

* Modified linear() to handle non-scalar length one coords
https://github.com/SciTools/iris/pull/508

* Propagate all coord names in construct midpoint
https://github.com/SciTools/iris/pull/499

* Resolved pickling issues with deferred loading
https://github.com/SciTools/iris/pull/511

* Modified plot.py to pass coords arg through to _map_common()
https://github.com/SciTools/iris/pull/463

* Use cartopy v0.8.0
https://github.com/SciTools/iris/pull/494


Incompatible changes
--------------------
* As part of simplifying the mechanism for accessing test data
`iris.io.select_data_path()`, `iris.config.DATA_REPOSITORY`,
`iris.config.MASTER_DATA_REPOSITORY` and
`iris.config.RESOURCE_DIR` have been removed.

Deprecations
------------
* The *add_custom_season_** functions from coord_categorisation.py have been deprecated in favour of adding their functionality to the *add_season_** functions



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

===========================

Features added
--------------
* Experimental support for loading ABF/ABL files.
* Support in `iris.analysis.interpolate.linear` for longitude ranges
other than [-180, 180].
* Support for customised CF profiles on export to netCDF.
* The documentation now includes guidance on how to cite Iris.
* The ability to calculate the exponential of a Cube, via
`iris.analysis.maths.exp()`.
* Experimental support for concatenating Cubes along existing dimensions
via `iris.experimental.concatenate.concatenate()`.

Bugs fixed
----------
* Printing a Cube now supports Unicode attribute values.
* PP export now sets LBMIN correctly.
* Converting between reference times now works correctly for
units with non-Gregorian calendars.
* Slicing a CubeList now returns a CubeList instead of a normal list.

Incompatible changes
--------------------
* N/A

Deprecations
------------
* The boolean methods/properties on the `Unit` class have been updated
to `is_...()` methods, in line with the project's naming conventions.

========================== ======================
Deprecated property/method New method
========================== ======================
convertible() is_convertible()
dimensionless is_dimensionless()
no_unit is_no_unit()
time_reference is_time_reference()
unknown is_unknown()
========================== ======================


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

==========================


Features added
--------------
* :meth:`iris.cube.Cube.convert_units()` and
:meth:`iris.coords.Coord.convert_units()` have been added for straightforward
conversion of cubes and coordinates from one unit to another.
* :attr:`iris.cube.Cube.var_name`, :attr:`iris.coords.Coord.var_name` and
:attr:`iris.aux_factory.AuxCoordFactory.var_name` attributes have been added.
This attribute represents the CF variable name of the object. It is populated
when loading from CF-netCDF files and is used when writing to CF-netCDF. A
var_name keyword argument has also been added to the
:meth:`iris.cube.Cube.coord()`, :meth:`iris.cube.Cube.coords()` and
:meth:`iris.cube.Cube.aux_factory()` methods.
* :meth:`iris.coords.Coord.is_compatible()` has been added. This method is
used to determine whether two coordinates are sufficiently alike to
allow operations such as :meth:`iris.coords.Coord.intersect()` and
:func:`iris.analysis.interpolate.regrid()` to take place. A corresponding
method for cubes, :meth:`iris.cube.Cube.is_compatible()`, has also been
added.
* Printing a :class:`~iris.cube.Cube` is now more user friendly with regards
to dates and time. All *time* and *forecast_reference_time* scalar coordinates
now display human readable date/time information.
* The units of a :class:`~iris.cube.Cube` are now shown when it is printed.
* The area weights calculated by :func:`iris.analysis.cartography.area_weights`
may now be normalised relative to the total grid area.
* Weights may now be passed to :meth:`iris.cube.Cube.rolling_window` aggregations,
thus allowing arbitrary digital filters to be applied to a :class:`~iris.cube.Cube`.

Bugs fixed
----------
* The GRIB hindcast interpretation of negative forecast times can be enabled
via the :data:`iris.fileformats.grib.hindcast_workaround` flag.
* The NIMROD file loader has been extended to cope with orography vertical
coordinates.

Incompatible changes
--------------------
* The deprecated :attr:`iris.cube.Cube.unit` and :attr:`iris.coords.Coord.unit`
attributes have been removed.

Deprecations
------------
* The :meth:`iris.coords.Coord.unit_converted()` method has been deprecated.
Users should make a copy of the coordinate using
:meth:`iris.coords.Coord.copy()` and then call the
:meth:`iris.coords.Coord.convert_units()` method of the new coordinate.
* With the addition of the var_name attribute the signatures of DimCoord and
AuxCoord have changed. This should have no impact if you are providing
parameters as keyword arguments, but it may cause issues if you are relying
on the position/order of the arguments.
* Iteration over a :class:`~iris.cube.Cube` has been deprecated. Instead,
users should use :meth:`iris.cube.Cube.slices`.


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

=========================


Features added
--------------
* Support for Mac OS X.
* GRIB1 import now supports time units of "3 hours".
* Fieldsfile import now supports unpacked and "CRAY" 32-bit packed data
in 64-bit Fieldsfiles.
* PP file import now supports "CRAY" 32-bit packed data.
* Various performance improvements, particularly for netCDF import,
PP import, and constraints.
* GRIB2 export now supports level types of altitude and height
(codes 102 and 103).
* iris.analysis.cartography.area_weights now supports non-standard
dimension orders.
* PP file import now adds the "forecast_reference_time" for fields
where LBTIM is 11, 12, 13, 31, or 32.
* PP file import now supports LBTIM values of 1, 2, and 3.
* Fieldsfile import now has some support for ancillary files.
* Coordinate categorisation functions added for day-of-year and
user-defined seasons.
* GRIB2 import now has partial support for probability data defined
with product template 4.9.

Bugs fixed
----------
* PP export no longer attempts to set/overwrite the STASH code based on
the standard_name.
* Cell comparisons now work consistently, which fixes a bug where
bounded_cell > point_cell compares the point to the bounds but,
point_cell < bounded_cell compares the points.
* Fieldsfile import now correctly recognises pre v3.1 and post v5.2
versions, which fixes a bug where the two were interchanged.
* iris.analysis.trajectory.interpolate now handles hybrid-height.

Incompatible changes
--------------------
* N/A

Deprecations
------------
* N/A


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

==========================

Features added
--------------
* Iris can now represent hybrid-pressure vertical coordinates, and load
them from GRIB files.
* Initial support for CF-style coordinate systems: lat-lon, rotated lat-lon,
and transverse Mercator (incl. OSGB).
* Iris can now load NIMROD files.
* Availability of Cynthia Brewer colour palettes.
* Add a citation to a plot.
* Readability improvements to Cube summary.
* Ensures netCDF files are properly closed.
* A more explicit set of load functions, which also allow the automatic
cube merging to be bypassed as a last resort.
* Save netCDF files with an unlimited dimension.
* The ability to project a cube with a lat-lon or rotated lat-lon coordinate
system into a range of map projections e.g. Polar Stereographic.

Incompatible changes
--------------------
* The "source" and "history" metadata are now represented as Cube
attributes, where previously they used coordinates.
* With the change to cartopy, the function iris.plot.gcm() is obsolete
and has been removed.
* Three functions have been removed from iris.analysis.cartography:
lat_lon_range(), get_lat_lon_grids(), and
get_lat_lon_contiguous_grids(). They have been replaced with
generalised versions: get_xy_grids()
and get_xy_contiguous_bounded_grids().
* iris.plot.gcm, iris.plot.map_setup functions are now removed as part
of the change to using cartopy. See the "what's new" section for further
information on working with cartopy.
* The method `Cube.coord_dims()` now returns a tuple instead of a list.

Deprecations
------------
* The methods `Coord.cos()` and `Coord.sin()` have been deprecated.
* The function `load_strict()` has been deprecated. Code should now use
`iris.load_cube()` and `iris.load_cubes()` instead.


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

============================

Features added
--------------
* Fixed an issue with netCDF loading that failed to close file handles.

Incompatible changes
--------------------
* None

Deprecations
------------
* None


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