TopocentricFrame (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.frames.Frame
- - org.orekit.frames.TopocentricFrame

All Implemented Interfaces:

Serializable, PVCoordinatesProvider
```
public class TopocentricFrame
extends Frame
implements PVCoordinatesProvider
```
地心地固坐标系。
与天体表面附近位置相关联的坐标系。

该坐标系的原点位于定义的大地点位置，右手系的规范三面角为：
- X轴在本地水平面（垂直天顶方向）中，沿着本地平行线向东
- Y轴在水平面（垂直天顶方向）中，沿着本地子午线向北
- Z轴指向天顶方向
Author:

Véronique Pommier-Maurussane

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`TopocentricFrame(BodyShape parentShape, GeodeticPoint point, String name)` 简单构造器。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`GeodeticPoint`	`computeLimitVisibilityPoint(double radius, double azimuth, double elevation)` 计算给定方向上卫星的限制可见点。
`<T extends org.hipparchus.CalculusFieldElement<T>> T`	`getAzimuth(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint, Frame frame, FieldAbsoluteDate<T> date)` 获取点相对于地心地固坐标系中心点的方位角。
`double`	`getAzimuth(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint, Frame frame, AbsoluteDate date)` 获取点相对于地心地固坐标系中心点的方位角。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getCartesianPoint()` 获取定义坐标系原点的表面点。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getEast()` 获取地心地固坐标系的东方向，以父形状坐标系表示。
`<T extends org.hipparchus.CalculusFieldElement<T>> T`	`getElevation(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint, Frame frame, FieldAbsoluteDate<T> date)` 获取点相对于本地点的仰角。
`double`	`getElevation(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint, Frame frame, AbsoluteDate date)` 获取点相对于本地点的仰角。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getNadir()` 获取地心地固坐标系的天顶方向，以父形状坐标系表示。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getNorth()` 获取地心地固坐标系的北方向，以父形状坐标系表示。
`BodyShape`	`getParentShape()` 获取定义本地点的地体形状。
`GeodeticPoint`	`getPoint()` 获取定义坐标系原点的表面点。
`<T extends org.hipparchus.CalculusFieldElement<T>> FieldGeodeticPoint<T>`	`getPoint(org.hipparchus.Field<T> field)` 获取定义坐标系原点的表面点。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getPosition(AbsoluteDate date, Frame frame)` 获取在所选坐标系中的体的位置。
`TimeStampedPVCoordinates`	`getPVCoordinates(AbsoluteDate date, Frame frame)` 获取所选坐标系中地心地固坐标系原点的`PVCoordinates`。
`<T extends org.hipparchus.CalculusFieldElement<T>> T`	`getRange(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint, Frame frame, FieldAbsoluteDate<T> date)` 获取点相对于地心地固坐标系中心点的距离。
`double`	`getRange(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint, Frame frame, AbsoluteDate date)` 获取点相对于地心地固坐标系中心点的距离。
`<T extends org.hipparchus.CalculusFieldElement<T>> T`	`getRangeRate(FieldPVCoordinates<T> extPV, Frame frame, FieldAbsoluteDate<T> date)` 获取点相对于地心地固坐标系中心点的距离率。
`double`	`getRangeRate(PVCoordinates extPV, Frame frame, AbsoluteDate date)` 获取点相对于地心地固坐标系中心点的距离率。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getSouth()` 获取地心地固坐标系的南方向，以父形状坐标系表示。
`<T extends org.hipparchus.CalculusFieldElement<T>> FieldTrackingCoordinates<T>`	`getTrackingCoordinates(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint, Frame frame, FieldAbsoluteDate<T> date)` 获取点相对于本地点的跟踪坐标。
`TrackingCoordinates`	`getTrackingCoordinates(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint, Frame frame, AbsoluteDate date)` 获取点相对于本地点的跟踪坐标。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getWest()` 获取地心地固坐标系的西方向，以父形状坐标系表示。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`getZenith()` 获取地心地固坐标系的天顶方向，以父形状坐标系表示。
`GeodeticPoint`	`pointAtDistance(double azimuth, double elevation, double distance)` 计算从站点观测到的距离为指定值的点。

Methods inherited from class org.orekit.frames.Frame
getAncestor, getDepth, getFrozenFrame, getName, getParent, getRoot, getStaticTransformTo, getStaticTransformTo, getTransformProvider, getTransformTo, getTransformTo, isChildOf, isPseudoInertial, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - TopocentricFrame
```
public TopocentricFrame(BodyShape parentShape,
                        GeodeticPoint point,
                        String name)
```
    简单构造器。
    
    参数：
    
    parentShape - 定义本地点的体形状
    
    point - 定义地心地固坐标系的本地表面点
    
    name - 字符串表示
- Method Detail
  - getParentShape
```
public BodyShape getParentShape()
```
    获取定义本地点的地体形状。
    
    返回：
    
    定义本地点的地体形状
  - getPoint
```
public GeodeticPoint getPoint()
```
    获取定义坐标系原点的表面点。
    
    返回：
    
    定义坐标系原点的表面点
  - getCartesianPoint
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getCartesianPoint()
```
    获取定义坐标系原点的表面点。
    
    返回：
    
    定义坐标系原点的表面点在体坐标系中
    
    自版本：
    
    12.0
  - getPoint
```
public <T extends org.hipparchus.CalculusFieldElement<T>> FieldGeodeticPoint<T> getPoint(org.hipparchus.Field<T> field)
```
    获取定义坐标系原点的表面点。
    
    类型参数：
    
    T - 元素的类型
    
    参数：
    
    field - 元素的字段
    
    返回：
    
    定义坐标系原点的表面点
    
    自版本：
    
    9.3
  - getZenith
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getZenith()
```
    获取地心地固坐标系的天顶方向，以父形状坐标系表示。
    天顶方向定义为本地水平面的法线。
    
    返回：
    
    天顶方向的单位向量
    
    另请参阅：
    
    getNadir()
  - getNadir
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getNadir()
```
    获取地心地固坐标系的天底方向，以父形状坐标系表示。
    天底方向是天顶方向的相反方向。
    
    返回：
    
    天底方向的单位向量
    
    另请参阅：
    
    getZenith()
  - getNorth
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getNorth()
```
    获取地心地固坐标系的北方向，以父形状坐标系表示。
    北方向在水平面中定义（垂直天顶方向），沿着本地子午线。
    
    返回：
    
    北方向的单位向量
    
    另请参阅：
    
    getSouth()
  - getSouth
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getSouth()
```
    获取地心地固坐标系的南方向，以父形状坐标系表示。
    南方向是北方向的相反方向。
    
    返回：
    
    南方向的单位向量
    
    另请参阅：
    
    getNorth()
  - getEast
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getEast()
```
    获取地心地固坐标系的东方向，以父形状坐标系表示。
    东方向在水平面中定义，以便完成直角三角形（东、北、天顶）。
    
    返回：
    
    东方向的单位向量
    
    另请参阅：
    
    getWest()
  - getWest
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getWest()
```
    获取地心地固坐标系的西方向，以父形状坐标系表示。
    西方向是东方向的相反方向。
    
    返回：
    
    西方向的单位向量
    
    另请参阅：
    
    getEast()
  - getTrackingCoordinates
```
public TrackingCoordinates getTrackingCoordinates(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint,
                                                  Frame frame,
                                                  AbsoluteDate date)
```
    获取点相对于本地点的跟踪坐标。
    
    参数：
    
    extPoint - 要计算仰角的点
    
    frame - 点所定义的坐标系
    
    date - 计算日期
    
    返回：
    
    点的跟踪坐标
    
    自版本：
    
    12.0
  - getTrackingCoordinates
```
public <T extends org.hipparchus.CalculusFieldElement<T>> FieldTrackingCoordinates<T> getTrackingCoordinates(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint,
                                                                                                             Frame frame,
                                                                                                             FieldAbsoluteDate<T> date)
```
    获取点相对于本地点的跟踪坐标。
    
    类型参数：
    
    T - 字段元素的类型
    
    参数：
    
    extPoint - 要计算仰角的点
    
    frame - 点所定义的坐标系
    
    date - 计算日期
    
    返回：
    
    点的跟踪坐标
    
    自版本：
    
    12.0
  - getElevation
```
public double getElevation(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint,
                           Frame frame,
                           AbsoluteDate date)
```
    获取点相对于本地点的仰角。
    仰角是本地水平面与从本地点到给定点的方向之间的角度。
    
    参数：
    
    extPoint - 要计算仰角的点
    
    frame - 点所定义的坐标系
    
    date - 计算日期
    
    返回：
    
    点的仰角
  - getElevation
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T getElevation(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint,
                                                                         Frame frame,
                                                                         FieldAbsoluteDate<T> date)
```
    获取点相对于本地点的仰角。
    仰角是本地水平面与从本地点到给定点的方向之间的角度。
    
    类型参数：
    
    T - 元素的类型
    
    参数：
    
    extPoint - 要计算仰角的点
    
    frame - 点所定义的坐标系
    
    date - 计算日期
    
    返回：
    
    点的仰角
    
    自版本：
    
    9.3
  - getAzimuth
```
public double getAzimuth(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint,
                         Frame frame,
                         AbsoluteDate date)
```
    获取点相对于地心地固坐标系中心点的方位角。
    方位角是本地点处的北方向与从本地点到给定点的投影在本地水平面上的角度。方位角按顺时针方向计数，即朝东为正。
    
    参数：
    
    extPoint - 要计算仰角的点
    
    frame - 点所定义的坐标系
    
    date - 计算日期
    
    返回：
    
    点的方位角
  - getAzimuth
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T getAzimuth(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint,
                                                                       Frame frame,
                                                                       FieldAbsoluteDate<T> date)
```
    获取点相对于地心地固坐标系中心点的方位角。
    方位角是本地点处的北方向与从本地点到给定点的投影在本地水平面上的角度。方位角按顺时针方向计数，即朝东为正。
    
    类型参数:
    
    T - 元素的类型
    
    参数:
    
    extPoint - 要计算仰角的点
    
    frame - 定义点的参考系
    
    date - 计算日期
    
    返回值:
    
    点的方位角
    
    自版本:
    
    9.3
  - getRange
```
public double getRange(org.hipparchus.geometry.euclidean.threed.Vector3D extPoint,
                       Frame frame,
                       AbsoluteDate date)
```
    获取与地心参考系中心点相关的点的距离。
    
    参数:
    
    extPoint - 要计算距离的点
    
    frame - 定义点的参考系
    
    date - 计算日期
    
    返回值:
    
    点的距离
  - getRange
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T getRange(org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> extPoint,
                                                                     Frame frame,
                                                                     FieldAbsoluteDate<T> date)
```
    获取与地心参考系中心点相关的点的距离。
    
    类型参数:
    
    T - 元素的类型
    
    参数:
    
    extPoint - 要计算距离的点
    
    frame - 定义点的参考系
    
    date - 计算日期
    
    返回值:
    
    点的距离
    
    自版本:
    
    9.3
  - getRangeRate
```
public double getRangeRate(PVCoordinates extPV,
                           Frame frame,
                           AbsoluteDate date)
```
    获取与地心参考系中心点相关的点的速度。
    
    参数:
    
    extPV - 要计算速度的点/速度
    
    frame - 定义点的参考系
    
    date - 计算日期
    
    返回值:
    
    点的速度（如果点远离参考系则为正）
  - getRangeRate
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T getRangeRate(FieldPVCoordinates<T> extPV,
                                                                         Frame frame,
                                                                         FieldAbsoluteDate<T> date)
```
    获取与地心参考系中心点相关的点的速度。
    
    类型参数:
    
    T - 元素的类型
    
    参数:
    
    extPV - 要计算速度的点/速度
    
    frame - 定义点的参考系
    
    date - 计算日期
    
    返回值:
    
    点的速度（如果点远离参考系则为正）
    
    自版本:
    
    9.3
  - computeLimitVisibilityPoint
```
public GeodeticPoint computeLimitVisibilityPoint(double radius,
                                                 double azimuth,
                                                 double elevation)
```
    计算卫星在给定方向上的极限可见点。
    例如，可以使用此方法计算围绕地面站的可见性圆，可以在方位角上简单循环，使用固定仰角或仰角取决于方位角以考虑地面遮挡。
    
    参数:
    
    radius - 卫星到地心的距离
    
    azimuth - 从站点指向的方位角
    
    elevation - 从站点指向的仰角
    
    返回值:
    
    卫星的极限可见点
  - pointAtDistance
```
public GeodeticPoint pointAtDistance(double azimuth,
                                     double elevation,
                                     double distance)
```
    计算从站点观测到的距离。
    
    参数:
    
    azimuth - 从站点指向的方位角
    
    elevation - 从站点指向的仰角
    
    distance - 到站点的距离
    
    返回值:
    
    观测到的点
  - getPosition
```
public org.hipparchus.geometry.euclidean.threed.Vector3D getPosition(AbsoluteDate date,
                                                                     Frame frame)
```
    获取所选参考系中物体的位置。
    
    由以下指定:
    
    getPosition 在接口 PVCoordinatesProvider
    
    参数:
    
    date - 当前日期
    
    frame - 定义位置的参考系
    
    返回值:
    
    物体的位置（米）
  - getPVCoordinates
```
public TimeStampedPVCoordinates getPVCoordinates(AbsoluteDate date,
                                                 Frame frame)
```
    获取所选参考系中地心参考系原点的PVCoordinates。
    
    由以下指定:
    
    getPVCoordinates 在接口 PVCoordinatesProvider
    
    参数:
    
    date - 当前日期
    
    frame - 定义位置的参考系
    
    返回值:
    
    地心参考系原点的位置/速度（米和米/秒）

Class TopocentricFrame

Constructor Summary

Method Summary

Methods inherited from class org.orekit.frames.Frame

Methods inherited from class java.lang.Object

Constructor Detail

TopocentricFrame

Method Detail

getParentShape

getPoint

getCartesianPoint

getPoint

getZenith

getNadir

getNorth

getSouth

getEast

getWest

getTrackingCoordinates

getTrackingCoordinates

getElevation

getElevation

getAzimuth

getAzimuth

getRange

getRange

getRangeRate

getRangeRate

computeLimitVisibilityPoint

pointAtDistance

getPosition

getPVCoordinates