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.

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)