tpxes¶
- erfa.tpxes(a, b, a0, b0)[source]¶
In the tangent plane projection, given celestial spherical coordinates for a star and the tangent point, solve for the star’s rectangular coordinates in the tangent plane.
- Parameters:
- adouble array
- bdouble array
- a0double array
- b0double array
- Returns:
- xidouble array
- etadouble array
Notes
Wraps ERFA function
eraTpxes
. The ERFA documentation is:- - - - - - - - - e r a T p x e s - - - - - - - - - In the tangent plane projection, given celestial spherical coordinates for a star and the tangent point, solve for the star's rectangular coordinates in the tangent plane. Given: a,b double star's spherical coordinates a0,b0 double tangent point's spherical coordinates Returned: *xi,*eta double rectangular coordinates of star image (Note 2) Returned (function value): int status: 0 = OK 1 = star too far from axis 2 = antistar on tangent plane 3 = antistar too far from axis Notes: 1) The tangent plane projection is also called the "gnomonic projection" and the "central projection". 2) The eta axis points due north in the adopted coordinate system. If the spherical coordinates are observed (RA,Dec), the tangent plane coordinates (xi,eta) are conventionally called the "standard coordinates". For right-handed spherical coordinates, (xi,eta) are also right-handed. The units of (xi,eta) are, effectively, radians at the tangent point. 3) All angular arguments are in radians. 4) This function is a member of the following set: spherical vector solve for > eraTpxes < eraTpxev xi,eta eraTpsts eraTpstv star eraTpors eraTporv origin References: Calabretta M.R. & Greisen, E.W., 2002, "Representations of celestial coordinates in FITS", Astron.Astrophys. 395, 1077 Green, R.M., "Spherical Astronomy", Cambridge University Press, 1987, Chapter 13. This revision: 2018 January 2 Copyright (C) 2013-2023, NumFOCUS Foundation. Derived, with permission, from the SOFA library. See notes at end of file.