From ccc8f67b7760dd12faf6007f12a672a8e03f4d88 Mon Sep 17 00:00:00 2001 From: Sergey Fedoseev Date: Fri, 20 Nov 2015 15:11:25 +0500 Subject: Fixed #25722 -- Added the GEOSGeometry.covers() method. --- docs/ref/contrib/gis/geos.txt | 22 ++++++++++++++++++++++ docs/releases/1.10.txt | 3 +++ 2 files changed, 25 insertions(+) (limited to 'docs') diff --git a/docs/ref/contrib/gis/geos.txt b/docs/ref/contrib/gis/geos.txt index fffaf61fe7..43727a1ed7 100644 --- a/docs/ref/contrib/gis/geos.txt +++ b/docs/ref/contrib/gis/geos.txt @@ -349,6 +349,28 @@ return a boolean. Returns ``True`` if :meth:`other.within(this) ` returns ``True``. +.. method:: GEOSGeometry.covers(other) + +.. versionadded:: 1.10 + +Returns ``True`` if this geometry covers the specified geometry. + +The ``covers`` predicate has the following equivalent definitions: + +* Every point of the other geometry is a point of this geometry. +* The DE-9IM Intersection Matrix for the two geometries is + ``T*****FF*``, ``*T****FF*``, ``***T**FF*``, or ``****T*FF*``. + +If either geometry is empty, returns ``False``. + +This predicate is similar to :meth:`GEOSGeometry.contains`, but is more +inclusive (i.e. returns ``True`` for more cases). In particular, unlike +:meth:`~GEOSGeometry.contains` it does not distinguish between points in the +boundary and in the interior of geometries. For most situations, ``covers()`` +should be preferred to :meth:`~GEOSGeometry.contains`. As an added benefit, +``covers()`` is more amenable to optimization and hence should outperform +:meth:`~GEOSGeometry.contains`. + .. method:: GEOSGeometry.crosses(other) Returns ``True`` if the DE-9IM intersection matrix for the two Geometries diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt index 9eb6e1d93a..26e8849f3f 100644 --- a/docs/releases/1.10.txt +++ b/docs/releases/1.10.txt @@ -71,6 +71,9 @@ Minor features ` property computes the union of all the elements of this geometry. +* Added the :meth:`GEOSGeometry.covers() + ` binary predicate. + :mod:`django.contrib.messages` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- cgit v1.3