How to edit the definition files

ALFOSC

ALFOSC definition files

The definition files belonging to the ALFOSC user interface serve different purposes. They associate a logical position of e.g. the filter wheel with a step value and a free format text string. Each of the ALFOSC wheels has 8 logical positions separated by 40000 steps. However, the mounting of grisms, slits and filters may require these positions to be offset from their default positions. The second purpose is to associate a text string with a position.

An example:

The second logical position of the aperture wheel is equipped with a 1.0" slit. This position will normally be at stepvalue 40000. Alignment shows that it should be at stepposition 38905. Furthermore, we want to name it Slit 1.0". The corresponding line in the setup file would look like this:

1  S     38905  Slit 1.0"

In this case the file slit.def is the one to edit.

All the definition files associated with ALFOSC are:

ALFOSC slits: ~alfosc/src/uif/setup/slit.def ALFOSC filters: ~alfosc/src/uif/setup/filter.def ALFOSC grisms: ~alfosc/src/uif/setup/grism.def ALFOSC focus: ~alfosc/src/uif/setup/focus.pos Calibration lamps: ~alfosc/src/uif/io/calibctrl.wsh Slit y-position: ~obs/alfosc/slitpos.def

The slitpos file should be edited by user obs and should never have an empty line at the end. To edit this file, you should use the alfosc.edit-slitpos program which will test the contents of the file and tell you if everything was correct.

The ALFOSC setup files filter.def and both FASU setup files has a column for NOT filter number (see exampels below). The ALFOSC setup files slit.def and grism.def has a column to indicate if the elements are aligned or not (see exampels below).

FASU definition files

The FASU has two definition files also located in the same directory as above, for filterwheel A and filterwheel B. FASU filters A: ~alfosc/src/uif/setup/fasua.def FASU filters B: ~alfosc/src/uif/setup/fasub.def In these files, only the text label can be changed.

To see the format of all these files and how they are structured, refer to the last page in this document. These files are edited using an editor. To update the ALFOSC GUI, re-read the definition files, with the button labeled READ SETUP placed in the lower part of the control window. Always print out the setups by pressing PRINT SETUP and insert the prints in the ALFOSC-binder. Postscript versions of these forms are saved in the local /tmp directory.

In case of you should change calibration lamps, you will have to edit the first lines in the file sandra:~alfosc/src/uif/io/calibctrl.wsh in order to change the lamps names in the UIF. Do it as user alfosc.

HiRAC definition files

To edit the definition files, you have to be user hirac on host elizabeth (~hirac/bin/filterdb). There are two files: one for defining filters and positions and one for offsets for positions of Tip/Tilt mirror:

HiRAC filters : ~hirac/bin/filterdb FastCAM mirror : ~hirac/bin/mountdb

Definition file printouts - examples:

sandra:~alfosc/src/uif/setup/fasua.def:
-------------------------------------------------------------------------
     |   pos    |   |  name      | |NOT#|    unused    unused    unused
     |          |   |            | |    |    |    |    |    |    |  |
          1         2         3         4         5         6         7
01234567890123456789012345678901234567890123456789012345678901234567890
-------------------------------------------------------------------------
 0 F            0   Empty           0        10.0      10.0      0  0 
 1 F            1   Cam.Obscura     0        10.0      10.0      0  0 
 2 F            2   Empty           0        10.0      10.0      0  0 
 3 F            3   Empty           0        10.0      10.0      0  0 
 4 F            4   Empty           0        10.0      10.0      0  0 
 5 F            5   Empty           0        10.0      10.0      0  0 
 6 F            6   Cal.lens        0        10.0      10.0      0  0 

sandra:~alfosc/src/uif/setup/fasub.def:
-------------------------------------------------------------------------
 pos           pos   name          NOT#    unused   unused     unused
-------------------------------------------------------------------------
 0 F            0       Empty       0        10.0      10.0      0  0 
 1 F            1       [SII]/6     91       10.0      10.0      0  0 
 2 F            2       Ha/5.0      70       10.0      10.0      0  0 
 3 F            3       Mill.404    0        10.0      10.0      0  0 
 4 F            4       Mill.407    0        10.0      10.0      0  0 
 5 F            5       Mill.1020   0        10.0      10.0      0  0 
 6 F            6       Mill.1033   0        10.0      10.0      0  0 

sandra:~alfosc/src/uif/setup/filter.def:
-------------------------------------------------------------------------
 pos           pos   name          NOT#      unused   unused     unused
-------------------------------------------------------------------------
 1 F          250   1 U#7           7        10.0      10.0      0  0 
 2 F        40250   2 B#74          74       10.0      10.0      0  0 
 3 F        80250   3 V#75          75       10.0      10.0      0  0 
 4 F       119648   4 Empty         18       10.0      10.0      0  0 
 5 F       160300   5 I#12          12       10.0      10.0      0  0 
 6 F       199608   6 R#76          76       10.0      10.0      0  0 
 7 F       241491   7 OIII#43       21       10.0      10.0      0  0 
 8 F       281250   8 Open          0        10.0      10.0      0  0 

sandra:~alfosc/src/uif/setup/grism.def:
('aligned' in column 65)
-------------------------------------------------------------------------
 pos      wheelpos   name              unused   unused   unused  Align unused
-------------------------------------------------------------------------
 1 G       319907   1 Grism #4         500.0    10.0      10.0      Y  0 
 2 G        40327   2 Grism #9 eche    500.0    10.0      10.0      Y  0 
 3 G        80847   3 Hartmann 1       500.0    10.0      10.0      Y  0 
 4 G       120107   4 Grism #7         500.0    10.0      10.0      N  0 
 5 G       160134   5 Hartmann 2       500.0    10.0      10.0      N  0 
 6 G       199870   6 Grsm #13 ech     500.0    10.0      10.0      Y  0 
 7 G       240600   7 Focus pyr        500.0    10.0      10.0      Y  0 
 8 G       280100   8 Open (Lyot)      500.0    10.0      10.0      0  0 

sandra:~alfosc/src/uif/setup/slit.def:
('aligned' in column 55)
-------------------------------------------------------------------------
 pos      wheelpos   name              size     unused     state         
-------------------------------------------------------------------------
 1 S       318456   1 Slit 1.0"         1.0"     10.0'     Y   
 2 S        38698   2 Slit 10.0"       10.0"     10.0'     Y   
 3 S        78445   3 Slit 2.4"         2.4"     10.0'     Y   
 4 S       118500   4 Coronograph       0.7"     10.0'     Y   
 5 S       158688   5 Slit 5.0"         2.0"     10.0'     Y   
 6 S       198556   6 Slit 1.3"         1.3"     10.0'     Y   
 7 S       239650   7 Pinhole           1.2"     10.0'     N   
 8 S       279150   8 Free              1.2"     10.0'     Y   

sandra:/home/obs1/alfosc/slitpos.def:
sandra:/home/obs2/alfosc/slitpos.def:
-------------------------------------------------------------------------
pos X-pos Y-pos
-------------------------------------------------------------------------
1 800 1021
2 800 1028
3 800 1028
4 800  906
5 800 1031
6 800 1035
7 800 1138
8 800 1000

sandra:~alfosc/src/uif/setup/focus.pos:
-------------------------------------------------------------------------
8800

elizabeth:~hirac/bin/filterdb:
-------------------------------------------------------------------------
# Rules:
# - Entries have to start with keyword "FILTERNO",
# - No unknown kerwords may appear in the data block,
# - The last line in the file must be "end",
# - Between the blocks, all text except "FILTERNO" 
#   may appear,
# - This (#) is not resolved as a comment, it's just
#   other text between blocks!
FILTERNO   1
NAME       Str u
NOTNR      16
TRANS_PASS 0.5
REFL_PASS  0.1
THICK      33
FLUX_ZERO  0

FILTERNO   2
NAME       Str v
NOTNR      16
TRANS_PASS 0.5
REFL_PASS  0.1
THICK      33
FLUX_ZERO  0

FILTERNO   3
NAME       Str b
NOTNR      17
TRANS_PASS 0.5
REFL_PASS  0.1
THICK      33
FLUX_ZERO  0

FILTERNO   4
NAME       Str y  
NOTNR      18
TRANS_PASS 0.5
REFL_PASS  0.1
THICK      33
FLUX_ZERO  0

FILTERNO   5
NAME       NeIII
NOTNR      31
TRANS_PASS 0.5
REFL_PASS  0.1
THICK      33
FLUX_ZERO  0

FILTERNO   6
NAME       HiRAC R    
NOTNR      4
TRANS_PASS 
REFL_PASS  
THICK      
FLUX_ZERO  

FILTERNO   7
NAME       HiRAC I    
NOTNR      5
TRANS_PASS 
REFL_PASS  
THICK      
FLUX_ZERO  

FILTERNO   8
NAME       Empty    
NOTNR      0
TRANS_PASS 
REFL_PASS  
THICK      
FLUX_ZERO  
end

elizabeth:~hirac/bin/mountdb:
-------------------------------------------------------------------------
WHEELPOS 1
FILTERNO 1
XOFF  -141
YOFF   113
ZOFF  2000

WHEELPOS 2
FILTERNO 2
XOFF   73
YOFF   175
ZOFF  2000

WHEELPOS 3
FILTERNO 3
XOFF    -92
YOFF    120
ZOFF  1800

WHEELPOS 4
FILTERNO 4
XOFF   165
YOFF   348
ZOFF  1300

WHEELPOS 5
FILTERNO 5
XOFF   -26
YOFF    10
ZOFF  2400

WHEELPOS 6
FILTERNO 6
XOFF   -63
YOFF   153
ZOFF  1400

WHEELPOS 7
FILTERNO 7
XOFF     0
YOFF     0
ZOFF  2400

WHEELPOS 8
FILTERNO 8
XOFF   -28
YOFF   283
ZOFF  1400
end

Last modified: May 31 2023