dtoolkit.geoaccessor.dataframe.from_xy#

dtoolkit.geoaccessor.dataframe.from_xy(df: pd.DataFrame, /, x: Hashable, y: Hashable, z: Hashable = None, crs: CRS | str | int = None) → gpd.GeoDataFrame[source]#

Generate GeoDataFrame of Point geometries from columns of DataFrame.

A sugary syntax wraps geopandas.points_from_xy().

Parameters
xHashable

df’s column name.

yHashable

df’s column name.

zHashable, optional

df’s column name.

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.

dropbool, default False

Don’t contain x, y and z columns anymore.

Deprecated since version 0.0.20: If you want to drop x, y and z columns, please use .drop(columns=[...]) method instead.

Returns
GeoDataFrame

See also

geopandas.points_from_xy
geopandas.GeoSeries.from_xy
dtoolkit.geoaccessor.dataframe.from_wkt

Notes

  • This method is the accessor of DataFrame, not GeoDataFrame.

  • This method could be called via df.points_from_xy or df.from_xy.

Examples

>>> import dtoolkit.geoaccessor
>>> import pandas as pd
>>> df = pd.DataFrame({"x": [122, 100], "y":[55, 1]})
>>> df
     x   y
0  122  55
1  100   1
>>> df.from_xy("x", "y", crs="EPSG:4326")
     x   y                    geometry
0  122  55  POINT (122.00000 55.00000)
1  100   1   POINT (100.00000 1.00000)