code: from warnings import warn
  
  import numpy as np
  import pandas as pd
  from pandas import DataFrame, Series
  
  from shapely.geometry import box
  from shapely.geometry.base import BaseGeometry
  from shapely.ops import cascaded_union
  
  from .array import GeometryArray, GeometryDtype
  
  
  def is_geometry_type(data):
      """
      Check if the data is of geometry dtype.
  
      Does not include object array of shapely scalars.
      """
      if isinstance(getattr(data, "dtype", None), GeometryDtype):
          # GeometryArray, GeoSeries and Series[GeometryArray]
          return True
      else:
          return False
  
  
  def _delegate_binary_method(op, this, other, align, *args, **kwargs):
      # type: (str, GeoSeries, GeoSeries) -> GeoSeries/Series
      this = this.geometry
      if isinstance(other, GeoPandasBase):
          if align and not this.index.equals(other.index):
              warn("The indices of the two GeoSeries are different.")
              this, other = this.align(other.geometry)
          else:
              other = other.geometry
  
          a_this = GeometryArray(this.values)
          other = GeometryArray(other.values)
      elif isinstance(other, BaseGeometry):
          a_this = GeometryArray(this.values)
      else:
          raise TypeError(type(this), type(other))
  
      data = getattr(a_this, op)(other, *args, **kwargs)
      return data, this.index
  
  
  def _binary_geo(op, this, other, align):
      # type: (str, GeoSeries, GeoSeries) -> GeoSeries
      """Binary operation on GeoSeries objects that returns a GeoSeries"""
      from .geoseries import GeoSeries
  
      geoms, index = _delegate_binary_method(op, this, other, align)
      return GeoSeries(geoms.data, index=index, crs=this.crs)
  
  
  def _binary_op(op, this, other, align, *args, **kwargs):
      # type: (str, GeoSeries, GeoSeries, args/kwargs) -> Series[bool/float]
      """Binary operation on GeoSeries objects that returns a Series"""
      data, index = _delegate_binary_method(op, this, other, align, *args, **kwargs)
      return Series(data, index=index)
  
  
  def _delegate_property(op, this):
      # type: (str, GeoSeries) -> GeoSeries/Series
      a_this = GeometryArray(this.geometry.values)
      data = getattr(a_this, op)
      if isinstance(data, GeometryArray):
          from .geoseries import GeoSeries
  
          return GeoSeries(data.data, index=this.index, crs=this.crs)
      else:
          return Series(data, index=this.index)
  
  
  def _delegate_geo_method(op, this, *args, **kwargs):
      # type: (str, GeoSeries) -> GeoSeries
      """Unary operation that returns a GeoSeries"""
      from .geoseries import GeoSeries
  
      a_this = GeometryArray(this.geometry.values)
      data = getattr(a_this, op)(*args, **kwargs).data
      return GeoSeries(data, index=this.index, crs=this.crs)
  
  
  class GeoPandasBase(object):
      @property
      def area(self):
          """Returns a ``Series`` containing the area of each geometry in the
          ``GeoSeries`` expressed in the units of the CRS.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         Polygon([(10, 0), (10, 5), (0, 0)]),
          ...         Polygon([(0, 0), (2, 2), (2, 0)]),
          ...         LineString([(0, 0), (1, 1), (0, 1)]),
          ...         Point(0, 1)
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    POLYGON ((10.00000 0.00000, 10.00000 5.00000, ...
          2    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 2....
          3    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s.area
          0     0.5
          1    25.0
          2     2.0
          3     0.0
          4     0.0
          dtype: float64
  
          See also
          --------
          GeoSeries.length : measure length
  
          Notes
          -----
          Area may be invalid for a geographic CRS using degrees as units;
          use :meth:`GeoSeries.to_crs` to project geometries to a planar
          CRS before using this function.
  
          Every operation in GeoPandas is planar, i.e. the potential third
          dimension is not taken into account.
          """
          return _delegate_property("area", self)
  
      @property
      def crs(self):
          """
          The Coordinate Reference System (CRS) represented as a ``pyproj.CRS``
          object.
  
          Returns None if the CRS is not set, and to set the value it
          :getter: Returns a ``pyproj.CRS`` or None. When setting, the value
          can be anything accepted by
          :meth:`pyproj.CRS.from_user_input() <pyproj.crs.CRS.from_user_input>`,
          such as an authority string (eg "EPSG:4326") or a WKT string.
  
          Examples
          --------
  
          >>> s.crs  # doctest: +SKIP
          <Geographic 2D CRS: EPSG:4326>
          Name: WGS 84
          Axis Info [ellipsoidal]:
          - Lat[north]: Geodetic latitude (degree)
          - Lon[east]: Geodetic longitude (degree)
          Area of Use:
          - name: World
          - bounds: (-180.0, -90.0, 180.0, 90.0)
          Datum: World Geodetic System 1984
          - Ellipsoid: WGS 84
          - Prime Meridian: Greenwich
  
          See also
          --------
          GeoSeries.set_crs : assign CRS
          GeoSeries.to_crs : re-project to another CRS
          """
          return self.geometry.values.crs
  
      @crs.setter
      def crs(self, value):
          """Sets the value of the crs"""
          self.geometry.values.crs = value
  
      @property
      def geom_type(self):
          """
          Returns a ``Series`` of strings specifying the `Geometry Type` of each
          object.
  
          Examples
          --------
          >>> from shapely.geometry import Point, Polygon, LineString
          >>> d = {'geometry': [Point(2, 1), Polygon([(0, 0), (1, 1), (1, 0)]),
          ... LineString([(0, 0), (1, 1)])]}
          >>> gdf = geopandas.GeoDataFrame(d, crs="EPSG:4326")
          >>> gdf.geom_type
          0         Point
          1       Polygon
          2    LineString
          dtype: object
          """
          return _delegate_property("geom_type", self)
  
      @property
      def type(self):
          """Return the geometry type of each geometry in the GeoSeries"""
          return self.geom_type
  
      @property
      def length(self):
          """Returns a ``Series`` containing the length of each geometry
          expressed in the units of the CRS.
  
          In the case of a (Multi)Polygon it measures the length
          of its exterior (i.e. perimeter).
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, MultiLineString, Point, \
  GeometryCollection
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         LineString([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(10, 0), (10, 5), (0, 0)]),
          ...         MultiLineString([((0, 0), (1, 0)), ((-1, 0), (1, 0))]),
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         Point(0, 1),
          ...         GeometryCollection([Point(1, 0), LineString([(10, 0), (10, 5), (0,\
   0)])])
          ...     ]
          ... )
          >>> s
          0    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          1    LINESTRING (10.00000 0.00000, 10.00000 5.00000...
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 0.0...
          3    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          4                              POINT (0.00000 1.00000)
          5    GEOMETRYCOLLECTION (POINT (1.00000 0.00000), L...
          dtype: geometry
  
          >>> s.length
          0     2.414214
          1    16.180340
          2     3.000000
          3     3.414214
          4     0.000000
          5    16.180340
          dtype: float64
  
          See also
          --------
          GeoSeries.area : measure area of a polygon
  
          Notes
          -----
          Length may be invalid for a geographic CRS using degrees as units;
          use :meth:`GeoSeries.to_crs` to project geometries to a planar
          CRS before using this function.
  
          Every operation in GeoPandas is planar, i.e. the potential third
          dimension is not taken into account.
  
          """
          return _delegate_property("length", self)
  
      @property
      def is_valid(self):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          geometries that are valid.
  
          Examples
          --------
  
          An example with one invalid polygon (a bowtie geometry crossing itself)
          and one missing geometry:
  
          >>> from shapely.geometry import Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         Polygon([(0,0), (1, 1), (1, 0), (0, 1)]),  # bowtie geometry
          ...         Polygon([(0, 0), (2, 2), (2, 0)]),
          ...         None
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 1....
          2    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 2....
          3                                                 None
          dtype: geometry
  
          >>> s.is_valid
          0     True
          1    False
          2     True
          3    False
          dtype: bool
  
          """
          return _delegate_property("is_valid", self)
  
      @property
      def is_empty(self):
          """
          Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          empty geometries.
  
          Examples
          --------
          An example of a GeoDataFrame with one empty point, one point and one missing
          value:
  
          >>> from shapely.geometry import Point
          >>> d = {'geometry': [Point(), Point(2, 1), None]}
          >>> gdf = geopandas.GeoDataFrame(d, crs="EPSG:4326")
          >>> gdf
                             geometry
          0  GEOMETRYCOLLECTION EMPTY
          1   POINT (2.00000 1.00000)
          2                      None
          >>> gdf.is_empty
          0     True
          1    False
          2    False
          dtype: bool
  
          See Also
          --------
          GeoSeries.isna : detect missing values
          """
          return _delegate_property("is_empty", self)
  
      @property
      def is_simple(self):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          geometries that do not cross themselves.
  
          This is meaningful only for `LineStrings` and `LinearRings`.
  
          Examples
          --------
          >>> from shapely.geometry import LineString
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         LineString([(0, 0), (1, 1), (1, -1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, -1)]),
          ...     ]
          ... )
          >>> s
          0    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          dtype: geometry
  
          >>> s.is_simple
          0    False
          1     True
          dtype: bool
          """
          return _delegate_property("is_simple", self)
  
      @property
      def is_ring(self):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          features that are closed.
  
          When constructing a LinearRing, the sequence of coordinates may be
          explicitly closed by passing identical values in the first and last indices.
          Otherwise, the sequence will be implicitly closed by copying the first tuple
          to the last index.
  
          Examples
          --------
          >>> from shapely.geometry import LineString, LinearRing
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         LineString([(0, 0), (1, 1), (1, -1)]),
          ...         LineString([(0, 0), (1, 1), (1, -1), (0, 0)]),
          ...         LinearRing([(0, 0), (1, 1), (1, -1)]),
          ...     ]
          ... )
          >>> s
          0    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2    LINEARRING (0.00000 0.00000, 1.00000 1.00000, ...
          dtype: geometry
  
          >>> s.is_ring
          0    False
          1     True
          2     True
          dtype: bool
  
          """
          return _delegate_property("is_ring", self)
  
      @property
      def has_z(self):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          features that have a z-component.
  
          Notes
          ------
          Every operation in GeoPandas is planar, i.e. the potential third
          dimension is not taken into account.
  
          Examples
          --------
          >>> from shapely.geometry import Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(0, 1),
          ...         Point(0, 1, 2),
          ...     ]
          ... )
          >>> s
          0              POINT (0.00000 1.00000)
          1    POINT Z (0.00000 1.00000 2.00000)
          dtype: geometry
  
          >>> s.has_z
          0    False
          1     True
          dtype: bool
          """
          return _delegate_property("has_z", self)
  
      #
      # Unary operations that return a GeoSeries
      #
  
      @property
      def boundary(self):
          """Returns a ``GeoSeries`` of lower dimensional objects representing
          each geometries's set-theoretic `boundary`.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, 0)]),
          ...         Point(0, 0),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s.boundary
          0    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          1        MULTIPOINT (0.00000 0.00000, 1.00000 0.00000)
          2                             GEOMETRYCOLLECTION EMPTY
          dtype: geometry
  
          See also
          --------
          GeoSeries.exterior : outer boundary (without interior rings)
  
          """
          return _delegate_property("boundary", self)
  
      @property
      def centroid(self):
          """Returns a ``GeoSeries`` of points representing the centroid of each
          geometry.
  
          Note that centroid does not have to be on or within original geometry.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, 0)]),
          ...         Point(0, 0),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s.centroid
          0    POINT (0.33333 0.66667)
          1    POINT (0.70711 0.50000)
          2    POINT (0.00000 0.00000)
          dtype: geometry
  
          See also
          --------
          GeoSeries.representative_point : point guaranteed to be within each geometry
          """
          return _delegate_property("centroid", self)
  
      @property
      def convex_hull(self):
          """Returns a ``GeoSeries`` of geometries representing the convex hull
          of each geometry.
  
          The convex hull of a geometry is the smallest convex `Polygon`
          containing all the points in each geometry, unless the number of points
          in the geometric object is less than three. For two points, the convex
          hull collapses to a `LineString`; for 1, a `Point`.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point, MultiPoint
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, 0)]),
          ...         MultiPoint([(0, 0), (1, 1), (0, 1), (1, 0), (0.5, 0.5)]),
          ...         MultiPoint([(0, 0), (1, 1)]),
          ...         Point(0, 0),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2    MULTIPOINT (0.00000 0.00000, 1.00000 1.00000, ...
          3        MULTIPOINT (0.00000 0.00000, 1.00000 1.00000)
          4                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s.convex_hull
          0    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 1....
          2    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          3        LINESTRING (0.00000 0.00000, 1.00000 1.00000)
          4                              POINT (0.00000 0.00000)
          dtype: geometry
  
          See also
          --------
          GeoSeries.envelope : bounding rectangle geometry
  
          """
          return _delegate_property("convex_hull", self)
  
      @property
      def envelope(self):
          """Returns a ``GeoSeries`` of geometries representing the envelope of
          each geometry.
  
          The envelope of a geometry is the bounding rectangle. That is, the
          point or smallest rectangular polygon (with sides parallel to the
          coordinate axes) that contains the geometry.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point, MultiPoint
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, 0)]),
          ...         MultiPoint([(0, 0), (1, 1)]),
          ...         Point(0, 0),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2        MULTIPOINT (0.00000 0.00000, 1.00000 1.00000)
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s.envelope
          0    POLYGON ((0.00000 0.00000, 1.00000 0.00000, 1....
          1    POLYGON ((0.00000 0.00000, 1.00000 0.00000, 1....
          2    POLYGON ((0.00000 0.00000, 1.00000 0.00000, 1....
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          See also
          --------
          GeoSeries.convex_hull : convex hull geometry
          """
          return _delegate_property("envelope", self)
  
      @property
      def exterior(self):
          """Returns a ``GeoSeries`` of LinearRings representing the outer
          boundary of each polygon in the GeoSeries.
  
          Applies to GeoSeries containing only Polygons. Returns ``None``` for
          other geometry types.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         Polygon([(1, 0), (2, 1), (0, 0)]),
          ...         Point(0, 1)
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    POLYGON ((1.00000 0.00000, 2.00000 1.00000, 0....
          2                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s.exterior
          0    LINEARRING (0.00000 0.00000, 1.00000 1.00000, ...
          1    LINEARRING (1.00000 0.00000, 2.00000 1.00000, ...
          2                                                 None
          dtype: geometry
  
          See also
          --------
          GeoSeries.boundary : complete set-theoretic boundary
          GeoSeries.interiors : list of inner rings of each polygon
          """
          # TODO: return empty geometry for non-polygons
          return _delegate_property("exterior", self)
  
      @property
      def interiors(self):
          """Returns a ``Series`` of List representing the
          inner rings of each polygon in the GeoSeries.
  
          Applies to GeoSeries containing only Polygons.
  
          Returns
          ----------
          inner_rings: Series of List
              Inner rings of each polygon in the GeoSeries.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon(
          ...             [(0, 0), (0, 5), (5, 5), (5, 0)],
          ...             [[(1, 1), (2, 1), (1, 2)], [(1, 4), (2, 4), (2, 3)]],
          ...         ),
          ...         Polygon([(1, 0), (2, 1), (0, 0)]),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 0.00000 5.00000, 5....
          1    POLYGON ((1.00000 0.00000, 2.00000 1.00000, 0....
          dtype: geometry
  
          >>> s.interiors
          0    [LINEARRING (1 1, 2 1, 1 2, 1 1), LINEARRING (...
          1                                                   []
          dtype: object
  
          See also
          --------
          GeoSeries.exterior : outer boundary
          """
          return _delegate_property("interiors", self)
  
      def representative_point(self):
          """Returns a ``GeoSeries`` of (cheaply computed) points that are
          guaranteed to be within each geometry.
  
          Examples
          --------
  
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (1, 1), (1, 0)]),
          ...         Point(0, 0),
          ...     ]
          ... )
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1    LINESTRING (0.00000 0.00000, 1.00000 1.00000, ...
          2                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s.representative_point()
          0    POINT (0.25000 0.50000)
          1    POINT (1.00000 1.00000)
          2    POINT (0.00000 0.00000)
          dtype: geometry
  
          See also
          --------
          GeoSeries.centroid : geometric centroid
          """
          return _delegate_geo_method("representative_point", self)
  
      #
      # Reduction operations that return a Shapely geometry
      #
  
      @property
      def cascaded_union(self):
          """Deprecated: Return the unary_union of all geometries"""
          return cascaded_union(np.asarray(self.geometry.values))
  
      @property
      def unary_union(self):
          """Returns a geometry containing the union of all geometries in the
          ``GeoSeries``.
  
          Examples
          --------
  
          >>> from shapely.geometry import box
          >>> s = geopandas.GeoSeries([box(0,0,1,1), box(0,0,2,2)])
          >>> s
          0    POLYGON ((1.00000 0.00000, 1.00000 1.00000, 0....
          1    POLYGON ((2.00000 0.00000, 2.00000 2.00000, 0....
          dtype: geometry
  
          >>> union = s.unary_union
          >>> print(union)
          POLYGON ((0 1, 0 2, 2 2, 2 0, 1 0, 0 0, 0 1))
          """
          return self.geometry.values.unary_union()
  
      #
      # Binary operations that return a pandas Series
      #
  
      def contains(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that contains `other`.
  
          An object is said to contain `other` if its `interior` contains the
          `boundary` and `interior` of the other object and their boundaries do
          not touch at all.
  
          This is the inverse of :meth:`within` in the sense that the expression
          ``a.contains(b) == b.within(a)`` always evaluates to ``True``.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if is
              contained.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (0, 2)]),
          ...         LineString([(0, 0), (0, 1)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(0, 4),
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (1, 2), (0, 2)]),
          ...         LineString([(0, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          1        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          2        LINESTRING (0.00000 0.00000, 0.00000 1.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2    POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0....
          3        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries contains a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> point = Point(0, 1)
          >>> s.contains(point)
          0    False
          1     True
          2    False
          3     True
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s2.contains(s, align=True)
          0    False
          1    False
          2    False
          3     True
          4    False
          dtype: bool
  
          >>> s2.contains(s, align=False)
          1     True
          2    False
          3     True
          4     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``contains`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.within
          """
          return _binary_op("contains", self, other, align)
  
      def geom_equals(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry equal to `other`.
  
          An object is said to be equal to `other` if its set-theoretic
          `boundary`, `interior`, and `exterior` coincides with those of the
          other.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test for
              equality.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (1, 2), (0, 2)]),
          ...         LineString([(0, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (1, 2), (0, 2)]),
          ...         Point(0, 1),
          ...         LineString([(0, 0), (0, 2)]),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2    POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0....
          3                              POINT (0.00000 1.00000)
          4        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries contains a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> polygon = Polygon([(0, 0), (2, 2), (0, 2)])
          >>> s.geom_equals(polygon)
          0     True
          1    False
          2    False
          3    False
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.geom_equals(s2)
          0    False
          1    False
          2    False
          3     True
          4    False
          dtype: bool
  
          >>> s.geom_equals(s2, align=False)
          0     True
          1     True
          2    False
          3    False
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is equal to *any* element of the other one.
  
          See also
          --------
          GeoSeries.geom_almost_equals
          GeoSeries.geom_equals_exact
  
          """
          return _binary_op("geom_equals", self, other, align)
  
      def geom_almost_equals(self, other, decimal=6, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` if
          each aligned geometry is approximately equal to `other`.
  
          Approximate equality is tested at all points to the specified `decimal`
          place precision.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to compare to.
          decimal : int
              Decimal place presion used when testing for approximate equality.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(0, 1.1),
          ...         Point(0, 1.01),
          ...         Point(0, 1.001),
          ...     ],
          ... )
  
          >>> s
          0    POINT (0.00000 1.10000)
          1    POINT (0.00000 1.01000)
          2    POINT (0.00000 1.00100)
          dtype: geometry
  
  
          >>> s.geom_almost_equals(Point(0, 1), decimal=2)
          0    False
          1    False
          2     True
          dtype: bool
  
          >>> s.geom_almost_equals(Point(0, 1), decimal=1)
          0    False
          1     True
          2     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is equal to *any* element of the other one.
  
          See also
          --------
          GeoSeries.geom_equals
          GeoSeries.geom_equals_exact
  
          """
          return _binary_op(
              "geom_almost_equals", self, other, decimal=decimal, align=align
          )
  
      def geom_equals_exact(self, other, tolerance, align=True):
          """Return True for all geometries that equal aligned *other* to a given
          tolerance, else False.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to compare to.
          tolerance : float
              Decimal place presion used when testing for approximate equality.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(0, 1.1),
          ...         Point(0, 1.0),
          ...         Point(0, 1.2),
          ...     ]
          ... )
  
          >>> s
          0    POINT (0.00000 1.10000)
          1    POINT (0.00000 1.00000)
          2    POINT (0.00000 1.20000)
          dtype: geometry
  
  
          >>> s.geom_equals_exact(Point(0, 1), tolerance=0.1)
          0    False
          1     True
          2    False
          dtype: bool
  
          >>> s.geom_equals_exact(Point(0, 1), tolerance=0.15)
          0     True
          1     True
          2    False
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is equal to *any* element of the other one.
  
          See also
          --------
          GeoSeries.geom_equals
          GeoSeries.geom_almost_equals
          """
          return _binary_op(
              "geom_equals_exact", self, other, tolerance=tolerance, align=align
          )
  
      def crosses(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that cross `other`.
  
          An object is said to cross `other` if its `interior` intersects the
          `interior` of the other but does not contain it, and the dimension of
          the intersection is less than the dimension of the one or the other.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if is
              crossed.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          2        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          2    LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          3                          POINT (1.00000 1.00000)
          4                          POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries crosses a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> line = LineString([(-1, 1), (3, 1)])
          >>> s.crosses(line)
          0     True
          1     True
          2     True
          3    False
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.crosses(s2, align=True)
          0    False
          1     True
          2    False
          3    False
          4    False
          dtype: bool
  
          >>> s.crosses(s2, align=False)
          0     True
          1     True
          2    False
          3    False
          dtype: bool
  
          Notice that a line does not cross a point that it contains.
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``crosses`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.disjoint
          GeoSeries.intersects
  
          """
          return _binary_op("crosses", self, other, align)
  
      def disjoint(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry disjoint to `other`.
  
          An object is said to be disjoint to `other` if its `boundary` and
          `interior` does not intersect at all with those of the other.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if is
              disjoint.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(-1, 0), (-1, 2), (0, -2)]),
          ...         LineString([(0, 0), (0, 1)]),
          ...         Point(1, 1),
          ...         Point(0, 0),
          ...     ],
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          2        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          0    POLYGON ((-1.00000 0.00000, -1.00000 2.00000, ...
          1        LINESTRING (0.00000 0.00000, 0.00000 1.00000)
          2                              POINT (1.00000 1.00000)
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          We can check each geometry of GeoSeries to a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> line = LineString([(0, 0), (2, 0)])
          >>> s.disjoint(line)
          0    False
          1    False
          2    False
          3     True
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.disjoint(s2)
          0     True
          1    False
          2    False
          3     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is equal to *any* element of the other one.
  
          See also
          --------
          GeoSeries.intersects
          GeoSeries.touches
  
          """
          return _binary_op("disjoint", self, other, align)
  
      def intersects(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that intersects `other`.
  
          An object is said to intersect `other` if its `boundary` and `interior`
          intersects in any way with those of the other.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if is
              intersected.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          2        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          2    LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          3                          POINT (1.00000 1.00000)
          4                          POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries crosses a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> line = LineString([(-1, 1), (3, 1)])
          >>> s.intersects(line)
          0    True
          1    True
          2    True
          3    True
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.intersects(s2, align=True)
          0    False
          1     True
          2     True
          3    False
          4    False
          dtype: bool
  
          >>> s.intersects(s2, align=False)
          0    True
          1    True
          2    True
          3    True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``crosses`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.disjoint
          GeoSeries.crosses
          GeoSeries.touches
          GeoSeries.intersection
          """
          return _binary_op("intersects", self, other, align)
  
      def overlaps(self, other, align=True):
          """Returns True for all aligned geometries that overlap *other*, else False.
  
          Geometries overlaps if they have more than one but not all
          points in common, have the same dimension, and the intersection of the
          interiors of the geometries has the same dimension as the geometries
          themselves.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if
              overlaps.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, MultiPoint, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         MultiPoint([(0, 0), (0, 1)]),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 0), (0, 2)]),
          ...         LineString([(0, 1), (1, 1)]),
          ...         LineString([(1, 1), (3, 3)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        MULTIPOINT (0.00000 0.00000, 0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 0....
          2        LINESTRING (0.00000 1.00000, 1.00000 1.00000)
          3        LINESTRING (1.00000 1.00000, 3.00000 3.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries overlaps a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> polygon = Polygon([(0, 0), (1, 0), (1, 1), (0, 1)])
          >>> s.overlaps(polygon)
          0     True
          1     True
          2    False
          3    False
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.overlaps(s2)
          0    False
          1     True
          2    False
          3    False
          4    False
          dtype: bool
  
          >>> s.overlaps(s2, align=False)
          0     True
          1    False
          2     True
          3    False
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``overlaps`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.crosses
          GeoSeries.intersects
  
          """
          return _binary_op("overlaps", self, other, align)
  
      def touches(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that touches `other`.
  
          An object is said to touch `other` if it has at least one point in
          common with `other` and its interior does not intersect with any part
          of the other. Overlapping features therefore do not touch.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if is
              touched.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, MultiPoint, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         MultiPoint([(0, 0), (0, 1)]),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (-2, 0), (0, -2)]),
          ...         LineString([(0, 1), (1, 1)]),
          ...         LineString([(1, 1), (3, 0)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        MULTIPOINT (0.00000 0.00000, 0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, -2.00000 0.00000, 0...
          2        LINESTRING (0.00000 1.00000, 1.00000 1.00000)
          3        LINESTRING (1.00000 1.00000, 3.00000 0.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries touches a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
  
          >>> line = LineString([(0, 0), (-1, -2)])
          >>> s.touches(line)
          0    True
          1    True
          2    True
          3    True
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.touches(s2, align=True)
          0    False
          1     True
          2     True
          3    False
          4    False
          dtype: bool
  
          >>> s.touches(s2, align=False)
          0     True
          1    False
          2     True
          3    False
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``touches`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.overlaps
          GeoSeries.intersects
  
          """
          return _binary_op("touches", self, other, align)
  
      def within(self, other, align=True):
          """Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that is within `other`.
  
          An object is said to be within `other` if its `boundary` and `interior`
          intersects only with the `interior` of the other (not its `boundary` or
          `exterior`).
  
          This is the inverse of :meth:`contains` in the sense that the
          expression ``a.within(b) == b.contains(a)`` always evaluates to
          ``True``.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : GeoSeries or geometric object
              The GeoSeries (elementwise) or geometric object to test if each
              geometry is within.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (1, 2), (0, 2)]),
          ...         LineString([(0, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(0, 0), (0, 2)]),
          ...         LineString([(0, 0), (0, 1)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 1.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          3                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (0.00000 0.00000, 0.00000 2.00000)
          3        LINESTRING (0.00000 0.00000, 0.00000 1.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries is within a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> polygon = Polygon([(0, 0), (2, 2), (0, 2)])
          >>> s.within(polygon)
          0     True
          1     True
          2    False
          3    False
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s2.within(s)
          0    False
          1    False
          2     True
          3    False
          4    False
          dtype: bool
  
          >>> s2.within(s, align=False)
          1     True
          2    False
          3     True
          4     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is ``within`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.contains
          """
          return _binary_op("within", self, other, align)
  
      def covers(self, other, align=True):
          """
          Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that is entirely covering `other`.
  
          An object A is said to cover another object B if no points of B lie
          in the exterior of A.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          See
          https://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html
          for reference.
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to check is being covered.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         Point(0, 0),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0.5, 0.5), (1.5, 0.5), (1.5, 1.5), (0.5, 1.5)]),
          ...         Polygon([(0, 0), (2, 0), (2, 2), (0, 2)]),
          ...         LineString([(1, 1), (1.5, 1.5)]),
          ...         Point(0, 0),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.50000 0.50000, 1.50000 0.50000, 1....
          2    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
          3        LINESTRING (1.00000 1.00000, 1.50000 1.50000)
          4                              POINT (0.00000 0.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries covers a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> poly = Polygon([(0, 0), (2, 0), (2, 2), (0, 2)])
          >>> s.covers(poly)
          0     True
          1    False
          2    False
          3    False
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.covers(s2, align=True)
          0    False
          1    False
          2    False
          3    False
          4    False
          dtype: bool
  
          >>> s.covers(s2, align=False)
          0     True
          1    False
          2     True
          3     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries ``covers`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.covered_by
          GeoSeries.overlaps
          """
          return _binary_op("covers", self, other, align)
  
      def covered_by(self, other, align=True):
          """
          Returns a ``Series`` of ``dtype('bool')`` with value ``True`` for
          each aligned geometry that is entirely covered by `other`.
  
          An object A is said to cover another object B if no points of B lie
          in the exterior of A.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          See
          https://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html
          for reference.
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to check is being covered.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series (bool)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0.5, 0.5), (1.5, 0.5), (1.5, 1.5), (0.5, 1.5)]),
          ...         Polygon([(0, 0), (2, 0), (2, 2), (0, 2)]),
          ...         LineString([(1, 1), (1.5, 1.5)]),
          ...         Point(0, 0),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         Point(0, 0),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.50000 0.50000, 1.50000 0.50000, 1....
          1    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
          2        LINESTRING (1.00000 1.00000, 1.50000 1.50000)
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 2.00000 0.00000, 2....
          2    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          3        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          4                              POINT (0.00000 0.00000)
          dtype: geometry
  
          We can check if each geometry of GeoSeries is covered by a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> poly = Polygon([(0, 0), (2, 0), (2, 2), (0, 2)])
          >>> s.covered_by(poly)
          0    True
          1    True
          2    True
          3    True
          dtype: bool
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.covered_by(s2, align=True)
          0    False
          1     True
          2     True
          3     True
          4    False
          dtype: bool
  
          >>> s.covered_by(s2, align=False)
          0     True
          1    False
          2     True
          3     True
          dtype: bool
  
          Notes
          -----
          This method works in a row-wise manner. It does not check if an element
          of one GeoSeries is ``covered_by`` *any* element of the other one.
  
          See also
          --------
          GeoSeries.covers
          GeoSeries.overlaps
          """
          return _binary_op("covered_by", self, other, align)
  
      def distance(self, other, align=True):
          """Returns a ``Series`` containing the distance to aligned `other`.
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to find the
              distance to.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
  
          Returns
          -------
          Series (float)
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 0), (1, 1)]),
          ...         Polygon([(0, 0), (-1, 0), (-1, 1)]),
          ...         LineString([(1, 1), (0, 0)]),
          ...         Point(0, 0),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0.5, 0.5), (1.5, 0.5), (1.5, 1.5), (0.5, 1.5)]),
          ...         Point(3, 1),
          ...         LineString([(1, 0), (2, 0)]),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 5),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 1.00000 0.00000, 1....
          1    POLYGON ((0.00000 0.00000, -1.00000 0.00000, -...
          2        LINESTRING (1.00000 1.00000, 0.00000 0.00000)
          3                              POINT (0.00000 0.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.50000 0.50000, 1.50000 0.50000, 1....
          2                              POINT (3.00000 1.00000)
          3        LINESTRING (1.00000 0.00000, 2.00000 0.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can check the distance of each geometry of GeoSeries to a single
          geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> point = Point(-1, 0)
          >>> s.distance(point)
          0    1.0
          1    0.0
          2    1.0
          3    1.0
          dtype: float64
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and use elements with the same index using
          ``align=True`` or ignore index and use elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.distance(s2, align=True)
          0         NaN
          1    0.707107
          2    2.000000
          3    1.000000
          4         NaN
          dtype: float64
  
          >>> s.distance(s2, align=False)
          0    0.000000
          1    3.162278
          2    0.707107
          3    1.000000
          dtype: float64
          """
          return _binary_op("distance", self, other, align)
  
      #
      # Binary operations that return a GeoSeries
      #
  
      def difference(self, other, align=True):
          """Returns a ``GeoSeries`` of the points in each aligned geometry that
          are not in `other`.
  
          .. image:: ../../../_static/binary_geo-difference.svg
             :align: center
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to find the
              difference to.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          GeoSeries
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 6),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (1.00000 1.00000)
          5                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can do difference of each geometry and a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.difference(Polygon([(0, 0), (1, 1), (0, 1)]))
          0    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          1    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          2        LINESTRING (1.00000 1.00000, 2.00000 2.00000)
          3    MULTILINESTRING ((2.00000 0.00000, 1.00000 1.0...
          4                                          POINT EMPTY
          dtype: geometry
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.difference(s2, align=True)
          0                                                 None
          1    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3                                     LINESTRING EMPTY
          4                              POINT (0.00000 1.00000)
          5                                                 None
          dtype: geometry
  
          >>> s.difference(s2, align=False)
          0    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          1    POLYGON ((0.00000 0.00000, 0.00000 2.00000, 1....
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                                          POINT EMPTY
          dtype: geometry
  
          See Also
          --------
          GeoSeries.symmetric_difference
          GeoSeries.union
          GeoSeries.intersection
          """
          return _binary_geo("difference", self, other, align)
  
      def symmetric_difference(self, other, align=True):
          """Returns a ``GeoSeries`` of the symmetric difference of points in
          each aligned geometry with `other`.
  
          For each geometry, the symmetric difference consists of points in the
          geometry not in `other`, and points in `other` not in the geometry.
  
          .. image:: ../../../_static/binary_geo-symm_diff.svg
             :align: center
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to find the
              symmetric difference to.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          GeoSeries
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 6),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (1.00000 1.00000)
          5                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can do symmetric difference of each geometry and a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.symmetric_difference(Polygon([(0, 0), (1, 1), (0, 1)]))
          0    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          1    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          2    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          3    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          4    POLYGON ((0.00000 1.00000, 1.00000 1.00000, 0....
          dtype: geometry
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.symmetric_difference(s2, align=True)
          0                                                 None
          1    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3                                     LINESTRING EMPTY
          4        MULTIPOINT (0.00000 1.00000, 1.00000 1.00000)
          5                                                 None
          dtype: geometry
  
          >>> s.symmetric_difference(s2, align=False)
          0    POLYGON ((0.00000 2.00000, 2.00000 2.00000, 1....
          1    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                                          POINT EMPTY
          dtype: geometry
  
          See Also
          --------
          GeoSeries.difference
          GeoSeries.union
          GeoSeries.intersection
          """
          return _binary_geo("symmetric_difference", self, other, align)
  
      def union(self, other, align=True):
          """Returns a ``GeoSeries`` of the union of points in each aligned geometry with
          `other`.
  
          .. image:: ../../../_static/binary_geo-union.svg
             :align: center
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to find the union
              with.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          GeoSeries
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 6),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (1.00000 1.00000)
          5                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can do union of each geometry and a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.union(Polygon([(0, 0), (1, 1), (0, 1)]))
          0    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 0....
          1    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 0....
          2    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          3    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          4    POLYGON ((0.00000 1.00000, 1.00000 1.00000, 0....
          dtype: geometry
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.union(s2, align=True)
          0                                                 None
          1    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 0....
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4        MULTIPOINT (0.00000 1.00000, 1.00000 1.00000)
          5                                                 None
          dtype: geometry
  
          >>> s.union(s2, align=False)
          0    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 0....
          1    GEOMETRYCOLLECTION (POLYGON ((0.00000 0.00000,...
          2    MULTILINESTRING ((0.00000 0.00000, 1.00000 1.0...
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
  
          See Also
          --------
          GeoSeries.symmetric_difference
          GeoSeries.difference
          GeoSeries.intersection
          """
          return _binary_geo("union", self, other, align)
  
      def intersection(self, other, align=True):
          """Returns a ``GeoSeries`` of the intersection of points in each
          aligned geometry with `other`.
  
          .. image:: ../../../_static/binary_geo-intersection.svg
             :align: center
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
  
          Parameters
          ----------
          other : Geoseries or geometric object
              The Geoseries (elementwise) or geometric object to find the
              intersection with.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          GeoSeries
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 6),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (1.00000 1.00000)
          5                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can also do intersection of each geometry and a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.intersection(Polygon([(0, 0), (1, 1), (0, 1)]))
          0    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          1    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          2        LINESTRING (0.00000 0.00000, 1.00000 1.00000)
          3                              POINT (1.00000 1.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.intersection(s2, align=True)
          0                                                 None
          1    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          2                              POINT (1.00000 1.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                                          POINT EMPTY
          5                                                 None
          dtype: geometry
  
          >>> s.intersection(s2, align=False)
          0    POLYGON ((0.00000 0.00000, 0.00000 1.00000, 1....
          1        LINESTRING (1.00000 1.00000, 1.00000 2.00000)
          2                              POINT (1.00000 1.00000)
          3                              POINT (1.00000 1.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
  
          See Also
          --------
          GeoSeries.difference
          GeoSeries.symmetric_difference
          GeoSeries.union
          """
          return _binary_geo("intersection", self, other, align)
  
      #
      # Other operations
      #
  
      @property
      def bounds(self):
          """Returns a ``DataFrame`` with columns ``minx``, ``miny``, ``maxx``,
          ``maxy`` values containing the bounds for each geometry.
  
          See ``GeoSeries.total_bounds`` for the limits of the entire series.
  
          Examples
          --------
          >>> from shapely.geometry import Point, Polygon, LineString
          >>> d = {'geometry': [Point(2, 1), Polygon([(0, 0), (1, 1), (1, 0)]),
          ... LineString([(0, 1), (1, 2)])]}
          >>> gdf = geopandas.GeoDataFrame(d, crs="EPSG:4326")
          >>> gdf.bounds
             minx  miny  maxx  maxy
          0   2.0   1.0   2.0   1.0
          1   0.0   0.0   1.0   1.0
          2   0.0   1.0   1.0   2.0
          """
          bounds = GeometryArray(self.geometry.values).bounds
          return DataFrame(
              bounds, columns=["minx", "miny", "maxx", "maxy"], index=self.index
          )
  
      @property
      def total_bounds(self):
          """Returns a tuple containing ``minx``, ``miny``, ``maxx``, ``maxy``
          values for the bounds of the series as a whole.
  
          See ``GeoSeries.bounds`` for the bounds of the geometries contained in
          the series.
  
          Examples
          --------
          >>> from shapely.geometry import Point, Polygon, LineString
          >>> d = {'geometry': [Point(3, -1), Polygon([(0, 0), (1, 1), (1, 0)]),
          ... LineString([(0, 1), (1, 2)])]}
          >>> gdf = geopandas.GeoDataFrame(d, crs="EPSG:4326")
          >>> gdf.total_bounds
          array([ 0., -1.,  3.,  2.])
          """
          return GeometryArray(self.geometry.values).total_bounds
  
      @property
      def sindex(self):
          """Generate the spatial index
  
          Creates R-tree spatial index based on ``pygeos.STRtree`` or
          ``rtree.index.Index``.
  
          Note that the  spatial index may not be fully
          initialized until the first use.
  
          Examples
          --------
          >>> from shapely.geometry import box
          >>> s = geopandas.GeoSeries(geopandas.points_from_xy(range(5), range(5)))
          >>> s
          0    POINT (0.00000 0.00000)
          1    POINT (1.00000 1.00000)
          2    POINT (2.00000 2.00000)
          3    POINT (3.00000 3.00000)
          4    POINT (4.00000 4.00000)
          dtype: geometry
  
          Query the spatial index with a single geometry based on the bounding box:
  
          >>> s.sindex.query(box(1, 1, 3, 3))
          array([1, 2, 3])
  
          Query the spatial index with a single geometry based on the predicate:
  
          >>> s.sindex.query(box(1, 1, 3, 3), predicate="contains")
          array([2])
  
          Query the spatial index with an array of geometries based on the bounding
          box:
  
          >>> s2 = geopandas.GeoSeries([box(1, 1, 3, 3), box(4, 4, 5, 5)])
          >>> s2
          0    POLYGON ((3.00000 1.00000, 3.00000 3.00000, 1....
          1    POLYGON ((5.00000 4.00000, 5.00000 5.00000, 4....
          dtype: geometry
  
          >>> s.sindex.query_bulk(s2)
          array([[0, 0, 0, 1],
                 [1, 2, 3, 4]])
  
          Query the spatial index with an array of geometries based on the predicate:
  
          >>> s.sindex.query_bulk(s2, predicate="contains")
          array([[0],
                 [2]])
          """
          return self.geometry.values.sindex
  
      @property
      def has_sindex(self):
          """Check the existence of the spatial index without generating it.
  
          Use the `.sindex` attribute on a GeoDataFrame or GeoSeries
          to generate a spatial index if it does not yet exist,
          which may take considerable time based on the underlying index
          implementation.
  
          Note that the underlying spatial index may not be fully
          initialized until the first use.
  
          Examples
          --------
  
          >>> from shapely.geometry import Point
          >>> d = {'geometry': [Point(1, 2), Point(2, 1)]}
          >>> gdf = geopandas.GeoDataFrame(d)
          >>> gdf.has_sindex
          False
          >>> index = gdf.sindex
          >>> gdf.has_sindex
          True
  
          Returns
          -------
          bool
              `True` if the spatial index has been generated or
              `False` if not.
          """
          return self.geometry.values.has_sindex
  
      def buffer(self, distance, resolution=16, **kwargs):
          """Returns a ``GeoSeries`` of geometries representing all points within
          a given ``distance`` of each geometric object.
  
          See http://shapely.readthedocs.io/en/latest/manual.html#object.buffer
          for details.
  
          Parameters
          ----------
          distance : float, np.array, pd.Series
              The radius of the buffer. If np.array or pd.Series are used
              then it must have same length as the GeoSeries.
          resolution : int (optional, default 16)
              The resolution of the buffer around each vertex.
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(0, 0),
          ...         LineString([(1, -1), (1, 0), (2, 0), (2, 1)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (0.00000 0.00000)
          1    LINESTRING (1.00000 -1.00000, 1.00000 0.00000,...
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.buffer(0.2)
          0    POLYGON ((0.20000 0.00000, 0.19904 -0.01960, 0...
          1    POLYGON ((0.80000 0.00000, 0.80096 0.01960, 0....
          2    POLYGON ((2.80000 -1.00000, 2.80000 1.00000, 2...
          dtype: geometry
  
          ``**kwargs`` accept further specification as ``join_style`` and ``cap_style``.
          See the following illustration of different options.
  
          .. plot:: _static/code/buffer.py
  
          """
          # TODO: update docstring based on pygeos after shapely 2.0
          if isinstance(distance, pd.Series):
              if not self.index.equals(distance.index):
                  raise ValueError(
                      "Index values of distance sequence does "
                      "not match index values of the GeoSeries"
                  )
              distance = np.asarray(distance)
  
          return _delegate_geo_method(
              "buffer", self, distance, resolution=resolution, **kwargs
          )
  
      def simplify(self, *args, **kwargs):
          """Returns a ``GeoSeries`` containing a simplified representation of
          each geometry.
  
          The algorithm (Douglas-Peucker) recursively splits the original line
          into smaller parts and connects these parts’ endpoints
          by a straight line. Then, it removes all points whose distance
          to the straight line is smaller than `tolerance`. It does not
          move any points and it always preserves endpoints of
          the original line or polygon.
          See http://shapely.readthedocs.io/en/latest/manual.html#object.simplify
          for details
  
          Parameters
          ----------
          tolerance : float
              All parts of a simplified geometry will be no more than
              `tolerance` distance from the original. It has the same units
              as the coordinate reference system of the GeoSeries.
              For example, using `tolerance=100` in a projected CRS with meters
              as units means a distance of 100 meters in reality.
          preserve_topology: bool (default True)
              False uses a quicker algorithm, but may produce self-intersecting
              or otherwise invalid geometries.
  
          Notes
          -----
          Invalid geometric objects may result from simplification that does not
          preserve topology and simplification may be sensitive to the order of
          coordinates: two geometries differing only in order of coordinates may be
          simplified differently.
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString
          >>> s = geopandas.GeoSeries(
          ...     [Point(0, 0).buffer(1), LineString([(0, 0), (1, 10), (0, 20)])]
          ... )
          >>> s
          0    POLYGON ((1.00000 0.00000, 0.99518 -0.09802, 0...
          1    LINESTRING (0.00000 0.00000, 1.00000 10.00000,...
          dtype: geometry
  
          >>> s.simplify(1)
          0    POLYGON ((1.00000 0.00000, 0.00000 -1.00000, -...
          1       LINESTRING (0.00000 0.00000, 0.00000 20.00000)
          dtype: geometry
          """
          return _delegate_geo_method("simplify", self, *args, **kwargs)
  
      def relate(self, other, align=True):
          """
          Returns the DE-9IM intersection matrices for the geometries
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          Parameters
          ----------
          other : BaseGeometry or GeoSeries
              The other geometry to computed
              the DE-9IM intersection matrices from.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          ----------
          spatial_relations: Series of strings
              The DE-9IM intersection matrices which describe
              the spatial relations of the other geometry.
  
          Examples
          --------
          >>> from shapely.geometry import Polygon, LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         Polygon([(0, 0), (2, 2), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(0, 1),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Polygon([(0, 0), (1, 1), (0, 1)]),
          ...         LineString([(1, 0), (1, 3)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...         Point(1, 1),
          ...         Point(0, 1),
          ...     ],
          ...     index=range(1, 6),
          ... )
  
          >>> s
          0    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          1    POLYGON ((0.00000 0.00000, 2.00000 2.00000, 0....
          2        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (0.00000 1.00000)
          dtype: geometry
  
          >>> s2
          1    POLYGON ((0.00000 0.00000, 1.00000 1.00000, 0....
          2        LINESTRING (1.00000 0.00000, 1.00000 3.00000)
          3        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          4                              POINT (1.00000 1.00000)
          5                              POINT (0.00000 1.00000)
          dtype: geometry
  
          We can relate each geometry and a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.relate(Polygon([(0, 0), (1, 1), (0, 1)]))
          0    212F11FF2
          1    212F11FF2
          2    F11F00212
          3    F01FF0212
          4    F0FFFF212
          dtype: object
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and compare elements with the same index using
          ``align=True`` or ignore index and compare elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.relate(s2, align=True)
          0         None
          1    212F11FF2
          2    0F1FF0102
          3    1FFF0FFF2
          4    FF0FFF0F2
          5         None
          dtype: object
  
          >>> s.relate(s2, align=False)
          0    212F11FF2
          1    1F20F1102
          2    0F1FF0102
          3    0F1FF0FF2
          4    0FFFFFFF2
          dtype: object
  
          """
          return _binary_op("relate", self, other, align)
  
      def project(self, other, normalized=False, align=True):
          """
          Return the distance along each geometry nearest to *other*
  
          The operation works on a 1-to-1 row-wise manner:
  
          .. image:: ../../../_static/binary_op-01.svg
             :align: center
  
          The project method is the inverse of interpolate.
  
  
          Parameters
          ----------
          other : BaseGeometry or GeoSeries
              The *other* geometry to computed projected point from.
          normalized : boolean
              If normalized is True, return the distance normalized to
              the length of the object.
          align : bool (default True)
              If True, automatically aligns GeoSeries based on their indices.
              If False, the order of elements is preserved.
  
          Returns
          -------
          Series
  
          Examples
          --------
          >>> from shapely.geometry import LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         LineString([(0, 0), (2, 0), (0, 2)]),
          ...         LineString([(0, 0), (2, 2)]),
          ...         LineString([(2, 0), (0, 2)]),
          ...     ],
          ... )
          >>> s2 = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 0),
          ...         Point(1, 0),
          ...         Point(2, 1),
          ...     ],
          ...     index=range(1, 4),
          ... )
  
          >>> s
          0    LINESTRING (0.00000 0.00000, 2.00000 0.00000, ...
          1        LINESTRING (0.00000 0.00000, 2.00000 2.00000)
          2        LINESTRING (2.00000 0.00000, 0.00000 2.00000)
          dtype: geometry
  
          >>> s2
          1    POINT (1.00000 0.00000)
          2    POINT (1.00000 0.00000)
          3    POINT (2.00000 1.00000)
          dtype: geometry
  
          We can project each geometry on a single
          shapely geometry:
  
          .. image:: ../../../_static/binary_op-03.svg
             :align: center
  
          >>> s.project(Point(1, 0))
          0    1.000000
          1    0.707107
          2    0.707107
          dtype: float64
  
          We can also check two GeoSeries against each other, row by row.
          The GeoSeries above have different indices. We can either align both GeoSeries
          based on index values and project elements with the same index using
          ``align=True`` or ignore index and project elements based on their matching
          order using ``align=False``:
  
          .. image:: ../../../_static/binary_op-02.svg
  
          >>> s.project(s2, align=True)
          0         NaN
          1    0.707107
          2    0.707107
          3         NaN
          dtype: float64
  
          >>> s.project(s2, align=False)
          0    1.000000
          1    0.707107
          2    0.707107
          dtype: float64
  
          See also
          --------
          GeoSeries.interpolate
          """
          return _binary_op("project", self, other, normalized=normalized, align=align)
  
      def interpolate(self, distance, normalized=False):
          """
          Return a point at the specified distance along each geometry
  
          Parameters
          ----------
          distance : float or Series of floats
              Distance(s) along the geometries at which a point should be
              returned. If np.array or pd.Series are used then it must have
              same length as the GeoSeries.
          normalized : boolean
              If normalized is True, distance will be interpreted as a fraction
              of the geometric object's length.
          """
          if isinstance(distance, pd.Series):
              if not self.index.equals(distance.index):
                  raise ValueError(
                      "Index values of distance sequence does "
                      "not match index values of the GeoSeries"
                  )
              distance = np.asarray(distance)
          return _delegate_geo_method(
              "interpolate", self, distance, normalized=normalized
          )
  
      def affine_transform(self, matrix):
          """Return a ``GeoSeries`` with translated geometries.
  
          See http://shapely.readthedocs.io/en/stable/manual.html#shapely.affinity.affine_transform
          for details.
  
          Parameters
          ----------
          matrix: List or tuple
              6 or 12 items for 2D or 3D transformations respectively.
  
              For 2D affine transformations,
              the 6 parameter matrix is ``[a, b, d, e, xoff, yoff]``
  
              For 3D affine transformations,
              the 12 parameter matrix is ``[a, b, c, d, e, f, g, h, i, xoff, yoff, zoff]``
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 1),
          ...         LineString([(1, -1), (1, 0)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -1.00000, 1.00000 0.00000)
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.affine_transform([2, 3, 2, 4, 5, 2])
          0                             POINT (10.00000 8.00000)
          1        LINESTRING (4.00000 0.00000, 7.00000 4.00000)
          2    POLYGON ((8.00000 4.00000, 13.00000 10.00000, ...
          dtype: geometry
  
          """  # noqa (E501 link is longer than max line length)
          return _delegate_geo_method("affine_transform", self, matrix)
  
      def translate(self, xoff=0.0, yoff=0.0, zoff=0.0):
          """Returns a ``GeoSeries`` with translated geometries.
  
          See http://shapely.readthedocs.io/en/latest/manual.html#shapely.affinity.translate
          for details.
  
          Parameters
          ----------
          xoff, yoff, zoff : float, float, float
              Amount of offset along each dimension.
              xoff, yoff, and zoff for translation along the x, y, and z
              dimensions respectively.
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 1),
          ...         LineString([(1, -1), (1, 0)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -1.00000, 1.00000 0.00000)
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.translate(2, 3)
          0                              POINT (3.00000 4.00000)
          1        LINESTRING (3.00000 2.00000, 3.00000 3.00000)
          2    POLYGON ((5.00000 2.00000, 6.00000 3.00000, 5....
          dtype: geometry
  
          """  # noqa (E501 link is longer than max line length)
          return _delegate_geo_method("translate", self, xoff, yoff, zoff)
  
      def rotate(self, angle, origin="center", use_radians=False):
          """Returns a ``GeoSeries`` with rotated geometries.
  
          See http://shapely.readthedocs.io/en/latest/manual.html#shapely.affinity.rotate
          for details.
  
          Parameters
          ----------
          angle : float
              The angle of rotation can be specified in either degrees (default)
              or radians by setting use_radians=True. Positive angles are
              counter-clockwise and negative are clockwise rotations.
          origin : string, Point, or tuple (x, y)
              The point of origin can be a keyword 'center' for the bounding box
              center (default), 'centroid' for the geometry's centroid, a Point
              object or a coordinate tuple (x, y).
          use_radians : boolean
              Whether to interpret the angle of rotation as degrees or radians
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 1),
          ...         LineString([(1, -1), (1, 0)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -1.00000, 1.00000 0.00000)
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.rotate(90)
          0                              POINT (1.00000 1.00000)
          1      LINESTRING (1.50000 -0.50000, 0.50000 -0.50000)
          2    POLYGON ((4.50000 -0.50000, 3.50000 0.50000, 2...
          dtype: geometry
  
          >>> s.rotate(90, origin=(0, 0))
          0                             POINT (-1.00000 1.00000)
          1        LINESTRING (1.00000 1.00000, 0.00000 1.00000)
          2    POLYGON ((1.00000 3.00000, 0.00000 4.00000, -1...
          dtype: geometry
  
          """
          return _delegate_geo_method(
              "rotate", self, angle, origin=origin, use_radians=use_radians
          )
  
      def scale(self, xfact=1.0, yfact=1.0, zfact=1.0, origin="center"):
          """Returns a ``GeoSeries`` with scaled geometries.
  
          The geometries can be scaled by different factors along each
          dimension. Negative scale factors will mirror or reflect coordinates.
  
          See http://shapely.readthedocs.io/en/latest/manual.html#shapely.affinity.scale
          for details.
  
          Parameters
          ----------
          xfact, yfact, zfact : float, float, float
              Scaling factors for the x, y, and z dimensions respectively.
          origin : string, Point, or tuple
              The point of origin can be a keyword 'center' for the 2D bounding
              box center (default), 'centroid' for the geometry's 2D centroid, a
              Point object or a coordinate tuple (x, y, z).
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 1),
          ...         LineString([(1, -1), (1, 0)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -1.00000, 1.00000 0.00000)
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.scale(2, 3)
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -2.00000, 1.00000 1.00000)
          2    POLYGON ((2.50000 -3.00000, 4.50000 0.00000, 2...
          dtype: geometry
  
          >>> s.scale(2, 3, origin=(0, 0))
          0                              POINT (2.00000 3.00000)
          1       LINESTRING (2.00000 -3.00000, 2.00000 0.00000)
          2    POLYGON ((6.00000 -3.00000, 8.00000 0.00000, 6...
          dtype: geometry
          """
          return _delegate_geo_method("scale", self, xfact, yfact, zfact, origin=origin)
  
      def skew(self, xs=0.0, ys=0.0, origin="center", use_radians=False):
          """Returns a ``GeoSeries`` with skewed geometries.
  
          The geometries are sheared by angles along the x and y dimensions.
  
          See http://shapely.readthedocs.io/en/latest/manual.html#shapely.affinity.skew
          for details.
  
          Parameters
          ----------
          xs, ys : float, float
              The shear angle(s) for the x and y axes respectively. These can be
              specified in either degrees (default) or radians by setting
              use_radians=True.
          origin : string, Point, or tuple (x, y)
              The point of origin can be a keyword 'center' for the bounding box
              center (default), 'centroid' for the geometry's centroid, a Point
              object or a coordinate tuple (x, y).
          use_radians : boolean
              Whether to interpret the shear angle(s) as degrees or radians
  
          Examples
          --------
          >>> from shapely.geometry import Point, LineString, Polygon
          >>> s = geopandas.GeoSeries(
          ...     [
          ...         Point(1, 1),
          ...         LineString([(1, -1), (1, 0)]),
          ...         Polygon([(3, -1), (4, 0), (3, 1)]),
          ...     ]
          ... )
          >>> s
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (1.00000 -1.00000, 1.00000 0.00000)
          2    POLYGON ((3.00000 -1.00000, 4.00000 0.00000, 3...
          dtype: geometry
  
          >>> s.skew(45, 30)
          0                              POINT (1.00000 1.00000)
          1       LINESTRING (0.50000 -1.00000, 1.50000 0.00000)
          2    POLYGON ((2.00000 -1.28868, 4.00000 0.28868, 4...
          dtype: geometry
  
          >>> s.skew(45, 30, origin=(0, 0))
          0                              POINT (2.00000 1.57735)
          1       LINESTRING (0.00000 -0.42265, 1.00000 0.57735)
          2    POLYGON ((2.00000 0.73205, 4.00000 2.30940, 4....
          dtype: geometry
          """
          return _delegate_geo_method(
              "skew", self, xs, ys, origin=origin, use_radians=use_radians
          )
  
      @property
      def cx(self):
          """
          Coordinate based indexer to select by intersection with bounding box.
  
          Format of input should be ``.cx[xmin:xmax, ymin:ymax]``. Any of
          ``xmin``, ``xmax``, ``ymin``, and ``ymax`` can be provided, but input
          must include a comma separating x and y slices. That is, ``.cx[:, :]``
          will return the full series/frame, but ``.cx[:]`` is not implemented.
  
          Examples
          --------
          >>> from shapely.geometry import LineString, Point
          >>> s = geopandas.GeoSeries(
          ...     [Point(0, 0), Point(1, 2), Point(3, 3), LineString([(0, 0), (3, 3)])]
          ... )
          >>> s
          0                          POINT (0.00000 0.00000)
          1                          POINT (1.00000 2.00000)
          2                          POINT (3.00000 3.00000)
          3    LINESTRING (0.00000 0.00000, 3.00000 3.00000)
          dtype: geometry
  
          >>> s.cx[0:1, 0:1]
          0                          POINT (0.00000 0.00000)
          3    LINESTRING (0.00000 0.00000, 3.00000 3.00000)
          dtype: geometry
  
          >>> s.cx[:, 1:]
          1                          POINT (1.00000 2.00000)
          2                          POINT (3.00000 3.00000)
          3    LINESTRING (0.00000 0.00000, 3.00000 3.00000)
          dtype: geometry
  
          """
          return _CoordinateIndexer(self)
  
      def equals(self, other):
          """
          Test whether two objects contain the same elements.
  
          This function allows two GeoSeries or GeoDataFrames to be compared
          against each other to see if they have the same shape and elements.
          Missing values in the same location are considered equal. The
          row/column index do not need to have the same type (as long as the
          values are still considered equal), but the dtypes of the respective
          columns must be the same.
  
          Parameters
          ----------
          other : GeoSeries or GeoDataFrame
              The other GeoSeries or GeoDataFrame to be compared with the first.
  
          Returns
          -------
          bool
              True if all elements are the same in both objects, False
              otherwise.
          """
          # we override this because pandas is using `self._constructor` in the
          # isinstance check (https://github.com/geopandas/geopandas/issues/1420)
          if not isinstance(other, type(self)):
              return False
          return self._data.equals(other._data)
  
  
  class _CoordinateIndexer(object):
      # see docstring GeoPandasBase.cx property above
  
      def __init__(self, obj):
          self.obj = obj
  
      def __getitem__(self, key):
          obj = self.obj
          xs, ys = key
          # handle numeric values as x and/or y coordinate index
          if type(xs) is not slice:
              xs = slice(xs, xs)
          if type(ys) is not slice:
              ys = slice(ys, ys)
          # don't know how to handle step; should this raise?
          if xs.step is not None or ys.step is not None:
              warn("Ignoring step - full interval is used.")
          if xs.start is None or xs.stop is None or ys.start is None or ys.stop is None:
              xmin, ymin, xmax, ymax = obj.total_bounds
          bbox = box(
              xs.start if xs.start is not None else xmin,
              ys.start if ys.start is not None else ymin,
              xs.stop if xs.stop is not None else xmax,
              ys.stop if ys.stop is not None else ymax,
          )
          idx = obj.intersects(bbox)
          return obj[idx]
  
apis: numpy.asarray pandas.Series pandas.DataFrame