GRAVI Pipeline Reference Manual  1.2.3
Functions
Earth Orientation Parameters

Functions

cpl_error_code gravi_eop_pointing_uv (cpl_table *input_table, cpl_propertylist *header, cpl_table *eop_table, cpl_propertylist *eop_header, int save_pointing, cpl_table *array_table)
 Compute the pointing directions and projected baselines. More...
 
cpl_error_code gravi_compute_pointing_uv (gravi_data *p2vmred_data, gravi_data *eop_data)
 Compute the pointing directions and projected baselines in OI_VIS. More...
 
char * gravity_eop_download_finals2000A (const char *eop_host, const char *eop_urlpath, int *data_length)
 Retrieve the Earth Orientation Parameters computed by IERS. More...
 
cpl_table * gravity_eop_data_totable (const char *eop_data, int data_length)
 Export a raw string buffer containing EOP data to a CPL table. More...
 

Detailed Description

This module implements the function link the the Earth Orientation Parameters. It contains the function called by the recipe gravity_eop to generate the static calibration file : gravity_eop_download_finals2000A() and gravity_eop_data_totable()

It also implements the computation the UV coordinates making use of this EOP calibration file : gravi_compute_pointing_uv()

Function Documentation

cpl_error_code gravi_compute_pointing_uv ( gravi_data *  p2vmred_data,
gravi_data *  eop_data 
)

Compute the pointing directions and projected baselines in OI_VIS.

Parameters
p2vmred_datainput/output data
eop_datadata containing the EOP pameters

Compute the projected baselines [UCOORD,VCOORD] for FT and SC Save the pointing directions [E_U,E_V,E_V,E_AZ,E_ZD] for the SC only

Definition at line 480 of file gravi_eop.c.

References gravi_data_get_table(), gravi_data_get_table_x(), and gravi_eop_pointing_uv().

cpl_error_code gravi_eop_pointing_uv ( cpl_table *  input_table,
cpl_propertylist *  header,
cpl_table *  eop_table,
cpl_propertylist *  eop_header,
int  save_pointing,
cpl_table *  array_table 
)

Compute the pointing directions and projected baselines.

Parameters
input_tableinput/output data
headerinput header
eop_tabletable containing the EOP pameters
eop_headerheader of EOP table
save_pointingsave (E_U,E_V,E_V,E_AZ,E_ZD) is specified
array_tableOI_ARRAY table (optional)

For each DIT of the input table, compute [E_U,E_V,E_W,E_AZ,E_ZD]_Obs as the transformation into Observed reference frame of the orthonormal [E_U,E_V,E_W,E_AZ,E_ZD]_ICRS defined in the ICRS. This way, the real-time projected baseline can be recomputed easily off-line. [E_U,E_V,E_W,E_AZ,E_ZD]_Obs does not form an orthonormal basis, due to the effects of precession, nutation, aberration... The quantities [E_U,E_V,E_W,E_AZ,E_ZD]_Obs are stored as new columns in the input table, is save_pointing is specified. If the array_table is specified, the projected baseline [UCOORD,VCOORD] is calculated.

Definition at line 242 of file gravi_eop.c.

Referenced by gravi_compute_pointing_uv(), and gravi_metrology_reduce().

cpl_table* gravity_eop_data_totable ( const char *  eop_data,
int  data_length 
)

Export a raw string buffer containing EOP data to a CPL table.

Parameters
eop_dataThe string buffer with the data
data_lengthThe total size of the data buffer
Returns
A string buffer with the full contents of the data

This function convert the ascii file retrieve from FTP and convert it to a CPL table.

Possible #_cpl_error_code_ set in this function:

  • CPL_ERROR_NULL_INPUT if eop_data is NULL
  • CPL_ERROR_NULL_INPUT if data_length doesn't correspond with the expected EOP records length

Definition at line 918 of file gravi_eop.c.

char* gravity_eop_download_finals2000A ( const char *  eop_host,
const char *  eop_urlpath,
int *  data_length 
)

Retrieve the Earth Orientation Parameters computed by IERS.

Parameters
eop_hostThe FTP host to retrieve the data from
eop_urlpathThe full path to the data file
data_lengthThe total size of the data buffer returned (returned)
Returns
A string buffer with the full contents of the data

This function will connect to a given FTP host specified in eop_host and the given eop_urlpath and retrieve the ascii file with the EOP data.

Possible #_cpl_error_code_ set in this function:

  • CPL_ERROR_NULL_INPUT if eop_host, data_length or eop_urlpath are NULL
  • CPL_ERROR_DATA_NOT_FOUND if the connection to the host cannot be successfully established.
  • CPL_ERROR_DATA_NOT_FOUND if the FTP transaction cannot be fullfilled.

Definition at line 559 of file gravi_eop.c.