Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 29 additions & 15 deletions docs/iris/src/whatsnew/1.12.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ What's New in Iris 1.12
***********************

:Release: 1.12
:Date: 2017-01-10
:Date: 2017-01-30

This document explains the new/changed features of Iris in version 1.12
(:doc:`View all changes <index>`.)
Expand All @@ -11,27 +11,29 @@ Iris 1.12 Features
==================
.. _showcase:

.. admonition:: Showcase Feature - New regridding schemes ...
.. admonition:: Showcase Feature: New regridding schemes

A new regridding scheme, :class:`iris.analysis.UnstructuredNearest`,
performs nearest-neighbour regridding from "unstructured" onto "structured" grids.
Here, "unstructured" means that the data has X and Y coordinate values
performs nearest-neighbour regridding from "unstructured" onto "structured"
grids. Here, "unstructured" means that the data has X and Y coordinate values
defined at each horizontal location, instead of the independent X and Y
dimensions that constitute a structured grid.
For example, data sampled on a trajectory or a tripolar ocean grid would be unstructured.
For example, data sampled on a trajectory or a tripolar ocean grid would be
unstructured.

The essential purpose is the same as
:class:`iris.experimental.regrid.ProjectedUnstructuredNearest`.
This scheme, by comparison, is generally more accurate, but slower.
In addition, added experimental ProjectedUnstructured regridders which use
scipy.interpolate.griddata to regrid unstructured data
(see :class:`iris.experimental.regrid.ProjectedUnstructuredLinear` and
:class:`iris.experimental.regrid.ProjectedUnstructuredNearest`). The
essential purpose is the same as :class:`iris.analysis.UnstructuredNearest`.
This scheme, by comparison, is generally faster, but less accurate.

In addition : added experimental ProjectedUnstructured regridders which use scipy.interpolate.griddata to regrid unstructured data (see :class:`iris.experimental.regrid.ProjectedUnstructuredLinear` and :class:`iris.experimental.regrid.ProjectedUnstructuredNearest`)

.. admonition:: Showcase Feature - Fast UM file loading
.. admonition:: Showcase Feature: Fast UM file loading

Support has been added for accelerated loading of UM files (PP and
Fieldsfile), when these have a suitable regular "structured" form.

A context manager is used to enable fast um loading in all the regular iris
A context manager is used to enable fast um loading in all the regular Iris
load functions, such as :meth:`iris.load` and :meth:`iris.load_cube`,
when loading data from UM file types.
For example:
Expand Down Expand Up @@ -102,9 +104,20 @@ Iris 1.12 Features
loaded and returned.
Previously, this simply resulted in an unrecoverable error.

* The transpose method of a Cube now results in a lazy transposed view of the original rather than realising the data then transposing it.
* The transpose method of a Cube now results in a lazy transposed view of the
original rather than realising the data then transposing it.

* The :func:`iris.analysis.cartography.area_weights` function is now more
accurate for single precision input bounds.

* Iris is now able to read seconds in datetimes provided in NAME trajectory
files.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


* Optimisations to trajectory interpolations have resulted in a significant
speed improvement.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


* Many new and updated translations between CF spec and STASH codes.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


* The :func:`iris.analysis.cartography.area_weights` function is now more accurate for single precision input bounds.

Deprecations
============
Expand All @@ -114,4 +127,5 @@ Deprecations

Documentation Changes
=====================
* Corrected documentation of :class:`iris.analysis.AreaWeighted` scheme to make the usage scope clearer.
* Corrected documentation of :class:`iris.analysis.AreaWeighted` scheme to make
the usage scope clearer.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

2 changes: 1 addition & 1 deletion lib/iris/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ def callback(cube, field, filename):


# Iris revision.
__version__ = '1.12.0rc1'
__version__ = '1.12.0'

# Restrict the names imported when using "from iris import *"
__all__ = ['load', 'load_cube', 'load_cubes', 'load_raw',
Expand Down