From 496ac822ca672236b704aad343984138f21c2fb7 Mon Sep 17 00:00:00 2001 From: Peter Killick Date: Wed, 10 Jan 2018 11:53:59 +0000 Subject: [PATCH] Add note on using intersection --- docs/iris/src/userguide/loading_iris_cubes.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/iris/src/userguide/loading_iris_cubes.rst b/docs/iris/src/userguide/loading_iris_cubes.rst index 0a2bef2bf2..ecf5c5caff 100644 --- a/docs/iris/src/userguide/loading_iris_cubes.rst +++ b/docs/iris/src/userguide/loading_iris_cubes.rst @@ -233,6 +233,19 @@ then specific STASH codes can be filtered:: For advanced usage there are further examples in the :class:`iris.Constraint` reference documentation. + +Constraining across the dateline +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Occasionally you may need to constrain your cube with a region that crosses either +the dateline or the meridian. An example use-case of this is to extract the entire +Pacific Ocean from a cube whose longitudes are bounded by the dateline. + +This functionality cannot be provided reliably using contraints. Instead you should use the +functionality provided by :meth:`cube.intersection ` +to extract this region. + + .. _using-time-constraints: Constraining on Time