Hydra GWC Interface


Hydra Data Streams:
-------------------

system	stream			description
------	------			-----------
wiyn	hydra.assign		Fiber assignments
wiyn	hydra.field		Information on the current field
wiyn	hydra.guider		FOPS coordinates
wiyn	hydra.gripper		Gripper status


Hydra Data Stream Attributes:
-----------------------------


-->hydra.assign
 
attribute	type   number	keyword	  units		description
---------	----   ------	--------  -----		-----------
SLFIB%d		string	5	*	

[%d = 0 to 150]

SLFIB0
...
SLFIB150

* keyword is hydra.assign.SLFIB?? (illegal FITS keyword)

The hydra.assign values are the same as appear in the .iraf file. This file is a log of the assignments and describe the function of each fiber along with target information. The first element is a code:
	Code		Function
	----		--------
	-2		Fuducial position
	-1		Not assigned
	 0		Sky
	 1		Target
	 2		Comparison Source (fibers 1 and 100)
The remaining elements are comments provided by the observer. One of the conventions for targets is : (2) Object name, (3,4) magnitudes, (5) observer index number. The other codes use the comment field to further describe the fiber.

The WIYN directory for ".iraf" files is oatmeal:/home/hydra/fields/.

An example (the first column is the index from the .iraf file):

  1  2 SCS
  2  1 T115 14.296  13.667 (280)
  3  0 sky 133.22  1854.78 (207)
  4  0 Random Sky (9984)
  5  1 T153 13.425  13.172 (318)
  6  0 Random Sky (9959)
  7  0 Random Sky (9971)
  8  1 B32  13.277  13.036 (18)
  9  1 T118 14.330  13.974 (283)
 10  1 T132 14.280  14.180 (297)
 11  0 Random Sky (9986)
 12  1 B14  12.967  12.669 (7)
 13  0 Random Sky (9967)
 14  1 B44  13.501  13.201 (24)
 15  1 T148 15.252  15.233 (313)
 16  0 Random Sky (9965)
 17  0 Random Sky (9969)
 18  1 T110 14.842  13.946 (275)
 19  0 Random Sky (9996)
 20  1 B1   11.983  11.408 (1)
 21  1 T160 14.608  13.762 (325)
 22  1 T126 14.844  14.607 (291)
 23  0 sky 613.37   559.27 (237)
 24  1 T101 14.137  13.370 (266)
 25  1 B2   12.144  11.808 (2)
 26  0 Random Sky (9976)
 27  0 Random Sky (9988)
 28  0 Random Sky (9960)
 29  0 Random Sky (9963)
 30  0 Random Sky (9975)
 31  0 Random Sky (9972)
 32  1 T158 13.205  13.153 (323)
 33  0 sky1108.78  1962.35 (217)
 34  1 B24  13.272  12.875 (12)
 35  1 B25  13.117  12.904 (13)
 36  1 B73  13.817  13.553 (35)
 37  1 B23  13.158  12.855 (11)
 38  1 T146 14.848  14.732 (311)
 39  1 B11  13.193  12.843 (5)
 40  1 T98  13.697  13.725 (263)
 41  0 Random Sky (9993)
 42  1 T86  13.534  13.354 (251)
 43  0 Random Sky (9977)
 44  0 Random Sky (9958)
 45  0 Random Sky (9979)
 46  0 Random Sky (9982)
 47  0 Random Sky (9998)
 48  1 B29  13.272  12.984 (16)
 49  1 T162 13.952  14.131 (327)
 50  1 T121 13?     13 (286)
 51  1 B34  13.301  13.008 (71)
 52  0 Random Sky (9970)
 53  0 Random Sky (9999)
 54  1 T111 14.722  14.787 (276)
 55  0 Random Sky (9968)
 56  1 T123 14.991  15.017 (288)
 57  0 Random Sky (9962)
 58 -2 Gap
 59  0 Random Sky (9961)
 60  0 Random Sky (9974)
 61  1 B221 15.258  14.839 (183)
 62  1 T149 15.181  14.655 (314)
 63  0 Random Sky (9983)
 64  0 Random Sky (9989)
 65  1 B16  13.139  12.717 (8)
 66  1 B35  13.287  13.019 (19)
 67  0 Random Sky (9994)
 68 -1 not assigned
 69  1 T108 12.812  12.171 (273)
 70  1 B53  13.952  13.491 (78)
 71  1 B61  14.202  13.637 (32)
 72  0 Random Sky (9997)
 73  1 B3   12.264  11.987 (3)
 74  0 Random Sky (9964)
 75 -2 Gap
 76  1 T135 14.265  14.159 (300)
 77  1 B6   12.712  12.506 (65)
 78  1 B67  13.985  13.495 (34)
 79  0 Random Sky (9981)
 80  1 T79  13.527  13.379 (244)
 81  1 B21  13.198  12.926 (10)
 82  1 B18  13.022  12.727 (9)
 83  0 Random Sky (9995)
 84  0 Random Sky (9990)
 85  0 Random Sky (9978)
 86  1 T159 12.547  12.492 (324)
 87  0 Random Sky (9966)
 88  1 B40  13.420  13.138 (21)
 89  0 Random Sky (9980)
 90  0 Random Sky (9987)
 91  1 T128 14.950  14.710 (293)
 92  0 sky1787.26  1419.25 (230)
 93  0 Random Sky (9991)
 94  0 Random Sky (9992)
 95  1 T99  14.565  14.159 (264)
 96  0 Random Sky (9973)
 97  0 Random Sky (9985)
 98 -1 Broken Fiber
 99 -1 not assigned
100  2 SCS
-->hydra.field
 
attribute	type   number	keyword	  units		description
---------	----   ------	--------  -----		-----------
fldname		string	1	FLDNAME   NONE		name of current field
fldtime		string	1	FLDTIME   		intended exposure time
fldlst		string	1	FLDLST    		field sidereal time
fldcoord	string	3	FLDCOORD  RA/DEC/epoch	field center
cable		string	1	FLDCABLE  NONE		name of current cable
cablesize	integer 1	CABLESIZE 


-->hydra.guider

attribute	type   number	keyword	  units		description
---------	----   ------	--------  -----		-----------
fop%c		float	7	FOP%c	  (multi)	coord. & geom.

[%c = A to L, 12 FOPS]

fopA				FOPA
...				...
fopL				FOPL

array values:

 1	fop x
 2	fop y
 3	distance from origin to button
 4	angle between fiber 0 pivot and this fiber's pivot
 5	angle between fiber 0 pivot and this fiber's button
 6	angle between this fiber's radial line and the tube at the button
 7	status of the fop (assigned sky, assigned object, random sky)


-->hydra.gripper

attribute	type   number	keyword	  units		description
---------	----   ------	--------  -----		-----------

position	Int	3		  encoder	gipper X,Y,Z
status		Int enumerated				gripper state



Last Update: 1999 April 16

Hydra GWC Interface - bob@noao.edu