tcsJ2B.3

Manpage of tcsH2a

tcsH2a

Section: C Library Functions (3)
Updated: 2012-04-23 10:08
Index Return to man pages list

NAME

tcsH2a, tcsH2f, tcsSplitHms, tcsSplitSec, tcsCheckHms, tcsCheckDms, tcsHms2rad, tcsDms2rad, tcsRad2Hms, tcsRad2Dms, tcsD2r, tcsR2d, tcsB2J, tcsJ2B, tcsCoord2AltAz, tcsAltAz2Coord - Various C Coordinate Conversions routines

SYNOPSIS


#include "tcsVcc.h"

void tcsH2a(double p,double h,double d,double *al,double *az);
void tcsH2f(double ph,double h,double d,double *p);

void tcsSplitHms(double angle,double *h,double *m,double *s);
void tcsSplitSec(double sec,double *h,double *m,double *s);

int    tcsCheckHms(double angle);
int    tcsCheckDms(double angle);

double tcsHms2rad (double angle);
double tcsDms2rad (double angle);
double tcsRad2Hms (double angle);
double tcsRad2Dms (double angle);
double tcsD2r (double deg);
double tcsR2d (double rad);

oid tcsJ2B(double alphaIn,
           double deltaIn,
           double epochIn,
           double equinoxIn,
           double pmaIn,
           double pmdIn,
           double radvelIn,
           double parallaxIn,
           double epochObserved,
           double equinoxObserved,
           double *alphaOut,
           double *deltaOut,
           double *pmaOut,
           double *pmdOut,
           double *radVelOut,
           double *parallaxOut);
void tcsB2J ( double alphaIn,
              double deltaIn,
              double epochIn,
              double equinoxIn,
              double pmaIn,
              double pmdIn,
              double radvelIn,
              double parallaxIn,
              double epochObserved,
              double equinoxObserved,
              double *alphaOut,
              double *deltaOut,
              double *pmaOut,
              double *pmdOut,
              double *radVelOut,
              double *parallaxOut);
void tcsCoord2AltAz (double alpha,
                     double delta,
                     tcsEPOCH_SYSTEM epochSystem,
                     double epoch,
                     double equinox,
                     double pma,
                     double pmd,
                     double radvel,
                     double parallax,
                     tcsCOORD_TYPE coordType,
                     double envTemp,
                     double envPressure,
                     double envHumidity,
                     double envLapseRate,
                     double siteLat,
                     double siteLong,
                     double siteHeight,
                     double sitePolmx,
                     double sitePolmy,
                     double timeDut1,
                     double wavelength,
                     double mjd,
                     double *alt,
                     double *az);
void tcsAltAz2Coord (double alt,
                     double az,
                     tcsEPOCH_SYSTEM epochSystem,
                     double epoch,
                     double equinox,
                     double pma,
                     double pmd,
                     double radvel,
                     double parallax,
                     tcsCOORD_TYPE coordType,
                     double envTemp,
                     double envPressure,
                     double envHumidity,
                     double envLapseRate,
                     double siteLat,
                     double siteLong,
                     double siteHeight,
                     double sitePolmx,
                     double sitePolmy,
                     double timeDut1,
                     double wavelength,
                     double mjd,
                     double *alphaOut,
                     double *deltaOut);

DESCRIPTION


These functions perform coordinate converstions usefull when dealing
with different types of astronomical coordinate systems.

void tcsH2a(double ph,double h,double d,double *al,double *az);
       Convert HA,decl to alt/az
       Given    : h,d    : HA and decl ; radians
                  ph     : latitude    ; radians
       Returned :          alt,az ; radians

void tcsH2f(double ph,double h,double d,double *p);
       Calculate parallactic angle ( for field rot,)
       from HA/decl
       Given    : h,d    : HA and decl ; radians
                  ph     : latitude    ; radians
       Returned : p      : parallactic angle ; radians

void tcsSplitHms(double angle,double *h,double *m,double *s);
       Split an angle,given in user format, to its parts.
       Given    :  angle      an angle as hhmmss.ttt (or ddmmss.tt)
       Returned :  h          hours (degrees)
                   m          minutes (arcminutes)
                   s          seconds (arcseconds)
       The given time/angle, a floating value in the format HHMMSS.TTT, is split
       up in the parts HH, MM and SS.TTT (or DDMMSS.TTT if the input parameter
       is an angle).
       NOTE:   if the given value is negative, all returned values
       will also be negative! Which is may be not what you want, so take care of
       the sign outside of this function!

void tcsSplitSec(double sec,double *h,double *m,double *s);
     This routine splits the argument in unit seconds
     to separate fields for hours,minutesand seconds+fraction.
     If the argument is arcseconds,the returned par's are of
     course deg,arcmin,arcsec+fraction.
     All parameters are double precision real.
     Parameters given :
            sec   :   seconds ( or arc seconds)
     Parameters returned :
            h     :   hours ( or degrees )
            m     :   minutes ( or arc minutes)
            s     :   sec+fraction of sec( or arcsec+ fract of arcsec)

int tcsCheckHms(double angle);
     Checks a time, given in user format, for its
     parts beeing withing correct ranges.
     Given    :  time      a time as hhmmss.ttt
     The given time, a floating value in the format HHMMSS.TTT, is split
     up in the parts HH, MM and SS.TTT and it is checked that:
          -60  <    SS.TTT     < 60
          -60  <      MM       < 60
            0  <=     HH       < 24

int tcsCheckDms(double angle);
     Checks an angle, given in user format, for its
     parts beeing withing correct ranges.
     Given    :  angle     an angle as ddmmss.ttt
     The given time, a floating value in the format DDMMSS.TTT, is split
     up in the parts DD, MM and SS.TTT and it is checked that:
            -60  <    SS.TTT     < 60
            -60  <      MM       < 60
     Any value for DD is considered acceptable

double tcsHms2rad (double angle);
     Convert a time/angle,given in user format, to radians.
     Given    :  angle      an angle as hhmmss.ttt (HoursMinutesSecs)
     Returned :  rad        the angle as radians
     The given time/angle, a floating value in the format HHMMSS.TTT, is
     converted to radians. See also tcsSplitHms

double tcsDms2rad (double angle);
     Convert an angle,given in user format, to radians.
     Given    :  angle      an angle as ddmmss.ttt (DegreesMinutesSecs)
     Returned :  rad        the angle as radians
     The given angle, a floating value in the format DDMMSS.TTT, is
     converted to radians. See also tcsSplitHms.

double tcsD2r (double deg);
     Convert the given angle from degrees to radians
     Given    :  deg        angle in degrees
     Returned :  rad        angle in radians

double tcsR2d (double rad);
     Convert the given angle from radians to degrees
     Given    :  rad        angle in radians
     Returned :  deg        angle in degrees

double tcsRad2Hms (double angle);
     Convert a time/angle,given in radians, to 'user format' hhmmss.ttt
     Given    :  rad        the angle as radians
     Returned :  angle      an angle as hhmmss.ttt (HoursMinutesSecs)
     See also tcsHms2Rad (which is the opposite function!)

double tcsRad2Dms (double angle);
     Convert an angle,given in radians, to 'user format' ddmmss.ttt
     Given    :  rad        the angle as radians
     Returned :  angle      an angle as ddmmss.ttt
     See also tcsDms2Rad (which is the opposite function!)

oid tcsJ2B(double alphaIn,           rad in J system
           double deltaIn,           rad in J system
           double epochIn,           end year in B system
           double equinoxIn,         end year in B system
           double pmaIn,             rad/year in J system
           double pmdIn,             rad/year in J system
           double radvelIn,          km/sec in J system
           double parallaxIn,        arcsecs in J system
           double epochObserved,     starting year in J system
           double equinoxObserved,   starting year in J system
           double *alphaOut,         rad in B system
           double *deltaOut,         rad in B system
           double *pmaOut,           rad/year in B system
           double *pmdOut,           rad/year in B system
           double *radVelOut,        km/sec in B system
           double *parallaxOut);     arcsecs in B system
      Converts Mean coordinates from JYYYY/FK5 to BXXXX/FK4.

void tcsB2J ( double alphaIn,           rad in B System
              double deltaIn,           rad in B System
              double epochIn,           start year in B System
              double equinoxIn,         start year in B System
              double pmaIn,             rad/year in B System
              double pmdIn,             rad/year in B System
              double radvelIn,          km/sec in B System
              double parallaxIn,        arcsecs in B System
              double epochObserved,     end year in J system
              double equinoxObserved,   end year in J system
              double *alphaOut,         rad in J system
              double *deltaOut,         rad in J system
              double *pmaOut,           rad/year in J system
              double *pmdOut,           rad/year in J system
              double *radVelOut,        km/sec in J system
              double *parallaxOut);     arcsecs in J system
      Converts mean coordinates from BXXXX/FK4 to JYYYY/FK5.

void tcsCoord2AltAz (double alpha,               // HHMMSS.TTT
                     double delta,               // DDMMSS.TTT
                     tcsEPOCH_SYSTEM epochSystem,
                     double epoch,               // year
                     double equinox,             // year
                     double pma,                 // arcsecs/year
                     double pmd,                 // arcsecs/year
                     double radvel,              // km/sec
                     double parallax,            // arcsecs
                     tcsCOORD_TYPE coordType,
                     double envTemp,              // degree C
                     double envPressure,          // mbar
                     double envHumidity,          // percent 0..100
                     double envLapseRate,         // degreeK/m 0..1
                     double siteLat,              // rad
                     double siteLong,             // rad
                     double siteHeight,           // m
                     double sitePolmx,            // rad
                     double sitePolmy,            // rad
                     double timeDut1,             // seconds
                     double wavelength,           // nm
                     double mjd,                  // MJD
                     double *alt,                 // rad
                     double *az                   // rad
                     );
      Convert  alpha/delta into alt/az in given coordinate system

void tcsAltAz2Coord (double alt,                 // rad
                     double az,                  // rad
                     tcsEPOCH_SYSTEM epochSystem,
                     double epoch,               // year
                     double equinox,             // year
                     double pma,                 // arcsecs/year
                     double pmd,                 // arcsecs/year
                     double radvel,              // km/sec
                     double parallax,            // arcsecs
                     tcsCOORD_TYPE coordType,
                     double envTemp,              // degree C
                     double envPressure,          // mbar
                     double envHumidity,          // percent 0..100
                     double envLapseRate,         // degreeK/m 0..1
                     double siteLat,              // rad
                     double siteLong,             // rad
                     double siteHeight,           // m
                     double sitePolmx,            // rad
                     double sitePolmy,            // rad
                     double timeDut1,             // seconds
                     double wavelength,           // nm
                     double mjd,                  // MJD
                     double *alphaOut,            // HHMMSS.TTT
                     double *deltaOut             // DDMMSS.TTT
                     );
      Convert alt/az to alpha/delta in given coordinate system

This document was created by man2html, using the manual pages.
Time: 10:08:46 GMT, April 23, 2012