| 1 | #include "slalib.h" | 
|---|
| 2 | #include "slamac.h" | 
|---|
| 3 | void slaMap ( double rm, double dm, double pr, double pd, | 
|---|
| 4 | double px, double rv, double eq, double date, | 
|---|
| 5 | double *ra, double *da ) | 
|---|
| 6 | /* | 
|---|
| 7 | **  - - - - - - - | 
|---|
| 8 | **   s l a M a p | 
|---|
| 9 | **  - - - - - - - | 
|---|
| 10 | ** | 
|---|
| 11 | **  Transform star RA,Dec from mean place to geocentric apparent. | 
|---|
| 12 | ** | 
|---|
| 13 | **  The reference frames and timescales used are post IAU 1976. | 
|---|
| 14 | ** | 
|---|
| 15 | **  References: | 
|---|
| 16 | **     1984 Astronomical Almanac, pp B39-B41. | 
|---|
| 17 | **     (also Lederle & Schwan, Astron. Astrophys. 134, 1-6, 1984) | 
|---|
| 18 | ** | 
|---|
| 19 | **  Given: | 
|---|
| 20 | **     rm,dm    double     mean RA,Dec (rad) | 
|---|
| 21 | **     pr,pd    double     proper motions:  RA,Dec changes per Julian year | 
|---|
| 22 | **     px       double     parallax (arcsec) | 
|---|
| 23 | **     rv       double     radial velocity (km/sec, +ve if receding) | 
|---|
| 24 | **     eq       double     epoch and equinox of star data (Julian) | 
|---|
| 25 | **     date     double     TDB for apparent place (JD-2400000.5) | 
|---|
| 26 | ** | 
|---|
| 27 | **  Returned: | 
|---|
| 28 | **     *ra,*da  double     apparent RA,Dec (rad) | 
|---|
| 29 | ** | 
|---|
| 30 | **  Called: | 
|---|
| 31 | **     slaMappa       star-independent parameters | 
|---|
| 32 | **     slaMapqk       quick mean to apparent | 
|---|
| 33 | ** | 
|---|
| 34 | **  Notes: | 
|---|
| 35 | ** | 
|---|
| 36 | **     1)  eq is the Julian epoch specifying both the reference | 
|---|
| 37 | **         frame and the epoch of the position - usually 2000. | 
|---|
| 38 | **         For positions where the epoch and equinox are | 
|---|
| 39 | **         different, use the routine slaPm to apply proper | 
|---|
| 40 | **         motion corrections before using this routine. | 
|---|
| 41 | ** | 
|---|
| 42 | **     2)  The distinction between the required TDB and TDT is | 
|---|
| 43 | **         always negligible.  Moreover, for all but the most | 
|---|
| 44 | **         critical applications UTC is adequate. | 
|---|
| 45 | ** | 
|---|
| 46 | **     3)  The proper motions in RA are dRA/dt rather than | 
|---|
| 47 | **         cos(dec)*dra/dt. | 
|---|
| 48 | ** | 
|---|
| 49 | **     4)  This routine may be wasteful for some applications | 
|---|
| 50 | **         because it recomputes the Earth position/velocity and | 
|---|
| 51 | **         the precession/nutation matrix each time, and because | 
|---|
| 52 | **         it allows for parallax and proper motion.  Where | 
|---|
| 53 | **         multiple transformations are to be carried out for one | 
|---|
| 54 | **         epoch, a faster method is to call the slaMappa routine | 
|---|
| 55 | **         once and then either the slaMapqk routine (which includes | 
|---|
| 56 | **         parallax and proper motion) or slaMapqkz (which assumes | 
|---|
| 57 | **         zero parallax and proper motion). | 
|---|
| 58 | ** | 
|---|
| 59 | **  Last revision:   12 June 1996 | 
|---|
| 60 | ** | 
|---|
| 61 | **  Copyright P.T.Wallace.  All rights reserved. | 
|---|
| 62 | */ | 
|---|
| 63 | { | 
|---|
| 64 | double amprms[21]; | 
|---|
| 65 |  | 
|---|
| 66 | /* Star-independent parameters */ | 
|---|
| 67 | slaMappa ( eq, date, amprms ); | 
|---|
| 68 |  | 
|---|
| 69 | /* Mean to apparent */ | 
|---|
| 70 | slaMapqk ( rm, dm, pr, pd, px, rv, amprms, ra, da ); | 
|---|
| 71 | } | 
|---|