~ubuntu-branches/debian/squeeze/stellarium/squeeze

« back to all changes in this revision

Viewing changes to src/stellplanet/gust86.h

  • Committer: Bazaar Package Importer
  • Author(s): Cédric Delfosse
  • Date: 2008-05-19 21:28:23 UTC
  • mfrom: (3.1.5 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080519212823-m5nfiuntxstxzxj7
Tags: 0.9.1-4
Add libxcursor-dev, libxfixes-dev, libxinerama-dev, libqt4-opengl-dev to
build-deps (Closes: #479906)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/************************************************************************
2
 
 
3
 
COMPUTATION OF THE COORDINATES OF THE URANIAN SATELLITES (GUST86),
4
 
version 0.1 (1988,1995) by LASKAR J. and JACOBSON, R. can be found at
5
 
ftp://ftp.imcce.fr/pub/ephem/satel/gust86
6
 
 
7
 
I (Johannes Gajdosik) have just taken the Fortran code and data
8
 
obtained from above and rearranged it into this piece of software.
9
 
 
10
 
I can neigther allow nor forbid the usage of the GUST86 theory.
11
 
The copyright notice below covers not the works of LASKAR J. and JACOBSON, R.,
12
 
but just my work, that is the compilation of the GUST86 theory
13
 
into the software supplied in this file.
14
 
 
15
 
 
16
 
Copyright (c) 2005 Johannes Gajdosik
17
 
 
18
 
Permission is hereby granted, free of charge, to any person obtaining a
19
 
copy of this software and associated documentation files (the "Software"),
20
 
to deal in the Software without restriction, including without limitation
21
 
the rights to use, copy, modify, merge, publish, distribute, sublicense,
22
 
and/or sell copies of the Software, and to permit persons to whom the
23
 
Software is furnished to do so, subject to the following conditions:
24
 
 
25
 
The above copyright notice and this permission notice shall be included
26
 
in all copies or substantial portions of the Software.
27
 
 
28
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
29
 
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
30
 
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
31
 
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
32
 
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
33
 
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
34
 
SOFTWARE.
35
 
 
36
 
My implementation of GUST86 has the following modifications:
37
 
1) Rotate results to "dynamical equinox and ecliptic J2000",
38
 
   the reference frame of VSOP87 and VSOP87A:
39
 
   The rotation matrix Gust86ToJ2000 can be derived from gust86.f,
40
 
   the rotation J2000ToVsop87 can be derived from vsop87.doc.
41
 
2) units used in calculations: julian day, AU, rad
42
 
3) use the same function EllipticToRectangular that I use in TASS17.
43
 
4) calculate the orbital elements not for every new jd but rather reuse
44
 
   the previousely calculated elements if possible
45
 
 
46
 
****************************************************************/
47
 
 
48
 
 
49
 
#ifndef _GUST86_H_
50
 
#define _GUST86_H_
51
 
 
52
 
#ifdef __cplusplus
53
 
extern "C" {
54
 
#endif
55
 
 
56
 
#define GUST86_MIRANDA   0
57
 
#define GUST86_ARIEL     1
58
 
#define GUST86_UMBRIEL   2
59
 
#define GUST86_TITANIA   3
60
 
#define GUST86_OBERON    4
61
 
 
62
 
void GetGust86Coor(double jd,int body,double *xyz);
63
 
  /* Return the rectangular coordinates of the given satellite
64
 
     and the given julian date jd expressed in dynamical time (TAI+32.184s).
65
 
     The origin of the xyz-coordinates is the center of the planet.
66
 
     The reference frame is "dynamical equinox and ecliptic J2000",
67
 
     which is the reference frame in VSOP87 and VSOP87A.
68
 
 
69
 
     According to vsop87.doc VSOP87 coordinates can be transformed to
70
 
     FK5 (=J2000=ICRF for our accuracy requirements) by
71
 
       X       cos(psi) -sin(psi) 0   1        0         0   X
72
 
       Y     = sin(psi)  cos(psi) 0 * 0 cos(eps) -sin(eps) * Y
73
 
       Z FK5          0         0 1   0 sin(eps)  cos(eps)   Z VSOP87
74
 
     with psi = -0.0000275 degrees = -0.099 arcsec and
75
 
     eps = 23.4392803055556 degrees = 23d26m21.4091sec.
76
 
 
77
 
     http://ssd.jpl.nasa.gov/horizons_doc.html#frames says:
78
 
       "J2000" selects an Earth Mean-Equator and dynamical Equinox of
79
 
       Epoch J2000.0 inertial reference system, where the Epoch of J2000.0
80
 
       is the Julian date 2451545.0. "Mean" indicates nutation effects are
81
 
       ignored in the frame definition. The system is aligned with the
82
 
       IAU-sponsored J2000 frame of the Radio Source Catalog of the
83
 
       International Earth Rotational Service (ICRF).
84
 
       The ICRF is thought to differ from FK5 by at most 0.01 arcsec.
85
 
 
86
 
     From this I conclude that in the context of stellarium
87
 
     ICRF, J2000 and FK5 are the same, while the transformation
88
 
     ICRF <-> VSOP87 must be done with the matrix given above.
89
 
   */
90
 
     
91
 
 
92
 
#ifdef __cplusplus
93
 
}
94
 
#endif
95
 
 
96
 
#endif