You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdeedu/kstars/kstars/jupitermoons.h

118 lines
4.2 KiB

/***************************************************************************
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
*/
TQString 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 TQString &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];
TQString 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