|
GRAVI Pipeline Reference Manual
1.2.3
|
Functions | |
| cpl_error_code | gravi_metrology_tac (cpl_table *metrology_table, cpl_table *vismet_table, cpl_propertylist *header) |
| Compute the metrology signal from TAC algorithm. More... | |
| cpl_error_code | gravi_metrology_telfc (cpl_table *metrology_table, cpl_table *vismet_table, gravi_data *default_focus_data, cpl_propertylist *header) |
| Best knowledge correction for referencing TEL to FC. More... | |
| cpl_error_code | gravi_metrology_acq (cpl_table *visacq_table, cpl_table *vismet_table, double delay, cpl_propertylist *header) |
| Fill the VIS_MET table with the OPD_PUPIL column. More... | |
| cpl_error_code | gravi_metrology_update_receiverpos (cpl_propertylist *header, cpl_table *receiver_table) |
| Update the receiver position from header from external calibration. More... | |
| double | gravi_metrology_get_posx (cpl_propertylist *header, int tel, int diode) |
| Read the receiver position from header. More... | |
| double | gravi_metrology_get_fc_focus (cpl_propertylist *header, int gv, gravi_data *static_param_data) |
| Read the fiber coupler focus offset from the fits header. More... | |
| double | gravi_metrology_get_fc_shift (cpl_propertylist *header, int gv, gravi_data *static_param_data) |
| Read the fiber coupler focus offset from the fits header. More... | |
| cpl_error_code | gravi_metrology_get_astig (cpl_propertylist *header, int gv, double *amplitude, double *angle, double *radius) |
| Read the astigmatism amplitude and angle from the fits header. More... | |
| cpl_table * | gravi_metrology_create (cpl_table *metrology_table, cpl_propertylist *header) |
| Create the VIS_MET table. More... | |
| cpl_error_code | gravi_metrology_drs (cpl_table *metrology_table, cpl_table *vismet_table, cpl_propertylist *header) |
| Fill the VIS_MET table with the DRS algorithm. More... | |
| cpl_table * | gravi_metrology_compute_p2vm (cpl_table *metrology_table, double wave_met) |
| Calibrate the P2VM of the metrology. More... | |
| cpl_error_code | gravi_metrology_reduce (gravi_data *data, gravi_data *eop_data, gravi_data *static_param_data, gravi_data *met_pos, const cpl_parameterlist *parlist) |
| Reduce the metrology. More... | |
This module implements the function relative to the metrology. The two main functions are
gravi_metrology_compute_p2vm() called by the recipe gravity_p2vm. With the same approach than the FT and SC combiners, it computes the P2VM of the metrology,gravi_metrology_reduce() called by the recipes gravity_vis, gravity_disp and gravity_piezo. It reduces the metrology signal to compute the phase of the metrology | cpl_error_code gravi_metrology_acq | ( | cpl_table * | visacq_table, |
| cpl_table * | vismet_table, | ||
| double | delay, | ||
| cpl_propertylist * | header | ||
| ) |
Fill the VIS_MET table with the OPD_PUPIL column.
| visacq_table | input OI_VIS_ACQ table |
| vismet_table | output OI_VIS_MET table |
| delay | delay in [s] between TIME in ACQ and the correction seen by the metrology (TIME in OI_VIS_MET) |
| header | corresponding HEADER |
Fill the OI_VIS_MET table from the OPD_PUPIL column computed from the OPD_PUPIL column of the OI_VIS_ACQ table.
Definition at line 1745 of file gravi_metrology.c.
References gravi_signal_create_sync().
Referenced by gravi_metrology_reduce().
| cpl_table* gravi_metrology_compute_p2vm | ( | cpl_table * | metrology_table, |
| double | wave_met | ||
| ) |
Calibrate the P2VM of the metrology.
| metrology_table | input metrology data |
| wave_met | Wavelength of the metrology [m] |
| CPL_ERROR_NULL_INPUT | input data is missing |
The resulting P2VM table contains the TRANSMISSION, COHERENCE and PHASE of the metrology.
Definition at line 3156 of file gravi_metrology.c.
References gravi_ellipse_phase_create().
| cpl_table* gravi_metrology_create | ( | cpl_table * | metrology_table, |
| cpl_propertylist * | header | ||
| ) |
Create the VIS_MET table.
| metrology_table | input METROLOGY table |
| header | corresponding HEADER |
Create the VIS_MET table from the METROLOGY table. The table has nsample*ntel rows, so that the measurements for beam 0 are in rows 0,5,10,15... the ones for beam 1 are in 1,6,11,16... that is following the same format as OI_FLUX. This function only create the TIME column.
Definition at line 1692 of file gravi_metrology.c.
Referenced by gravi_metrology_reduce(), and gravi_wave_compute_opds().
| cpl_error_code gravi_metrology_drs | ( | cpl_table * | metrology_table, |
| cpl_table * | vismet_table, | ||
| cpl_propertylist * | header | ||
| ) |
Fill the VIS_MET table with the DRS algorithm.
| metrology_table | input METROLOGY table |
| vismet_table | output OI_VIS_MET table |
| header | corresponding HEADER |
Fill the VIS_MET table from the METROLOGY table with the pipeline alorithm. The function creates the columns PHASE_MET_FC (scalar) and PHASE_MET_TEL (array of 4 values = diodes). Note that the p2vm of the metrology is note used in this computation.
Definition at line 1883 of file gravi_metrology.c.
Referenced by gravi_metrology_reduce(), and gravi_wave_compute_opds().
| cpl_error_code gravi_metrology_get_astig | ( | cpl_propertylist * | header, |
| int | gv, | ||
| double * | amplitude, | ||
| double * | angle, | ||
| double * | radius | ||
| ) |
Read the astigmatism amplitude and angle from the fits header.
| header | input header |
| gv | gravity input [0...3] |
| amplitude | output amplitude of the astigmatism in [nm] |
| angle | output angle of the astigmatism in [deg] rmax radius of the telescope in [m] |
Definition at line 1621 of file gravi_metrology.c.
Referenced by gravi_metrology_telfc().
| double gravi_metrology_get_fc_focus | ( | cpl_propertylist * | header, |
| int | gv, | ||
| gravi_data * | static_param_data | ||
| ) |
Read the fiber coupler focus offset from the fits header.
| header | input header |
| gv | gravity input [0...3] |
Definition at line 1446 of file gravi_metrology.c.
References gravi_data_get_table().
Referenced by gravi_metrology_telfc().
| double gravi_metrology_get_fc_shift | ( | cpl_propertylist * | header, |
| int | gv, | ||
| gravi_data * | static_param_data | ||
| ) |
Read the fiber coupler focus offset from the fits header.
| header | input header |
| gv | gravity input [0...3] |
| static_param_data | default values for focus and focus shift |
Definition at line 1533 of file gravi_metrology.c.
References gravi_data_get_table().
Referenced by gravi_metrology_telfc().
| double gravi_metrology_get_posx | ( | cpl_propertylist * | header, |
| int | tel, | ||
| int | diode | ||
| ) |
Read the receiver position from header.
| header | input header |
| tel | telescope number (0 to 3) in gravity_beam |
| diode | diode number (0 to 3) |
Definition at line 1390 of file gravi_metrology.c.
Referenced by gravi_metrology_telfc().
| cpl_error_code gravi_metrology_reduce | ( | gravi_data * | data, |
| gravi_data * | eop_data, | ||
| gravi_data * | static_param_data, | ||
| gravi_data * | met_pos, | ||
| const cpl_parameterlist * | parlist | ||
| ) |
Reduce the metrology.
| data | a gravi_data with a METROLOGY extension (input/output) |
| eop_data | Earth orientation parameter data or NULL |
| met_pos | Metrology receiver position data or NULL |
| parlist | list of recipe options (including acq-correction-delay) |
| CPL_ERROR_NULL_INPUT | input data is missing |
The resulting VIS_MET table is created from the METROLOGY table and added this data. It is then updated with the TAC algorithm.
EKW : Attention met_pos is called diode_pos in call
Definition at line 3323 of file gravi_metrology.c.
References gravi_data_add_table(), gravi_data_get_table(), gravi_data_get_table_x(), gravi_data_has_extension(), gravi_eop_pointing_uv(), gravi_metrology_acq(), gravi_metrology_create(), gravi_metrology_drs(), gravi_metrology_tac(), gravi_metrology_telfc(), gravi_metrology_update_receiverpos(), and gravi_param_get_double_default().
| cpl_error_code gravi_metrology_tac | ( | cpl_table * | metrology_table, |
| cpl_table * | vismet_table, | ||
| cpl_propertylist * | header | ||
| ) |
Compute the metrology signal from TAC algorithm.
| metrology_table | The input METROLOGY table |
| vismet_table | The input/output OI_VIS_MET table |
| header | The corresponding HEADER |
Wrapper to interface with the TAC real-time algorithm. This fill new columns in the existing OI_VIS_MET table: OPD_MET_FC and OPD_MET_TEL, as well as FLAGs...
Definition at line 2249 of file gravi_metrology.c.
Referenced by gravi_metrology_reduce().
| cpl_error_code gravi_metrology_telfc | ( | cpl_table * | metrology_table, |
| cpl_table * | vismet_table, | ||
| gravi_data * | default_focus_data, | ||
| cpl_propertylist * | header | ||
| ) |
Best knowledge correction for referencing TEL to FC.
| metrology_table | The input METROLOGY table |
| vismet_table | The input/output OI_VIS_MET table |
| header | The corresponding HEADER |
FE start "tel" referes to "GV" all through this function
Definition at line 2483 of file gravi_metrology.c.
References gravi_metrology_get_astig(), gravi_metrology_get_fc_focus(), gravi_metrology_get_fc_shift(), and gravi_metrology_get_posx().
Referenced by gravi_metrology_reduce().
| cpl_error_code gravi_metrology_update_receiverpos | ( | cpl_propertylist * | header, |
| cpl_table * | receiver_table | ||
| ) |
Update the receiver position from header from external calibration.
| header | input/output header to be modified |
| receiver_table | table with the new receiver position |
The table shall have a column TEL_NAME with value 'UT1', 'AT3'..., a column RECX[4] with the x-position of the 4 diode of this telescope, and a column REXY[4] with the y-position of the 4 diode of this telescope.
The function update the keys 'ESO MET UTi RECjX' and 'ESO MET UTi RECjY' of the the input headers.
Definition at line 1331 of file gravi_metrology.c.
Referenced by gravi_metrology_reduce().
1.8.11