Stellarium  0.16.1
List of all members | Public Types | Public Slots | Signals | Public Member Functions | Static Public Attributes | Properties
StelCore Class Reference

Main class for Stellarium core processing. More...

#include <StelCore.hpp>

+ Inheritance diagram for StelCore:
+ Collaboration diagram for StelCore:

Public Types

enum  FrameType {
  FrameUninitialized, FrameAltAz, FrameHeliocentricEclipticJ2000, FrameObservercentricEclipticJ2000,
  FrameObservercentricEclipticOfDate, FrameEquinoxEqu, FrameJ2000, FrameGalactic,
  FrameSupergalactic
}
 Supported reference frame types. More...
 
enum  ProjectionType {
  ProjectionPerspective, ProjectionStereographic, ProjectionFisheye, ProjectionOrthographic,
  ProjectionEqualArea, ProjectionHammer, ProjectionSinusoidal, ProjectionMercator,
  ProjectionMiller, ProjectionCylinder
}
 Available projection types. More...
 
enum  RefractionMode { RefractionAuto, RefractionOn, RefractionOff }
 Available refraction mode. More...
 
enum  DeltaTAlgorithm {
  WithoutCorrection, Schoch, Clemence, IAU,
  AstronomicalEphemeris, TuckermanGoldstine, MullerStephenson, Stephenson1978,
  SchmadelZech1979, MorrisonStephenson1982, StephensonMorrison1984, StephensonHoulden,
  Espenak, Borkowski, SchmadelZech1988, ChaprontTouze,
  StephensonMorrison1995, Stephenson1997, ChaprontMeeus, JPLHorizons,
  MeeusSimons, MontenbruckPfleger, ReingoldDershowitz, MorrisonStephenson2004,
  Reijs, EspenakMeeus, EspenakMeeusZeroMoonAccel, Banjevic,
  IslamSadiqQureshi, KhalidSultanaZaidi, StephensonMorrisonHohenkerk2016, Custom
}
 Available DeltaT algorithms. More...
 

Public Slots

void moveObserverTo (const StelLocation &target, double duration=1., double durationIfPlanetChange=1.)
 Smoothly move the observer to the given location. More...
 
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...
 
QString getCurrentProjectionNameI18n () const
 
QStringList getAllProjectionTypeKeys () const
 Get the list of all the available projections. More...
 
void setCurrentDeltaTAlgorithm (DeltaTAlgorithm algorithm)
 Set the current algorithm and nDot used therein 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...
 
double getViewportHorizontalOffset (void) const
 Get current value for horizontal viewport offset [-50...50] An offset of 50 percent means projective image center is on the right screen border. More...
 
void setViewportHorizontalOffset (double newOffsetPct)
 Set horizontal viewport offset. More...
 
double getViewportVerticalOffset (void) const
 Get current value for vertical viewport offset [-50...50] An offset of 50 percent means projective image center is on the upper screen border. More...
 
void setViewportVerticalOffset (double newOffsetPct)
 Set vertical viewport offset. More...
 
void setViewportOffset (double newHorizontalOffsetPct, double newVerticalOffsetPct)
 
void setViewportStretch (float stretch)
 Can be used in specialized setups, intended e.g. 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...
 
double getJDOfLastJDUpdate () const
 Returns the JD of the last time resetSync() was called. More...
 
void setMilliSecondsOfLastJDUpdate (qint64 millis)
 Sets the system date which corresponds to the jdOfLastJDUpdate. More...
 
qint64 getMilliSecondsOfLastJDUpdate () const
 Returns the system date of the last time resetSync() was called. 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...
 
double getSolutionEquationOfTime (const double JDE) const
 Get solution of equation of time Source: J. More...
 
bool getUseDST () const
 
void setUseDST (const bool b)
 
bool getUseCustomTimeZone (void) const
 
void setUseCustomTimeZone (const bool b)
 
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)
 Compute DeltaT estimation for a given date. More...
 
double getDeltaT () const
 Get current DeltaT. More...
 
bool getUseNutation () const
 
void setUseNutation (bool use)
 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 revertTimeDirection (void)
 
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 addMinute ()
 Add one [Earth, solar] minute to the current simulation time. 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 addSiderealWeek ()
 Add seven sidereal days 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 subtractMinute ()
 Subtract one [Earth, solar] minute to the current 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 subtractSiderealWeek ()
 Subtract seven sidereal days 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 addSaros ()
 Add one saros (223 synodic months) 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 subtractSaros ()
 Subtract one saros (223 synodic months) 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 DeltaT. More...
 
void setDeltaTCustomNDot (float v)
 Set n-dot for custom equation for calculation of DeltaT. More...
 
void setDeltaTCustomEquationCoefficients (Vec3f c)
 Set coefficients for custom equation for calculation of DeltaT. More...
 
float getDeltaTCustomYear () const
 Get central year for custom equation for calculation of DeltaT. More...
 
float getDeltaTCustomNDot () const
 Get n-dot for custom equation for calculation of DeltaT. More...
 
float getDeltaTnDot () const
 Get n-dot for current DeltaT algorithm. More...
 
Vec3f getDeltaTCustomEquationCoefficients () const
 Get coefficients for custom equation for calculation of DeltaT. More...
 
void initEphemeridesFunctions ()
 initialize ephemerides calculation functions More...
 
bool de430IsAvailable ()
 true if DE430 ephemeris file has been found More...
 
bool de431IsAvailable ()
 true if DE431 ephemeris file has been found More...
 
bool de430IsActive ()
 true if DE430 ephemeris is in use More...
 
bool de431IsActive ()
 true if DE431 ephemeris is in use More...
 
void setDe430Active (bool status)
 switch DE430 use to More...
 
void setDe431Active (bool status)
 switch DE431 use to More...
 
QString getIAUConstellation (const Vec3d positionEqJnow) const
 Return 3-letter abbreviation of IAU constellation name for position in equatorial coordinates on the current epoch. More...
 

Signals

void locationChanged (StelLocation)
 This signal is emitted when the observer location has changed. More...
 
void targetLocationChanged (StelLocation)
 This signal is emitted whenever the targetted location changes. More...
 
void timeRateChanged (double rate)
 This signal is emitted when the time rate has changed. More...
 
void timeSyncOccurred (double jDay)
 This signal is emitted whenever the time is re-synced. More...
 
void dateChanged ()
 This signal is emitted when the date has changed. More...
 
void flipHorzChanged (bool b)
 This signal indicates a horizontal display flip. More...
 
void flipVertChanged (bool b)
 This signal indicates a vertical display flip. More...
 
void flagUseNutationChanged (bool b)
 This signal indicates a switch in use of nutation. More...
 
void flagUseTopocentricCoordinatesChanged (bool b)
 This signal indicates a switch in use of topocentric coordinates. More...
 
void currentProjectionTypeChanged (StelCore::ProjectionType newType)
 Emitted whenever the projection type changes. More...
 
void currentProjectionTypeKeyChanged (const QString &newValue)
 Emitted whenever the projection type changes. More...
 
void currentProjectionNameI18nChanged (const QString &newValue)
 Emitted whenever the projection type changes. More...
 

Public Member Functions

void init ()
 Init and load all main core components. More...
 
void update (double deltaTime)
 Update all the objects with respect to the time. More...
 
void windowHasBeenResized (float x, float y, float width, float height)
 Handle the resizing of the window. More...
 
void preDraw ()
 Update core state before drawing modules. More...
 
void postDraw ()
 Update core state after drawing modules. More...
 
StelProjectorP getProjection2d () const
 Get a new instance of a simple 2d projection. More...
 
StelProjectorP getProjection (FrameType frameType, RefractionMode refractionMode=RefractionAuto) const
 Get a new instance of projector using a modelview transformation corresponding to the given frame. More...
 
StelProjectorP getProjection (StelProjector::ModelViewTranformP modelViewTransform, ProjectionType projType=(ProjectionType) 1000) const
 Get a new instance of projector using the given modelview transformation. More...
 
StelToneReproducergetToneReproducer ()
 Get the current tone reproducer used in the core. More...
 
const StelToneReproducergetToneReproducer () const
 Get the current tone reproducer used in the core. More...
 
StelSkyDrawergetSkyDrawer ()
 Get the current StelSkyDrawer used in the core. More...
 
const StelSkyDrawergetSkyDrawer () const
 Get the current StelSkyDrawer used in the core. More...
 
const StelGeodesicGridgetGeodesicGrid (int maxLevel) const
 Get an instance of StelGeodesicGrid which is garanteed to allow for at least maxLevel levels. More...
 
StelMovementMgrgetMovementMgr ()
 Get the instance of movement manager. More...
 
const StelMovementMgrgetMovementMgr () const
 Get the const instance of movement manager. More...
 
void setClippingPlanes (double znear, double zfar)
 Set the near and far clipping planes. More...
 
void getClippingPlanes (double *zn, double *zf) const
 Get the near and far clipping planes. More...
 
QString projectionTypeKeyToNameI18n (const QString &key) const
 Get the translated projection name from its TypeKey for the current locale. More...
 
QString projectionNameI18nToTypeKey (const QString &nameI18n) const
 Get the projection TypeKey from its translated name for the current locale. More...
 
StelProjector::StelProjectorParams getCurrentStelProjectorParams () const
 Get the current set of parameters to use when creating a new StelProjector. More...
 
void setCurrentStelProjectorParams (const StelProjector::StelProjectorParams &newParams)
 Set the set of parameters to use when creating a new StelProjector. More...
 
void lookAtJ2000 (const Vec3d &pos, const Vec3d &up)
 Set vision direction. More...
 
Vec3d altAzToEquinoxEqu (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 
Vec3d equinoxEquToAltAz (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 
Vec3d altAzToJ2000 (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 
Vec3d j2000ToAltAz (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 
void j2000ToAltAzInPlaceNoRefraction (Vec3f *v) const
 
Vec3d galacticToJ2000 (const Vec3d &v) const
 
Vec3d supergalacticToJ2000 (const Vec3d &v) const
 
Vec3d equinoxEquToJ2000 (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 Transform position vector v from equatorial coordinates of date (which may also include atmospheric refraction) to those of J2000. More...
 
Vec3d j2000ToJ1875 (const Vec3d &v) const
 Use fixed matrix to allow fast transformation of positions related to the IAU constellation borders. More...
 
Vec3d j2000ToEquinoxEqu (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 Transform position vector v from equatorial coordinates J2000 to those of date (optionally corrected by refraction). More...
 
Vec3d j2000ToGalactic (const Vec3d &v) const
 
Vec3d j2000ToSupergalactic (const Vec3d &v) const
 
Vec3d heliocentricEclipticToAltAz (const Vec3d &v, RefractionMode refMode=RefractionAuto) const
 Transform vector from heliocentric ecliptic coordinate to altazimuthal. More...
 
Vec3d heliocentricEclipticToEquinoxEqu (const Vec3d &v) const
 Transform from heliocentric coordinate to equatorial at current equinox (for the planet where the observer stands) More...
 
StelProjector::ModelViewTranformP getHeliocentricEclipticModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for heliocentric ecliptic (Vsop87) drawing. More...
 
StelProjector::ModelViewTranformP getObservercentricEclipticJ2000ModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric ecliptic (Vsop87) drawing. More...
 
StelProjector::ModelViewTranformP getObservercentricEclipticOfDateModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric ecliptic of Date drawing. More...
 
StelProjector::ModelViewTranformP getEquinoxEquModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric equatorial at equinox drawing. More...
 
StelProjector::ModelViewTranformP getAltAzModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric altazimuthal drawing. More...
 
StelProjector::ModelViewTranformP getJ2000ModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric J2000 equatorial drawing. More...
 
StelProjector::ModelViewTranformP getGalacticModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric Galactic equatorial drawing. More...
 
StelProjector::ModelViewTranformP getSupergalacticModelViewTransform (RefractionMode refMode=RefractionAuto) const
 Get the modelview matrix for observer-centric Supergalactic equatorial drawing. More...
 
Vec3d getObserverHeliocentricEclipticPos () const
 Return the observer heliocentric ecliptic position (GZ: presumably J2000) More...
 
const StelLocationgetCurrentLocation () const
 Get the informations on the current location. More...
 
float getUTCOffset (const double JD) const
 Get the UTC offset on the current location (in hours) More...
 
QString getCurrentTimeZone () const
 
void setCurrentTimeZone (const QString &tz)
 
const QSharedPointer< class PlanetgetCurrentPlanet () const
 
const StelObservergetCurrentObserver () const
 Unfortunately we also need this. More...
 
void setObserver (StelObserver *obs)
 Replaces the current observer. StelCore assumes ownership of the observer. More...
 
SphericalCap getVisibleSkyArea () const
 
double getLocalSiderealTime () const
 Get the sidereal time shifted by the observer longitude. More...
 
double getLocalSiderealDayLength () const
 Get the duration of a sidereal day for the current observer in day. More...
 
double getLocalSiderealYearLength () const
 Get the duration of a sidereal year for the current observer in days. More...
 
QString getStartupTimeMode ()
 Return the startup mode, can be "actual" (i.e. More...
 
void setStartupTimeMode (const QString &s)
 
QString getCurrentDeltaTAlgorithmValidRangeDescription (const double JD, QString *marker) const
 Get info about valid range for current algorithm for calculation of Delta-T. More...
 
bool isBrightDaylight () const
 Checks for altitude of the Sun - is it night or day? More...
 
double getCurrentEpoch () const
 Get value of the current Julian epoch (i.e. current year with decimal fraction, e.g. 2012.34567) More...
 
QString getDefaultProjectionTypeKey (void) const
 Get the default Mapping used by the Projection. More...
 
Vec3d getMouseJ2000Pos (void) const
 

Static Public Attributes

static const Mat4d matJ2000ToVsop87
 Rotation matrix from equatorial J2000 to ecliptic (VSOP87A). More...
 
static const Mat4d matVsop87ToJ2000
 Rotation matrix from ecliptic (VSOP87A) to equatorial J2000. More...
 
static const Mat4d matJ2000ToGalactic
 Rotation matrix from J2000 to Galactic reference frame, using FITS convention. More...
 
static const Mat4d matGalacticToJ2000
 Rotation matrix from Galactic to J2000 reference frame, using FITS convention. More...
 
static const Mat4d matJ2000ToSupergalactic
 Rotation matrix from J2000 to Supergalactic reference frame. More...
 
static const Mat4d matSupergalacticToJ2000
 Rotation matrix from Supergalactic to J2000 reference frame. More...
 
static const double JD_SECOND
 
static const double JD_MINUTE
 
static const double JD_HOUR
 
static const double JD_DAY
 
static const double ONE_OVER_JD_SECOND
 
static const double TZ_ERA_BEGINNING
 

Properties

bool flipHorz
 
bool flipVert
 
bool flagUseNutation
 
bool flagUseTopocentricCoordinates
 
ProjectionType currentProjectionType
 
QString currentProjectionTypeKey
 This is just another way to access the projection type, by string instead of enum. More...
 
QString currentProjectionNameI18n
 Read-only property returning the localized projection name. 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 Enumeration Documentation

Available DeltaT algorithms.

Enumerator
WithoutCorrection 

Without correction, DeltaT is Zero. Like Stellarium versions before 0.12.

Schoch 

Schoch (1931) algorithm for DeltaT.

Clemence 

Clemence (1948) algorithm for DeltaT.

IAU 

IAU (1952) algorithm for DeltaT (based on observations by Spencer Jones (1939))

AstronomicalEphemeris 

Astronomical Ephemeris (1960) algorithm for DeltaT.

TuckermanGoldstine 

Tuckerman (1962, 1964) & Goldstine (1973) algorithm for DeltaT.

MullerStephenson 

Muller & Stephenson (1975) algorithm for DeltaT.

Stephenson1978 

Stephenson (1978) algorithm for DeltaT.

SchmadelZech1979 

Schmadel & Zech (1979) algorithm for DeltaT.

MorrisonStephenson1982 

Morrison & Stephenson (1982) algorithm for DeltaT (used by RedShift)

StephensonMorrison1984 

Stephenson & Morrison (1984) algorithm for DeltaT.

StephensonHoulden 

Stephenson & Houlden (1986) algorithm for DeltaT.

Espenak 

Espenak (1987, 1989) algorithm for DeltaT.

Borkowski 

Borkowski (1988) algorithm for DeltaT.

SchmadelZech1988 

Schmadel & Zech (1988) algorithm for DeltaT.

ChaprontTouze 

Chapront-Touzé & Chapront (1991) algorithm for DeltaT.

StephensonMorrison1995 

Stephenson & Morrison (1995) algorithm for DeltaT.

Stephenson1997 

Stephenson (1997) algorithm for DeltaT.

ChaprontMeeus 

Chapront, Chapront-Touze & Francou (1997) & Meeus (1998) algorithm for DeltaT.

JPLHorizons 

JPL Horizons algorithm for DeltaT.

MeeusSimons 

Meeus & Simons (2000) algorithm for DeltaT.

MontenbruckPfleger 

Montenbruck & Pfleger (2000) algorithm for DeltaT.

ReingoldDershowitz 

Reingold & Dershowitz (2002, 2007) algorithm for DeltaT.

MorrisonStephenson2004 

Morrison & Stephenson (2004, 2005) algorithm for DeltaT.

Reijs 

Reijs (2006) algorithm for DeltaT.

EspenakMeeus 

Espenak & Meeus (2006) algorithm for DeltaT (Recommended, default)

EspenakMeeusZeroMoonAccel 

Espenak & Meeus (2006) algorithm for DeltaT (but without additional Lunar acceleration. FOR TESTING ONLY, NONPUBLIC)

Banjevic 

Banjevic (2006) algorithm for DeltaT.

IslamSadiqQureshi 

Islam, Sadiq & Qureshi (2008 + revisited 2013) algorithm for DeltaT (6 polynomials)

KhalidSultanaZaidi 

M. Khalid, Mariam Sultana and Faheem Zaidi polynomial approximation of time period 1620-2013 (2014)

StephensonMorrisonHohenkerk2016 

Stephenson, Morrison, Hohenkerk (2016) RSPA paper provides spline fit to observations for -720..2016 and else parabolic fit.

Custom 

User defined coefficients for quadratic equation for DeltaT.

Definition at line 111 of file StelCore.hpp.

Supported reference frame types.

Enumerator
FrameUninitialized 

Reference frame is not set (FMajerech: Added to avoid condition on uninitialized value in StelSkyLayerMgr::draw())

FrameAltAz 

Altazimuthal reference frame centered on observer.

FrameHeliocentricEclipticJ2000 

Fixed-ecliptic reference frame centered on the Sun. GZ: This is J2000 ecliptical / almost VSOP87.

FrameObservercentricEclipticJ2000 

Fixed-ecliptic reference frame centered on the Observer. GZ: was ObservercentricEcliptic, but renamed because it is Ecliptic of J2000!

FrameObservercentricEclipticOfDate 

Moving ecliptic reference frame centered on the Observer. GZ new for V0.14: Ecliptic of date, i.e. includes the precession of the ecliptic.

FrameEquinoxEqu 

Equatorial reference frame at the current equinox centered on the observer.

The north pole follows the precession of the planet on which the observer is located. On Earth, this may include nutation if so configured. Has been corrected for V0.14 to really properly reflect ecliptical motion and precession (Vondrak 2011 model) and nutation.

FrameJ2000 

Equatorial reference frame at the J2000 equinox centered on the observer. This is also the ICRS reference frame.

FrameGalactic 

Galactic reference frame centered on observer.

FrameSupergalactic 

Supergalactic reference frame centered on observer.

Definition at line 69 of file StelCore.hpp.

Available projection types.

A value of 1000 indicates the default projection

Enumerator
ProjectionPerspective 

Perspective projection.

ProjectionStereographic 

Stereographic projection.

ProjectionFisheye 

Fisheye projection.

ProjectionOrthographic 

Orthographic projection.

ProjectionEqualArea 

Equal Area projection.

ProjectionHammer 

Hammer-Aitoff projection.

ProjectionSinusoidal 

Sinusoidal projection.

ProjectionMercator 

Mercator projection.

ProjectionMiller 

Miller cylindrical projection.

ProjectionCylinder 

Cylinder projection.

Definition at line 86 of file StelCore.hpp.

Available refraction mode.

Enumerator
RefractionAuto 

Automatically decide to add refraction if atmosphere is activated.

RefractionOn 

Always add refraction (i.e. apparent coordinates)

RefractionOff 

Never add refraction (i.e. geometric coordinates)

Definition at line 102 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.

The Gaussian Year is 365.2568983 days, and is C.F.Gauss's value for the Sidereal Year. Note that 1 GaussY=2 π/k where k is the Gaussian gravitational constant. A massless body orbits one solar mass in 1AU distance in a Gaussian Year.

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::addMinute ( )
slot

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

void StelCore::addSaros ( )
slot

Add one saros (223 synodic months) 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::addSiderealWeek ( )
slot

Add seven sidereal days to the simulation time.

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

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)
slot

Compute DeltaT 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 might differ by milliseconds at best but 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 who created a collection from many formulas for calculation of DeltaT: http://www.staff.science.uu.nl/~gent0113/deltat/deltat.htm
Use this only if needed, prefer calling getDeltaT() for access to the current value.
Up to V0.15.1, if the requested year was outside validity range, we returned zero or some useless value. Starting with V0.15.2 the value from the edge of the defined range is returned instead if not explicitly zero is given in the source. Limits can be queried with getCurrentDeltaTAlgorithmValidRangeDescription()
void StelCore::currentProjectionNameI18nChanged ( const QString &  newValue)
signal

Emitted whenever the projection type changes.

void StelCore::currentProjectionTypeChanged ( StelCore::ProjectionType  newType)
signal

Emitted whenever the projection type changes.

void StelCore::currentProjectionTypeKeyChanged ( const QString &  newValue)
signal

Emitted whenever the projection type changes.

void StelCore::dateChanged ( )
signal

This signal is emitted when the date has changed.

bool StelCore::de430IsActive ( )
slot

true if DE430 ephemeris is in use

bool StelCore::de430IsAvailable ( )
slot

true if DE430 ephemeris file has been found

bool StelCore::de431IsActive ( )
slot

true if DE431 ephemeris is in use

bool StelCore::de431IsAvailable ( )
slot

true if DE431 ephemeris file has been found

void StelCore::decreaseTimeSpeed ( )
slot

Decrease the time speed.

void StelCore::decreaseTimeSpeedLess ( )
slot

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

Vec3d StelCore::equinoxEquToJ2000 ( const Vec3d v,
RefractionMode  refMode = RefractionAuto 
) const

Transform position vector v from equatorial coordinates of date (which may also include atmospheric refraction) to those of J2000.

Use refMode=StelCore::RefractionOff if you don't want any atmosphere correction. Use refMode=StelCore::RefractionOn to create observed (apparent) coordinates (which are subject to refraction). Use refMode=StelCore::RefractionAuto to correct coordinates for refraction only when atmosphere is active.

void StelCore::flagUseNutationChanged ( bool  b)
signal

This signal indicates a switch in use of nutation.

void StelCore::flagUseTopocentricCoordinatesChanged ( bool  b)
signal

This signal indicates a switch in use of topocentric coordinates.

void StelCore::flipHorzChanged ( bool  b)
signal

This signal indicates a horizontal display flip.

void StelCore::flipVertChanged ( bool  b)
signal

This signal indicates a vertical display flip.

QStringList StelCore::getAllProjectionTypeKeys ( ) const
slot

Get the list of all the available projections.

StelProjector::ModelViewTranformP StelCore::getAltAzModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric altazimuthal drawing.

void StelCore::getClippingPlanes ( double *  zn,
double *  zf 
) const

Get the near and far clipping planes.

DeltaTAlgorithm StelCore::getCurrentDeltaTAlgorithm ( ) const
inlineslot

Get the current algorithm for time correction (DeltaT)

Definition at line 374 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::getCurrentDeltaTAlgorithmValidRangeDescription ( const double  JD,
QString *  marker 
) const

Get info about valid range for current algorithm for calculation of Delta-T.

Parameters
JDthe Julian Day number to test.
markerreceives a string: "*" if jDay is outside valid range, or "?" if range unknown, else an empty string.
Returns
valid range as explanatory string.
double StelCore::getCurrentEpoch ( ) const

Get value of the current Julian epoch (i.e. current year with decimal fraction, e.g. 2012.34567)

const StelLocation& StelCore::getCurrentLocation ( ) const

Get the informations on the current location.

const StelObserver* StelCore::getCurrentObserver ( ) const

Unfortunately we also need this.

Returns the current observer. Note that the observer object may be deleted at any time when control returns to StelCore.

QString StelCore::getCurrentProjectionTypeKey ( void  ) const
slot

Get the current Mapping used by the Projection.

StelProjector::StelProjectorParams StelCore::getCurrentStelProjectorParams ( ) const

Get the current set of parameters to use when creating a new StelProjector.

QString StelCore::getDefaultLocationID ( ) const
slot

Get the location used by default at startup.

QString StelCore::getDefaultProjectionTypeKey ( void  ) const

Get the default Mapping used by the Projection.

double StelCore::getDeltaT ( ) const
slot

Get current DeltaT.

Vec3f StelCore::getDeltaTCustomEquationCoefficients ( ) const
inlineslot

Get coefficients for custom equation for calculation of DeltaT.

Definition at line 697 of file StelCore.hpp.

float StelCore::getDeltaTCustomNDot ( ) const
inlineslot

Get n-dot for custom equation for calculation of DeltaT.

Definition at line 693 of file StelCore.hpp.

float StelCore::getDeltaTCustomYear ( ) const
inlineslot

Get central year for custom equation for calculation of DeltaT.

Definition at line 691 of file StelCore.hpp.

float StelCore::getDeltaTnDot ( ) const
inlineslot

Get n-dot for current DeltaT algorithm.

Definition at line 695 of file StelCore.hpp.

StelProjector::ModelViewTranformP StelCore::getEquinoxEquModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric equatorial at equinox drawing.

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.
StelProjector::ModelViewTranformP StelCore::getGalacticModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric Galactic equatorial drawing.

const StelGeodesicGrid* StelCore::getGeodesicGrid ( int  maxLevel) const

Get an instance of StelGeodesicGrid which is garanteed to allow for at least maxLevel levels.

StelProjector::ModelViewTranformP StelCore::getHeliocentricEclipticModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for heliocentric ecliptic (Vsop87) drawing.

QString StelCore::getIAUConstellation ( const Vec3d  positionEqJnow) const
slot

Return 3-letter abbreviation of IAU constellation name for position in equatorial coordinates on the current epoch.

Follows 1987PASP...99..695R: Nancy Roman: Identification of a Constellation from a Position Data file from ADC catalog VI/42 with her amendment from 1999-12-30.

Parameters
positionEqJnowposition vector in rectangular equatorial coordinates of current epoch&equinox.
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.

StelProjector::ModelViewTranformP StelCore::getJ2000ModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric J2000 equatorial drawing.

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::getJDOfLastJDUpdate ( ) const
slot

Returns the JD of the last time resetSync() was called.

double StelCore::getLocalSiderealDayLength ( ) const

Get the duration of a sidereal day for the current observer in day.

double StelCore::getLocalSiderealTime ( ) const

Get the sidereal time shifted by the observer longitude.

Returns
the local sidereal time in radian
double StelCore::getLocalSiderealYearLength ( ) const

Get the duration of a sidereal year for the current observer in days.

qint64 StelCore::getMilliSecondsOfLastJDUpdate ( ) const
slot

Returns the system date of the last time resetSync() was called.

double StelCore::getMJDay ( ) const
slot

Get the current date in Modified Julian Day (UT)

StelMovementMgr* StelCore::getMovementMgr ( )

Get the instance of movement manager.

const StelMovementMgr* StelCore::getMovementMgr ( ) const

Get the const instance of movement manager.

StelProjector::ModelViewTranformP StelCore::getObservercentricEclipticJ2000ModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric ecliptic (Vsop87) drawing.

StelProjector::ModelViewTranformP StelCore::getObservercentricEclipticOfDateModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric ecliptic of Date drawing.

Vec3d StelCore::getObserverHeliocentricEclipticPos ( ) const

Return the observer heliocentric ecliptic position (GZ: presumably J2000)

double StelCore::getPresetSkyTime ( ) const
slot

Return the preset sky time in JD.

StelProjectorP StelCore::getProjection ( FrameType  frameType,
RefractionMode  refractionMode = RefractionAuto 
) const

Get a new instance of projector using a modelview transformation corresponding to the given frame.

If not specified the refraction effect is included if atmosphere is on.

StelProjectorP StelCore::getProjection ( StelProjector::ModelViewTranformP  modelViewTransform,
ProjectionType  projType = (ProjectionType) 1000 
) const

Get a new instance of projector using the given modelview transformation.

If not specified the projection used is the one currently used as default.

StelProjectorP StelCore::getProjection2d ( ) const

Get a new instance of a simple 2d projection.

This projection cannot be used to project or unproject but only for 2d painting

bool StelCore::getRealTimeSpeed ( ) const
slot

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

StelSkyDrawer* StelCore::getSkyDrawer ( )

Get the current StelSkyDrawer used in the core.

const StelSkyDrawer* StelCore::getSkyDrawer ( ) const

Get the current StelSkyDrawer used in the core.

double StelCore::getSolutionEquationOfTime ( const double  JDE) const
slot

Get solution of equation of time Source: J.

Meeus "Astronomical Algorithms" (2nd ed., with corrections as of August 10, 2009) p.183-187.

Parameters
JDEJD in Dynamical Time (previously called Ephemeris Time)
Returns
time in minutes
QString StelCore::getStartupTimeMode ( )

Return the startup mode, can be "actual" (i.e.

take current time from system), "today" (take some time e.g. on the evening of today) or "preset" (completely preconfigured).

StelProjector::ModelViewTranformP StelCore::getSupergalacticModelViewTransform ( RefractionMode  refMode = RefractionAuto) const

Get the modelview matrix for observer-centric Supergalactic equatorial drawing.

double StelCore::getTimeRate ( ) const
slot

Get time speed in JDay/sec.

StelToneReproducer* StelCore::getToneReproducer ( )

Get the current tone reproducer used in the core.

const StelToneReproducer* StelCore::getToneReproducer ( ) const

Get the current tone reproducer used in the core.

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

Definition at line 496 of file StelCore.hpp.

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

Definition at line 501 of file StelCore.hpp.

float StelCore::getUTCOffset ( const double  JD) const

Get the UTC offset on the current location (in hours)

double StelCore::getViewportHorizontalOffset ( void  ) const
slot

Get current value for horizontal viewport offset [-50...50] An offset of 50 percent means projective image center is on the right screen border.

double StelCore::getViewportVerticalOffset ( void  ) const
slot

Get current value for vertical viewport offset [-50...50] An offset of 50 percent means projective image center is on the upper screen border.

Vec3d StelCore::heliocentricEclipticToAltAz ( const Vec3d v,
RefractionMode  refMode = RefractionAuto 
) const

Transform vector from heliocentric ecliptic coordinate to altazimuthal.

Vec3d StelCore::heliocentricEclipticToEquinoxEqu ( const Vec3d v) const

Transform from heliocentric coordinate to equatorial at current equinox (for the planet where the observer stands)

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::init ( )

Init and load all main core components.

void StelCore::initEphemeridesFunctions ( )
slot

initialize ephemerides calculation functions

bool StelCore::isBrightDaylight ( ) const

Checks for altitude of the Sun - is it night or day?

Returns
true if sun higher than about -6 degrees, i.e. "day" includes civil twilight.
Note
Useful mostly for brightness-controlled GUI decisions like font colors.
Vec3d StelCore::j2000ToEquinoxEqu ( const Vec3d v,
RefractionMode  refMode = RefractionAuto 
) const

Transform position vector v from equatorial coordinates J2000 to those of date (optionally corrected by refraction).

Use refMode=StelCore::RefractionOff if you don't want any atmosphere correction. Use refMode=StelCore::RefractionOn to correct observed (apparent) coordinates (which are subject to refraction). Use refMode=StelCore::RefractionAuto to correct coordinates for refraction only when atmosphere is active.

Vec3d StelCore::j2000ToJ1875 ( const Vec3d v) const

Use fixed matrix to allow fast transformation of positions related to the IAU constellation borders.

void StelCore::locationChanged ( StelLocation  )
signal

This signal is emitted when the observer location has changed.

void StelCore::lookAtJ2000 ( const Vec3d pos,
const Vec3d up 
)

Set vision direction.

void StelCore::moveObserverTo ( const StelLocation target,
double  duration = 1.,
double  durationIfPlanetChange = 1. 
)
slot

Smoothly move the observer to the given location.

Parameters
targetthe target location
durationdirection of view move duration in s
durationIfPlanetChangedirection of view + planet travel move duration in s. This is used only if the destination planet is different from the starting one.
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::postDraw ( )

Update core state after drawing modules.

void StelCore::preDraw ( )

Update core state before drawing modules.

QString StelCore::projectionNameI18nToTypeKey ( const QString &  nameI18n) const

Get the projection TypeKey from its translated name for the current locale.

QString StelCore::projectionTypeKeyToNameI18n ( const QString &  key) const

Get the translated projection name from its TypeKey for the current locale.

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::setClippingPlanes ( double  znear,
double  zfar 
)

Set the near and far clipping planes.

void StelCore::setCurrentDeltaTAlgorithm ( DeltaTAlgorithm  algorithm)
slot

Set the current algorithm and nDot used therein for time correction (DeltaT)

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::setCurrentStelProjectorParams ( const StelProjector::StelProjectorParams newParams)

Set the set of parameters to use when creating a new StelProjector.

void StelCore::setDe430Active ( bool  status)
slot

switch DE430 use to

Parameters
status(if de430IsAvailable()). DE430 is only used if date is within range of DE430.
void StelCore::setDe431Active ( bool  status)
slot

switch DE431 use to

Parameters
status(if de431IsAvailable()). DE431 is only used if DE430 is not used and the date is within range of DE431.
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 DeltaT.

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

Definition at line 688 of file StelCore.hpp.

void StelCore::setDeltaTCustomNDot ( float  v)
inlineslot

Set n-dot for custom equation for calculation of DeltaT.

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

Definition at line 685 of file StelCore.hpp.

void StelCore::setDeltaTCustomYear ( float  y)
inlineslot

Set central year for custom equation for calculation of DeltaT.

Parameters
ythe year, e.g. 1820

Definition at line 682 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::setMilliSecondsOfLastJDUpdate ( qint64  millis)
slot

Sets the system date which corresponds to the jdOfLastJDUpdate.

Usually, you do NOT want to call this method. This method is used by the RemoteSync plugin.

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::setObserver ( StelObserver obs)

Replaces the current observer. StelCore assumes ownership of the observer.

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  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 498 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 503 of file StelCore.hpp.

void StelCore::setViewportHorizontalOffset ( double  newOffsetPct)
slot

Set horizontal viewport offset.

Argument will be clamped to be inside [-50...50] An offset of 50 percent means projective image center is on the right screen border Animation is available via StelMovementMgr::moveViewport()

void StelCore::setViewportStretch ( float  stretch)
slot

Can be used in specialized setups, intended e.g.

for multi-projector installations with edge blending.

Parameters
stretch[default 1] enlarge to stretch image to non-square pixels. A minimum value of 0.001 is enforced.
Note
This only influences the projected content. Things like ScreenImages keep square pixels.
void StelCore::setViewportVerticalOffset ( double  newOffsetPct)
slot

Set vertical viewport offset.

Argument will be clamped to be inside [-50...50] An offset of 50 percent means projective image center is on the upper screen border Setting to a negative value will move the visible horizon down, this may be desired esp. in cylindrical projection. Animation is available via StelMovementMgr::moveViewport()

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::subtractMinute ( )
slot

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

void StelCore::subtractSaros ( )
slot

Subtract one saros (223 synodic months) 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::subtractSiderealWeek ( )
slot

Subtract seven sidereal days 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::targetLocationChanged ( StelLocation  )
signal

This signal is emitted whenever the targetted location changes.

void StelCore::timeRateChanged ( double  rate)
signal

This signal is emitted when the time rate has changed.

void StelCore::timeSyncOccurred ( double  jDay)
signal

This signal is emitted whenever the time is re-synced.

This happens whenever the internal jDay is changed through setJDay/setMJDay and similar, and whenever the time rate changes.

void StelCore::toggleRealTimeSpeed ( )
slot

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

void StelCore::update ( double  deltaTime)

Update all the objects with respect to the time.

Parameters
deltaTimethe time increment in sec.
void StelCore::windowHasBeenResized ( float  x,
float  y,
float  width,
float  height 
)

Handle the resizing of the window.

Member Data Documentation

const Mat4d StelCore::matGalacticToJ2000
static

Rotation matrix from Galactic to J2000 reference frame, using FITS convention.

Definition at line 278 of file StelCore.hpp.

const Mat4d StelCore::matJ2000ToGalactic
static

Rotation matrix from J2000 to Galactic reference frame, using FITS convention.

Definition at line 276 of file StelCore.hpp.

const Mat4d StelCore::matJ2000ToSupergalactic
static

Rotation matrix from J2000 to Supergalactic reference frame.

Definition at line 280 of file StelCore.hpp.

const Mat4d StelCore::matJ2000ToVsop87
static

Rotation matrix from equatorial J2000 to ecliptic (VSOP87A).

Definition at line 272 of file StelCore.hpp.

const Mat4d StelCore::matSupergalacticToJ2000
static

Rotation matrix from Supergalactic to J2000 reference frame.

Definition at line 282 of file StelCore.hpp.

const Mat4d StelCore::matVsop87ToJ2000
static

Rotation matrix from ecliptic (VSOP87A) to equatorial J2000.

Definition at line 274 of file StelCore.hpp.

Property Documentation

QString StelCore::currentProjectionNameI18n
read

Read-only property returning the localized projection name.

Definition at line 63 of file StelCore.hpp.

QString StelCore::currentProjectionTypeKey
readwrite

This is just another way to access the projection type, by string instead of enum.

Definition at line 61 of file StelCore.hpp.


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