geopandas.GeoSeries.offset_curve#

GeoSeries.offset_curve(distance, quad_segs=8, join_style='round', mitre_limit=5.0)[source]#

Returns a LineString or MultiLineString geometry at a distance from the object on its right or its left side. Parameters ———- distance : float | array-like

Specifies the offset distance from the input geometry. Negative for right side offset, positive for left side offset.

quad_segsint (optional, default 8): Specifies the number of linear segments in a quarter circle in the approximation of circular arcs.
join_style{‘round’, ‘bevel’, ‘mitre’}, (optional, default ‘round’): Specifies the shape of outside corners. ‘round’ results in rounded shapes. ‘bevel’ results in a beveled edge that touches the original vertex. ‘mitre’ results in a single vertex that is beveled depending on the mitre_limit parameter.
mitre_limitfloat (optional, default 5.0): Crops of ‘mitre’-style joins if the point is displaced from the buffered vertex by more than this limit.

See http://shapely.readthedocs.io/en/latest/manual.html#object.offset_curve for details.

Examples

>>> from shapely.geometry import LineString
>>> s = geopandas.GeoSeries(
...     [
...         LineString([(0, 0), (0, 1), (1, 1)]),
...     ],
...     crs=3857
... )
>>> s
0    LINESTRING (0 0, 0 1, 1 1)
dtype: geometry

>>> s.offset_curve(1)
0    LINESTRING (-1 0, -1 1, -0.981 1.195, -0.924 1...
dtype: geometry