程序包 org.hipparchus.geometry.spherical.twod

类 S2Point

java.lang.Object
org.hipparchus.geometry.spherical.twod.S2Point
所有已实现的接口:
Serializable, Point<Sphere2D>
public class S2Point extends Object implements Point<Sphere2D>
该类表示2球面上的一个点。

我们使用数学约定，将x-y平面上的方位角 \( \theta \) 作为第一个坐标，将极角 \( \varphi \) 作为第二个坐标（参见 Spherical Coordinates 在 MathWorld 中）。

此类的实例保证是不可变的。

另请参阅:

  • 字段概要

    字段
    修饰符和类型
    字段
    说明
    static final S2Point
    MINUS_I
    -I（坐标：\( \theta = \pi, \varphi = \pi/2 \)）。
    static final S2Point
    MINUS_J
    -J（坐标：\( \theta = 3\pi/2, \varphi = \pi/2 \)）。
    static final S2Point
    MINUS_K
    -K（坐标：\( \theta = 任意角度, \varphi = \pi \)）。
    static final S2Point
    NaN
    一个所有坐标均设置为 NaN 的向量。
    static final S2Point
    PLUS_I
    +I（坐标：\( \theta = 0, \varphi = \pi/2 \)）。
    static final S2Point
    PLUS_J
    +J（坐标：\( \theta = \pi/2, \varphi = \pi/2 \)）。
    static final S2Point
    PLUS_K
    +K（坐标：\( \theta = 任意角度, \varphi = 0 \)）。

  • 构造器概要

    构造器
    构造器
    说明
    S2Point(double theta, double phi)
    简单构造函数。
    S2Point(Vector3D vector)
    简单构造函数。

  • 方法概要

    修饰符和类型
    方法
    说明
    double
    distance(Point<Sphere2D> point)
    计算该实例与另一个点之间的距离。
    static double
    distance(S2Point p1, S2Point p2)
    计算两点之间的距离（角分离）。
    boolean
    equals(Object other)
    测试2球面上两点是否相等。
    boolean
    equalsIeee754(Object other)
    测试2球面上两点是否相等。
    double
    getPhi()
    获取极角 \( \varphi \)。
    Space
    getSpace()
    获取点所属的空间。
    double
    getTheta()
    获取x-y平面上的方位角 \( \theta \)。
    Vector3D
    getVector()
    获取相应的在3D欧几里德空间中归一化的向量。
    int
    hashCode()
    获取点的哈希码。
    boolean
    isNaN()
    如果此点的任何坐标为 NaN，则返回 true；否则返回 false
    S2Point
    negate()
    获取该实例的相反向量。
    String
    toString()
     

    从类继承的方法 java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • 字段详细资料

    • PLUS_I

      public static final S2Point PLUS_I
      +I（坐标：\( \theta = 0, \varphi = \pi/2 \)）。

    • PLUS_J

      public static final S2Point PLUS_J
      +J（坐标：\( \theta = \pi/2, \varphi = \pi/2 \)）。

    • PLUS_K

      public static final S2Point PLUS_K
      +K（坐标：\( \theta = 任意角度, \varphi = 0 \)）。

    • MINUS_I

      public static final S2Point MINUS_I
      -I（坐标：\( \theta = \pi, \varphi = \pi/2 \)）。

    • MINUS_J

      public static final S2Point MINUS_J
      -J（坐标：\( \theta = 3\pi/2, \varphi = \pi/2 \)）。

    • MINUS_K

      public static final S2Point MINUS_K
      -K（坐标：\( \theta = 任意角度, \varphi = \pi \)）。

    • NaN

      public static final S2Point NaN
      一个所有坐标均设置为 NaN 的向量。

  • 构造器详细资料

  • 方法详细资料

    • getTheta

      public double getTheta()
      获取x-y平面上的方位角 \( \theta \)。
      返回:
      x-y平面上的方位角 \( \theta \)
      另请参阅:

    • getPhi

      public double getPhi()
      获取极角 \( \varphi \)。
      返回:
      极角 \( \varphi \)
      另请参阅:

    • getVector

      public Vector3D getVector()
      获取相应的在3D欧几里德空间中归一化的向量。
      返回:
      归一化的向量

    • getSpace

      public Space getSpace()
      获取点所属的空间。
      指定者:
      getSpace 在接口中 Point<Sphere2D>
      返回:
      包含的空间

    • isNaN

      public boolean isNaN()
      如果此点的任何坐标为 NaN，则返回 true；否则返回 false
      指定者:
      isNaN 在接口中 Point<Sphere2D>
      返回:
      如果此点的任何坐标为 NaN，则返回 true；否则返回 false

    • negate

      public S2Point negate()
      获取该实例的相反向量。
      返回:
      一个与该实例相反的新向量

    • distance

      public double distance(Point<Sphere2D> point)
      计算该实例与另一个点之间的距离。
      指定者:
      distance 在接口中 Point<Sphere2D>
      参数:
      point - 第二个点
      返回:
      该实例与 p 之间的距离

    • distance

      public static double distance(S2Point p1, S2Point p2)
      计算两点之间的距离（角分离）。
      参数:
      p1 - 第一个向量
      p2 - 第二个向量
      返回:
      p1 和 p2 之间的角分离

    • equals

      public boolean equals(Object other)
      测试2球面上两点是否相等。

      如果两点的所有坐标完全相同，并且没有一个是 Double.NaN，则认为这两个点是相等的。

      NaN 坐标被认为全局影响该点并彼此相等 - 即，如果点的任何（或所有）坐标等于 Double.NaN，则该点等于 NaN。

      覆盖:
      equals 在类中 Object
      参数:
      other - 要测试是否与此相等的对象
      返回:
      如果两个2球面上的点对象相等，则返回 true；如果对象为 null、不是 S2Point 的实例或不等于此 S2Point 实例，则返回 false

    • equalsIeee754

      public boolean equalsIeee754(Object other)
      测试2球面上两点是否相等。

      如果两点的所有坐标完全相同，并且没有一个是 Double.NaN，则认为这两个点是相等的。

      根据 IEEE754 处理，如果任一点的任何坐标为 NaN，则认为这些点不同。这意味着 S2Point.NaN.equals(S2Point.NaN) 返回 false，尽管实例与自身进行了检查。

      参数:
      other - 要测试是否与此相等的对象
      返回:
      如果两个点对象相等，则返回 true；如果对象为 null、不是 S2Point 的实例或不等于此 S2Point 实例，则返回 false
      从以下版本开始:
      2.1

    • hashCode

      public int hashCode()
      Get a hashCode for the point.

      All NaN values have the same hash code.

      覆盖:
      hashCode 在类中 Object
      返回:
      为该对象返回一个哈希码值

    • toString

      public String toString()
      覆盖:
      toString 在类中 Object