TimeBase#

class astropy.time.TimeBase[源代码]#

基类：MaskableShapedLikeNDArray

从中继承time和TimeDelta的基时间类。

属性摘要

`T`	返回一个实例，并将数据转置。
`cache`	返回与此实例关联的缓存。
`format`	获取或设置时间格式。
`in_subfmt`	Unix通配符模式，用于选择用于分析字符串输入时间的子格式。
`isscalar`
`jd1`	在JD中内部存储时间值的两个双精度值中的第一个。
`jd2`	JD商店的第二（2）倍的时间价值。
`location`
`mask`	面具。
`masked`	实例是否使用屏蔽值。
`ndim`	实例和基础数组的维度数。
`out_subfmt`	Unix通配符模式，用于选择用于输出时间的子格式。
`precision`	以浮点形式输出秒时的十进制精度（0到9之间的整数值）。
`scale`	时间尺度。
`shape`	时间实例的形状。
`size`	根据形状计算的对象大小。
`unmasked`	获取一个不带遮罩的实例。
`value`	当前格式的时间值(S)。
`writeable`

方法总结

`argmax`([axis, out])	返回给定轴上最大值的索引。
`argmin`([axis, out])	返回沿给定轴的最小值的索引。
`argsort`([axis, kind])	返回将对时间数组进行排序的索引。
`copy`([format])	返回时间对象的完全独立副本，可以选择更改格式。
`diagonal`(args, *kwargs)	返回具有指定对角线的实例。
`filled`(fill_value)	获取底层数据的副本，并填充掩码值。
`flatten`(args, *kwargs)	返回数组折叠为一维的副本。
`insert`(obj, values[, axis])	在列中的给定索引之前插入值，并返回一个新的 `Time` 或 `TimeDelta` 对象。
`isclose`(other[, atol])	返回一个布尔数组或布尔数组，其中两个时间对象在时间容差内元素上相等。
`max`([axis, out, keepdims])	沿给定轴的最大值。
`mean`([axis, dtype, out, keepdims, where])	沿给定轴的平均值。
`min`([axis, out, keepdims])	沿给定轴的最小值。
`ptp`([axis, out, keepdims])
`ravel`(args, *kwargs)	返回数组折叠为一维的实例。
`replicate`([format, copy, cls])	返回时间对象的副本，可以选择更改格式。
`reshape`(args, *kwargs)	返回包含具有新形状的相同数据的实例。
`sort`([axis])	返回沿指定轴排序的副本。
`squeeze`(args, *kwargs)	返回删除了一维形状条目的实例。
`swapaxes`(args, *kwargs)	返回交换给定轴的实例。
`take`(indices[, axis, out, mode])	返回由给定索引处的元素构成的新实例。
`to_string` \()	输出Time或TimeDelta对象的字符串表示形式。
`to_value`(format[, subfmt])	获取以指定输出格式表示的时间值。
`transpose`(args, *kwargs)	返回一个实例，并将数据转置。

属性文档

T#

返回一个实例，并将数据转置。

参数与 T . 所有内部数据都是原始数据的视图。

cache#: 返回与此实例关联的缓存。

format#

获取或设置时间格式。

该格式定义了通过访问时表示时间的方式 .value 属性。默认情况下，它与初始化 Time 实例，但可以将其设置为可用于初始化的任何其他值。这些可以用以下方式列出：

>>> list(Time.FORMATS)
['jd', 'mjd', 'decimalyear', 'unix', 'unix_tai', 'cxcsec', 'gps', 'plot_date',
 'stardate', 'datetime', 'ymdhms', 'iso', 'isot', 'yday', 'datetime64',
 'fits', 'byear', 'jyear', 'byear_str', 'jyear_str']

in_subfmt#: Unix通配符模式，用于选择用于分析字符串输入时间的子格式。

isscalar#

jd1#: 在JD中内部存储时间值的两个双精度值中的第一个。

jd2#: JD商店的第二（2）倍的时间价值。

location#

mask#

masked#

ndim#: 实例和基础数组的维度数。

out_subfmt#: Unix通配符模式，用于选择用于输出时间的子格式。

precision#: 以浮点形式输出秒时的十进制精度（0到9之间的整数值）。

scale#: 时间尺度。

shape#

时间实例的形状。

喜欢 shape ，可以通过指定元组设置为新形状。请注意，如果不同的实例共享一些但不是所有的底层数据，那么设置一个实例的形状可能会使另一个实例不可用。因此，强烈建议对新实例进行重新构造 reshape 方法。

加薪:

ValueError: 如果新形状的元素总数错误。
AttributeError: 如果 jd1 ， jd2 ， location ， delta_ut1_utc 或 delta_tdb_tt 如果不复制数组，则无法更改属性。对于这些情况，请使用 Time.reshape 方法（该方法复制任何不能就地重塑的数组）。

size#: 根据形状计算的对象大小。

unmasked#

获取一个不带遮罩的实例。

请注意，当用户获得新实例时，底层数据将是共享的。

参见

filled: 获取基础数据的副本，并填写了屏蔽值。

value#: 当前格式的时间值(S)。

writeable#

方法文件

argmax(axis=None, out=None)[源代码]#

返回给定轴上最大值的索引。

这和 argmax() ，但为了确保两个数字的完全精度翻倍 jd1 和 jd2 被使用。看到了吗 argmax() 有关详细文档。

argmin(axis=None, out=None)[源代码]#

返回沿给定轴的最小值的索引。

这和 argmin() ，但为了确保两个数字的完全精度翻倍 jd1 和 jd2 被使用。看到了吗 argmin() 有关详细文档。

argsort(axis=-1, kind='stable')[源代码]#

返回将对时间数组进行排序的索引。

这和 argsort() ，但为了确保两个数字的完全精度翻倍 jd1 和 jd2 ，并复制相应的属性。在内部，它使用 lexsort() ，因此无法选择排序方法。

参数:

axis : int ，可选PYTHON：int，可选: 排序所依据的轴。缺省值为-1，表示沿最后一个轴排序。
kind‘稳定’，可选: 使用以下命令进行排序 lexsort() 因此，此参数将被忽略，但为了与兼容而保留 argsort() 。排序是稳定的，这意味着相同元素的顺序保持不变。

返回:

indices : ndarray恩达雷: 对时间数组进行排序的索引数组。

copy(format=None)[源代码]#

返回时间对象的完全独立副本，可以选择更改格式。

如果 format 则返回的时间对象的时间格式将相应设置，否则将与原始时间对象保持不变。

在此方法中，将生成内部时间数组的完整副本。内部时间数组通常不会被用户更改，因此在大多数情况下 replicate() 应使用方法。

参数:

format : str ，可选Python：字符串，可选: 副本的时间格式。

返回:

tm : Time object时间对象: 此对象的副本

diagonal(*args, **kwargs)#

返回具有指定对角线的实例。

参数与 diagonal() . 所有内部数据都是原始数据的视图。

filled(fill_value)#

获取底层数据的副本，并填充掩码值。

参数:

fill_value : object对象: 要替换掩码值的值。

返回:

filled例如: 副本 self 将掩蔽项替换为 fill_value .

参见

unmasked: 获得没有面具的实例。

flatten(*args, **kwargs)#

返回数组折叠为一维的副本。

参数与 flatten() .

insert(obj, values, axis=0)[源代码]#

在列中的给定索引之前插入值，并返回一个新的 Time 或 TimeDelta 对象。

要插入的值必须符合的就地设置规则 Time 对象（请参见 Get and set values 在 Time 文件）。

API签名与 np.insert API，但更为有限。插入索引规范 obj 必须是单个整数，并且 axis 必须是 0 用于索引前的简单行插入。

参数:

obj : intPython ：整型: 前一个整数索引 values 插入。
values : array_likeNumpy：ARRAY_LIKE: 要插入的值。如果 values 与数量不同， values 转换为匹配类型。
axis : int ，可选PYTHON：int，可选: 插入轴 values . 默认值为0，这是唯一允许的值，将插入一行。

返回:

out ： Time 子类时间子类: 具有插入值的新时间对象

isclose(other, atol=None)[源代码]#

返回一个布尔数组或布尔数组，其中两个时间对象在时间容差内元素上相等。

这将计算以下表达式：

abs(self - other) <= atol

参数:

其他： Time时间: 用于比较的时间对象。
atol ： Quantity 或 TimeDelta数量或时间增量: 对以时间为单位的平等的绝对容忍(例如 u.s 或 u.day )。缺省值是128位JD时间表示法中的两位，相当于大约40皮秒。

max(axis=None, out=None, keepdims=False)[源代码]#

沿给定轴的最大值。

这和 max() ，但为了确保两个数字的完全精度翻倍 jd1 和 jd2 ，并复制相应的属性。

请注意 out 参数仅用于与兼容 np.max ；因为 Time 实例是不可变的，不可能有一个 out 将结果存储在中。

mean(axis=None, dtype=None, out=None, keepdims=False, *, where=True)[源代码]#

沿给定轴的平均值。

这类似于 mean() ，但进行了调整，以确保两个双精度 jd1 和 jd2 并复制相应的属性。

请注意， out 参数的存在只是为了与 np.mean ；自 Time 实例是不可变的，因此不可能具有实际的 out 将结果存储在。

类似地， dtype 参数也只是为了兼容性而存在；它对 Time 。

参数:

axis : None 或 int 或 tuple 的 int ，可选PYTHON：NONE或PYTHON：INT或PYTHON：PYTHON的元组：INT，可选: 沿其计算平均值的一个或多个轴。默认情况下，计算展平数组的平均值。
dtype : NonePython ：无: 仅显示为与兼容 mean() ，一定是 None 。
out : NonePython ：无: 仅显示为与兼容 mean() ，一定是 None 。
keepdims : bool ，可选可选的布尔: 如果设置为True，则减少的轴将作为尺寸为1的尺寸保留在结果中。使用此选项，结果将针对输入数组正确广播。
where : array_like 的 bool ，可选NumPy：bool的数组_like，可选: 要包含在平均值中的元素。看见 reduce 了解更多细节。

返回:

m : Time时间: 包含平均值的新时间实例

min(axis=None, out=None, keepdims=False)[源代码]#

沿给定轴的最小值。

这和 min() ，但为了确保两个数字的完全精度翻倍 jd1 和 jd2 ，并复制相应的属性。

请注意 out 参数仅用于与兼容 np.min ；因为 Time 实例是不可变的，不可能有一个 out 将结果存储在中。

ptp(axis=None, out=None, keepdims=False)[源代码]#

自 7.0 版本弃用: Ptp功能已被弃用，可能会在未来的版本中删除。改用NP.Ptp。

沿给定轴的峰对峰（最大值-最小值）。

这种方法类似于 numpy.ptp() 函数，但经过调整以确保两个双精度型 jd1 和 jd2 采用了

请注意 out 参数仅用于与兼容 ptp ；因为 Time 实例是不可变的，不可能有一个 out 将结果存储在中。

ravel(*args, **kwargs)#

返回数组折叠为一维的实例。

参数与 ravel() . 请注意，在不复制数据的情况下，不可能总是分解数组。如果要在复制数据时引发错误，则应指定形状 (-1,) 到形状属性。

replicate(format=None, copy=False, cls=None)[源代码]#

返回时间对象的副本，可以选择更改格式。

如果 format 则返回的时间对象的时间格式将相应设置，否则将与原始时间对象保持不变。

如果 copy 设置为 True 然后将生成内部时间数组的完整副本。默认情况下，为了节省内存，复制副本将使用对原始阵列的引用。内部时间数组通常不可由用户更改，因此在大多数情况下不需要设置 copy 到 True .

方便方法copy（）可用，其中 copy 是 True 默认情况下。

参数:

format : str ，可选Python：字符串，可选: 复制副本的时间格式。
copy : bool ，可选可选的布尔: 返回真实副本，而不是尽可能使用引用。

返回:

tm : Time object时间对象: 此对象的副本

reshape(*args, **kwargs)#

返回包含具有新形状的相同数据的实例。

参数与 reshape() 。请注意，并非总是可以在不复制数据的情况下更改数组的形状(请参见 reshape() 文档)。如果希望在复制数据时引发错误，则应将新形状分配给Shape属性(注意：这可能不适用于所有使用 NDArrayShapeMethods )。

sort(axis=-1)[源代码]#

返回沿指定轴排序的副本。

这和 sort() ，但内部使用索引 lexsort() 以确保两个数字的完全精度加倍 jd1 和 jd2 保留，并且相应的属性也被正确地排序和复制。

参数:

axis : int 或 NonePYTHON：INT或PYTHON：NONE: 要排序的轴。如果 None ，对展平数组进行排序。默认情况下，按最后一个轴排序。

squeeze(*args, **kwargs)#

返回删除了一维形状条目的实例。

参数与 squeeze() . 所有内部数据都是原始数据的视图。

swapaxes(*args, **kwargs)#

返回交换给定轴的实例。

参数与 swapaxes() ： axis1, axis2 . 所有内部数据都是原始数据的视图。

take(indices, axis=None, out=None, mode='raise')#

返回由给定索引处的元素构成的新实例。

参数与 take() ，但显然，不能给出输出数组。

to_string()[源代码]#

输出Time或TimeDelta对象的字符串表示形式。

类似于 str(self.value) (它使用NumPy数组格式)，但数组值仅针对实际输出的项进行求值。对于大型阵列，这可以显著提高性能。

返回:

out : strPython ：字符串: 时间值的字符串表示形式。

to_value(format, subfmt='*')[源代码]#

获取以指定输出格式表示的时间值。

此方法允许表示 Time 所需输出中的对象 format 和可选子格式 subfmt . 可用的内置格式包括 jd ， mjd ， iso 等等。每种格式都可以有自己的子格式

对于内置的数字格式，例如 jd 或 unix ， subfmt 可以是“float”、“long”、“decimal”、“str”或“bytes”之一。在这里，“长期”使用 numpy.longdouble 精度有所提高（增强取决于平台）和“十进制” decimal.Decimal 完全精确。对于'str'和'bytes'，也会选择位数，以便准确表示时间值。

对于内置的类似日期的字符串格式，“date”或“date”或“date”（或“longdate”等）之一，在 TimeFITS ). 对于包括秒的子格式，小数秒使用的位数由 precision .

参数:

format : strPython ：字符串: 需要时间值的格式。默认：当前格式。
subfmt : str 或 None ，可选PYTHON：字符串或PYTHON：无，可选: 值或通配符模式，以选择应在其中给定值的子格式。默认值“*”选择给定格式的第一个可用值，即“float”或“date_hms”。如果 None ，使用实例的 out_subfmt .

transpose(*args, **kwargs)#

返回一个实例，并将数据转置。

参数与 transpose() . 所有内部数据都是原始数据的视图。