Module org.apache.lucene.spatial3d
Package org.apache.lucene.spatial3d.geom

Class GeoStandardPath.BaseSegmentEndpoint

java.lang.Object
org.apache.lucene.spatial3d.geom.BasePlanetObject
org.apache.lucene.spatial3d.geom.GeoBaseBounds
org.apache.lucene.spatial3d.geom.GeoStandardPath.BaseSegmentEndpoint
All Implemented Interfaces:
Bounded, GeoBounds, GeoStandardPath.PathComponent, GeoStandardPath.SegmentEndpoint, Membership, PlanetObject, SerializableObject
Direct Known Subclasses:
GeoStandardPath.CircleSegmentEndpoint, GeoStandardPath.CutoffDualCircleSegmentEndpoint
Enclosing class:
GeoStandardPath
private static class GeoStandardPath.BaseSegmentEndpoint extends GeoBaseBounds implements GeoStandardPath.SegmentEndpoint
Base implementation of SegmentEndpoint

  • Field Details

    • previous

      protected final GeoStandardPath.PathComponent previous
      The previous path element

    • point

      protected final GeoPoint point
      The center point of the endpoint

    • NO_MEMBERSHIP

      protected static final Membership[] NO_MEMBERSHIP
      Null membership

  • Constructor Details

  • Method Details

    • isWithin

      public boolean isWithin(Vector point)
      Description copied from interface: GeoStandardPath.PathComponent
      Check if point is within this endpoint.
      Specified by:
      isWithin in interface GeoStandardPath.PathComponent
      Specified by:
      isWithin in interface Membership
      Parameters:
      point - is the point.
      Returns:
      true of within.

    • isWithin

      public boolean isWithin(double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Check if point is within this endpoint.
      Specified by:
      isWithin in interface GeoStandardPath.PathComponent
      Specified by:
      isWithin in interface Membership
      Parameters:
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      true of within.

    • isWithinSection

      public boolean isWithinSection(double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Check if point is within this section (within cutoff planes).
      Specified by:
      isWithinSection in interface GeoStandardPath.PathComponent

    • isWithinSection

      public boolean isWithinSection(Vector point)
      Description copied from interface: GeoStandardPath.PathComponent
      Check if point is within this section (within cutoff planes).
      Specified by:
      isWithinSection in interface GeoStandardPath.PathComponent

    • getStartingDistance

      public double getStartingDistance(DistanceStyle distanceStyle)
      Description copied from interface: GeoStandardPath.PathComponent
      Retrieve the starting distance along the path for this path element.
      Specified by:
      getStartingDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style
      Returns:
      the starting path distance in aggregation form

    • distance

      public double distance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute distance measure starting from beginning of the path and including perpendicular dog-leg to a point within the corridor.
      Specified by:
      distance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style
      x - is the x coordinate of the point we want to get the distance to
      y - is the y coordinate of the point we want to get the distance to
      z - is the z coordinate of the point we want to get the distance to
      Returns:
      the distance from start of path

    • nearestDistance

      public GeoStandardPath.DistancePair nearestDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Get the nearest distance for a point. This is the old "legacy" computation: We find the segment endpoint or path segment with the closest pathCenterDistance(), and keep track of the one where that's at a minimum. We then compute nearestPathDistance() if it's a segment and add that to fullPathDistance() computed along the entire path up to that point.

      So what we are minimizing is not what we are returning here. That is why this is tricky to modularize; we need to return two values: the best pathCenterDistance, and the corresponding nearestPathDistance + startingDistance.

      Specified by:
      nearestDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style
      x - is the x coordinate of the point we want to get the distance to
      y - is the y coordinate of the point we want to get the distance to
      z - is the z coordinate of the point we want to get the distance to
      Returns:
      the DistancePair containing both distances described above

    • fullPathDistance

      public double fullPathDistance(DistanceStyle distanceStyle)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute the total distance this path component adds to the path.
      Specified by:
      fullPathDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      Returns:
      the full path distance.

    • pathDeltaDistance

      public double pathDeltaDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute delta path distance.
      Specified by:
      pathDeltaDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      the distance metric, in aggregation form.

    • pathDistance

      public double pathDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute path distance.
      Specified by:
      pathDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      the distance

    • nearestPathDistance

      public double nearestPathDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute nearest path distance (distance from start of segment to point adjacent the one specitied, if reachable by this segment).
      Specified by:
      nearestPathDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      the distance metric, in aggregation form.

    • pathCenterDistance

      public double pathCenterDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute path center distance (distance from the point to center of the path, if reachable by this segment).
      Specified by:
      pathCenterDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      the distance metric, or POSITIVE_INFINITY if the point is not within the bounds of the path segment.

    • outsideDistance

      public double outsideDistance(DistanceStyle distanceStyle, double x, double y, double z)
      Description copied from interface: GeoStandardPath.PathComponent
      Compute external distance.
      Specified by:
      outsideDistance in interface GeoStandardPath.PathComponent
      Parameters:
      distanceStyle - is the distance style.
      x - is the point x.
      y - is the point y.
      z - is the point z.
      Returns:
      the distance metric.

    • intersects

      public boolean intersects(Plane p, XYZBounds planeBounds, GeoPoint[] notablePoints, Membership[] bounds)
      Description copied from interface: GeoStandardPath.PathComponent
      Determine if this endpoint intersects a specified plane.
      Specified by:
      intersects in interface GeoStandardPath.PathComponent
      Parameters:
      p - is the plane.
      planeBounds - are the XYZBounds of the plane we're looking for an intersection with.
      notablePoints - are the points associated with the plane.
      bounds - are any bounds which the intersection must lie within.
      Returns:
      true if there is a matching intersection.

    • intersects

      public boolean intersects(GeoShape geoShape)
      Description copied from interface: GeoStandardPath.PathComponent
      Determine if this endpoint intersects a GeoShape.
      Specified by:
      intersects in interface GeoStandardPath.PathComponent
      Parameters:
      geoShape - is the GeoShape.
      Returns:
      true if there is shape intersect this endpoint.

    • getBounds

      public void getBounds(Bounds bounds)
      Description copied from interface: Bounded
      Compute bounds for the shape.
      Specified by:
      getBounds in interface Bounded
      Specified by:
      getBounds in interface GeoStandardPath.PathComponent
      Overrides:
      getBounds in class GeoBaseBounds
      Parameters:
      bounds - is the input bounds object. The input object will be modified.

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class BasePlanetObject

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class BasePlanetObject

    • toString

      public String toString()
      Overrides:
      toString in class Object