1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
/***************************************************************************
jupitermoons.h - description
-------------------
begin : Fri Oct 18 2002
copyright : (C) 2002 by Jason Harris
email : kstars@30doradus.org
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
#ifndef JUPITERMOONS_H
#define JUPITERMOONS_H
#include "skypoint.h"
/**@class JupiterMoons
*Implements the four largest moons of Jupiter.
*See Chapter 43 of "Astronomical Algorithms"by Jean Meeus for details
*
*TODO: make the moons SkyObjects, rather than just points.
*
*@author Jason Harris
*@version 1.0
*/
class KSPlanet;
class KSSun;
class JupiterMoons {
public:
/**Constructor. Assign the name of each moon,
*and initialize their XYZ positions to zero.
*/
JupiterMoons();
/**Destructor (empty)*/
~JupiterMoons();
/**Find the positions of each Moon, relative to Jupiter.
*We use an XYZ coordinate system, centered on Jupiter,
*where the X-axis corresponds to Jupiter's Equator,
*the Y-Axis is parallel to Jupiter's Poles, and the
*Z-axis points along the line joining the Earth and
*Jupiter. Once the XYZ positions are known, this
*function also computes the RA,Dec positions of each
*Moon, and sets the inFront bool variable to indicate
*whether the Moon is nearer to us than Jupiter or not
*(this information is used to determine whether the
*Moon should be drawn on top of Jupiter, or vice versa).
*
*See "Astronomical Algorithms" bu Jean Meeus, Chapter 43.
*
*@param num pointer to the KSNumbers object describing
*the date/time at which to find the positions.
*@param jup pointer to the jupiter object
*@param ksun pointer to the Sun object
*/
void findPosition( const KSNumbers *num, const KSPlanet *jup, const KSSun *ksun );
/**@return pointer to the stored RA,Dec position of a moon.
*@param id which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto
*/
SkyPoint* pos( int id ) { return &Pos[id]; }
/**@return TRUE if the Moon is nearer to Earth than Jupiter.
*@param id which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto
*/
bool inFront( int id ) const { return InFront[id]; }
/**@return the name of a moon.
*@param id which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto
*/
QString name( int id ) const { return Name[id]; }
/**@return ID number of a moon, given its name:
*0=Io, 1=Europa, 2=Ganymede, 3=Callisto.
*Return -1 if the name does not match one of these.
*/
int moonNamed( const QString &name ) const;
/**Convert the RA,Dec coordinates of each moon to Az,Alt
*@param LSTh pointer to the current local sidereal time
*@param lat pointer to the geographic latitude
*/
void EquatorialToHorizontal( const dms *LSTh, const dms *lat );
/**@return the X-coordinate in the Jupiter-centered coord. system.
*@param i which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto.
*/
double x( int i ) const { return XJ[i]; }
/**@return the Y-coordinate in the Jupiter-centered coord. system.
*@param i which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto.
*/
double y( int i ) const { return YJ[i]; }
/**@return the Z-coordinate in the Jupiter-centered coord. system.
*@param i which moon? 0=Io, 1=Europa, 2=Ganymede, 3=Callisto.
*/
double z( int i ) const { return ZJ[i]; }
private:
SkyPoint Pos[4];
QString Name[4];
bool InFront[4];
//the rectangular position, relative to Jupiter. X-axis is equator of Jupiter; usints are Jup. Radius
double XJ[4], YJ[4], ZJ[4];
};
#endif
|