Unit (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.utils.units.Unit

All Implemented Interfaces:

Serializable
```
public class Unit
extends Object
implements Serializable
```
基本处理乘法单位。
这个类绝不是单位处理的完整实现。要获得完整支持，请查看像UOM这样的库。这个类仅处理时间、长度、质量和电流维度，以及角度（无量纲）。

此类的实例是不可变的。

Since:

11.0

Author:

Luc Maisonobe

See Also:

UOM, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static Unit`	`AMPERE` 安培单位。
`static Unit`	`ARC_MINUTE` 角分单位。
`static Unit`	`ARC_SECOND` 角秒单位。
`static Unit`	`BAR` 巴单位。
`static Unit`	`COULOMB` 库仑单位。
`static Unit`	`DAY` 天单位。
`static Unit`	`DEGREE` 度单位。
`static Unit`	`EARTH_RADII` 地球半径用作CCSDS OMM中的Bstar单位。
`static Unit`	`GRAM` 克单位。
`static Unit`	`HERTZ` 赫兹单位。
`static Unit`	`HOUR` 小时单位。
`static Unit`	`JOULE` 焦耳单位。
`static Unit`	`KILOGRAM` 千克单位。
`static Unit`	`KILOMETRE` 千米单位。
`static Unit`	`METRE` 米单位。
`static Unit`	`MINUTE` 分钟单位。
`static Unit`	`NEWTON` 牛顿单位。
`static Unit`	`NONE` 无单位。
`static Unit`	`OHM` 欧姆单位。
`static Unit`	`ONE` 无量纲单位。
`static Unit`	`PASCAL` 帕斯卡单位。
`static Unit`	`PERCENT` 百分比单位。
`static Unit`	`RADIAN` 弧度单位。
`static Unit`	`REVOLUTION` 圈单位。
`static Unit`	`SECOND` 秒单位。
`static Unit`	`SOLAR_FLUX_UNIT` 太阳辐射单位。
`static Unit`	`TESLA` 特斯拉单位。
`static Unit`	`TOTAL_ELECTRON_CONTENT_UNIT` 总电子含量单位。
`static Unit`	`VOLT` 伏特单位。
`static Unit`	`WATT` 瓦特单位。
`static Unit`	`YEAR` 儒略年单位。

Constructor Summary

Constructors
Constructor and Description
`Unit(String name, double scale, org.hipparchus.fraction.Fraction mass, org.hipparchus.fraction.Fraction length, org.hipparchus.fraction.Fraction time, org.hipparchus.fraction.Fraction current, org.hipparchus.fraction.Fraction angle)` 简单构造器。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Unit`	`alias(String newName)` 为单位创建别名。
`Unit`	`divide(String newName, Unit other)` 创建单位的商。
`static void`	`ensureCompatible(String description, List<Unit> reference, boolean allowScaleDifferences, List<Unit> units)` 确保一些单位与参考单位兼容。
`boolean`	`equals(Object unit)` 检查实例是否表示与另一个实例相同的单位。
`double`	`fromSI(double value)` 将值从国际单位制转换。
`double`	`fromSI(Double value)` 将值从国际单位制转换。
`org.hipparchus.fraction.Fraction`	`getAngle()` 获取角度指数。
`org.hipparchus.fraction.Fraction`	`getCurrent()` 获取电流指数。
`org.hipparchus.fraction.Fraction`	`getLength()` 获取长度指数。
`org.hipparchus.fraction.Fraction`	`getMass()` 获取质量指数。
`String`	`getName()` 获取单位的名称。
`double`	`getScale()` 获取到国际单位制的比例因子。
`org.hipparchus.fraction.Fraction`	`getTime()` 获取时间指数。
`int`	`hashCode()` 为此单位创建哈希码。
`Unit`	`multiply(String newName, Unit other)` 创建单位的乘积。
`static Unit`	`parse(String unitSpecification)` 解析单位。
`Unit`	`power(String newName, org.hipparchus.fraction.Fraction exponent)` 创建单位的幂。
`boolean`	`sameDimension(Unit other)` 检查单位是否与另一个单位具有相同的维度。
`Unit`	`sameDimensionSI()` 创建具有相同维度的国际单位制单位。
`Unit`	`scale(String newName, double factor)` 缩放单位。
`Unit`	`sqrt(String newName)` 创建单位的根。
`double`	`toSI(double value)` 将值转换为国际单位制单位。
`double`	`toSI(Double value)` 将值转换为国际单位制单位。
`String`	`toString()`

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

- Field Detail
  - NONE
```
public static final Unit NONE
```
    无单位。
  - ONE
```
public static final Unit ONE
```
    无量纲单位。
  - PERCENT
```
public static final Unit PERCENT
```
    百分比单位。
  - SECOND
```
public static final Unit SECOND
```
    秒单位。
  - MINUTE
```
public static final Unit MINUTE
```
    分钟单位。
  - HOUR
```
public static final Unit HOUR
```
    小时单位。
  - DAY
```
public static final Unit DAY
```
    天单位。
  - YEAR
```
public static final Unit YEAR
```
    儒略年单位。
    
    另请参阅:
    
    IAU的SI单位
  - HERTZ
```
public static final Unit HERTZ
```
    赫兹单位。
  - METRE
```
public static final Unit METRE
```
    米单位。
  - KILOMETRE
```
public static final Unit KILOMETRE
```
    千米单位。
  - KILOGRAM
```
public static final Unit KILOGRAM
```
    千克单位。
  - GRAM
```
public static final Unit GRAM
```
    克单位。
  - AMPERE
```
public static final Unit AMPERE
```
    安培单位。
  - RADIAN
```
public static final Unit RADIAN
```
    弧度单位。
  - DEGREE
```
public static final Unit DEGREE
```
    度单位。
  - ARC_MINUTE
```
public static final Unit ARC_MINUTE
```
    角分单位。
  - ARC_SECOND
```
public static final Unit ARC_SECOND
```
    角秒单位。
  - REVOLUTION
```
public static final Unit REVOLUTION
```
    圈单位。
  - NEWTON
```
public static final Unit NEWTON
```
    牛顿单位。
  - PASCAL
```
public static final Unit PASCAL
```
    帕斯卡单位。
  - BAR
```
public static final Unit BAR
```
    巴单位。
  - JOULE
```
public static final Unit JOULE
```
    焦耳单位。
  - WATT
```
public static final Unit WATT
```
    瓦特单位。
  - COULOMB
```
public static final Unit COULOMB
```
    库仑单位。
  - VOLT
```
public static final Unit VOLT
```
    伏特单位。
  - OHM
```
public static final Unit OHM
```
    欧姆单位。
  - TESLA
```
public static final Unit TESLA
```
    特斯拉单位。
  - SOLAR_FLUX_UNIT
```
public static final Unit SOLAR_FLUX_UNIT
```
    太阳辐射单位。
  - TOTAL_ELECTRON_CONTENT_UNIT
```
public static final Unit TOTAL_ELECTRON_CONTENT_UNIT
```
    总电子含量单位。
  - EARTH_RADII
```
public static final Unit EARTH_RADII
```
    地球半径用作CCSDS OMM中的Bstar单位。
- Constructor Detail
  - Unit
```
public Unit(String name,
            double scale,
            org.hipparchus.fraction.Fraction mass,
            org.hipparchus.fraction.Fraction length,
            org.hipparchus.fraction.Fraction time,
            org.hipparchus.fraction.Fraction current,
            org.hipparchus.fraction.Fraction angle)
```
    简单构造器。
    
    参数:
    
    name - 单位的名称
    
    scale - 到国际单位制的比例因子
    
    mass - 质量指数
    
    length - 长度指数
    
    time - 时间指数
    
    current - 电流指数
    
    angle - 角度指数
- Method Detail
  - getName
```
public String getName()
```
    获取单位的名称。
    
    返回:
    
    单位的名称
  - getScale
```
public double getScale()
```
    获取到国际单位制的比例因子。
    
    返回:
    
    到国际单位制的比例因子
  - getMass
```
public org.hipparchus.fraction.Fraction getMass()
```
    获取质量指数。
    
    返回:
    
    质量指数
  - getLength
```
public org.hipparchus.fraction.Fraction getLength()
```
    获取长度指数。
    
    返回:
    
    长度指数
  - getTime
```
public org.hipparchus.fraction.Fraction getTime()
```
    获取时间指数。
    
    返回:
    
    时间指数
  - getCurrent
```
public org.hipparchus.fraction.Fraction getCurrent()
```
    获取电流指数。
    
    返回:
    
    电流指数
  - getAngle
```
public org.hipparchus.fraction.Fraction getAngle()
```
    获取角度指数。
    
    返回:
    
    角度指数
  - sameDimension
```
public boolean sameDimension(Unit other)
```
    检查单位是否与另一个单位具有相同的维度。
    
    参数:
    
    other - 要检查的其他单位
    
    返回:
    
    如果单位与另一个单位具有相同的维度，则为true
  - sameDimensionSI
```
public Unit sameDimensionSI()
```
    创建具有相同维度的国际单位制单位。
    
    返回:
    
    一个新的单位，具有与实例相同的维度，并且比例因子设置为1.0
  - ensureCompatible
```
public static void ensureCompatible(String description,
                                    List<Unit> reference,
                                    boolean allowScaleDifferences,
                                    List<Unit> units)
```
    确保一些单位与参考单位兼容。
    
    参数:
    
    description - 单位列表的描述（用于生成错误消息）
    
    reference - 参考单位
    
    units - 要检查的单位
    
    allowScaleDifferences - 如果为true，则允许具有相同维度但不同比例的单位（如KILOMETRE与METRE），否则它们将触发异常
    
    抛出:
    
    OrekitException - 如果单位不兼容（元素数量、维度或比例）
  - alias
```
public Unit alias(String newName)
```
    为单位创建别名。
    
    参数:
    
    newName - 新单位的名称
    
    返回:
    
    代表与实例相同单位但名称不同的新单位
  - scale
```
public Unit scale(String newName,
                  double factor)
```
    缩放单位。
    
    参数:
    
    newName - 新单位的名称
    
    factor - 缩放因子
    
    返回:
    
    代表缩放倍数的新单位
  - power
```
public Unit power(String newName,
                  org.hipparchus.fraction.Fraction exponent)
```
    创建单位的幂。
    
    参数:
    
    newName - 新单位的名称
    
    exponent - 要应用的指数
    
    返回:
    
    代表实例幂的新单位
  - sqrt
```
public Unit sqrt(String newName)
```
    创建单位的根。
    
    参数:
    
    newName - 新单位的名称
    
    返回:
    
    代表实例平方根的新单位
  - multiply
```
public Unit multiply(String newName,
                     Unit other)
```
    创建单位的乘积。
    
    参数:
    
    newName - 新单位的名称
    
    other - 要与之相乘的单位
    
    返回:
    
    代表此单位乘以另一个单位的新单位
  - divide
```
public Unit divide(String newName,
                   Unit other)
```
    创建单位的商。
    
    参数:
    
    newName - 新单位的名称
    
    other - 要除以的单位
    
    返回:
    
    代表此单位除以另一个单位的新单位
  - toSI
```
public double toSI(double value)
```
    将值转换为国际单位制单位。
    
    参数:
    
    value - 实例单位的值
    
    返回:
    
    国际单位制单位中的值
  - toSI
```
public double toSI(Double value)
```
    将值转换为国际单位制单位。
    
    参数:
    
    value - 实例单位的值
    
    返回:
    
    国际单位制单位中的值
  - fromSI
```
public double fromSI(double value)
```
    将值从国际单位制单位转换。
    
    参数:
    
    value - 国际单位制单位的值
    
    返回:
    
    实例单位中的值
  - fromSI
```
public double fromSI(Double value)
```
    将值从国际单位制单位转换。
    
    参数:
    
    value - 国际单位制单位的值
    
    返回:
    
    实例单位中的值
  - parse
```
public static Unit parse(String unitSpecification)
```
    解析单位。
    单位规范的语法允许链式单位乘法和除法，以及对单位进行幂运算。
    
    用于单位的符号是SI单位及一些扩展。
    
    年
    
    朱利安年的非SI单位是"a"，但我们也接受"yr"
    
    天
    
    天的非SI单位是"d"，但我们也接受"day"
    
    无量纲
    
    "1"和"#"（U+0023，井号）都被接受
    
    质量
    
    "g"是标准符号，尽管单位是"kg"（它是唯一一个在名称中有前缀的单位，因此所有倍数必须基于"g"）
    
    度
    
    度的基本符号是"°"（U+00B0，度符号），但我们也接受"◦"（U+25E6，白色圆点）和"deg"
    
    角分
    
    角分的基本符号是"′"（U+2032，分）但我们也接受"'"（U+0027，撇号）
    
    角秒
    
    角秒的基本符号是"″"（U+2033，秒）但我们也接受"''"（两个U+0027，撇号），"\""（U+0022，引号）和"as"
    
    所有SI前缀（从"y"，yocto，到"Y"，Yotta）都被接受，以及整数前缀。微10⁻⁶的标准符号是"µ"（U+00B5，微符号），但我们也接受"μ"（U+03BC，希腊字母小mu）。请注意，某些组合是被禁止的，例如"Pa"是帕斯卡，而不是peta年，"as"对于此解析器来说是角秒，而不是atto秒，因为太空领域的许多人使用mas表示毫角秒，µas表示微角秒。请注意，前缀是区分大小写的！整数前缀可用于指定单位，如"30s"，但只能在规范的开头使用一次（即"2rev/d²"是被接受的，但"rev/(2d)²"是被拒绝的）。符合SI手册《国际单位制》（第9版，2019年）的规定，每个SI前缀都是单位的一部分，并且在单位符号之前没有分隔符（即MHz被视为一个标识符）。
    乘法
    
    可以用"*"（U+002A，星号），"×"（U+00D7，乘号），"."（U+002E，句点）或"·"（U+00B7，中点）作为运算符来指定
    
    除法
    
    可以用"/"（U+002F，斜杠）或"⁄"（U+2044，分数斜杠）作为运算符来指定
    
    幂
    
    可以通过以下方式指定
    
    使用Unicode "√"（U+221A，平方根）字符作为前缀
    
    使用"**"，"^"后缀或隐式使用Unicode上标
    指数可以以不同的方式指定：
    - 作为整数，如"m^-2"或"m⁻²"
    - 直接作为Unicode字符表示少数Unicode支持的分数，如"Ω^⅞"
    - 作为CCSDS使用的特殊十进制值0.5，如"km**0.5"
    - 作为用斜杠或分数斜杠分隔的两个整数括在括号中，如"Pa^(11/12)"
    对于整数指数，如果使用明确的指数标记"**"或"^"，则数字必须是来自Unicode基本拉丁块的ASCII数字，或者如果使用隐式指数（即根本没有标记），则必须使用Unicode上标数字。对于分数指数，不允许使用Unicode上标，因为Unicode不提供上标斜杠。负指数也可以使用。
    这些规则意味着所有以下（愚蠢的）示例都会被正确解析：MHz，km/√d，kg.m.s⁻¹，µas^⅖/(h**(2)×m)³，km/√(kg.s)，km**0.5，2rev/d²
    参数：
    
    unitSpecification - 要解析的单位规范
    
    返回：
    
    解析后的单位
  - equals
```
public boolean equals(Object unit)
```
    检查实例是否表示与另一个实例相同的单位。
    名称不被考虑，因此别名被视为相等。
    
    覆盖：
    
    equals 在类 Object中
    
    参数：
    
    unit - 其他单位
    
    返回：
    
    如果实例和其他单位引用相同的单位，则为true
  - hashCode
```
public int hashCode()
```
    获取此单位的哈希码。
    
    覆盖：
    
    hashCode 在类 Object中
    
    返回：
    
    哈希码
  - toString
```
public String toString()
```
    覆盖：
    
    toString 在类 Object中

Class Unit

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NONE

ONE

PERCENT

SECOND

MINUTE

HOUR

DAY

YEAR

HERTZ

METRE

KILOMETRE

KILOGRAM

GRAM

AMPERE

RADIAN

DEGREE

ARC_MINUTE

ARC_SECOND

REVOLUTION

NEWTON

PASCAL

BAR

JOULE

WATT

COULOMB

VOLT

OHM

TESLA

SOLAR_FLUX_UNIT

TOTAL_ELECTRON_CONTENT_UNIT

EARTH_RADII

Constructor Detail

Unit

Method Detail

getName

getScale

getMass

getLength

getTime

getCurrent

getAngle

sameDimension

sameDimensionSI

ensureCompatible

alias

scale

power

sqrt

multiply

divide

toSI

toSI

fromSI

fromSI

parse

equals

hashCode

toString