Prjprm#

class astropy.wcs.Prjprm#

基类：object

类的新实例，该类包含投影或反投影本机球面坐标所需的信息。它由必须由用户设置的某些成员(给定)和由WCSLIB例程设置的其他成员(返回)组成。后者中的一些供参考，其他仅供内部使用。

属性摘要

`bounds`	控制边界检查。
`category`	Read-only. 与相关值匹配的投影类别 `wcs` 模块常量：
`code`	由FITS标准定义的三字母投影代码。
`conformal`	Read-only. 如果投影是保形的，则为True。
`divergent`	Read-only. 如果投影在纬度上发散，则为True。
`equiareal`	Read-only. 如果投影面积相等，则为True。
`global_projection`	Read-only. 如果投影可以表示有限的非重叠贴图中的整个球体，则为True。
`m`	Read-only. 中间整数值(仅用于 `ZPN` 和 `HPX` 预测)。
`n`	Read-only. 中间整数值(仅用于 `ZPN` 和 `HPX` 预测)。
`name`	Read-only. 投影的详细名称。
`phi0`	当地的经度， \(\phi_0\) 参照点的(以度为单位)，即该点 `(x,y) = (0,0)` 。
`pv`	投影参数。
`pvrange`	Read-only. 投影参数指标范围：第一个允许指标的100倍加上参数个数，例如 `TAN` 为0(无参数)， `SZP` 是103(1到3)，以及 `ZPN` 为30(0到29)。
`r0`	投影的生成球体的半径，一个线性缩放参数。
`simplezen`	Read-only. 如果投影是径向对称的天顶投影，则为True。
`theta0`	原生纬度， \(\theta_0\) 参照点的(以度为单位)，即该点 `(x,y) = (0,0)` 。
`w`	Read-only. 从投影参数派生的中间浮点值，在此处缓存以保存重新计算。
`x0`	Read-only. 中的偏移 `x` 用来强迫 \((x,y) = (0,0)\) 在… \((\phi_0, \theta_0)\) 。
`y0`	Read-only. 中的偏移 `y` 用来强迫 \((x,y) = (0,0)\) 在… \((\phi_0, \theta_0)\) 。

方法总结

`get_pvi`	设置/获取特定指标的投影参数。
`prjs2x`	投影原生球面坐标 \((\phi,\theta)\) 到笛卡尔 `(x,y)` 投影平面上的坐标。
`prjx2s`	笛卡尔反投影 `(x,y)` 投影到本地球面坐标的平面上的坐标 \((\phi,\theta)\) 。
`set`(/)	此方法设置一个 `Prjprm` 对象中提供的信息。
`set_pvi`	设置/获取特定指标的投影参数。

属性文档

bounds#

控制边界检查。如果 bounds&1 然后启用球面到笛卡尔的严格边界检查 (s2x )的转换 AZP ， SZP ， TAN ， SIN ， ZPN ，以及 COP 投射。如果 bounds&2 然后启用笛卡尔到球面变换的严格边界检查 (x2s )，用于 HPX 和 XPH 投射。如果 bounds&4 然后是笛卡尔到球面的变换 (x2s )将调用WCSLIB的 prjbchk() 对计算的原生坐标执行边界检查，并设置公差以适应每个投影。默认情况下，Bound在初始化期间设置为7，这将启用所有检查。将其置零以禁用所有检查。

不需要重置 Prjprm 结构(通过 Prjprm.set() )何时 bounds 已经改变了。

category#

Read-only. 与相关值匹配的投影类别 wcs 模块常量：

PRJ_天顶、PRJ_柱面、PRJ_伪柱面、PRJ_常规、PRJ_圆锥、PRJ_POLYCONIC、PRJ_QUADCUBE和PRJ_HEALPIX。

code#: 由FITS标准定义的三字母投影代码。

conformal#: Read-only. 如果投影是保形的，则为True。

divergent#: Read-only. 如果投影在纬度上发散，则为True。

equiareal#: Read-only. 如果投影面积相等，则为True。

global_projection#: Read-only. 如果投影可以表示有限的非重叠贴图中的整个球体，则为True。

m#: Read-only. 中间整数值(仅用于 ZPN 和 HPX 预测)。

n#: Read-only. 中间整数值(仅用于 ZPN 和 HPX 预测)。

name#: Read-only. 投影的详细名称。

phi0#: 当地的经度， \(\phi_0\) 参照点的(以度为单位)，即该点 (x,y) = (0,0) 。如果未定义，初始化例程会将其设置为特定于投影的缺省值。

pv#

Projection parameters. These correspond to the PVi_ma keywords in FITS, so pv[0] is PVi_0a, pv[1] is PVi_1a, etc., where i denotes the latitude-like axis. Many projections use pv[1] (PVi_1a), some also use pv[2] (PVi_2a) and SZP uses pv[3] (PVi_3a). ZPN is currently the only projection that uses any of the others.

在设置时 pv 使用列表或 numpy.ndarray ，元素设置为 None 将保持不变，而设置为 numpy.nan 将设置为 WCSLIB %s UNDEFINED 有特殊的价值。出于效率目的，如果提供列表或 numpy.ndarray 的长度小于 pv 成员的值，然后在 pv 将保持不变。

备注

在检索时 pv ，一份 prjprm.pv 数组返回。修改此数组值不会修改基础 WCSLIB %s prjprm.pv 数据。

pvrange#: Read-only. 投影参数指标范围：第一个允许指标的100倍加上参数个数，例如 TAN 为0(无参数)， SZP 是103(1到3)，以及 ZPN 为30(0到29)。

r0#: 投影的生成球体的半径，一个线性缩放参数。如果这是零，它将被重置为其缺省值 \(180^\circ/\pi\) (Fits WCS的值)。

simplezen#: Read-only. 如果投影是径向对称的天顶投影，则为True。

theta0#: 原生纬度， \(\theta_0\) 参照点的(以度为单位)，即该点 (x,y) = (0,0) 。如果未定义，初始化例程会将其设置为特定于投影的缺省值。

w#: Read-only. 从投影参数派生的中间浮点值，在此处缓存以保存重新计算。

备注

在检索时 w ，一份 prjprm.w 数组返回。修改此数组值不会修改基础 WCSLIB %s prjprm.w 数据。

x0#: Read-only. 中的偏移 x 用来强迫 \((x,y) = (0,0)\) 在… \((\phi_0, \theta_0)\) 。

y0#: Read-only. 中的偏移 y 用来强迫 \((x,y) = (0,0)\) 在… \((\phi_0, \theta_0)\) 。

方法文件

get_pvi()#

Set/Get projection parameters for specific index. These correspond to the PVi_ma keywords in FITS, so pv[0] is PVi_0a, pv[1] is PVi_1a, etc., where i denotes the latitude-like axis. Many projections use pv[1] (PVi_1a), some also use pv[2] (PVi_2a) and SZP uses pv[3] (PVi_3a). ZPN is currently the only projection that uses any of the others.

设置 pvi 价值目标 None 将重置相应的 WCSLIB %s prjprm.pv 元素设置为由设置的默认值。 WCSLIB %s prjini() 。

设置 pvi 价值目标 numpy.nan 将设置相应的 WCSLIB %s prjprm.pv 元素设置为 WCSLIB %s UNDEFINED 有特殊的价值。

prjs2x()#

投影原生球面坐标 \((\phi,\theta)\) 到笛卡尔 (x,y) 投影平面上的坐标。

投影是由指定的 Prjprm.code 。

参数:

phi : numpy.ndarraynumpy.ndarray: 与经度对应的数组 \(\phi\) 投影点在本地球面坐标中的位置(以度为单位)。
theta : numpy.ndarraynumpy.ndarray: 与经度对应的数组 \(\theta\) 投影点在本地球面坐标中的位置(以度为单位)。对应于无效的值 \((\phi, \theta)\) 坐标设置为 numpy.nan 。

返回:

x, y : tuple 的 numpy.ndarrayPYTHON：umpy.ndarray的元组: 投影坐标。

加薪:

MemoryError: 空值 prjprm 传递给WCSLIB例程的指针。
InvalidPrjParametersError: 投影参数无效。

prjx2s()#

笛卡尔反投影 (x,y) 投影到本地球面坐标的平面上的坐标 \((\phi,\theta)\) 。

投影是由指定的 Prjprm.code 。

参数:

x, y : numpy.ndarraynumpy.ndarray: 对应于第一个 (x )和第二 (y )投影坐标。

返回:

phi, theta : tuple 的 numpy.ndarrayPYTHON：umpy.ndarray的元组: 经度和纬度 \((\phi,\theta)\) 投影点在本地球面坐标中的位置(以度为单位)。对应于无效的值 (x,y) 坐标设置为 numpy.nan 。

加薪:

MemoryError: 空值 prjprm 传递给WCSLIB例程的指针。
InvalidPrjParametersError: 投影参数无效。

set(/)#

此方法设置一个 Prjprm 对象中提供的信息。

请注意，此例程不需要直接调用；它将由 prjx2s 和 prjs2x 如果 Prjprm.flag 是除预定义的魔术值之外的任何值。

的一个重要性质 set() 是投影代码必须在 Prjprm 为了 set() 以确定所需的投影。

加薪:

MemoryError: 空值 prjprm 传递给WCSLIB例程的指针。
InvalidPrjParametersError: 投影参数无效。
InvalidCoordinateError: 一个或多个 (x,y) 或 (lon,lat) 坐标无效。

set_pvi()#

Set/Get projection parameters for specific index. These correspond to the PVi_ma keywords in FITS, so pv[0] is PVi_0a, pv[1] is PVi_1a, etc., where i denotes the latitude-like axis. Many projections use pv[1] (PVi_1a), some also use pv[2] (PVi_2a) and SZP uses pv[3] (PVi_3a). ZPN is currently the only projection that uses any of the others.

设置 pvi 价值目标 None 将重置相应的 WCSLIB %s prjprm.pv 元素设置为由设置的默认值。 WCSLIB %s prjini() 。

设置 pvi 价值目标 numpy.nan 将设置相应的 WCSLIB %s prjprm.pv 元素设置为 WCSLIB %s UNDEFINED 有特殊的价值。