gfa_data

Overview

GFA parameters.

Creators

  • PlateMaker external interface

Users

This list is not promised to be comprehensive.

  • fvcproc
  • PlateMaker internals
    • fvcAstrom

Contents

Keyword/value pairs

When the keyword is a set of three values separated by commas, they are ${GFAID},${HOLEID}, value, where ${GFAID} is the petal id + 2, and ${HOLEID} is the hole id.

When the keyword is a set of two values separated by comma, the first is the ${GFAID}, ( petal id + 2)

2,42,col = 2 is GFA number (petal id + 2), 42 is hole id,

Keyword Sample value Units Description
None 2   list of GFA ids
project proto    
tileid 52254    
zd 27.44178472044613 degrees zenith distance
psi 150.85492066373553 degrees negative of paralactic angle
xi0 6.5945868063190373e-05 degrees actual tangent plane coordinates at center of CCD
eta0 -0.00016989541370016534 degrees actual tangent plane coordinates at center of CCD
s 1.0002189031434108   change in scale factor relative to a nominal value
theta -0.00056063517993644072 degrees nominal rotation (counterclockwise) of actual coordinates relateive to tangent plane coordinates
theta0 4.1 degrees overall rotation of focal plane
2,ifid 42 43   hole ids of the GIFs
2,xoff 2.7506939664907182 arcminutes center of the GFA in linearized focal plane coordinates (CS5)
2,yoff 0.24427590213262662 arcminutes center of the GFA in linearized focal plane coordinates (CS5)
2,42,type GIF   GIF or FIF
2,42,row 3276.7636378262332 GFA pixels virtual CCD coordinates of fiducials relative to the CCD
2,42,col 3081.6180577939972 GFA pixels virtual CCD coordinates of fiducials relative to the CCD
2,42,eta 0.051188826358939128 degrees apparent tangent plane coordinate of centroid
2,42,xi -0.17248601345808898 degrees apparent tangent plane coordinate of centroid
2,42,etachief 0.05118568736622546 degrees apparent tangent plane coordinate of chief ray
2,42,xichief -0.17248624972149657 degrees apparent tangent plane coordinate of chief ray
2,42,xpix 1163.399999987842 pixels GIF position relative to center of CCD in actual local GFA frame
2,42,ypix 2775.6000000035856 pixels GIF position relative to center of CCD in actual local GFA frame
2,42,xpos 9.7109999998176306 mm GIF position relative to center of CCD in nominal local GFA frame
2,42,ypos -26.274000000053782 mm GIF position relative to center of CCD in nominal local GRA frame

Storage and access

Through DOS

After gfaproc is run for a sequence, the get PML command may be used retrieve the sequence data from PlateMaker.

First, a PML connection must be established:

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

The positioner coordinates are normally calculated by PlateMaker when gfaproc is called. So, load some sample input for it, and run gfaproc:

>>> from PlateMaker import test_data
>>> nfs_data = test_data.nfs_data
>>> gfa_images = test_data.gfa_images
>>> stdstars = test_data.stdstars
>>> pm.execute('set', seqid=test_data.seq_id)
'SUCCESS'
>>> pm.execute('gfaproc', nfs_data=nfs_data,
...            gfa_images=gfa_images,
...            stdstars=stdstars)
'SUCCESS'

Now we can retrieve the GFA data from PlateMaker:

>>> from pprint import pprint
>>> gfa_data = pm.execute('get', 'gfa_data')
>>> pprint(gfa_data) 
OrderedDict([(None, array([... 2, ...])),
             ...
             ((2, 541, 'eta'), ...),
             ((2, 541, 'etachief'), ...),
             ...
             ('zd', ...)])

Preferred file representation

Name template:gfadata-${SEQID}.par
Format:Yanny .par file

Example

::
>>> from PlateMaker import test_data
>>> fname = test_data.data_dir + '/gfadata-52254.4.par'
>>> print(open(fname,'r').read()) 
None 2 4 6 7 9 11
10,ifid
11,541,eta -0.023426485217428409
11,541,etachief -0.023429205766866332
11,541,xi -1.4353086029301239
11,541,xichief -1.4352942530595987
11,541,xpix -2021.1141989029297
11,541,xpos -37.996712983543944
11,541,ypix 170.4135091549249
11,541,ypos 12.803797362676127
11,542,eta -0.18110133820570368
11,542,etachief -0.18109988257839418
11,542,xi -1.6073058143662668
11,542,xichief -1.6073035685690058
11,542,xpix 1265.8420795549314
11,542,xpos 11.307631193323971
11,542,ypix 2677.6601285610614
11,542,ypos -24.804901928415919
11,ifid 541 542
11,xoff 94.309373975677332
11,yoff -4.888045530315491
2,541,eta 0.82466434337399475
2,541,etachief 0.82465477842716128
2,541,xi -1.1749078364722734
2,541,xichief -1.1748967037123434
2,541,xpix -2021.1128989082108
2,541,xpos -37.996693483623162
2,541,ypix 170.46115459002829
2,541,ypos 12.803082681149576
2,542,eta 0.79820337398361063
2,542,etachief 0.79820409068956932
2,542,xi -1.4067245155202415
2,542,xichief -1.4067212301858161
2,542,xpix 1265.8534542145721
2,542,xpos 11.307801813218582
2,542,ypix 2677.6345425524923
2,542,ypos -24.804518138287388
2,ifid 541 542
2,xoff 79.167415258037465
2,yoff 51.476846232815468
3,ifid
...