Hello.
Le ven. 11 mars 2022 à 16:18, Matt Juntunen
<matt.a.juntu...@gmail.com> a écrit :
>
> Hello,
>
> I recently posted a PR [1] for GEOMETRY-142 [2], which is for adding
> PointMap and PointSet implementations. These are Map and Set
> implementations specifically designed to use Points as keys.
Is there a gentle introduction to how it works and/or the intended
use cases?
> They
> support fuzzy key comparison, meaning that points do not have to be
> exactly equal to each other in order to be considered equal by the
> map/set. (Note that this means these types do not follow the strict
> Map/Set contracts since they are not consistent with equals. This is
> documented in the PointMap/PointSet javadocs.)
Does it entail issues about some use cases or applications that
need this functionality? Or do they not generally care about that
contract?
If so, maybe this collection shouldn't implement the standard JDK
interfaces (?).
> I've completely hidden
> the implementation details from the public API
Thanks.
> since I anticipate
> changes in the future with regard to the algorithms used.
Where does the anticipation come from?
> Instances
> are created through factory classes in each space. Ex:
>
> PointMap<Vector3D, String> map = EuclideanCollections.pointMap3D(precision);
> PointSet<Point2S> set = SphericalCollections.pointSet2S(precision);
>
> Since fuzzy key comparison is used, I've added the following methods
> to the interfaces to allow access to the exact, "canonical" version of
> the key stored in the collection.
>
> PointMap<P, V> {
> // return the key corresponding to pt, or null if not found
> P resolveKey(P pt);
>
> // return the map entry corresponding to pt, or null if not found
> Map.Entry<P, V> resolveEntry(P pt);
> }
>
> PointSet<P> {
> // return the key corresponding to pt, or null if not found
> P resolve(P pt);
> }
I don't quite follow; which are the corresponding "non-canonical"
accessors?
>
> Reviews and comments are welcome.
Is there a notion of neighbours (as in: return the "n" entries that
are closest to a given point)?
Regards,
Gilles
>
> Regards,
> Matt Juntunen
>
>
> [1] https://github.com/apache/commons-geometry/pull/194
> [2] https://issues.apache.org/jira/projects/GEOMETRY/issues/GEOMETRY-142
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org
