GeoSeries

Constructor

GeoSeries(*args, **kwargs)

A Series object designed to store shapely geometry objects.

General methods and attributes

GeoSeries.area

Returns a Series containing the area of each geometry in the GeoSeries.

GeoSeries.bounds

Returns a DataFrame with columns minx, miny, maxx, maxy values containing the bounds for each geometry.

GeoSeries.total_bounds

Returns a tuple containing minx, miny, maxx, maxy values for the bounds of the series as a whole.

GeoSeries.length

Returns a Series containing the length of each geometry.

GeoSeries.geom_type

Returns a Series of strings specifying the Geometry Type of each object.

GeoSeries.distance(self, other)

Returns a Series containing the distance to other.

GeoSeries.representative_point(self)

Returns a GeoSeries of (cheaply computed) points that are guaranteed to be within each geometry.

GeoSeries.exterior

Returns a GeoSeries of LinearRings representing the outer boundary of each polygon in the GeoSeries.

GeoSeries.interiors

Returns a Series of List representing the inner rings of each polygon in the GeoSeries.

GeoSeries.x

Return the x location of point geometries in a GeoSeries

GeoSeries.y

Return the y location of point geometries in a GeoSeries

Unary predicates

GeoSeries.is_empty

Returns a Series of dtype('bool') with value True for empty geometries.

GeoSeries.is_ring

Returns a Series of dtype('bool') with value True for features that are closed.

GeoSeries.is_simple

Returns a Series of dtype('bool') with value True for geometries that do not cross themselves.

GeoSeries.is_valid

Returns a Series of dtype('bool') with value True for geometries that are valid.

GeoSeries.has_z

Returns a Series of dtype('bool') with value True for features that have a z-component.

Binary Predicates

GeoSeries.geom_almost_equals(self, other[, …])

Returns a Series of dtype('bool') with value True if each geometry is approximately equal to other.

GeoSeries.contains(self, other)

Returns a Series of dtype('bool') with value True for each geometry that contains other.

GeoSeries.crosses(self, other)

Returns a Series of dtype('bool') with value True for each geometry that cross other.

GeoSeries.disjoint(self, other)

Returns a Series of dtype('bool') with value True for each geometry disjoint to other.

GeoSeries.geom_equals(self, other)

Returns a Series of dtype('bool') with value True for each geometry equal to other.

GeoSeries.intersects(self, other)

Returns a Series of dtype('bool') with value True for each geometry that intersects other.

GeoSeries.overlaps(self, other)

Returns True for all geometries that overlap other, else False.

GeoSeries.touches(self, other)

Returns a Series of dtype('bool') with value True for each geometry that touches other.

GeoSeries.within(self, other)

Returns a Series of dtype('bool') with value True for each geometry that is within other.

GeoSeries.covers(self, other)

Returns a Series of dtype('bool') with value True for each geometry that is entirely covering other.

GeoSeries.covered_by(self, other)

Returns a Series of dtype('bool') with value True for each geometry that is entirely covered by other.

Set-theoretic Methods

GeoSeries.difference(self, other)

Returns a GeoSeries of the points in each geometry that are not in other.

GeoSeries.intersection(self, other)

Returns a GeoSeries of the intersection of points in each geometry with other.

GeoSeries.symmetric_difference(self, other)

Returns a GeoSeries of the symmetric difference of points in each geometry with other.

GeoSeries.union(self, other)

Returns a GeoSeries of the union of points in each geometry with other.

Constructive Methods and Attributes

GeoSeries.buffer(self, distance[, resolution])

Returns a GeoSeries of geometries representing all points within a given distance of each geometric object.

GeoSeries.boundary

Returns a GeoSeries of lower dimensional objects representing each geometries’s set-theoretic boundary.

GeoSeries.centroid

Returns a GeoSeries of points representing the centroid of each geometry.

GeoSeries.convex_hull

Returns a GeoSeries of geometries representing the convex hull of each geometry.

GeoSeries.envelope

Returns a GeoSeries of geometries representing the envelope of each geometry.

GeoSeries.simplify(self, \*args, \*\*kwargs)

Returns a GeoSeries containing a simplified representation of each geometry.

Affine transformations

GeoSeries.affine_transform(self, matrix)

Return a GeoSeries with translated geometries.

GeoSeries.rotate(self, angle[, origin, …])

Returns a GeoSeries with rotated geometries.

GeoSeries.scale(self[, xfact, yfact, zfact, …])

Returns a GeoSeries with scaled geometries.

GeoSeries.skew(self[, xs, ys, origin, …])

Returns a GeoSeries with skewed geometries.

GeoSeries.translate(self[, xoff, yoff, zoff])

Returns a GeoSeries with translated geometries.

Aggregating methods

GeoSeries.unary_union

Returns a geometry containing the union of all geometries in the GeoSeries.

Reading and writing files

GeoSeries.from_file(filename, \*\*kwargs)

Alternate constructor to create a GeoSeries from a file.

GeoSeries.to_file(self, filename[, driver, …])

Write the GeoSeries to a file.

GeoSeries.to_json(self, \*\*kwargs)

Returns a GeoJSON string representation of the GeoSeries.

Projection handling

GeoSeries.crs

The Coordinate Reference System (CRS) represented as a pyproj.CRS object.

GeoSeries.set_crs(self[, crs, epsg, …])

Set the Coordinate Reference System (CRS) of a GeoSeries.

GeoSeries.to_crs(self[, crs, epsg])

Returns a GeoSeries with all geometries transformed to a new coordinate reference system.

Missing values

GeoSeries.fillna(self[, value, method, inplace])

Fill NA values with a geometry (empty polygon by default).

GeoSeries.isna(self)

Detect missing values.

GeoSeries.notna(self)

Detect non-missing values.

Plotting

GeoSeries.plot(self, \*args, \*\*kwargs)

Plot a GeoSeries.

Spatial index

GeoSeries.sindex

Interface

GeoSeries.__geo_interface__

Returns a GeoSeries as a python feature collection.

Methods of pandas Series objects are also available, although not all are applicable to geometric objects and some may return a Series rather than a GeoSeries result when appropriate. The methods isna() and fillna() have been implemented specifically for GeoSeries and are expected to work correctly.