Home · All Namespaces · All Classes · Functions · Coding Style · Plugins · File Structure

StelUtils Namespace Reference

contains general purpose utility functions. More...


Functions

double hmsToRad (unsigned int h, unsigned int m, double s)
double dmsToRad (int d, unsigned int m, double s)
void radToHms (double rad, unsigned int &h, unsigned int &m, double &s)
void radToDms (double rad, bool &sign, unsigned int &d, unsigned int &m, double &s)
QString radToHmsStrAdapt (double angle)
QString radToHmsStr (double angle, bool decimal=false)
QString radToDmsStrAdapt (double angle, bool useD=false)
QString radToDmsStr (double angle, bool decimal=false, bool useD=false)
Vec3f strToVec3f (const QStringList &s)
Vec3f strToVec3f (const QString &s)
QString vec3fToHtmlColor (const Vec3f &v)
Vec3f htmlColorToVec3f (const QString &c)
void spheToRect (double lng, double lat, Vec3d &v)
void spheToRect (float lng, float lat, Vec3f &v)
void rectToSphe (double *lng, double *lat, const Vec3d &v)
void rectToSphe (float *lng, float *lat, const Vec3d &v)
double getDecAngle (const QString &str)
bool isPowerOfTwo (int value)
int getBiggerPowerOfTwo (int value)
double asinh (double z)
void getDateFromJulianDay (double julianDay, int *year, int *month, int *day)
void getTimeFromJulianDay (double julianDay, int *hour, int *minute, int *second)
QString sixIntsToIsoString (int year, int month, int day, int hour, int minute, int second)
QString jdToIsoString (double jd)
QString localeDateString (int year, int month, int day, int dayOfWeek, QString fmt)
QString localeDateString (int year, int month, int day, int dayOfWeek)
double getJDFromSystem (void)
double qTimeToJDFraction (const QTime &time)
QTime jdFractionToQTime (const double jd)
float getGMTShiftFromQT (double JD)
double qDateTimeToJd (const QDateTime &dateTime)
QDateTime jdToQDateTime (const double &jd)
bool getJDFromDate (double *newjd, int y, int m, int d, int h, int min, int s)
int numberOfDaysInMonthInYear (int month, int year)
bool changeDateTimeForRollover (int oy, int om, int od, int oh, int omin, int os, int *ry, int *rm, int *rd, int *rh, int *rmin, int *rs)
void debugQVariantMap (const QVariant &m, const QString &indent="", const QString &key="")
QList< int > getIntsFromISO8601String (const QString &iso8601Date)


Detailed Description

contains general purpose utility functions.

Function Documentation

double StelUtils::asinh ( double  z  ) 

Return the inverse sinus hyperbolic of z.

void StelUtils::debugQVariantMap ( const QVariant &  m,
const QString &  indent = "",
const QString &  key = "" 
)

Output a QVariantMap to qDebug(). Formats like a tree where there are nested objects.

double StelUtils::dmsToRad ( int  d,
unsigned int  m,
double  s 
)

Convert an angle in +-dms format to radian.

Parameters:
d degree component
m arcmin component
s arcsec component
Returns:
angle in radian

int StelUtils::getBiggerPowerOfTwo ( int  value  ) 

Return the first power of two bigger than the given value.

void StelUtils::getDateFromJulianDay ( double  julianDay,
int *  year,
int *  month,
int *  day 
)

Make from julianDay a year, month, day for the Julian Date julianDay represents.

double StelUtils::getDecAngle ( const QString &  str  ) 

Convert a string longitude, latitude, RA or Declination angle to radians.

Parameters:
str the angle in format something like these:
  • +53d 51'21.6"
  • +53d51'21.6"
  • -1d 10'31.8"
  • +46d6'31"
  • 50D46'0"N
  • 123D47'59"W
  • 123.567 N
  • 123.567W
  • -123.567
  • 12h 14m 6s The degree separator may be a degree symbol (\xBA) in addition to a 'd' or 'D'.
Returns:
the angle in radians. Latitude: North are positive, South are negative. Longitude: East is positive, West is negative. Note: if there is a N, S, E or W suffix, any leading + or - characters are ignored.

float StelUtils::getGMTShiftFromQT ( double  JD  ) 

Return number of hours offset from GMT, using Qt functions.

QList<int> StelUtils::getIntsFromISO8601String ( const QString &  iso8601Date  ) 

Use RegExp for final to parse a QString to six ints, use in the event QDateTime cannot handle the date.

double StelUtils::getJDFromSystem ( void   ) 

Get the current Julian Date from system time.

Returns:
the current Julian Date

void StelUtils::getTimeFromJulianDay ( double  julianDay,
int *  hour,
int *  minute,
int *  second 
)

Make from julianDay an hour, minute, second.

double StelUtils::hmsToRad ( unsigned int  h,
unsigned int  m,
double  s 
)

Convert an angle in hms format to radian.

Parameters:
h hour component
m minute component
s second component
Returns:
angle in radian

Vec3f StelUtils::htmlColorToVec3f ( const QString &  c  ) 

Converts a color in HTML notation to a Vec3f.

Parameters:
c The HTML spec color string

bool StelUtils::isPowerOfTwo ( int  value  ) 

Check if a number is a power of 2.

QTime StelUtils::jdFractionToQTime ( const double  jd  ) 

Convert a fraction of a Julian Day to a QTime.

QDateTime StelUtils::jdToQDateTime ( const double &  jd  ) 

Convert a julian day to a QDateTime.

Parameters:
jd to convert
Returns:
the matching UTC QDateTime

QString StelUtils::localeDateString ( int  year,
int  month,
int  day,
int  dayOfWeek 
)

Format the date and day-of-week per the default locale's QLocale::ShortFormat.

Returns:
QString representing the formatted date

QString StelUtils::localeDateString ( int  year,
int  month,
int  day,
int  dayOfWeek,
QString  fmt 
)

Format the date and day-of-week per the format in fmt (see QDateTime::toString()).

Returns:
QString representing the formatted date

double StelUtils::qDateTimeToJd ( const QDateTime &  dateTime  ) 

Convert a QT QDateTime class to julian day.

Parameters:
dateTime the UTC QDateTime to convert
Returns:
the matching decimal Julian Day

double StelUtils::qTimeToJDFraction ( const QTime &  time  ) 

Convert a time of day to the fraction of a Julian Day.

Note that a Julian Day starts at 12:00, not 0:00, and so 12:00 == 0.0 and 0:00 == 0.5

void StelUtils::radToDms ( double  rad,
bool &  sign,
unsigned int &  d,
unsigned int &  m,
double &  s 
)

Convert an angle in radian to +-dms format.

Parameters:
rad input angle in radian
sign true if positive, false otherwise
d degree component
m minute component
s second component

QString StelUtils::radToDmsStr ( double  angle,
bool  decimal = false,
bool  useD = false 
)

Convert an angle in radian to a dms formatted string.

Parameters:
angle input angle in radian
useD Define if letter "d" must be used instead of deg sign
decimal output decimal second value

QString StelUtils::radToDmsStrAdapt ( double  angle,
bool  useD = false 
)

Convert an angle in radian to a dms formatted string.

If the second, minute part is == 0, it is not output

Parameters:
angle input angle in radian
useD Define if letter "d" must be used instead of deg sign

void StelUtils::radToHms ( double  rad,
unsigned int &  h,
unsigned int &  m,
double &  s 
)

Convert an angle in radian to hms format.

Parameters:
rad input angle in radian
h hour component
m minute component
s second component

QString StelUtils::radToHmsStr ( double  angle,
bool  decimal = false 
)

Convert an angle in radian to a hms formatted string.

Parameters:
angle input angle in radian
decimal output decimal second value

QString StelUtils::radToHmsStrAdapt ( double  angle  ) 

Convert an angle in radian to a hms formatted string.

If the second, minute part is == 0, it is not output

Parameters:
angle input angle in radian

void StelUtils::rectToSphe ( float *  lng,
float *  lat,
const Vec3d v 
)

Convert from spherical coordinates to Rectangular direction.

Parameters:
lng float* to store longitude in radian
lat float* to store latitude in radian
v the input 3D vector

void StelUtils::rectToSphe ( double *  lng,
double *  lat,
const Vec3d v 
)

Convert from spherical coordinates to Rectangular direction.

Parameters:
lng double* to store longitude in radian
lat double* to store latitude in radian
v the input 3D vector

QString StelUtils::sixIntsToIsoString ( int  year,
int  month,
int  day,
int  hour,
int  minute,
int  second 
)

Utility for formatting to a simple iso 8601 string.

void StelUtils::spheToRect ( float  lng,
float  lat,
Vec3f v 
)

Convert from spherical coordinates to Rectangular direction.

Parameters:
lng longitude in radian
lat latitude in radian
v the resulting 3D unti vector

void StelUtils::spheToRect ( double  lng,
double  lat,
Vec3d v 
)

Convert from spherical coordinates to Rectangular direction.

Parameters:
lng longitude in radian
lat latitude in radian
v the resulting 3D unit vector

Vec3f StelUtils::strToVec3f ( const QStringList &  s  ) 

Obtains a Vec3f from a string.

Parameters:
s the string describing the Vector with the form "x,y,z"
Returns:
The corresponding vector

QString StelUtils::vec3fToHtmlColor ( const Vec3f v  ) 

Converts a Vec3f to HTML color notation.

Parameters:
v The vector
Returns:
The string in HTML color notation "#rrggbb".


Generated on Mon Feb 2 17:23:48 2009 for Stellarium by  doxygen 1.5.5