Main Page   Modules   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

probeCalc.h File Reference

#include "trk.h"

Include dependency graph for probeCalc.h:

Include dependency graph

Go to the source code of this file.

Probe coordinate calculations

#define probeGS_EPOCH   2000.0
#define probeSLAPRMS_ACCESS_TIMEOUT   1
ccsCOMPL_STAT probeCalcConstructor (ccsERROR *error)
ccsCOMPL_STAT probeCalcDestructor (ccsERROR *error)
ccsCOMPL_STAT probeCalcGetSlaPrms (trkSLALIB_PRMS *slaPrms, ccsERROR *error)
ccsCOMPL_STAT probeCalcSetSlaPrms (const trkSLALIB_PRMS *slaPrms, ccsERROR *error)
ccsCOMPL_STAT probeCalcSlaBg (const vltDOUBLE mjd, const vltDOUBLE dut1, const vltDOUBLE lambda, const trkSITE_CONSTANTS *siteConst, const trkPOLAR_MOTION *polarMotion, const trkSITE_ENVIRONMENT *siteEnv, trkSLALIB_PRMS *slalibPrms, ccsERROR *error)
ccsCOMPL_STAT probeCalcSlaFg (const vltDOUBLE mjd, const vltDOUBLE alphaMean, const vltDOUBLE deltaMean, trkSLALIB_PRMS *slalibPrms, vltDOUBLE *alphaObserved, vltDOUBLE *deltaObserved, ccsERROR *error)
ccsCOMPL_STAT probeCalcAD2ADObs (const vltDOUBLE alphaGs, const vltDOUBLE deltaGs, const vltDOUBLE lamGs, vltDOUBLE *alphaObsGs, vltDOUBLE *deltaObsGs, vltDOUBLE *alphaObsObj, vltDOUBLE *deltaObsObj, ccsERROR *error)
ccsCOMPL_STAT probeCalcADObsToRTheta (const vltDOUBLE alphaGs, const vltDOUBLE deltaGs, const vltDOUBLE alphaObj, const vltDOUBLE deltaObj, vltDOUBLE *r, vltDOUBLE *theta, ccsERROR *error)
ccsCOMPL_STAT probeCalcGetCoordAD (vltDOUBLE *alpha, vltDOUBLE *delta, ccsERROR *error)
ccsCOMPL_STAT probeCalcRThetaToADObs (const vltDOUBLE r, const vltDOUBLE theta, const vltDOUBLE alphaObsObj, const vltDOUBLE deltaObsObj, vltDOUBLE *alphaObsGs, vltDOUBLE *deltaObsGs, ccsERROR *error)
ccsCOMPL_STAT probeCalcADObs2Mean (const vltDOUBLE alphaObsGs, const vltDOUBLE deltaObsGs, const vltDOUBLE mjd, vltDOUBLE *alphaMeanGs, vltDOUBLE *deltaMeanGs, ccsERROR *error)
ccsCOMPL_STAT probeCalcRemTrkTime (const vltDOUBLE ra, const vltDOUBLE decl, const vltDOUBLE lowLim, const vltDOUBLE highLim, const vltDOUBLE siderealTime, const vltDOUBLE lat, vltDOUBLE *remTime, ccsERROR *error)

Define Documentation

#define probeGS_EPOCH   2000.0
 

The default epoch of guide star coordinates.

#define probeSLAPRMS_ACCESS_TIMEOUT   1
 

Timeout in seconds for gaining access to slalib parameters.

Function Documentation

ccsCOMPL_STAT probeCalcConstructor (  ccsERROR *    error ) 
 

C'tor sets up internal data structures and allocates necessary sempahores.

ccsCOMPL_STAT probeCalcDestructor (  ccsERROR *    error ) 
 

D'tor releases all resources, like semaphores.

ccsCOMPL_STAT probeCalcGetSlaPrms (  trkSLALIB_PRMS *    slaPrms,
ccsERROR *    error
) 
 

Gets a COPY of the internal slaprms structure, the operation is semaphore protected.

ccsCOMPL_STAT probeCalcSetSlaPrms (  const trkSLALIB_PRMS *    slaPrms,
ccsERROR *    error
) 
 

Sets the internal slaprms to the given ones, the operation is semaphore protected.

ccsCOMPL_STAT probeCalcSlaBg (  const vltDOUBLE    mjd,
const vltDOUBLE    dut1,
const vltDOUBLE    lambda,
const trkSITE_CONSTANTS *    siteConst,
const trkPOLAR_MOTION *    polarMotion,
const trkSITE_ENVIRONMENT *    siteEnv,
trkSLALIB_PRMS *    slalibPrms,
ccsERROR *    error
) 
 

Computes slowly changing astronomical data.

Parameters:
slalibPrms  the result of the calculations

ccsCOMPL_STAT probeCalcSlaFg (  const vltDOUBLE    mjd,
const vltDOUBLE    alphaMean,
const vltDOUBLE    deltaMean,
trkSLALIB_PRMS *    slalibPrms,
vltDOUBLE *    alphaObserved,
vltDOUBLE *    deltaObserved,
ccsERROR *    error
) 
 

Calculate observed alpha/delta from mean alpha/delta

ccsCOMPL_STAT probeCalcAD2ADObs (  const vltDOUBLE    alphaGs,
const vltDOUBLE    deltaGs,
const vltDOUBLE    lamGs,
vltDOUBLE *    alphaObsGs,
vltDOUBLE *    deltaObsGs,
vltDOUBLE *    alphaObsObj,
vltDOUBLE *    deltaObsObj,
ccsERROR *    error
) 
 

Calculate the observed position of the guide star and get the observed position of the object.

ccsCOMPL_STAT probeCalcADObsToRTheta (  const vltDOUBLE    alphaGs,
const vltDOUBLE    deltaGs,
const vltDOUBLE    alphaObj,
const vltDOUBLE    deltaObj,
vltDOUBLE *    r,
vltDOUBLE *    theta,
ccsERROR *    error
) 
 

Calculates adapter r/theta coordinates from delta Alpha/delta Delta. Use slalib to calculate the tangent plane coordinates xi,eta. from this we get the distance from the center r = sqrt(xi*xi+eta*eta) and the angle ps = atan(eta/xi)

Finally calculate the angle p between the center and the projection of the star from m2. This is not needed here but required by calculations done later.

Parameters:
alphaGs  position in alpha in radians on the sky
deltaGs  position in delta in radians on the sky
alphaObj  position of the center in radians on the sky
deltaObj  position of the center in radians on the sky
r  r in the probe coordinates in radians
theta  theta angle in radians
error  returned error structure

ccsCOMPL_STAT probeCalcGetCoordAD (  vltDOUBLE *    alpha,
vltDOUBLE *    delta,
ccsERROR *    error
) 
 

Reverse calculate actual alpha/delta coordinates from the actual angles.

Parameters:
alpha  alpha mean of the guide star in radians
delta  delta mean of the guide star in radians

ccsCOMPL_STAT probeCalcRThetaToADObs (  const vltDOUBLE    r,
const vltDOUBLE    theta,
const vltDOUBLE    alphaObsObj,
const vltDOUBLE    deltaObsObj,
vltDOUBLE *    alphaObsGs,
vltDOUBLE *    deltaObsGs,
ccsERROR *    error
) 
 

Calculate alpha/delta of guide star from actual r/theta and target alpha/delta.

Parameters:
r  radius in radians
theta  angle in radians
alphaObsObj  target object observed alpha in radians
deltaObsObj  target object observed delta in radians
alphaObsGs  guide star observed alpha in radians
deltaObsGs  guide star observed delta in radians

ccsCOMPL_STAT probeCalcADObs2Mean (  const vltDOUBLE    alphaObsGs,
const vltDOUBLE    deltaObsGs,
const vltDOUBLE    mjd,
vltDOUBLE *    alphaMeanGs,
vltDOUBLE *    deltaMeanGs,
ccsERROR *    error
) 
 

Convert observed alpha/delta to mean alpha/delta.

Parameters:
mjd  Mean Julian Date, if 0.0 then the current UTC is taken instead

ccsCOMPL_STAT probeCalcRemTrkTime (  const vltDOUBLE    ra,
const vltDOUBLE    decl,
const vltDOUBLE    lowLim,
const vltDOUBLE    highLim,
const vltDOUBLE    siderealTime,
const vltDOUBLE    lat,
vltDOUBLE *    remTime,
ccsERROR *    error
) 
 

Calculate remaining tracking time.

Parameters:
ra  RA observed in radians
decl  DEC observed in radians
lowLim  low limit (user defined)
highLim  high limit (user defined)
siderealTime  local sideral time in radians
latitude 
remTime  remaining tracking time in DAYS

Generated on Wed Dec 3 14:55:29 2003 for ATCS API by doxygen1.2.13.1 written by Dimitri van Heesch, © 1997-2001