HorizontalPosition

java.lang.Object
- io.github.kensuke1984.kibrary.util.HorizontalPosition

すべての実装されたインタフェース:

java.lang.Comparable<HorizontalPosition>

直系の既知のサブクラス:

Location
```
public class HorizontalPosition
extends java.lang.Object
implements java.lang.Comparable<HorizontalPosition>
```
Position
Latitude Longitude
This class is immutable.

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

HorizontalPosition(double latitude, double longitude)
地理緯度、経度でのコンストラクト

コンストラクタ
コンストラクタと説明
`HorizontalPosition(double latitude, double longitude)` 地理緯度、経度でのコンストラクト

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`int`	`compareTo(HorizontalPosition o)` Sorting order is Latitude → Longitude
`boolean`	`equals(java.lang.Object obj)`
`double`	`getAzimuth(HorizontalPosition position)`
`double`	`getBackAzimuth(HorizontalPosition position)`
`double`	`getEpicentralDistance(HorizontalPosition horizontalPosition)`
`double`	`getGeocentricLatitude()`
`double`	`getLatitude()`
`double`	`getLongitude()` (-180:180]
`HorizontalPosition`	`getMidpoint(HorizontalPosition position)` 元点loc0と入力locとの大円上の中点を求める半径は考慮しない locとloc0のなす震央距離を⊿ loc0を北極に持って行ったときのlocの経度をphi1 とすると、点(r, ⊿/2, 0) をｚ軸周りにphi１回転して、loc0を北極から元の位置に戻す作業をすればいい
`double`	`getPath(HorizontalPosition position)` d = 2・N・ψ ここに，地点1の緯度φ1，経度λ1，地点2の緯度φ2，経度λ2のときの直交座標地をそれぞれ（x1，y1，z1），（x2，y2，z2）とすると2地点間の直距離 Rn は A = 6378140m（地球赤道半径），B = 6356755m（地球極半径），ｅ2 = (A2 - B2)/A2 e：離心率 N1 = A/sqrt(1 - e2・sin2φ1)， N_2 = A/sqrt(1 - e2・sin2φ2) x1 = N_1・cosφ1cosλ_1， x2 = N_2・cosφ_2cosλ_2 y1 = N_1・cosφ1sinλ_1， y2 = N_2・cosφ_2sinλ_2 z1 = N_1・(1 - e2)sinφ_1， z2 = N_2・(1 - e**2)sinφ_2 中心から2地点を見込んだ中心角の半分の角 ψ は ψ = sin-1( (Rn/2)/N )， N = (N1 + N2)/2 ただし，計算に使用した緯度・経度はラジアンに変換。
`double`	`getPhi()` 極座標でのφ
`double`	`getTheta()` 極座標でのθ
`int`	`hashCode()`
`Location`	`toLocation(double r)`
`Point2D`	`toPoint2D()`
`java.lang.String`	`toString()`
`XYZ`	`toXYZ(double r)`

クラスから継承されたメソッド java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - HorizontalPosition
```
public HorizontalPosition(double latitude,
                          double longitude)
```
    地理緯度、経度でのコンストラクト
    
    パラメータ:
    
    latitude - [deg] geographic latitude [-90, 90] latitude
    
    longitude - [deg] (-180, 360)
- メソッドの詳細
  - compareTo
```
public int compareTo(HorizontalPosition o)
```
    Sorting order is Latitude → Longitude
    
    定義:
    
    compareTo インタフェース内 java.lang.Comparable<HorizontalPosition>
  - hashCode
```
public int hashCode()
```
    オーバーライド:
    
    hashCode クラス内 java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    オーバーライド:
    
    equals クラス内 java.lang.Object
  - toLocation
```
public Location toLocation(double r)
```
    パラメータ:
    
    r - [km] radius
    
    戻り値:
    
    rの情報を含めたLocation(新しく作る deep copy)
  - getAzimuth
```
public double getAzimuth(HorizontalPosition position)
```
    パラメータ:
    
    position - HorizontalPosition to compute azimuth with
    
    戻り値:
    
    locationとのazimuth [rad]
  - getBackAzimuth
```
public double getBackAzimuth(HorizontalPosition position)
```
    パラメータ:
    
    position - HorizontalPosition to compute back azimuth with
    
    戻り値:
    
    locationとのback azimuth [rad]
  - getLatitude
```
public double getLatitude()
```
    戻り値:
    
    geographic latitude [deg] [-90, 90]（地理緯度）
  - getLongitude
```
public double getLongitude()
```
    (-180:180]
    
    戻り値:
    
    geographic longitude [deg]
  - getTheta
```
public double getTheta()
```
    極座標でのθ
    
    戻り値:
    
    theta [rad] in sperical coordinate.
  - getPhi
```
public double getPhi()
```
    極座標でのφ
    
    戻り値:
    
    phi [rad[ in sperical coordinate.
  - getEpicentralDistance
```
public double getEpicentralDistance(HorizontalPosition horizontalPosition)
```
    パラメータ:
    
    horizontalPosition - HorizontalPosition
    
    戻り値:
    
    epicentral distance [rad] between this and horizontalPosition
  - getMidpoint
```
public HorizontalPosition getMidpoint(HorizontalPosition position)
```
    元点loc0と入力locとの大円上の中点を求める半径は考慮しない locとloc0のなす震央距離を⊿ loc0を北極に持って行ったときのlocの経度をphi1 とすると、点(r, ⊿/2, 0) をｚ軸周りにphi１回転して、loc0を北極から元の位置に戻す作業をすればいい
    
    パラメータ:
    
    position - HorizontalPosition of target
    
    戻り値:
    
    HorizontalPosition of the center between the position and this
  - toXYZ
```
public XYZ toXYZ(double r)
```
    パラメータ:
    
    r - radius
    
    戻り値:
    
    XYZ at radius ｒ
  - toString
```
public java.lang.String toString()
```
    オーバーライド:
    
    toString クラス内 java.lang.Object
  - getGeocentricLatitude
```
public double getGeocentricLatitude()
```
    戻り値:
    
    geocentric latitude [rad]
  - getPath
```
public double getPath(HorizontalPosition position)
```
    d = 2・N・ψ
    ここに，地点1の緯度φ1，経度λ1，地点2の緯度φ2，経度λ2のときの直交座標地をそれぞれ（x1，y1，z1），（x2，y2，z2）とすると2地点間の直距離 Rn は
    A = 6378140m（地球赤道半径），B = 6356755m（地球極半径），ｅ**2 = (A**2 - B**2)/A**2 e：離心率
    N1 = A/sqrt(1 - e**2・sin**2φ1)， N_2 = A/sqrt(1 - e2・sin**2φ2) x1 = N_1・cosφ1cosλ_1， x2 = N_2・cosφ_2cosλ_2 y1 = N_1・cosφ1sinλ_1， y2 = N_2・cosφ_2sinλ_2 z1 = N_1・(1 - e**2)sinφ_1， z2 = N_2・(1 - e**2)sinφ_2
    中心から2地点を見込んだ中心角の半分の角 ψ は
    ψ = sin-1( (Rn/2)/N )， N = (N1 + N2)/2
    ただし，計算に使用した緯度・経度はラジアンに変換。標高は無視して計算。 TODO ずれる
    
    パラメータ:
    
    position - HorizontalPosition of target
    
    戻り値:
    
    大円上での距離精度はそこまでよくない
  - toPoint2D
```
public Point2D toPoint2D()
```
    戻り値:
    
    Point2D of this

クラス HorizontalPosition

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

コンストラクタの詳細

HorizontalPosition

メソッドの詳細

compareTo

hashCode

equals

toLocation

getAzimuth

getBackAzimuth

getLatitude

getLongitude

getTheta

getPhi

getEpicentralDistance

getMidpoint

toXYZ

toString

getGeocentricLatitude

getPath

toPoint2D