CCDData#

class astropy.nddata.CCDData(*args, **kwd)[源代码]#

基类：NDDataArray

描述基本CCD数据的类。

CCDData类基于NDData对象，包括单个CCD图像的数据数组、不确定帧、掩码帧、标志帧、元数据、单元和WCS信息。

参数:

data : CCDDataastropy:-like 或 array_likeCCDDataAsterpy：-LIKE或NumPY：ARRAY_LIKE: 其中包含的实际数据 CCDData 对象。请注意，数据将始终由参考，所以你应该复制 data 如果这是你想要的行为的话。
uncertainty : StdDevUncertainty, VarianceUncertainty, InverseVariance, numpy.ndarray or None ，可选StdDevUncertity、VarianceUncerfity、InverseVariance、numpy.ndarray或python：无，可选: 数据的不确定性。如果不确定性是 numpy.ndarray ，它假定为，并存储为 StdDevUncertainty . 默认是 None .
mask : numpy.ndarray or None ，可选Numpy.ndarray或PYTHON：无，可选: 数据的掩码，以布尔Numpy数组的形式给出，其形状与数据的形状匹配。值必须是 False 数据在哪里 有效的 和 True 如果不是的话（比如Numpy掩码数组）。如果 data 是一个numpy蒙面数组，提供 mask 这将导致掩码数组中的掩码被忽略。默认为 None .
flags : numpy.ndarray or FlagCollection or None ，可选Numpy.ndarray或FlagCollection或PYTHON：无，可选: 提供每个像素信息的标志。可以将这些数组指定为具有与数据形状匹配的任何类型的Numpy数组，也可以指定为 FlagCollection 实例，其形状与数据的形状匹配。默认为 None .
wcs : WCS or None ，可选WCS或PYTHON：无，可选: 包含数据的世界坐标系的WCS对象。默认为 None .
meta : dict-like object 或 None ，可选像dict一样: 此对象的元数据。“元数据”这里指的是包含在该对象中的所有信息，但不属于该特定对象的任何其他属性的一部分，例如创建日期、唯一标识符、模拟参数、曝光时间、望远镜名称等。
unit : Unit or str ，可选单位或 Python ：字符串，可选: 数据的单位。默认为 None .

警告

如果单位是 None 或者没有另外指定它将引发一个 ValueError
psf : numpy.ndarray or None ，可选Numpy.ndarray或PYTHON：无，可选: 此图像中心的PSF的图像表示。为了使卷积保持通量不变，通常应将其归一化以求和为一。

加薪:

ValueError: 如果 uncertainty 或 mask 无法将输入（例如，匹配形状）广播到 data .

笔记

CCDData 对象可以很容易地转换为常规: Numpy数组使用 numpy.asarray .

例如：：

>>> from astropy.nddata import CCDData
>>> import numpy as np
>>> x = CCDData([1,2,3], unit='adu')
>>> np.asarray(x)
array([1, 2, 3])

例如，这在使用matplotlib打印二维图像时非常有用。

>>> from astropy.nddata import CCDData
>>> from matplotlib import pyplot as plt   
>>> x = CCDData([[1,2,3], [4,5,6]], unit='adu')
>>> plt.imshow(x)   

属性:

known_invalid_fits_unit_strings: 将常用的字典映射到技术上无效的单元名称字符串到正确的有效单元类型（或单元字符串）中。这主要适用于变体名称，如“电子/S”，这些名称在形式上无效，但不含糊且经常遇到，因此可以方便地将其映射到正确的单位。

方法

*read(args, 夸克）	`Classmethod` 基于创建CCDData实例 `FITS` 文件。此方法使用 `fits_ccddata_reader()` 使用提供的参数。
*write(args, 夸克）	将CCDData实例的内容写入新的 `FITS` 文件。此方法使用 `fits_ccddata_writer()` 使用提供的参数。

属性摘要

`data`	`ndarray` -例如：存储的数据集。
`header`
`known_invalid_fits_unit_strings`
`psf`	数据集的PSF的图像表示形式。
`uncertainty`	任何类型：数据集中的不确定性，如果有的话。
`unit`	`Unit` ：数据集的单位（如果有）。
`wcs`	任何类型：数据集的世界坐标系（WCS）（如果有）。

方法总结

`add`(operand[, operand2])	见 `astropy.nddata.NDArithmeticMixin.add` .
`copy` \()	返回CCDData对象的副本。
`divide`(operand[, operand2])	见 `astropy.nddata.NDArithmeticMixin.divide` .
`multiply`(operand[, operand2])	见 `astropy.nddata.NDArithmeticMixin.multiply` .
`subtract`(operand[, operand2])	见 `astropy.nddata.NDArithmeticMixin.subtract` .
`to_hdu`([hdu_mask, hdu_uncertainty, ...])	从CCDData对象创建HDUList对象。

属性文档

data#

header#

known_invalid_fits_unit_strings = {'ELECTRONS': Unit("electron"), 'ELECTRONS/S': Unit("electron / s"), 'electrons': Unit("electron")}#

psf#

uncertainty#

unit#

wcs#

方法文件

classmethod add(operand, operand2=None, **kwargs)#: 见 astropy.nddata.NDArithmeticMixin.add .

copy()[源代码]#: 返回CCDData对象的副本。

classmethod divide(operand, operand2=None, **kwargs)#: 见 astropy.nddata.NDArithmeticMixin.divide .

classmethod multiply(operand, operand2=None, **kwargs)#: 见 astropy.nddata.NDArithmeticMixin.multiply .

classmethod subtract(operand, operand2=None, **kwargs)#: 见 astropy.nddata.NDArithmeticMixin.subtract .

to_hdu(hdu_mask='MASK', hdu_uncertainty='UNCERT', hdu_flags=None, wcs_relax=True, key_uncertainty_type='UTYPE', as_image_hdu=False, hdu_psf='PSFIMAGE')[源代码]#

从CCDData对象创建HDUList对象。

参数:

hdu_mask, hdu_uncertainty, hdu_flags, hdu_psf : str 或 None ，可选PYTHON：字符串或PYTHON：无，可选: 如果是字符串，则将此属性附加到HDUList ImageHDU 以字符串作为扩展名。目前不支持标志。如果 None 不追加此属性。缺省值为 'MASK' 对于面具， 'UNCERT' 对于不确定性， 'PSFIMAGE' 对于PSF，以及 None 为了旗帜。
wcs_relax : bool布尔: 的值 relax 用于将WCS转换为FITS标头时使用的参数 to_header . 普通的 CTYPE RA---TAN-SIP 和 DEC--TAN-SIP 要求 relax=True 对于 -SIP 部分 CTYPE 保存。
key_uncertainty_type : str ，可选Python：字符串，可选: 用于在不确定度hdu中存储不确定性类型的不确定性（如果有）的类名的头键名。默认为 UTYPE .

在 3.1 版本加入.
as_image_hdu : bool布尔: 如果此选项为 True ，返回的第一项 HDUList 是一种 ImageHDU ，而不是默认设置 PrimaryHDU 。

返回:

hdulist公司 ： HDUListHDUList

加薪:

ValueError

如果 self.mask 已设置但不是 numpy.ndarray .
如果 self.uncertainty 是固定的，但不是一个可怕的不确定性类型。
如果 self.uncertainty 已设置，但有另一个单位 self.data .

NotImplementedError

不支持保存标志。