Script TheSky  Version 1.32
Public Types | Public Slots | Public Member Functions | Properties | List of all members
sky6Utils Class Reference

The sky6Utils object. More...

Inheritance diagram for sky6Utils:

Public Types

enum  SkXUtilsSexagesimalFormat {
  FMT_DMS =0, FMT_DMS_SIGN =1, FMT_DMS_NS =2, FMT_DMS_EW =3,
  FMT_HMS =4, FMT_TIME =5, FMT_DMS_MINIM =6, FMT_COMMAS =7,
  FMT_NOCOMMAS =8
}
 
enum  SkXUtilsSexagesimalSigFigs {
  SSF_ONE =0, SSF_TWO =1, SSF_THREE =2, SSF_FOUR =3,
  SSF_FIVE =4, SSF_SIX =5, SSF_SEVEN =6, SSF_EIGHT =7
}
 

Public Slots

void ConvertStringToRA (QString strRA)
 Converts a string that contains right ascension to a double value and places the result into the dOut0() property.
 
void ConvertStringToDec (QString strDec)
 Converts a string that contains declination to a double value and places the result into the dOut0() property.
 
void ConvertEquatorialToString (double RA1, double Dec1, int SigFigs)
 Converts equatorial coordinates given by the double right ascension (RA) and declination (Dec) parameters to a string formatted by the SkUtilsSexagesimalSigFigs argument. More...
 
void ConvertHorizonToString (double Az, double Alt, int SigFigs)
 Converts horizon-based coordinates given by the azimuth altitude values to a string formatted by the SkUtilsSexagesimalSigFigs argument. More...
 
void ConvertRADecToAzAlt (double ra, double dec)
 Converts equatorial coordinates (right ascension/declination or RA/Dec) to horizon-based coordinates (azimuth/altitude or Az/Alt). More...
 
void ConvertAzAltToRADec (double az, double alt)
 Converts horizon-based coordinates (azimuth/altitude or Az/Alt) to equatorial coordinates (right ascension/declination or RA/Dec). More...
 
void ConvertJulianDateToCalender (double JulianDay)
 Converts a Julian date to a Gregorian calendar date (year, month, day, hour, minute and second). More...
 
void ConvertCalenderToJulianDate (int Year, int Month, int Day, int Hour, int Minute, double Second)
 Converts a Gregorian calendar date (year, month, day, hour, minute and second) to a Julian date. More...
 
void ConvertDMSToAngle (int Degrees, int Minutes, double Seconds)
 Converts degrees, minutes, seconds to an angle. More...
 
void ConvertAngleToDMS (double Angle)
 Converts an angle to degrees, minutes, seconds. More...
 
void ConvertSexagesimalToString (double Value, int Format, int SigFigs)
 Converts a "sexagesimal" formatted number (that is, a number that contains hours, minutes and seconds, or degrees, minutes, seconds) to a string. More...
 
void ComputePositionAngle (double RA1, double Dec1, double RA2, double Dec2)
 Computes the position angle (the angle measured counterclockwise from true North) between two equatorial coordinates. More...
 
void ComputeAngularSeparation (double RA1, double Dec1, double RA2, double Dec2)
 Computes the angular separation between two equatorial coordinates. More...
 
void ComputeHourAngle (double Ra)
 Computes the hour angle (a number between 0 and 12, measured East to West) for a right ascension coordinate. More...
 
void ComputeAirMass (double Alt)
 Computes the air mass at a given altitude. More...
 
void ComputeLocalSiderealTime ()
 Computes the local sidereal time from TheSky's location and time settings. More...
 
void ComputeUniversalTime ()
 Computes the universal time (UT) from TheSky's location and time settings. More...
 
void ComputeJulianDate ()
 Computes the Julian date (JD) from TheSky's location and time settings. More...
 
void ComputeRefraction (double Alt)
 Computes the refraction (in seconds) at a given altitude. More...
 
void ComputeRiseTransitSetTimes (double RA, double Dec)
 Computes the rise, transit, and set times for the specified equatorial coordinate (right ascension and declination). More...
 
void PrecessNowTo2000 (double RA, double Dec)
 Precess coordinates for the current Epoch to Epoch 2000.0. More...
 
void Precess2000ToNow (double RA, double Dec)
 Precess coordinates for Epoch 2000 to the current Epoch. More...
 

Public Member Functions

 Q_ENUMS (SkXUtilsSexagesimalFormat)
 
 Q_ENUMS (SkXUtilsSexagesimalSigFigs)
 

Properties

QString strOut
 This property holds the string result for various methods. More...
 
double dOut0
 This property holds the double result for various methods. More...
 
double dOut1
 This property holds the double result for various methods. More...
 
double dOut2
 This property holds the double result for various methods. More...
 
double dOut3
 This property holds the double result for various methods. More...
 
double dOut4
 This property holds the double result for various methods. More...
 
double dOut5
 This property holds the double result for various methods. More...
 

Detailed Description

The sky6Utils object.

The Utils object gives access to commonly used astronomy related routines and conversions. The routines include the ability to compute the position angle and angular separation between to objects, the hour angle, air-mass, refraction and rise transit set times of an object, the local sidereal time, universal time, Julian date of TheSky as well as the ability to precess coordinates to and from epoch 2000.

The conversions include the ability to convert a string to a double and vise versa for both equatorial coordinates (right ascension/declination) and horizon coordinates (azimuth/altitude), the ability to convert between equatorial and horizon coordinates and vise versa, convert a calendar day (year, month, day, hour, minute, second) to a Julian date and vise-versa as well as the ability to format most any "sexagesimal" to a string with a wide variety of formats.

Member Enumeration Documentation

◆ SkXUtilsSexagesimalFormat

Enumerator
FMT_DMS 

Format in DMS.

FMT_DMS_SIGN 

Format in DMS including a sign.

FMT_DMS_NS 

Format in DMS including a N and S.

FMT_DMS_EW 

Format in DMS including a E and W.

FMT_HMS 

Format in HMS.

FMT_TIME 

Format time.

FMT_DMS_MINIM 

Format DMS minimum size.

FMT_COMMAS 

Format using commas.

FMT_NOCOMMAS 

Format using no commas.

◆ SkXUtilsSexagesimalSigFigs

Enumerator
SSF_ONE 

Format to 1 significant figure.

SSF_TWO 

Format to 2 significant figures.

SSF_THREE 

Format to 3 significant figures.

SSF_FOUR 

Format to 4 significant figures.

SSF_FIVE 

Format to 5 significant figures.

SSF_SIX 

Format to 6 significant figures.

SSF_SEVEN 

Format to 7 significant figures.

SSF_EIGHT 

Format to 8 significant figures.

Member Function Documentation

◆ ComputeAirMass

void sky6Utils::ComputeAirMass ( double  Alt)
slot

Computes the air mass at a given altitude.

The result is placed in the dOut0() property().

◆ ComputeAngularSeparation

void sky6Utils::ComputeAngularSeparation ( double  RA1,
double  Dec1,
double  RA2,
double  Dec2 
)
slot

Computes the angular separation between two equatorial coordinates.

The result is placed in the dOut0() property().

◆ ComputeHourAngle

void sky6Utils::ComputeHourAngle ( double  Ra)
slot

Computes the hour angle (a number between 0 and 12, measured East to West) for a right ascension coordinate.

The result is placed in the dOut0() property().

◆ ComputeJulianDate

void sky6Utils::ComputeJulianDate ( )
slot

Computes the Julian date (JD) from TheSky's location and time settings.

The result is placed in the dOut0() property().

◆ ComputeLocalSiderealTime

void sky6Utils::ComputeLocalSiderealTime ( )
slot

Computes the local sidereal time from TheSky's location and time settings.

The result is placed in the dOut0() property().

◆ ComputePositionAngle

void sky6Utils::ComputePositionAngle ( double  RA1,
double  Dec1,
double  RA2,
double  Dec2 
)
slot

Computes the position angle (the angle measured counterclockwise from true North) between two equatorial coordinates.

The result is placed in the dOut0() property().

◆ ComputeRefraction

void sky6Utils::ComputeRefraction ( double  Alt)
slot

Computes the refraction (in seconds) at a given altitude.

The result is placed in the dOut0() property().

◆ ComputeRiseTransitSetTimes

void sky6Utils::ComputeRiseTransitSetTimes ( double  RA,
double  Dec 
)
slot

Computes the rise, transit, and set times for the specified equatorial coordinate (right ascension and declination).

The result is placed into the dOut0(), dOut1() and dOut2() properties respectively.

◆ ComputeUniversalTime

void sky6Utils::ComputeUniversalTime ( )
slot

Computes the universal time (UT) from TheSky's location and time settings.

The result is placed in the dOut0() property().

◆ ConvertAngleToDMS

void sky6Utils::ConvertAngleToDMS ( double  Angle)
slot

Converts an angle to degrees, minutes, seconds.

The results is placed into the dOut0(), dOut1(), dOut2() properties respectively.

◆ ConvertAzAltToRADec

void sky6Utils::ConvertAzAltToRADec ( double  az,
double  alt 
)
slot

Converts horizon-based coordinates (azimuth/altitude or Az/Alt) to equatorial coordinates (right ascension/declination or RA/Dec).

The result is placed into the dOut0() and dOut1() properties respectively.

◆ ConvertCalenderToJulianDate

void sky6Utils::ConvertCalenderToJulianDate ( int  Year,
int  Month,
int  Day,
int  Hour,
int  Minute,
double  Second 
)
slot

Converts a Gregorian calendar date (year, month, day, hour, minute and second) to a Julian date.

The result is placed in the dOut0() property().

◆ ConvertDMSToAngle

void sky6Utils::ConvertDMSToAngle ( int  Degrees,
int  Minutes,
double  Seconds 
)
slot

Converts degrees, minutes, seconds to an angle.

The result is placed inthe dOut0() property().

◆ ConvertEquatorialToString

void sky6Utils::ConvertEquatorialToString ( double  RA1,
double  Dec1,
int  SigFigs 
)
slot

Converts equatorial coordinates given by the double right ascension (RA) and declination (Dec) parameters to a string formatted by the SkUtilsSexagesimalSigFigs argument.

The retult is placed into the strOut() property.

◆ ConvertHorizonToString

void sky6Utils::ConvertHorizonToString ( double  Az,
double  Alt,
int  SigFigs 
)
slot

Converts horizon-based coordinates given by the azimuth altitude values to a string formatted by the SkUtilsSexagesimalSigFigs argument.

The retult is placed into the strOut() property.

◆ ConvertJulianDateToCalender

void sky6Utils::ConvertJulianDateToCalender ( double  JulianDay)
slot

Converts a Julian date to a Gregorian calendar date (year, month, day, hour, minute and second).

The result is placed into the dOut0() through dOut5() properties respectively.

◆ ConvertRADecToAzAlt

void sky6Utils::ConvertRADecToAzAlt ( double  ra,
double  dec 
)
slot

Converts equatorial coordinates (right ascension/declination or RA/Dec) to horizon-based coordinates (azimuth/altitude or Az/Alt).

The result is placed into the dOut0() and dOut1() properties respectively.

◆ ConvertSexagesimalToString

void sky6Utils::ConvertSexagesimalToString ( double  Value,
int  Format,
int  SigFigs 
)
slot

Converts a "sexagesimal" formatted number (that is, a number that contains hours, minutes and seconds, or degrees, minutes, seconds) to a string.

The result into the strOut() property.

Parameters
Formatis a SkXUtilsSexagesimalFormat
SigFigsis a SkXUtilsSexagesimalSigFigs

◆ Precess2000ToNow

void sky6Utils::Precess2000ToNow ( double  RA,
double  Dec 
)
slot

Precess coordinates for Epoch 2000 to the current Epoch.

The result is placed in the dOut0() and dOut1() properties repectively().

◆ PrecessNowTo2000

void sky6Utils::PrecessNowTo2000 ( double  RA,
double  Dec 
)
slot

Precess coordinates for the current Epoch to Epoch 2000.0.

The result is placed in the dOut0() and dOut1() properties repectively().

Property Documentation

◆ dOut0

sky6Utils::dOut0
read

This property holds the double result for various methods.

See also
ConvertDMSToAngle(), ConvertStringToRA()

◆ dOut1

sky6Utils::dOut1
read

This property holds the double result for various methods.

See also
PrecessNowTo2000(), Precess2000ToNow()

◆ dOut2

sky6Utils::dOut2
read

This property holds the double result for various methods.

See also
ConvertAngleToDMS()

◆ dOut3

sky6Utils::dOut3
read

This property holds the double result for various methods.

See also
ConvertJulianDateToCalender()

◆ dOut4

sky6Utils::dOut4
read

This property holds the double result for various methods.

See also
ConvertJulianDateToCalender()

◆ dOut5

sky6Utils::dOut5
read

This property holds the double result for various methods.

See also
ConvertJulianDateToCalender()

◆ strOut

sky6Utils::strOut
readwrite

This property holds the string result for various methods.

See also
ConvertStringToRA(), ConvertHorizonToString()
ScriptTheSkyX Examples
(C) Software Bisque, Inc. All rights reserved.