Stellarium 0.14.3
List of all members | Public Slots | Signals
StelCore Class Reference

Main class for Stellarium core processing. More...

#include <StelCore.hpp>

Public Slots

void setCurrentProjectionType (ProjectionType type)
 Set the current ProjectionType to use. More...
 
ProjectionType getCurrentProjectionType () const
 
QString getCurrentProjectionTypeKey (void) const
 Get the current Mapping used by the Projection. More...
 
void setCurrentProjectionTypeKey (QString type)
 Set the current ProjectionType to use from its key. More...
 
QStringList getAllProjectionTypeKeys () const
 Get the list of all the available projections. More...
 
void setCurrentDeltaTAlgorithm (DeltaTAlgorithm algorithm)
 Set the current algorithm for time correction (DeltaT) More...
 
DeltaTAlgorithm getCurrentDeltaTAlgorithm () const
 Get the current algorithm for time correction (DeltaT) More...
 
QString getCurrentDeltaTAlgorithmDescription (void) const
 Get description of the current algorithm for time correction. More...
 
QString getCurrentDeltaTAlgorithmKey (void) const
 Get the current algorithm used by the DeltaT. More...
 
void setCurrentDeltaTAlgorithmKey (QString type)
 Set the current algorithm to use from its key. More...
 
void setMaskType (StelProjector::StelProjectorMaskType m)
 Set the mask type. More...
 
void setFlagGravityLabels (bool gravity)
 Set the flag with decides whether to arrage labels so that they are aligned with the bottom of a 2d screen, or a 3d dome. More...
 
void setDefaultAngleForGravityText (float a)
 Set the offset rotation angle in degree to apply to gravity text (only if gravityLabels is set to false). More...
 
void setFlipHorz (bool flip)
 Set the horizontal flip status. More...
 
void setFlipVert (bool flip)
 Set the vertical flip status. More...
 
bool getFlipHorz (void) const
 Get the state of the horizontal flip. More...
 
bool getFlipVert (void) const
 Get the state of the vertical flip. More...
 
QString getDefaultLocationID () const
 Get the location used by default at startup. More...
 
void setDefaultLocationID (const QString &id)
 Set the location to use by default at startup. More...
 
void returnToDefaultLocation ()
 Return to the default location. More...
 
void returnToHome ()
 Return to the default location and set default landscape with atmosphere and fog effects. More...
 
void setJD (double newJD)
 Set the current date in Julian Day (UT) More...
 
void setJDE (double newJDE)
 Set the current date in Julian Day (TT). More...
 
double getJD () const
 Get the current date in Julian Day (UT). More...
 
double getJDE () const
 Get the current date in Julian Day (TT). More...
 
void setMJDay (double MJD)
 Set the current date in Modified Julian Day (UT). More...
 
double getMJDay () const
 Get the current date in Modified Julian Day (UT) More...
 
double computeDeltaT (const double JD) const
 Compute Delta-T estimation for a given date. More...
 
double getDeltaT () const
 Get current DeltaT. More...
 
bool getUseNutation () const
 
void setUseNutation (bool useNutation)
 Set whether you want computation and simulation of nutation (a slight wobble of Earth's axis, just a few arcseconds). More...
 
bool getUseTopocentricCoordinates () const
 
void setUseTopocentricCoordinates (bool use)
 Set whether you want computation and simulation of nutation (a slight wobble of Earth's axis, just a few arcseconds). More...
 
double getPresetSkyTime () const
 Return the preset sky time in JD. More...
 
void setPresetSkyTime (double d)
 Set the preset sky time from a JD. More...
 
void setTimeRate (double ts)
 Set time speed in JDay/sec. More...
 
double getTimeRate () const
 Get time speed in JDay/sec. More...
 
void increaseTimeSpeed ()
 Increase the time speed. More...
 
void decreaseTimeSpeed ()
 Decrease the time speed. More...
 
void increaseTimeSpeedLess ()
 Increase the time speed, but not as much as with increaseTimeSpeed() More...
 
void decreaseTimeSpeedLess ()
 Decrease the time speed but not as much as with decreaseTimeSpeed() More...
 
void setZeroTimeSpeed ()
 Set time speed to 0, i.e. freeze the passage of simulation time. More...
 
void setRealTimeSpeed ()
 Set real time speed, i.e. 1 sec/sec. More...
 
void toggleRealTimeSpeed ()
 Set real time speed or pause simulation if we are already in realtime speed. More...
 
bool getRealTimeSpeed () const
 Get whether it is real time speed, i.e. 1 sec/sec. More...
 
void setTimeNow ()
 Set stellarium time to current real world time. More...
 
void setTodayTime (const QTime &target)
 Set the time to some value, leaving the day the same. More...
 
bool getIsTimeNow () const
 Get whether the current stellarium time is the real world time. More...
 
QTime getInitTodayTime (void)
 get the initial "today time" from the config file More...
 
void setInitTodayTime (const QTime &time)
 set the initial "today time" from the config file More...
 
void setPresetSkyTime (QDateTime dateTime)
 Set the preset sky time from a QDateTime. More...
 
void addHour ()
 Add one [Earth, solar] hour to the current simulation time. More...
 
void addDay ()
 Add one [Earth, solar] day to the current simulation time. More...
 
void addWeek ()
 Add one [Earth, solar] week to the current simulation time. More...
 
void addSiderealDay ()
 Add one sidereal day to the simulation time. More...
 
void addSiderealYear ()
 Add one sidereal year to the simulation time. More...
 
void addSiderealYears (float n=100.f)
 Add n sidereal years to the simulation time. More...
 
void subtractHour ()
 Subtract one [Earth, solar] hour to the current simulation time. More...
 
void subtractDay ()
 Subtract one [Earth, solar] day to the current simulation time. More...
 
void subtractWeek ()
 Subtract one [Earth, solar] week to the current simulation time. More...
 
void subtractSiderealDay ()
 Subtract one sidereal day to the simulation time. More...
 
void subtractSiderealYear ()
 Subtract one sidereal year to the simulation time. More...
 
void subtractSiderealYears (float n=100.f)
 Subtract n sidereal years to the simulation time. More...
 
void addSynodicMonth ()
 Add one synodic month to the simulation time. More...
 
void addDraconicYear ()
 Add one draconic year to the simulation time. More...
 
void addDraconicMonth ()
 Add one draconic month to the simulation time. More...
 
void addAnomalisticMonth ()
 Add one anomalistic month to the simulation time. More...
 
void addAnomalisticYear ()
 Add one anomalistic year to the simulation time. More...
 
void addAnomalisticYears (float n=100.f)
 Add n anomalistic years to the simulation time. More...
 
void addMeanTropicalMonth ()
 Add one mean tropical month to the simulation time. More...
 
void addMeanTropicalYear ()
 Add one mean tropical year to the simulation time. More...
 
void addMeanTropicalYears (float n=100.f)
 Add n mean tropical years to the simulation time. More...
 
void addTropicalYear ()
 Add one tropical year to the simulation time. More...
 
void addJulianYear ()
 Add one Julian year to the simulation time. More...
 
void addJulianYears (float n=100.f)
 Add n Julian years to the simulation time. More...
 
void addGaussianYear ()
 Add one Gaussian year to the simulation time. More...
 
void subtractSynodicMonth ()
 Subtract one synodic month to the simulation time. More...
 
void subtractDraconicYear ()
 Subtract one draconic year to the simulation time. More...
 
void subtractDraconicMonth ()
 Subtract one draconic month to the simulation time. More...
 
void subtractAnomalisticMonth ()
 Subtract one anomalistic month to the simulation time. More...
 
void subtractAnomalisticYear ()
 Subtract one anomalistic year to the simulation time. More...
 
void subtractAnomalisticYears (float n=100.f)
 Subtract n anomalistic years to the simulation time. More...
 
void subtractMeanTropicalMonth ()
 Subtract one mean tropical month to the simulation time. More...
 
void subtractMeanTropicalYear ()
 Subtract one mean tropical year to the simulation time. More...
 
void subtractMeanTropicalYears (float n=100.f)
 Subtract n mean tropical years to the simulation time. More...
 
void subtractTropicalYear ()
 Subtract one tropical year to the simulation time. More...
 
void subtractJulianYear ()
 Subtract one Julian year to the simulation time. More...
 
void subtractJulianYears (float n=100.f)
 Subtract n Julian years to the simulation time. More...
 
void subtractGaussianYear ()
 Subtract one Gaussian year to the simulation time. More...
 
void addSolarDays (double d)
 Add a number of Earth Solar days to the current simulation time. More...
 
void addSiderealDays (double d)
 Add a number of sidereal days to the current simulation time, based on the observer body's rotational period. More...
 
void moveObserverToSelected ()
 Move the observer to the selected object. More...
 
void setDeltaTCustomYear (float y)
 Set central year for custom equation for calculation of Delta-T. More...
 
void setDeltaTCustomNDot (float v)
 Set n-dot for custom equation for calculation of Delta-T. More...
 
void setDeltaTCustomEquationCoefficients (Vec3f c)
 Set coefficients for custom equation for calculation of Delta-T. More...
 
float getDeltaTCustomYear () const
 Get central year for custom equation for calculation of Delta-T. More...
 
float getDeltaTCustomNDot () const
 Get n-dot for custom equation for calculation of Delta-T. More...
 
Vec3f getDeltaTCustomEquationCoefficients () const
 Get coefficients for custom equation for calculation of Delta-T. More...
 

Signals

void locationChanged (StelLocation)
 This signal is emitted when the observer location has changed. More...
 
void timeRateChanged (double rate)
 This signal is emitted when the time rate has changed. More...
 

Detailed Description

Main class for Stellarium core processing.

This class provides services like management of sky projections, tone conversion, or reference frame conversion. It is used by the various StelModules to update and display themselves. There is currently only one StelCore instance in Stellarium, but in the future they may be more, allowing for example to display several independent views of the sky at the same time.

Author
Fabien Chereau, Matthew Gates, Georg Zotti

Definition at line 48 of file StelCore.hpp.

Member Function Documentation

void StelCore::addAnomalisticMonth ( )
slot

Add one anomalistic month to the simulation time.

void StelCore::addAnomalisticYear ( )
slot

Add one anomalistic year to the simulation time.

void StelCore::addAnomalisticYears ( float  n = 100.f)
slot

Add n anomalistic years to the simulation time.

void StelCore::addDay ( )
slot

Add one [Earth, solar] day to the current simulation time.

void StelCore::addDraconicMonth ( )
slot

Add one draconic month to the simulation time.

void StelCore::addDraconicYear ( )
slot

Add one draconic year to the simulation time.

void StelCore::addGaussianYear ( )
slot

Add one Gaussian year to the simulation time.

void StelCore::addHour ( )
slot

Add one [Earth, solar] hour to the current simulation time.

void StelCore::addJulianYear ( )
slot

Add one Julian year to the simulation time.

void StelCore::addJulianYears ( float  n = 100.f)
slot

Add n Julian years to the simulation time.

void StelCore::addMeanTropicalMonth ( )
slot

Add one mean tropical month to the simulation time.

void StelCore::addMeanTropicalYear ( )
slot

Add one mean tropical year to the simulation time.

void StelCore::addMeanTropicalYears ( float  n = 100.f)
slot

Add n mean tropical years to the simulation time.

void StelCore::addSiderealDay ( )
slot

Add one sidereal day to the simulation time.

The length of time depends on the current planetary body on which the observer is located.

void StelCore::addSiderealDays ( double  d)
slot

Add a number of sidereal days to the current simulation time, based on the observer body's rotational period.

Parameters
dthe decimal number of sidereal days to add (use negative values to subtract)
void StelCore::addSiderealYear ( )
slot

Add one sidereal year to the simulation time.

The length of time depends on the current planetary body on which the observer is located. Sidereal year connected to orbital period of planets.

void StelCore::addSiderealYears ( float  n = 100.f)
slot

Add n sidereal years to the simulation time.

The length of time depends on the current planetary body on which the observer is located. Sidereal year connected to orbital period of planets.

void StelCore::addSolarDays ( double  d)
slot

Add a number of Earth Solar days to the current simulation time.

Parameters
dthe decimal number of days to add (use negative values to subtract)
void StelCore::addSynodicMonth ( )
slot

Add one synodic month to the simulation time.

void StelCore::addTropicalYear ( )
slot

Add one tropical year to the simulation time.

void StelCore::addWeek ( )
slot

Add one [Earth, solar] week to the current simulation time.

double StelCore::computeDeltaT ( const double  JD) const
slot

Compute Delta-T estimation for a given date.

DeltaT is the accumulated effect of earth's rotation slowly getting slower, mostly caused by tidal braking by the Moon. For accurate positioning of objects in the sky, we must compute earth-based clock-dependent things like earth rotation, hour angles etc. using plain UT, but all orbital motions or rotation of the other planets must be computed in TT, which is a regular time frame. Also satellites are computed in the UT frame because (1) they are short-lived and (2) must follow paths over earth ground. (Note that we make no further difference between TT and DT, those are regarded equivalent for our purpose.)

Parameters
JDthe date and time expressed as a Julian Day
Returns
DeltaT in seconds
Note
Thanks to Rob van Gent which create a collection from many formulas for calculation of Delta-T: http://www.staff.science.uu.nl/~gent0113/deltat/deltat.htm
Use this only if needed, prefer calling getDeltaT() for access to the current value.
void StelCore::decreaseTimeSpeed ( )
slot

Decrease the time speed.

void StelCore::decreaseTimeSpeedLess ( )
slot

Decrease the time speed but not as much as with decreaseTimeSpeed()

QStringList StelCore::getAllProjectionTypeKeys ( ) const
slot

Get the list of all the available projections.

DeltaTAlgorithm StelCore::getCurrentDeltaTAlgorithm ( ) const
inlineslot

Get the current algorithm for time correction (DeltaT)

Definition at line 331 of file StelCore.hpp.

QString StelCore::getCurrentDeltaTAlgorithmDescription ( void  ) const
slot

Get description of the current algorithm for time correction.

QString StelCore::getCurrentDeltaTAlgorithmKey ( void  ) const
slot

Get the current algorithm used by the DeltaT.

QString StelCore::getCurrentProjectionTypeKey ( void  ) const
slot

Get the current Mapping used by the Projection.

QString StelCore::getDefaultLocationID ( ) const
slot

Get the location used by default at startup.

double StelCore::getDeltaT ( ) const
slot

Get current DeltaT.

Vec3f StelCore::getDeltaTCustomEquationCoefficients ( ) const
inlineslot

Get coefficients for custom equation for calculation of Delta-T.

Definition at line 585 of file StelCore.hpp.

float StelCore::getDeltaTCustomNDot ( ) const
inlineslot

Get n-dot for custom equation for calculation of Delta-T.

Definition at line 583 of file StelCore.hpp.

float StelCore::getDeltaTCustomYear ( ) const
inlineslot

Get central year for custom equation for calculation of Delta-T.

Definition at line 581 of file StelCore.hpp.

bool StelCore::getFlipHorz ( void  ) const
slot

Get the state of the horizontal flip.

Returns
True if flipped horizontally, else false.
bool StelCore::getFlipVert ( void  ) const
slot

Get the state of the vertical flip.

Returns
True if flipped vertically, else false.
QTime StelCore::getInitTodayTime ( void  )
slot

get the initial "today time" from the config file

bool StelCore::getIsTimeNow ( ) const
slot

Get whether the current stellarium time is the real world time.

double StelCore::getJD ( ) const
slot

Get the current date in Julian Day (UT).

double StelCore::getJDE ( ) const
slot

Get the current date in Julian Day (TT).

The name is derived from the classical name "Ephemeris Time", of which TT is the successor. It is still frequently used in the literature.

double StelCore::getMJDay ( ) const
slot

Get the current date in Modified Julian Day (UT)

double StelCore::getPresetSkyTime ( ) const
slot

Return the preset sky time in JD.

bool StelCore::getRealTimeSpeed ( ) const
slot

Get whether it is real time speed, i.e. 1 sec/sec.

double StelCore::getTimeRate ( ) const
slot

Get time speed in JDay/sec.

bool StelCore::getUseNutation ( ) const
inlineslot
Returns
whether nutation is currently used.

Definition at line 405 of file StelCore.hpp.

bool StelCore::getUseTopocentricCoordinates ( ) const
inlineslot
Returns
whether topocentric coordinates are currently used.

Definition at line 410 of file StelCore.hpp.

void StelCore::increaseTimeSpeed ( )
slot

Increase the time speed.

void StelCore::increaseTimeSpeedLess ( )
slot

Increase the time speed, but not as much as with increaseTimeSpeed()

void StelCore::locationChanged ( StelLocation  )
signal

This signal is emitted when the observer location has changed.

void StelCore::moveObserverToSelected ( )
slot

Move the observer to the selected object.

This will only do something if the selected object is of the correct type - i.e. a planet.

void StelCore::returnToDefaultLocation ( )
slot

Return to the default location.

void StelCore::returnToHome ( )
slot

Return to the default location and set default landscape with atmosphere and fog effects.

void StelCore::setCurrentDeltaTAlgorithm ( DeltaTAlgorithm  algorithm)
inlineslot

Set the current algorithm for time correction (DeltaT)

Definition at line 329 of file StelCore.hpp.

void StelCore::setCurrentDeltaTAlgorithmKey ( QString  type)
slot

Set the current algorithm to use from its key.

void StelCore::setCurrentProjectionType ( ProjectionType  type)
slot

Set the current ProjectionType to use.

void StelCore::setCurrentProjectionTypeKey ( QString  type)
slot

Set the current ProjectionType to use from its key.

void StelCore::setDefaultAngleForGravityText ( float  a)
slot

Set the offset rotation angle in degree to apply to gravity text (only if gravityLabels is set to false).

void StelCore::setDefaultLocationID ( const QString &  id)
slot

Set the location to use by default at startup.

void StelCore::setDeltaTCustomEquationCoefficients ( Vec3f  c)
inlineslot

Set coefficients for custom equation for calculation of Delta-T.

Parameters
ythe coefficients, e.g. -20,0,32

Definition at line 578 of file StelCore.hpp.

void StelCore::setDeltaTCustomNDot ( float  v)
inlineslot

Set n-dot for custom equation for calculation of Delta-T.

Parameters
ythe n-dot value, e.g. -26.0

Definition at line 575 of file StelCore.hpp.

void StelCore::setDeltaTCustomYear ( float  y)
inlineslot

Set central year for custom equation for calculation of Delta-T.

Parameters
ythe year, e.g. 1820

Definition at line 572 of file StelCore.hpp.

void StelCore::setFlagGravityLabels ( bool  gravity)
slot

Set the flag with decides whether to arrage labels so that they are aligned with the bottom of a 2d screen, or a 3d dome.

void StelCore::setFlipHorz ( bool  flip)
slot

Set the horizontal flip status.

Parameters
flipThe new value (true = flipped, false = unflipped).
void StelCore::setFlipVert ( bool  flip)
slot

Set the vertical flip status.

Parameters
flipThe new value (true = flipped, false = unflipped).
void StelCore::setInitTodayTime ( const QTime &  time)
slot

set the initial "today time" from the config file

void StelCore::setJD ( double  newJD)
slot

Set the current date in Julian Day (UT)

void StelCore::setJDE ( double  newJDE)
slot

Set the current date in Julian Day (TT).

The name is derived from the classical name "Ephemeris Time", of which TT is the successor. It is still frequently used in the literature.

void StelCore::setMaskType ( StelProjector::StelProjectorMaskType  m)
slot

Set the mask type.

void StelCore::setMJDay ( double  MJD)
slot

Set the current date in Modified Julian Day (UT).

MJD is simply JD-2400000.5, getting rid of large numbers and starting days at midnight. It is mostly used in satellite contexts.

void StelCore::setPresetSkyTime ( double  d)
slot

Set the preset sky time from a JD.

void StelCore::setPresetSkyTime ( QDateTime  dateTime)
slot

Set the preset sky time from a QDateTime.

void StelCore::setRealTimeSpeed ( )
slot

Set real time speed, i.e. 1 sec/sec.

void StelCore::setTimeNow ( )
slot

Set stellarium time to current real world time.

void StelCore::setTimeRate ( double  ts)
slot

Set time speed in JDay/sec.

void StelCore::setTodayTime ( const QTime &  target)
slot

Set the time to some value, leaving the day the same.

void StelCore::setUseNutation ( bool  useNutation)
inlineslot

Set whether you want computation and simulation of nutation (a slight wobble of Earth's axis, just a few arcseconds).

Definition at line 407 of file StelCore.hpp.

void StelCore::setUseTopocentricCoordinates ( bool  use)
inlineslot

Set whether you want computation and simulation of nutation (a slight wobble of Earth's axis, just a few arcseconds).

Definition at line 412 of file StelCore.hpp.

void StelCore::setZeroTimeSpeed ( )
slot

Set time speed to 0, i.e. freeze the passage of simulation time.

void StelCore::subtractAnomalisticMonth ( )
slot

Subtract one anomalistic month to the simulation time.

void StelCore::subtractAnomalisticYear ( )
slot

Subtract one anomalistic year to the simulation time.

void StelCore::subtractAnomalisticYears ( float  n = 100.f)
slot

Subtract n anomalistic years to the simulation time.

void StelCore::subtractDay ( )
slot

Subtract one [Earth, solar] day to the current simulation time.

void StelCore::subtractDraconicMonth ( )
slot

Subtract one draconic month to the simulation time.

void StelCore::subtractDraconicYear ( )
slot

Subtract one draconic year to the simulation time.

void StelCore::subtractGaussianYear ( )
slot

Subtract one Gaussian year to the simulation time.

void StelCore::subtractHour ( )
slot

Subtract one [Earth, solar] hour to the current simulation time.

void StelCore::subtractJulianYear ( )
slot

Subtract one Julian year to the simulation time.

void StelCore::subtractJulianYears ( float  n = 100.f)
slot

Subtract n Julian years to the simulation time.

void StelCore::subtractMeanTropicalMonth ( )
slot

Subtract one mean tropical month to the simulation time.

void StelCore::subtractMeanTropicalYear ( )
slot

Subtract one mean tropical year to the simulation time.

void StelCore::subtractMeanTropicalYears ( float  n = 100.f)
slot

Subtract n mean tropical years to the simulation time.

void StelCore::subtractSiderealDay ( )
slot

Subtract one sidereal day to the simulation time.

The length of time depends on the current planetary body on which the observer is located.

void StelCore::subtractSiderealYear ( )
slot

Subtract one sidereal year to the simulation time.

The length of time depends on the current planetary body on which the observer is located. Sidereal year connected to orbital period of planets.

void StelCore::subtractSiderealYears ( float  n = 100.f)
slot

Subtract n sidereal years to the simulation time.

The length of time depends on the current planetary body on which the observer is located. Sidereal year connected to orbital period of planets.

void StelCore::subtractSynodicMonth ( )
slot

Subtract one synodic month to the simulation time.

void StelCore::subtractTropicalYear ( )
slot

Subtract one tropical year to the simulation time.

void StelCore::subtractWeek ( )
slot

Subtract one [Earth, solar] week to the current simulation time.

void StelCore::timeRateChanged ( double  rate)
signal

This signal is emitted when the time rate has changed.

void StelCore::toggleRealTimeSpeed ( )
slot

Set real time speed or pause simulation if we are already in realtime speed.


The documentation for this class was generated from the following file: