Package org.h2gis.functions.io.utility

Class CoordinatesUtils

java.lang.Object
org.h2gis.functions.io.utility.CoordinatesUtils
public final class CoordinatesUtils extends Object
This utility class provides some useful methods related to JTS Coordinate objects.
Author:
Erwan Bocher

  • Method Summary

    Modifier and Type
    Method
    Description
    static boolean
    contains(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)
     
    static boolean
    contains2D(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)
    Checks if a coordinate array contains a specific coordinate.
    static boolean
    contains3D(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)
    Check if a coordinate array contains a specific coordinate.
    static org.locationtech.jts.geom.Coordinate[]
    getFurthestCoordinate(org.locationtech.jts.geom.Coordinate base, org.locationtech.jts.geom.Coordinate[] coords)
    Find the furthest coordinate in a geometry from a base coordinate
    static double
    interpolate(org.locationtech.jts.geom.Coordinate firstCoordinate, org.locationtech.jts.geom.Coordinate lastCoordinate, org.locationtech.jts.geom.Coordinate toBeInterpolated)
    Interpolates a z value (linearly) between the two coordinates.
    static double
    length3D(org.locationtech.jts.geom.CoordinateSequence pts)
    Computes the length of a linestring specified by a sequence of points.
    static double
    length3D(org.locationtech.jts.geom.Geometry geom)
    Returns the 3D length of the geometry
    static double
    length3D(org.locationtech.jts.geom.LineString lineString)
    Returns the 3D perimeter of a line string.
    static double
    length3D(org.locationtech.jts.geom.Polygon polygon)
    Returns the 3D perimeter of a polygon
    static double[]
    zMinMax(org.locationtech.jts.geom.Coordinate[] cs)
    Determine the min and max "z" values in an array of Coordinates.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • interpolate

      public static double interpolate(org.locationtech.jts.geom.Coordinate firstCoordinate, org.locationtech.jts.geom.Coordinate lastCoordinate, org.locationtech.jts.geom.Coordinate toBeInterpolated)
      Interpolates a z value (linearly) between the two coordinates.
      Parameters:
      firstCoordinate -
      lastCoordinate -
      toBeInterpolated -
      Returns:

    • contains

      public static boolean contains(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)

    • contains2D

      public static boolean contains2D(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)
      Checks if a coordinate array contains a specific coordinate. The equality is done only in 2D (z values are not checked).
      Parameters:
      coords -
      coord -
      Returns:

    • contains3D

      public static boolean contains3D(org.locationtech.jts.geom.Coordinate[] coords, org.locationtech.jts.geom.Coordinate coord)
      Check if a coordinate array contains a specific coordinate. The equality is done in 3D (z values ARE checked).
      Parameters:
      coords -
      coord -
      Returns:

    • zMinMax

      public static double[] zMinMax(org.locationtech.jts.geom.Coordinate[] cs)
      Determine the min and max "z" values in an array of Coordinates.
      Parameters:
      cs - The array to search.
      Returns:
      An array of size 2, index 0 is min, index 1 is max.

    • getFurthestCoordinate

      public static org.locationtech.jts.geom.Coordinate[] getFurthestCoordinate(org.locationtech.jts.geom.Coordinate base, org.locationtech.jts.geom.Coordinate[] coords)
      Find the furthest coordinate in a geometry from a base coordinate
      Parameters:
      base -
      coords -
      Returns:
      the base coordinate and the target coordinate

    • length3D

      public static double length3D(org.locationtech.jts.geom.CoordinateSequence pts)
      Computes the length of a linestring specified by a sequence of points. if a coordinate has a NaN z return 0.
      Parameters:
      pts - the points specifying the linestring
      Returns:
      the length of the linestring

    • length3D

      public static double length3D(org.locationtech.jts.geom.Geometry geom)
      Returns the 3D length of the geometry
      Parameters:
      geom -
      Returns:

    • length3D

      public static double length3D(org.locationtech.jts.geom.LineString lineString)
      Returns the 3D perimeter of a line string.
      Parameters:
      lineString -
      Returns:

    • length3D

      public static double length3D(org.locationtech.jts.geom.Polygon polygon)
      Returns the 3D perimeter of a polygon
      Parameters:
      polygon -
      Returns: