environmentaltools.common.to_shp

environmentaltools.common.to_shp(file_name: str, lon: Series, lat: Series, geometry_type: str = 'point', values: Series = None)[source]

Save spatial data to ESRI shapefile format.

Creates shapefiles with point, multi-point, line, or multi-line geometries from coordinate data.

Parameters:

  • file_name (str) – Output shapefile path (without .shp extension).

  • lon (pd.Series or list) – Longitude or X coordinates.

  • lat (pd.Series or list) – Latitude or Y coordinates.

  • geometry_type (str) – Geometry type to create. Options: - ‘point’: Single point - ‘multi-point’: Multiple separate points - ‘line’: Single polyline - ‘multi-line’: Multiple polylines (requires values parameter) Defaults to ‘point’.

  • values (pd.Series, optional) – Values to group coordinates for multi-line geometries. Each unique value creates a separate line. Defaults to None.

Returns:

None

Raises:

  • ImportError – If pyshp package is not installed.

  • ValueError – If geometry_type is not recognized.