org.orekit.frames

Class LocalMagneticFieldFrame

java.lang.Object

org.orekit.frames.LocalMagneticFieldFrame

All Implemented Interfaces:

LOF

public class LocalMagneticFieldFrame
extends Object
implements LOF

这个类处理磁场变化姿态提供者。

它被设计用作Bdot姿态指向法则，将特定的机体轴与地球磁场矢量对齐。

通过磁场进行姿态控制被称为Bdot，因为它沿着轨道跟随地球磁场矢量的正弦变化。在轨道上使用磁力矩器来使仪器与卫星与行星磁场对齐，产生沿着轨道的正弦扭矩。

Author:

Alberto Ferrero, Vincent Cucchietti

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocalMagneticFieldFrame.LOFBuilderVector 枚举定义了本地轨道坐标系的+j轴将如何定义。

Constructor Summary

Constructors

Constructor and Description
LocalMagneticFieldFrame(Frame inertialFrame, GeoMagneticField magneticField, Frame bodyFrame) 使用本地轨道坐标系的默认定义构造函数：x：磁场 y：完整正交框架 z：磁场与轨道动量的叉积。
LocalMagneticFieldFrame(Frame inertialFrame, GeoMagneticField magneticField, LocalMagneticFieldFrame.LOFBuilderVector lofBuilderVector, Frame bodyFrame) 使用自定义本地轨道坐标系定义的构造函数：x：磁场 y：完整正交框架 z：磁场与选择的矢量的叉积 矢量 对于近极轨道，建议使用 轨道动量 来定义本地轨道坐标系。

Method Summary

Modifier and Type	Method and Description
Frame	getInertialFrame() 获取交错帧。
GeoMagneticField	getMagneticField() 获取地球磁场。
String	getName() 获取本地轨道坐标系的名称。
org.hipparchus.geometry.euclidean.threed.Rotation	rotationFromInertial(AbsoluteDate date, PVCoordinates pv) 获取从惯性坐标系到本地轨道坐标系的旋转。
<T extends org.hipparchus.CalculusFieldElement<T>> org.hipparchus.geometry.euclidean.threed.FieldRotation<T>	rotationFromInertial(org.hipparchus.Field<T> field, FieldAbsoluteDate<T> date, FieldPVCoordinates<T> pv) 获取从惯性坐标系到本地轨道坐标系的旋转。

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.frames.LOF

isQuasiInertial, rotationFromLOF, rotationFromLOF, rotationFromLOFInToLOFOut, rotationFromLOFInToLOFOut, transformFromInertial, transformFromInertial, transformFromLOF, transformFromLOF, transformFromLOFInToLOFOut, transformFromLOFInToLOFOut

Constructor Detail

LocalMagneticFieldFrame

public LocalMagneticFieldFrame(Frame inertialFrame,
                               GeoMagneticField magneticField,
                               Frame bodyFrame)

使用本地轨道坐标系的默认定义构造函数：

• x：磁场
• y：完整正交框架
• z：磁场与轨道动量的叉积

. 注意：如果计划在赤道轨道上使用此构造函数，则不要使用，因为磁场和轨道动量矢量将是平行的，会导致错误抛出

参数：

inertialFrame - 计算变换和旋转时给出位置-速度坐标的惯性坐标系

magneticField - 地球磁场模型

bodyFrame - 与机体形状相关的机体坐标系

LocalMagneticFieldFrame

public LocalMagneticFieldFrame(Frame inertialFrame,
                               GeoMagneticField magneticField,
                               LocalMagneticFieldFrame.LOFBuilderVector lofBuilderVector,
                               Frame bodyFrame)

使用自定义本地轨道坐标系定义的构造函数：

• x：磁场
• y：完整正交框架
• z：磁场与选择的 矢量类型

对于近极轨道，建议使用 轨道动量 来定义本地轨道坐标系。然而，对于近赤道轨道，建议使用 位置或速度。

参数：

inertialFrame - 计算变换和旋转时给出位置-速度坐标的惯性坐标系

magneticField - 地球磁场模型

lofBuilderVector - 用于定义本地轨道坐标系的矢量

bodyFrame - 与机体形状相关的机体坐标系

Method Detail

rotationFromInertial

public <T extends org.hipparchus.CalculusFieldElement<T>> org.hipparchus.geometry.euclidean.threed.FieldRotation<T> rotationFromInertial(org.hipparchus.Field<T> field,
                                                                                                                                         FieldAbsoluteDate<T> date,
                                                                                                                                         FieldPVCoordinates<T> pv)

获取从惯性坐标系到本地轨道坐标系的旋转。

此旋转不包括任何时间导数。如果还需要第一时间导数（即旋转速率），则必须调用完整的 LOF.transformFromInertial(FieldAbsoluteDate, FieldPVCoordinates) 方法，并从中提取完整的旋转变换。

方向为X轴与磁场矢量对齐，Y轴与磁场矢量与选择的 矢量类型 的叉积对齐。

注意：在此实现中，该方法简单地将给定字段的正常旋转化为字段。因此，所有导数都会丢失。

接口中指定：

rotationFromInertial 在接口 LOF

类型参数：

T - 字段元素的类型

参数：

field - 元素所属的字段

date - 旋转的日期

pv - 某个惯性坐标系中的航天器的位置-速度

返回：

从惯性坐标系到本地轨道坐标系的旋转

rotationFromInertial

public org.hipparchus.geometry.euclidean.threed.Rotation rotationFromInertial(AbsoluteDate date,
                                                                              PVCoordinates pv)

获取从惯性坐标系到本地轨道坐标系的旋转。

此旋转不包括任何时间导数。如果还需要第一时间导数（即旋转速率），则必须调用完整的 transformFromInertial 方法，并从中提取完整的旋转变换。 方向为X轴与磁场矢量对齐，Z轴与磁场矢量与选择的 矢量类型 的叉积对齐。

接口中指定：

rotationFromInertial 在接口 LOF

参数：

date - 旋转的日期

pv - 某个惯性坐标系中的航天器的位置-速度

返回：

从惯性坐标系到本地轨道坐标系的旋转

getName

public String getName()

获取本地轨道坐标系的名称。

接口中指定：

getName 在接口 LOF

返回：

本地轨道坐标系的名称

getInertialFrame

public Frame getInertialFrame()

获取交错帧。

返回：

惯性坐标系

getMagneticField

public GeoMagneticField getMagneticField()

获取地球磁场。

返回：

地球磁场