pygeos.set_operations
¶
-
pygeos.set_operations.
difference
(a, b, **kwargs)¶ Returns the part of geometry A that does not intersect with geometry B.
- Parameters
a : Geometry or array_like
b : Geometry or array_like
Examples
>>> line = Geometry("LINESTRING (0 0, 2 2)") >>> difference(line, Geometry("LINESTRING (1 1, 3 3)")) <pygeos.Geometry LINESTRING (0 0, 1 1)> >>> difference(line, Geometry("LINESTRING EMPTY")) <pygeos.Geometry LINESTRING (0 0, 2 2)> >>> difference(line, None) is None True
-
pygeos.set_operations.
intersection
(a, b, **kwargs)¶ Returns the geometry that is shared between input geometries.
- Parameters
a : Geometry or array_like
b : Geometry or array_like
See also
Examples
>>> line = Geometry("LINESTRING(0 0, 2 2)") >>> intersection(line, Geometry("LINESTRING(1 1, 3 3)")) <pygeos.Geometry LINESTRING (1 1, 2 2)>
-
pygeos.set_operations.
intersection_all
(geometries, axis=0, **kwargs)¶ Returns the intersection of multiple geometries.
- Parameters
geometries : array_like
axis : int
Axis along which the operation is performed. The default (zero) performs the operation over the first dimension of the input array. axis may be negative, in which case it counts from the last to the first axis.
See also
Examples
>>> line_1 = Geometry("LINESTRING(0 0, 2 2)") >>> line_2 = Geometry("LINESTRING(1 1, 3 3)") >>> intersection_all([line_1, line_2]) <pygeos.Geometry LINESTRING (1 1, 2 2)> >>> intersection_all([[line_1, line_2, None]], axis=1).tolist() [None]
-
pygeos.set_operations.
symmetric_difference
(a, b, **kwargs)¶ Returns the geometry that represents the portions of input geometries that do not intersect.
- Parameters
a : Geometry or array_like
b : Geometry or array_like
See also
Examples
>>> line = Geometry("LINESTRING(0 0, 2 2)") >>> symmetric_difference(line, Geometry("LINESTRING(1 1, 3 3)")) <pygeos.Geometry MULTILINESTRING ((0 0, 1 1), (2 2, 3 3))>
-
pygeos.set_operations.
symmetric_difference_all
(geometries, axis=0, **kwargs)¶ Returns the symmetric difference of multiple geometries.
- Parameters
geometries : array_like
axis : int
Axis along which the operation is performed. The default (zero) performs the operation over the first dimension of the input array. axis may be negative, in which case it counts from the last to the first axis.
See also
Examples
>>> line_1 = Geometry("LINESTRING(0 0, 2 2)") >>> line_2 = Geometry("LINESTRING(1 1, 3 3)") >>> symmetric_difference_all([line_1, line_2]) <pygeos.Geometry MULTILINESTRING ((0 0, 1 1), (2 2, 3 3))> >>> symmetric_difference_all([[line_1, line_2, None]], axis=1).tolist() [None]
-
pygeos.set_operations.
union
(a, b, **kwargs)¶ Merges geometries into one.
- Parameters
a : Geometry or array_like
b : Geometry or array_like
See also
Examples
>>> line = Geometry("LINESTRING(0 0, 2 2)") >>> union(line, Geometry("LINESTRING(2 2, 3 3)")) <pygeos.Geometry MULTILINESTRING ((0 0, 2 2), (2 2, 3 3))> >>> union(line, None) is None True
-
pygeos.set_operations.
union_all
(geometries, axis=0, **kwargs)¶ Returns the union of multiple geometries.
- Parameters
geometries : array_like
axis : int
Axis along which the operation is performed. The default (zero) performs the operation over the first dimension of the input array. axis may be negative, in which case it counts from the last to the first axis.
See also
Examples
>>> line_1 = Geometry("LINESTRING(0 0, 2 2)") >>> line_2 = Geometry("LINESTRING(2 2, 3 3)") >>> union_all([line_1, line_2]) <pygeos.Geometry MULTILINESTRING ((0 0, 2 2), (2 2, 3 3))> >>> union_all([[line_1, line_2, None]], axis=1).tolist() [<pygeos.Geometry MULTILINESTRING ((0 0, 2 2), (2 2, 3 3))>]