GeoSeries

Constructor

GeoSeries([data, index, crs])

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 expressed in the units of the CRS.

GeoSeries.boundary

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

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 expressed in the units of the CRS.

GeoSeries.geom_type

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

GeoSeries.distance(other[, align])

Returns a Series containing the distance to aligned other.

GeoSeries.representative_point()

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

GeoSeries.z

Return the z 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.contains(other[, align])

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

GeoSeries.crosses(other[, align])

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

GeoSeries.disjoint(other[, align])

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

GeoSeries.geom_equals(other[, align])

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

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

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

GeoSeries.geom_equals_exact(other, tolerance)

Return True for all geometries that equal aligned other to a given tolerance, else False.

GeoSeries.intersects(other[, align])

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

GeoSeries.overlaps(other[, align])

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

GeoSeries.touches(other[, align])

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

GeoSeries.within(other[, align])

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

GeoSeries.covers(other[, align])

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

GeoSeries.covered_by(other[, align])

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

Set-theoretic Methods

GeoSeries.clip_by_rect(xmin, ymin, xmax, ymax)

Returns a GeoSeries of the portions of geometry within the given rectangle.

GeoSeries.difference(other[, align])

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

GeoSeries.intersection(other[, align])

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

GeoSeries.symmetric_difference(other[, align])

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

GeoSeries.union(other[, align])

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

Constructive Methods and Attributes

GeoSeries.buffer(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(*args, **kwargs)

Returns a GeoSeries containing a simplified representation of each geometry.

Affine transformations

GeoSeries.affine_transform(matrix)

Return a GeoSeries with translated geometries.

GeoSeries.rotate(angle[, origin, use_radians])

Returns a GeoSeries with rotated geometries.

GeoSeries.scale([xfact, yfact, zfact, origin])

Returns a GeoSeries with scaled geometries.

GeoSeries.skew([xs, ys, origin, use_radians])

Returns a GeoSeries with skewed geometries.

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

Returns a GeoSeries with translated geometries.

Aggregating and exploding

GeoSeries.unary_union

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

GeoSeries.explode([ignore_index, index_parts])

Explode multi-part geometries into multiple single geometries.

Serialization / IO / conversion

GeoSeries.from_file(filename, **kwargs)

Alternate constructor to create a GeoSeries from a file.

GeoSeries.from_wkb(data[, index, crs])

Alternate constructor to create a GeoSeries from a list or array of WKB objects

GeoSeries.from_wkt(data[, index, crs])

Alternate constructor to create a GeoSeries from a list or array of WKT objects

GeoSeries.from_xy(x, y[, z, index, crs])

Alternate constructor to create a GeoSeries of Point geometries from lists or arrays of x, y(, z) coordinates

GeoSeries.to_file(filename[, driver, index])

Write the GeoSeries to a file.

GeoSeries.to_json(**kwargs)

Returns a GeoJSON string representation of the GeoSeries.

GeoSeries.to_wkb([hex])

Convert GeoSeries geometries to WKB

GeoSeries.to_wkt(**kwargs)

Convert GeoSeries geometries to WKT

Projection handling

GeoSeries.crs

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

GeoSeries.set_crs([crs, epsg, inplace, ...])

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

GeoSeries.to_crs([crs, epsg])

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

GeoSeries.estimate_utm_crs([datum_name])

Returns the estimated UTM CRS based on the bounds of the dataset.

Missing values

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

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

GeoSeries.isna()

Detect missing values.

GeoSeries.notna()

Detect non-missing values.

Overlay operations

GeoSeries.clip(mask[, keep_geom_type])

Clip points, lines, or polygon geometries to the mask extent.

Plotting

GeoSeries.plot(*args, **kwargs)

Plot a GeoSeries.

GeoSeries.explore(*args, **kwargs)

Interactive map based on folium/leaflet.jsInteractive map based on GeoPandas and folium/leaflet.js

Spatial index

GeoSeries.sindex

Generate the spatial index

GeoSeries.has_sindex

Check the existence of the spatial index without generating it.

Indexing

GeoSeries.cx

Coordinate based indexer to select by intersection with bounding box.

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.