dtoolkit.geoaccessor.series.to_geoseries#

dtoolkit.geoaccessor.series.to_geoseries(s: pd.Series, /, crs: CRS | str | int = None, **kwargs) → gpd.GeoSeries | pd.Series[source]#

Transform an array of shapely scalars Series to a GeoSeries.

Parameters:

crsCRS, str, int, optional: Coordinate Reference System of the geometry objects. Can be anything accepted by from_user_input(), such as an authority string (eg “EPSG:4326” / 4326) or a WKT string.
**kwargs: See the documentation for GeoSeries and for complete details on the keyword arguments.

Returns:

GeoSeries or Series: GeoSeries if the data is an array of shapely scalars.

See also

dtoolkit.geoaccessor.series.to_geoframe
dtoolkit.geoaccessor.dataframe.to_geoframe

Examples

>>> import dtoolkit.geoaccessor
>>> import pandas as pd
>>> s = pd.Series(
...     pd.Series(
...         [
...             "POINT (1 1)",
...             "POINT (2 2)",
...             "POINT (3 3)",
...         ],
...         name="WKT",
...     )
...     .from_wkt(crs=4326)
...     .geometry
... )
>>> s
0    POINT (1.00000 1.00000)
1    POINT (2.00000 2.00000)
2    POINT (3.00000 3.00000)
Name: geometry, dtype: geometry
>>> type(s)
<class 'pandas.core.series.Series'>
>>> gs = s.to_geoseries()
>>> gs
0    POINT (1.00000 1.00000)
1    POINT (2.00000 2.00000)
2    POINT (3.00000 3.00000)
Name: geometry, dtype: geometry
>>> type(gs)
<class 'geopandas.geoseries.GeoSeries'>