Package org.apache.commons.geometry.core
Interface Embedding<P extends Point<P>,S extends Point<S>>
- Type Parameters:
P
- Point type defining the embedding space.S
- Point type defining the embedded subspace.
- All Known Subinterfaces:
EmbeddingHyperplane<P,
,S> PlaneConvexSubset.Embedded
,PlaneSubset.Embedded
,RegionEmbedding<P,
S>
- All Known Implementing Classes:
AbstractEmbeddedRegionPlaneSubset
,EmbeddedAreaPlaneConvexSubset
,EmbeddedTreeGreatCircleSubset
,EmbeddedTreeLineSubset
,EmbeddedTreeLineSubset3D
,EmbeddedTreePlaneSubset
,EmbeddingPlane
,GreatArc
,GreatCircle
,GreatCircleSubset
,Line
,Line3D
,LineConvexSubset
,LineConvexSubset3D
,LineSpanningSubset
,LineSpanningSubset3D
,LineSubset
,LineSubset3D
,Ray
,Ray3D
,ReverseRay
,ReverseRay3D
,Segment
,Segment3D
This interface defines mappings between a space and one of its subspaces.
Subspaces are the lower-dimension subsets of a space. For example, in an n-dimension space, the subspaces are the (n-1) dimension space, the (n-2) dimension space, and so on. This interface can be used regardless of the difference in number of dimensions between the space and the target subspace. For example, a line in 3D Euclidean space can use this interface to map directly from 3D Euclidean space to 1D Euclidean space (ie, the location along the line).
-
Method Summary
Modifier and TypeMethodDescriptiontoSpace
(Collection<S> pts) Transform a collection of subspace points into space points.Transform a subspace point into a space point.toSubspace
(Collection<P> pts) Transform a collection of space points into subspace points.toSubspace
(P pt) Transform a space point into a subspace point.
-
Method Details
-
toSubspace
Transform a space point into a subspace point.- Parameters:
pt
- n-dimension point of the space- Returns:
- lower-dimension point of the subspace corresponding to the specified space point
- See Also:
-
toSubspace
Transform a collection of space points into subspace points.- Parameters:
pts
- collection of n-dimension points to transform- Returns:
- collection of transformed lower-dimension points.
- See Also:
-
toSpace
Transform a subspace point into a space point.- Parameters:
pt
- lower-dimension point of the subspace- Returns:
- n-dimension point of the space corresponding to the specified subspace point
- See Also:
-
toSpace
Transform a collection of subspace points into space points.- Parameters:
pts
- collection of lower-dimension points to transform- Returns:
- collection of transformed n-dimension points.
- See Also:
-