Class UnaryUnionOp
- java.lang.Object
-
- org.locationtech.jts.operation.union.UnaryUnionOp
-
public class UnaryUnionOp extends java.lang.Object
Unions aCollection
ofGeometry
s or a single Geometry (which may be aGeoometryCollection
) together. By using this special-purpose operation over a collection of geometries it is possible to take advantage of various optimizations to improve performance. HeterogeneousGeometryCollection
s are fully supported.The result obeys the following contract:
- Unioning a set of
Polygon
s has the effect of merging the areas (i.e. the same effect as iteratively unioning all individual polygons together). - Unioning a set of
LineString
s has the effect of noding and dissolving the input linework. In this context "fully noded" means that there will be an endpoint or node in the result for every endpoint or line segment crossing in the input. "Dissolved" means that any duplicate (i.e. coincident) line segments or portions of line segments will be reduced to a single line segment in the result. This is consistent with the semantics of theGeometry.union(Geometry)
operation. If merged linework is required, theLineMerger
class can be used. - Unioning a set of
Point
s has the effect of merging all identical points (producing a set with no duplicates).
- Unioning a set of
-
-
Field Summary
Fields Modifier and Type Field Description private GeometryFactory
geomFact
private java.util.List
lines
private java.util.List
points
private java.util.List
polygons
-
Constructor Summary
Constructors Constructor Description UnaryUnionOp(java.util.Collection geoms)
Constructs a unary union operation for aCollection
ofGeometry
s, using theGeometryFactory
of the input geometries.UnaryUnionOp(java.util.Collection geoms, GeometryFactory geomFact)
Constructs a unary union operation for aCollection
ofGeometry
s.UnaryUnionOp(Geometry geom)
Constructs a unary union operation for aGeometry
(which may be aGeometryCollection
).
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description private void
extract(java.util.Collection geoms)
private void
extract(Geometry geom)
Geometry
union()
Gets the union of the input geometries.static Geometry
union(java.util.Collection geoms)
Computes the geometric union of aCollection
ofGeometry
s.static Geometry
union(java.util.Collection geoms, GeometryFactory geomFact)
Computes the geometric union of aCollection
ofGeometry
s.static Geometry
union(Geometry geom)
Constructs a unary union operation for aGeometry
(which may be aGeometryCollection
).private Geometry
unionNoOpt(Geometry g0)
Computes a unary union with no extra optimization, and no short-circuiting.private Geometry
unionWithNull(Geometry g0, Geometry g1)
Computes the union of two geometries, either of both of which may be null.
-
-
-
Field Detail
-
polygons
private java.util.List polygons
-
lines
private java.util.List lines
-
points
private java.util.List points
-
geomFact
private GeometryFactory geomFact
-
-
Constructor Detail
-
UnaryUnionOp
public UnaryUnionOp(java.util.Collection geoms, GeometryFactory geomFact)
Constructs a unary union operation for aCollection
ofGeometry
s.- Parameters:
geoms
- a collection of geometriesgeomFact
- the geometry factory to use if the collection is empty
-
UnaryUnionOp
public UnaryUnionOp(java.util.Collection geoms)
Constructs a unary union operation for aCollection
ofGeometry
s, using theGeometryFactory
of the input geometries.- Parameters:
geoms
- a collection of geometries
-
UnaryUnionOp
public UnaryUnionOp(Geometry geom)
Constructs a unary union operation for aGeometry
(which may be aGeometryCollection
).- Parameters:
geom
-
-
-
Method Detail
-
union
public static Geometry union(java.util.Collection geoms)
Computes the geometric union of aCollection
ofGeometry
s.- Parameters:
geoms
- a collection of geometries- Returns:
- the union of the geometries,
or
null
if the input is empty
-
union
public static Geometry union(java.util.Collection geoms, GeometryFactory geomFact)
Computes the geometric union of aCollection
ofGeometry
s. If no input geometries were provided but aGeometryFactory
was provided, an emptyGeometryCollection
is returned.- Parameters:
geoms
- a collection of geometriesgeomFact
- the geometry factory to use if the collection is empty- Returns:
- the union of the geometries, or an empty GEOMETRYCOLLECTION
-
union
public static Geometry union(Geometry geom)
Constructs a unary union operation for aGeometry
(which may be aGeometryCollection
).- Parameters:
geom
- a geometry to union- Returns:
- the union of the elements of the geometry or an empty GEOMETRYCOLLECTION
-
extract
private void extract(java.util.Collection geoms)
-
extract
private void extract(Geometry geom)
-
union
public Geometry union()
Gets the union of the input geometries. If no input geometries were provided but aGeometryFactory
was provided, an emptyGeometryCollection
is returned. Otherwise, the return value isnull
.- Returns:
- a Geometry containing the union,
or an empty GEOMETRYCOLLECTION if no geometries were provided in the input,
or
null
if no GeometryFactory was provided
-
unionWithNull
private Geometry unionWithNull(Geometry g0, Geometry g1)
Computes the union of two geometries, either of both of which may be null.- Parameters:
g0
- a Geometryg1
- a Geometry- Returns:
- the union of the input(s) or null if both inputs are null
-
unionNoOpt
private Geometry unionNoOpt(Geometry g0)
Computes a unary union with no extra optimization, and no short-circuiting. Due to the way the overlay operations are implemented, this is still efficient in the case of linear and puntal geometries. Uses robust version of overlay operation to ensure identical behaviour to the union(Geometry) operation.- Parameters:
g0
- a geometry- Returns:
- the union of the input geometry
-
-