django.contrib.gis.geos.geometry.GEOSGeometryBase

class documentation

class GEOSGeometryBase(GEOSBase):

Known subclasses: django.contrib.gis.geos.geometry.GEOSGeometry

View In Hierarchy

Undocumented

Class Method from​_gml Undocumented
Static Method from​_ewkt Undocumented
Class Method ​_from​_wkb Undocumented
Static Method ​_from​_wkt Undocumented
Method __and__ Return the intersection of this Geometry and the other.
Method __copy__ Return a clone because the copy of a GEOSGeometry may contain an invalid pointer location if the original is garbage collected.
Method __deepcopy__ The deepcopy routine is used by the Node class of django.utils.tree; thus, the protocol routine needs to be implemented to return correct copies (clones) of these GEOS objects, which use C pointers.
Method __eq__ Equivalence testing, a Geometry may be compared with another Geometry or an EWKT representation.
Method __getstate__ Undocumented
Method __hash__ Undocumented
Method __init__ Undocumented
Method __or__ Return the union of this Geometry and the other.
Method __repr__ Short-hand representation because WKT may be very large.
Method __setstate__ Undocumented
Method __str__ EWKT is used for the string representation.
Method __sub__ Return the difference this Geometry and the other.
Method __xor__ Return the symmetric difference of this Geometry and the other.
Method ​_from​_pickle​_wkb Undocumented
Method ​_ogr​_ptr Undocumented
Method ​_post​_init Perform post-initialization setup.
Method ​_to​_pickle​_wkb Undocumented
Method ​_topology Return Geometry from the given pointer.
Method buffer No summary
Method buffer​_with​_style Same as buffer() but allows customizing the style of the buffer.
Method clone Clone this Geometry.
Method contains Return true if other.within(this) returns true.
Method covers Return True if the DE-9IM Intersection Matrix for the two geometries is T*****FF*, T****FF, **T**FF, or ****T*FF*. If either geometry is empty, return False.
Method crosses Return true if the DE-9IM intersection matrix for the two Geometries is T*T****** (for a point and a curve,a point and an area or a line and an area) 0******** (for two curves).
Method difference Return a Geometry representing the points making up this Geometry that do not make up other.
Method disjoint Return true if the DE-9IM intersection matrix for the two Geometries is FF*FF****.
Method distance Return the distance between the closest points on this Geometry and the other. Units will be in those of the coordinate system of the Geometry.
Method equals Return true if the DE-9IM intersection matrix for the two Geometries is T*F**FFF*.
Method equals​_exact Return true if the two Geometries are exactly equal, up to a specified tolerance.
Method intersection Return a Geometry representing the points shared by this Geometry and other.
Method intersects Return true if disjoint return false.
Method normalize Convert this Geometry to normal form (or canonical form).
Method overlaps Return true if the DE-9IM intersection matrix for the two Geometries is T*T***T** (for two points or two surfaces) 1*T***T** (for two curves).
Method relate Return the DE-9IM intersection matrix for this Geometry and the other.
Method relate​_pattern Return true if the elements in the DE-9IM intersection matrix for the two Geometries match the elements in pattern.
Method simplify Return the Geometry, simplified using the Douglas-Peucker algorithm to the specified tolerance (higher tolerance => less points). If no tolerance provided, defaults to 0.
Method srid.setter Set the SRID for the geometry.
Method sym​_difference Return a set combining the points in this Geometry not in other, and the points in other not in this Geometry.
Method touches Return true if the DE-9IM intersection matrix for the two Geometries is FT*******, F**T***** or F***T****.
Method transform No summary
Method union Return a Geometry representing all the points in this Geometry and other.
Method within Return true if the DE-9IM intersection matrix for the two Geometries is T*F**F***.
Constant ​_GEOS​_CLASSES Undocumented
Class Variable has​_cs Undocumented
Instance Variable __class__ Undocumented
Instance Variable ​_cs Undocumented
Instance Variable ​_ptr Undocumented
Instance Variable ptr Undocumented
Instance Variable srid Get the SRID for the geometry. Return None if no SRID is set.
Property area Return the area of the Geometry.
Property boundary Return the boundary as a newly allocated Geometry object.
Property centroid The centroid is equal to the centroid of the set of component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid).
Property convex​_hull Return the smallest convex Polygon that contains all the points in the Geometry.
Property coord​_seq Return a clone of the coordinate sequence for this Geometry.
Property crs Alias for srs property.
Property dims Return the dimension of this Geometry (0=point, 1=line, 2=surface).
Property empty Return a boolean indicating whether the set of points in this Geometry are empty.
Property envelope Return the envelope for this geometry (a polygon).
Property ewkb Return the EWKB representation of this Geometry as a Python buffer. This is an extension of the WKB specification that includes any SRID value that are a part of this geometry.
Property ewkt Return the EWKT (SRID + WKT) of the Geometry.
Property extent Return the extent of this geometry as a 4-tuple, consisting of (xmin, ymin, xmax, ymax).
Property geom​_type Return a string representing the Geometry type, e.g. 'Polygon'
Property geom​_typeid Return an integer representing the Geometry type.
Property hasz Return whether the geometry has a 3D dimension.
Property hex Return the WKB of this Geometry in hexadecimal form. Please note that the SRID is not included in this representation because it is not a part of the OGC specification (use the hexewkb property instead).
Property hexewkb Return the EWKB of this Geometry in hexadecimal form. This is an extension of the WKB specification that includes SRID value that are a part of this geometry.
Property json Return GeoJSON representation of this Geometry.
Property kml Return the KML representation of this Geometry.
Property length Return the length of this Geometry (e.g., 0 for point, or the circumference of a Polygon).
Property num​_coords Return the number of coordinates in the Geometry.
Property num​_geom Return the number of geometries in the Geometry.
Property num​_points Return the number points, or coordinates, in the Geometry.
Property ogr Return the OGR Geometry for this Geometry.
Property point​_on​_surface Compute an interior point of this Geometry.
Property prepared Return a PreparedGeometry corresponding to this geometry -- it is optimized for the contains, intersects, and covers operations.
Property ring Return whether or not the geometry is a ring.
Property simple Return false if the Geometry isn't simple.
Property srs Return the OSR SpatialReference for SRID of this Geometry.
Property unary​_union Return the union of all the elements of this geometry.
Property valid Test the validity of this Geometry.
Property valid​_reason Return a string containing the reason for any invalidity.
Property wkb Return the WKB (Well-Known Binary) representation of this Geometry as a Python buffer. SRID and Z values are not included, use the ewkb property instead.
Property wkt Return the WKT (Well-Known Text) representation of this Geometry.

Inherited from CPointerBase (via GEOSBase):

Method __del__ Free the memory used by the C++ object.
Method ptr.setter Undocumented
Class Variable destructor Undocumented
@classmethod
def from_gml(cls, gml_string):

Undocumented

@staticmethod
def from_ewkt(ewkt):

Undocumented

@classmethod
def _from_wkb(cls, wkb):

Undocumented

@staticmethod
def _from_wkt(wkt):

Undocumented

def __and__(self, other):
Return the intersection of this Geometry and the other.
def __copy__(self):
Return a clone because the copy of a GEOSGeometry may contain an invalid pointer location if the original is garbage collected.
def __deepcopy__(self, memodict):
The deepcopy routine is used by the Node class of django.utils.tree; thus, the protocol routine needs to be implemented to return correct copies (clones) of these GEOS objects, which use C pointers.
def __eq__(self, other):
Equivalence testing, a Geometry may be compared with another Geometry or an EWKT representation.
def __getstate__(self):

Undocumented

def __hash__(self):

Undocumented

def __init__(self, ptr, cls):
overridden in django.contrib.gis.geos.geometry.GEOSGeometry

Undocumented

def __or__(self, other):
Return the union of this Geometry and the other.
def __repr__(self):
Short-hand representation because WKT may be very large.
def __setstate__(self, state):

Undocumented

def __str__(self):
EWKT is used for the string representation.
def __sub__(self, other):
Return the difference this Geometry and the other.
def __xor__(self, other):
Return the symmetric difference of this Geometry and the other.
def _from_pickle_wkb(self, wkb):
overridden in django.contrib.gis.geos.point.Point

Undocumented

def _ogr_ptr(self):
overridden in django.contrib.gis.geos.point.Point

Undocumented

def _post_init(self):
Perform post-initialization setup.
def _to_pickle_wkb(self):
overridden in django.contrib.gis.geos.point.Point

Undocumented

def _topology(self, gptr):
Return Geometry from the given pointer.
def buffer(self, width, quadsegs=8):
Return a geometry that represents all points whose distance from this Geometry is less than or equal to distance. Calculations are in the Spatial Reference System of this Geometry. The optional third parameter sets the number of segment used to approximate a quarter circle (defaults to 8). (Text from PostGIS documentation at ch. 6.1.3)
def buffer_with_style(self, width, quadsegs=8, end_cap_style=1, join_style=1, mitre_limit=5.0):

Same as buffer() but allows customizing the style of the buffer.

End cap style can be round (1), flat (2), or square (3). Join style can be round (1), mitre (2), or bevel (3). Mitre ratio limit only affects mitered join style.

def clone(self):
Clone this Geometry.
def contains(self, other):
Return true if other.within(this) returns true.
def covers(self, other):
Return True if the DE-9IM Intersection Matrix for the two geometries is T*****FF*, T****FF, **T**FF, or ****T*FF*. If either geometry is empty, return False.
def crosses(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is T*T****** (for a point and a curve,a point and an area or a line and an area) 0******** (for two curves).
def difference(self, other):
Return a Geometry representing the points making up this Geometry that do not make up other.
def disjoint(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is FF*FF****.
def distance(self, other):
Return the distance between the closest points on this Geometry and the other. Units will be in those of the coordinate system of the Geometry.
def equals(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is T*F**FFF*.
def equals_exact(self, other, tolerance=0):
Return true if the two Geometries are exactly equal, up to a specified tolerance.
def intersection(self, other):
Return a Geometry representing the points shared by this Geometry and other.
def intersects(self, other):
Return true if disjoint return false.
def normalize(self):
Convert this Geometry to normal form (or canonical form).
def overlaps(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is T*T***T** (for two points or two surfaces) 1*T***T** (for two curves).
def relate(self, other):
Return the DE-9IM intersection matrix for this Geometry and the other.
def relate_pattern(self, other, pattern):
Return true if the elements in the DE-9IM intersection matrix for the two Geometries match the elements in pattern.
def simplify(self, tolerance=0.0, preserve_topology=False):

Return the Geometry, simplified using the Douglas-Peucker algorithm to the specified tolerance (higher tolerance => less points). If no tolerance provided, defaults to 0.

By default, don't preserve topology - e.g. polygons can be split, collapse to lines or disappear holes can be created or disappear, and lines can cross. By specifying preserve_topology=True, the result will have the same dimension and number of components as the input. This is significantly slower.

@srid.setter
def srid(self, srid):
Set the SRID for the geometry.
def sym_difference(self, other):
Return a set combining the points in this Geometry not in other, and the points in other not in this Geometry.
def touches(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is FT*******, F**T***** or F***T****.
def transform(self, ct, clone=False):
Requires GDAL. Transform the geometry according to the given transformation object, which may be an integer SRID, and WKT or PROJ string. By default, transform the geometry in-place and return nothing. However if the clone keyword is set, don't modify the geometry and return a transformed clone instead.
def union(self, other):
Return a Geometry representing all the points in this Geometry and other.
def within(self, other):
Return true if the DE-9IM intersection matrix for the two Geometries is T*F**F***.
_GEOS_CLASSES =

Undocumented

Value
None
has_cs: bool =
overridden in django.contrib.gis.geos.linestring.LineString, django.contrib.gis.geos.point.Point

Undocumented

__class__ =

Undocumented

_cs =

Undocumented

_ptr =
overrides django.contrib.gis.ptr.CPointerBase._ptr
overridden in django.contrib.gis.geos.point.Point

Undocumented

ptr =
overrides django.contrib.gis.ptr.CPointerBase.ptr
overridden in django.contrib.gis.geos.collections.GeometryCollection, django.contrib.gis.geos.linestring.LineString, django.contrib.gis.geos.polygon.Polygon

Undocumented

@property
srid =
overridden in django.contrib.gis.geos.geometry.GEOSGeometry
Get the SRID for the geometry. Return None if no SRID is set.
@property
area =
Return the area of the Geometry.
@property
boundary =
Return the boundary as a newly allocated Geometry object.
@property
centroid =
The centroid is equal to the centroid of the set of component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid).
@property
convex_hull =
Return the smallest convex Polygon that contains all the points in the Geometry.
@property
coord_seq =
Return a clone of the coordinate sequence for this Geometry.
@property
crs =
Alias for srs property.
@property
dims =
Return the dimension of this Geometry (0=point, 1=line, 2=surface).
@property
empty =
Return a boolean indicating whether the set of points in this Geometry are empty.
@property
envelope =
Return the envelope for this geometry (a polygon).
@property
ewkb =
Return the EWKB representation of this Geometry as a Python buffer. This is an extension of the WKB specification that includes any SRID value that are a part of this geometry.
@property
ewkt =
Return the EWKT (SRID + WKT) of the Geometry.
@property
extent =
Return the extent of this geometry as a 4-tuple, consisting of (xmin, ymin, xmax, ymax).
@property
geom_type =
Return a string representing the Geometry type, e.g. 'Polygon'
@property
geom_typeid =
Return an integer representing the Geometry type.
@property
hasz =
Return whether the geometry has a 3D dimension.
@property
hex =
Return the WKB of this Geometry in hexadecimal form. Please note that the SRID is not included in this representation because it is not a part of the OGC specification (use the hexewkb property instead).
@property
hexewkb =
Return the EWKB of this Geometry in hexadecimal form. This is an extension of the WKB specification that includes SRID value that are a part of this geometry.
@property
json =
Return GeoJSON representation of this Geometry.
@property
kml =
overridden in django.contrib.gis.geos.collections.GeometryCollection, django.contrib.gis.geos.polygon.Polygon
Return the KML representation of this Geometry.
@property
length =
Return the length of this Geometry (e.g., 0 for point, or the circumference of a Polygon).
@property
num_coords =
Return the number of coordinates in the Geometry.
@property
num_geom =
Return the number of geometries in the Geometry.
@property
num_points =
Return the number points, or coordinates, in the Geometry.
@property
ogr =
Return the OGR Geometry for this Geometry.
@property
point_on_surface =
Compute an interior point of this Geometry.
@property
prepared =
Return a PreparedGeometry corresponding to this geometry -- it is optimized for the contains, intersects, and covers operations.
@property
ring =
Return whether or not the geometry is a ring.
@property
simple =
Return false if the Geometry isn't simple.
@property
srs =
Return the OSR SpatialReference for SRID of this Geometry.
@property
unary_union =
Return the union of all the elements of this geometry.
@property
valid =
Test the validity of this Geometry.
@property
valid_reason =
Return a string containing the reason for any invalidity.
@property
wkb =
Return the WKB (Well-Known Binary) representation of this Geometry as a Python buffer. SRID and Z values are not included, use the ewkb property instead.
@property
wkt =
Return the WKT (Well-Known Text) representation of this Geometry.