class_docstr: A Series object designed to store shapely geometry objects.
  
  Parameters
  ----------
  data : array-like, dict, scalar value
      The geometries to store in the GeoSeries.
  index : array-like or Index
      The index for the GeoSeries.
  crs : value (optional)
      Coordinate Reference System of the geometry objects. 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.
  
  kwargs
      Additional arguments passed to the Series constructor,
       e.g. ``name``.
  
  Examples
  --------
  
  >>> from shapely.geometry import Point
  >>> s = geopandas.GeoSeries([Point(1, 1), Point(2, 2), Point(3, 3)])
  >>> s
  0    POINT (1 1)
  1    POINT (2 2)
  2    POINT (3 3)
  dtype: geometry
  
  >>> s = geopandas.GeoSeries(
  ...     [Point(1, 1), Point(2, 2), Point(3, 3)], crs="EPSG:3857"
  ... )
  >>> s.crs  # doctest: +SKIP
  <Projected CRS: EPSG:3857>
  Name: WGS 84 / Pseudo-Mercator
  Axis Info [cartesian]:
  - X[east]: Easting (metre)
  - Y[north]: Northing (metre)
  Area of Use:
  - name: World - 85°S to 85°N
  - bounds: (-180.0, -85.06, 180.0, 85.06)
  Coordinate Operation:
  - name: Popular Visualisation Pseudo-Mercator
  - method: Popular Visualisation Pseudo Mercator
  Datum: World Geodetic System 1984
  - Ellipsoid: WGS 84
  - Prime Meridian: Greenwich
  
  >>> s = geopandas.GeoSeries(
  ...    [Point(1, 1), Point(2, 2), Point(3, 3)], index=["a", "b", "c"], crs=4326
  ... )
  >>> s
  a    POINT (1 1)
  b    POINT (2 2)
  c    POINT (3 3)
  dtype: geometry
  
  >>> s.crs
  <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 ensemble
  - Ellipsoid: WGS 84
  - Prime Meridian: Greenwich
  
  See Also
  --------
  GeoDataFrame
  pandas.Series
class_docstr_tok: ["A","Series","object","designed","to","store","shapely","geometry","objects",".","Parameters","--","--","--","--","--","data",":","array-like",",","dict",",","scalar","value","The","geometries","to","store","in","the","GeoSeries",".","index",":","array-like","or","Index","The","index","for","the","GeoSeries",".","crs",":","value","(","optional",")","Coordinate","Reference","System","of","the","geometry","objects",".","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",".","kwargs","Additional","arguments","passed","to","the","Series","constructor",",","e.g",".","``","name","``",".","Examples","--","--","--","--",">",">",">","from","shapely.geometry","import","Point",">",">",">","s","=","geopandas.GeoSeries","(","[","Point","(","1",",","1",")",",","Point","(","2",",","2",")",",","Point","(","3",",","3",")","]",")",">",">",">","s","0","POINT","(","1","1",")","1","POINT","(","2","2",")","2","POINT","(","3","3",")","dtype",":","geometry",">",">",">","s","=","geopandas.GeoSeries","(","...","[","Point","(","1",",","1",")",",","Point","(","2",",","2",")",",","Point","(","3",",","3",")","]",",","crs=","''","EPSG:3857","''","...",")",">",">",">","s.crs","#","doctest",":","+SKIP","<","Projected","CRS",":","EPSG:3857",">","Name",":","WGS","84","\/","Pseudo-Mercator","Axis","Info","[","cartesian","]",":","-","X","[","east","]",":","Easting","(","metre",")","-","Y","[","north","]",":","Northing","(","metre",")","Area","of","Use",":","-","name",":","World","-","85\u00b0S","to","85\u00b0N","-","bounds",":","(","-180.0",",","-85.06",",","180.0",",","85.06",")","Coordinate","Operation",":","-","name",":","Popular","Visualisation","Pseudo-Mercator","-","method",":","Popular","Visualisation","Pseudo","Mercator","Datum",":","World","Geodetic","System","1984","-","Ellipsoid",":","WGS","84","-","Prime","Meridian",":","Greenwich",">",">",">","s","=","geopandas.GeoSeries","(","...","[","Point","(","1",",","1",")",",","Point","(","2",",","2",")",",","Point","(","3",",","3",")","]",",","index=","[","``","a","''",",","``","b","''",",","``","c","''","]",",","crs=4326","...",")",">",">",">","s","a","POINT","(","1","1",")","b","POINT","(","2","2",")","c","POINT","(","3","3",")","dtype",":","geometry",">",">",">","s.crs","<","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","ensemble","-","Ellipsoid",":","WGS","84","-","Prime","Meridian",":","Greenwich","See","Also","--","--","--","--","GeoDataFrame","pandas.Series"]
docstr: Set the Coordinate Reference System (CRS) of a ``GeoSeries``.
  
  NOTE: The underlying geometries are not transformed to this CRS. To
  transform the geometries to a new CRS, use the ``to_crs`` method.
  
  Parameters
  ----------
  crs : pyproj.CRS, optional if `epsg` is specified
      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.
  epsg : int, optional if `crs` is specified
      EPSG code specifying the projection.
  inplace : bool, default False
      If True, the CRS of the GeoSeries will be changed in place
      (while still returning the result) instead of making a copy of
      the GeoSeries.
  allow_override : bool, default False
      If the the GeoSeries already has a CRS, allow to replace the
      existing CRS, even when both are not equal.
  
  Returns
  -------
  GeoSeries
  
  Examples
  --------
  >>> from shapely.geometry import Point
  >>> s = geopandas.GeoSeries([Point(1, 1), Point(2, 2), Point(3, 3)])
  >>> s
  0    POINT (1 1)
  1    POINT (2 2)
  2    POINT (3 3)
  dtype: geometry
  
  Setting CRS to a GeoSeries without one:
  
  >>> s.crs is None
  True
  
  >>> s = s.set_crs('epsg:3857')
  >>> s.crs  # doctest: +SKIP
  <Projected CRS: EPSG:3857>
  Name: WGS 84 / Pseudo-Mercator
  Axis Info [cartesian]:
  - X[east]: Easting (metre)
  - Y[north]: Northing (metre)
  Area of Use:
  - name: World - 85°S to 85°N
  - bounds: (-180.0, -85.06, 180.0, 85.06)
  Coordinate Operation:
  - name: Popular Visualisation Pseudo-Mercator
  - method: Popular Visualisation Pseudo Mercator
  Datum: World Geodetic System 1984
  - Ellipsoid: WGS 84
  - Prime Meridian: Greenwich
  
  Overriding existing CRS:
  
  >>> s = s.set_crs(4326, allow_override=True)
  
  Without ``allow_override=True``, ``set_crs`` returns an error if you try to
  override CRS.
  
  See Also
  --------
  GeoSeries.to_crs : re-project to another CRS
docstr_tok: ["Set","the","Coordinate","Reference","System","(","CRS",")","of","a","``","GeoSeries","``",".","NOTE",":","The","underlying","geometries","are","not","transformed","to","this","CRS",".","To","transform","the","geometries","to","a","new","CRS",",","use","the","``","to_crs","``","method",".","Parameters","--","--","--","--","--","crs",":","pyproj.CRS",",","optional","if","`","epsg","`","is","specified","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",".","epsg",":","int",",","optional","if","`","crs","`","is","specified","EPSG","code","specifying","the","projection",".","inplace",":","bool",",","default","False","If","True",",","the","CRS","of","the","GeoSeries","will","be","changed","in","place","(","while","still","returning","the","result",")","instead","of","making","a","copy","of","the","GeoSeries",".","allow_override",":","bool",",","default","False","If","the","the","GeoSeries","already","has","a","CRS",",","allow","to","replace","the","existing","CRS",",","even","when","both","are","not","equal",".","Returns","--","--","--","-","GeoSeries","Examples","--","--","--","--",">",">",">","from","shapely.geometry","import","Point",">",">",">","s","=","geopandas.GeoSeries","(","[","Point","(","1",",","1",")",",","Point","(","2",",","2",")",",","Point","(","3",",","3",")","]",")",">",">",">","s","0","POINT","(","1","1",")","1","POINT","(","2","2",")","2","POINT","(","3","3",")","dtype",":","geometry","Setting","CRS","to","a","GeoSeries","without","one",":",">",">",">","s.crs","is","None","True",">",">",">","s","=","s.set_crs","(","'epsg:3857","'",")",">",">",">","s.crs","#","doctest",":","+SKIP","<","Projected","CRS",":","EPSG:3857",">","Name",":","WGS","84","\/","Pseudo-Mercator","Axis","Info","[","cartesian","]",":","-","X","[","east","]",":","Easting","(","metre",")","-","Y","[","north","]",":","Northing","(","metre",")","Area","of","Use",":","-","name",":","World","-","85\u00b0S","to","85\u00b0N","-","bounds",":","(","-180.0",",","-85.06",",","180.0",",","85.06",")","Coordinate","Operation",":","-","name",":","Popular","Visualisation","Pseudo-Mercator","-","method",":","Popular","Visualisation","Pseudo","Mercator","Datum",":","World","Geodetic","System","1984","-","Ellipsoid",":","WGS","84","-","Prime","Meridian",":","Greenwich","Overriding","existing","CRS",":",">",">",">","s","=","s.set_crs","(","4326",",","allow_override=True",")","Without","``","allow_override=True","``",",","``","set_crs","``","returns","an","error","if","you","try","to","override","CRS",".","See","Also","--","--","--","--","GeoSeries.to_crs",":","re-project","to","another","CRS"]
code: def set_crs(
      self,
      crs: Optional[Any] = None,
      epsg: Optional[int] = None,
      inplace: bool = False,
      allow_override: bool = False,
  ):
      """
      Set the Coordinate Reference System (CRS) of a ``GeoSeries``.
  
      NOTE: The underlying geometries are not transformed to this CRS. To
      transform the geometries to a new CRS, use the ``to_crs`` method.
  
      Parameters
      ----------
      crs : pyproj.CRS, optional if `epsg` is specified
          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.
      epsg : int, optional if `crs` is specified
          EPSG code specifying the projection.
      inplace : bool, default False
          If True, the CRS of the GeoSeries will be changed in place
          (while still returning the result) instead of making a copy of
          the GeoSeries.
      allow_override : bool, default False
          If the the GeoSeries already has a CRS, allow to replace the
          existing CRS, even when both are not equal.
  
      Returns
      -------
      GeoSeries
  
      Examples
      --------
      >>> from shapely.geometry import Point
      >>> s = geopandas.GeoSeries([Point(1, 1), Point(2, 2), Point(3, 3)])
      >>> s
      0    POINT (1 1)
      1    POINT (2 2)
      2    POINT (3 3)
      dtype: geometry
  
      Setting CRS to a GeoSeries without one:
  
      >>> s.crs is None
      True
  
      >>> s = s.set_crs('epsg:3857')
      >>> s.crs  # doctest: +SKIP
      <Projected CRS: EPSG:3857>
      Name: WGS 84 / Pseudo-Mercator
      Axis Info [cartesian]:
      - X[east]: Easting (metre)
      - Y[north]: Northing (metre)
      Area of Use:
      - name: World - 85°S to 85°N
      - bounds: (-180.0, -85.06, 180.0, 85.06)
      Coordinate Operation:
      - name: Popular Visualisation Pseudo-Mercator
      - method: Popular Visualisation Pseudo Mercator
      Datum: World Geodetic System 1984
      - Ellipsoid: WGS 84
      - Prime Meridian: Greenwich
  
      Overriding existing CRS:
  
      >>> s = s.set_crs(4326, allow_override=True)
  
      Without ``allow_override=True``, ``set_crs`` returns an error if you try to
      override CRS.
  
      See Also
      --------
      GeoSeries.to_crs : re-project to another CRS
  
      """
      if crs is not None:
          crs = CRS.from_user_input(crs)
      elif epsg is not None:
          crs = CRS.from_epsg(epsg)
      else:
          raise ValueError("Must pass either crs or epsg.")
  
      if (
          not allow_override
          and self.crs is not None
          and not self.crs == crs
      ):
          raise ValueError(
              "The GeoSeries already has a CRS which is not equal to the passed "
              "CRS. Specify 'allow_override=True' to allow replacing the existing "
              "CRS without doing any transformation. If you actually want to "
              "transform the geometries, use 'GeoSeries.to_crs' instead."
          )
      if not inplace:
          result = self.copy()
      else:
          result = self
      result.crs = crs
      return result
  
imports: from __future__ import annotations
  import json
  import typing
  from typing import Optional, Any, Callable, Dict
  import warnings
  import numpy
  import pandas
  from pandas import Series
  from pandas.core.internals import SingleBlockManager
  from pyproj import CRS
  import shapely
  from shapely.geometry.base import BaseGeometry
  from shapely.geometry import GeometryCollection
  from geopandas.base import GeoPandasBase, _delegate_property
  from geopandas.plotting import plot_series
  from geopandas.explore import _explore_geoseries
  import geopandas
  from .None import _compat
  from ._decorator import doc
  from .array import GeometryDtype, from_shapely, from_wkb, from_wkt, points_from_xy, to_wkb, to_wkt
  from .base import is_geometry_type
label_desc: Use image node_id 33 for calling the GeoSeries obj's underlying member method code with example usage: obj.set_crs(crs, epsg, inplace, allow_override) and returns: result