fvcproc

Overview

Calibrate FVC spots astrometrically in the following steps:

• Match GFA fiducial spot positions to astrometrically calibrated GFA fiducials from standard stars, and computes an astrometric solution for the FVC CCD.
• Compute the FVC pixels coordinates for all targets.
• Compute the difference between the actual spot positions in the FVC with the desired positions based on the astrometrically calibrated targets.

Input

Arguments

nfs_data

miscellaneous parameters associated with the sequence

gfa_data

GFA solution and miscelaneous parameters

targets

the target catalog used to dial the positioners

merged_fvc_spots

target spot positions from the FVC system

Configuration

TODO

Output

ref:

Return value

Either SUCCESS if the the caluculation is successful, or an error message othewise.

Use

First, a PML connection must be established:

>>> from DOSlib.PML import dos_connection
>>> pm = dos_connection('PLATEMAKER')
>>> pm.execute('configure')
'SUCCESS'

For this demonstration, load some sample data for the input:

>>> from PlateMaker import test_data
>>> seq_id = test_data.seq_id
>>> nfs_data = test_data.nfs_data
>>> targets = test_data.targets
>>> gfa_data = test_data.gfa_data
>>> merged_fvc_spots = test_data.merged_fvc_spots

Actually execute fvcproc:

>>> pm.execute('set', seqid=seq_id)
'SUCCESS'
>>> pm.execute('fvcproc',
...            nfs_data=nfs_data,
...            targets=targets,
...            gfa_data=gfa_data,
...            merged_fvc_spots=merged_fvc_spots)
'SUCCESS'

The results of the calculations can then be retrieved:

>>> fvc_data = pm.execute('get', 'fvc_data')
>>> positioner_corr = pm.execute('get', 'positioner_corr')