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
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
This document was created by
man2html,
using the manual pages.
Time: 10:08:46 GMT, April 23, 2012