pyerfa 2.0.1.4

安装说明

您可以使用简单的命令从软件包目录安装该软件包。

$ pip install .

同样，可以使用以下命令创建wheel文件：

$ pip wheel .

您可以从PyPI或直接从git仓库获取该软件包。

$ git clone --recursive https://github.com/liberfa/pyerfa/

该软件包还提供了夜间轮询wheel，获取方式如下：

$ pip install --upgrade --index-url https://pypi.anaconda.org/liberfa/simple pyerfa --pre

测试

为了测试，可以一起安装软件包及其测试依赖项，然后使用以下命令进行测试：

$ pip install .[test]
$ pytest

或者，可以使用tox，它将为您设置一个单独的测试环境，具有以下功能：

$ tox -e test

用法

该软件包可以作为erfa导入，它包含所有由ERFA封装的ufuncs的python代码，并记录错误和警告。还公开了由ERFA在erfam.h中定义的常量，以及对应于ERFA使用的结构的numpy.dtype。示例

>>> import erfa
>>> erfa.jd2cal(2460000., [0, 1, 2, 3])
(array([2023, 2023, 2023, 2023], dtype=int32),
 array([2, 2, 2, 2], dtype=int32),
 array([24, 25, 26, 27], dtype=int32),
 array([0.5, 0.5, 0.5, 0.5]))
>>> erfa.plan94(2460000., [0, 1, 2, 3], 1)
array([([ 0.09083713, -0.39041392, -0.21797389], [0.02192341, 0.00705449, 0.00149618]),
       ([ 0.11260694, -0.38275202, -0.21613731], [0.02160375, 0.00826891, 0.00217806]),
       ([ 0.13401992, -0.37387798, -0.21361622], [0.0212094 , 0.00947838, 0.00286503]),
       ([ 0.15500031, -0.36379788, -0.21040601], [0.02073822, 0.01068061, 0.0035561 ])],
      dtype={'names': ['p', 'v'], 'formats': [('<f8', (3,)), ('<f8', (3,))], 'offsets': [0, 24], 'itemsize': 48, 'aligned': True})
>>> erfa.dt_pv
dtype([('p', '<f8', (3,)), ('v', '<f8', (3,))], align=True)
>>> erfa.dt_eraLDBODY
dtype([('bm', '<f8'), ('dl', '<f8'), ('pv', [('p', '<f8', (3,)), ('v', '<f8', (3,))])], align=True)
>>> erfa.DAYSEC
86400.0

您也可以直接使用ufuncs，但那时必须显式处理警告和错误状态。例如，比较以下内容：

>>> erfa.jd2cal(-600000., [0, 1, 2, 3])
Traceback (most recent call last):
...
ErfaError: ERFA function "jd2cal" yielded 4 of "unacceptable date (Note 1)"
>>> erfa.ufunc.jd2cal(-600000., [0, 1, 2, 3])
(array([-1, -1, -1, -1], dtype=int32),
 ...,
 array([-1, -1, -1, -1], dtype=int32))

许可

PyERFA采用3条款BSD风格许可 - 请参阅LICENSE.rst文件。