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 有特殊的价值。