The format of the shuffle.cfg and fplane.txt files can change, but here are examples that were valid as of early Dec 2017:
shuffle.cfg [General] # Input coordinates localcat = None # Interactive Mode interactive = False # Use HPF selection criteria for candidate stars hpf = False # Optimize using brightest stars for probes or distance from center of patrol region use_brightness = False # output file names outfile = shout.result outinfo = shout.info probestarcatalog = shout.probestars ifustarcatalog = shout.ifustars acamstarcatalog = shout.acamstars closestcatalog = shout_nearby_gal.result hetcommandsfile = shout.hetcommands # format for RA/DEC 0 = RA[deg], DEC[deg], 1 = RA[h], DEC[deg] informat = 1 # IFU position file fplane_file = fplane.txt # edge length of ACAM in degrees (209.0 arcsec) # this entry is ignored and will be soon removed acam_size = 0.05804 # ACAM coordinates for clarity and use in defining candidate stars that fall within the acam acam_x_origin = 189.1 acam_y_origin = 386.8 acam_pix_scale = 0.2709 acam_x_length = 775 acam_y_length = 773 # edge length of IFU in degrees (48.4 arcsec) ifu_size = 0.0134 # exclude ifuslots from shuffle ifuslot_exclude = 000, 056, 066 # lrs edge length of IFU in degrees (12.4" x 6.1") lrs_sizex = 0.00344 lrs_sizey = 0.00169 # edge width of IFU in degrees (3 arcsec), # calibration stars that fall within this distance of the edge of the IFU will not be considered ifu_edge = 0.000833 # shuffle radius in degrees (1 arcmin) radius = 0.0167 # shuffle step width, set to zero to skip shuffling dstep = 0.0014 # diameter of focal plane in degrees (22 arcmin) dfplane = 0.3667 # minimum angular separation of probes is 22.1 deg, called probemind0 # probemind1 is the angular separation of the pair (gp to gp, and wf to wf) probemind0 = 24.1 probemind1 = 90. # inner/outer diameter of guide star/WFS patrol region in degrees (16 and 22 arcmin, respectively) dpatrol_min = 0.29 dpatrol_max = 0.35 # this used to 0.3667, brought it in to 0.36, then for dext7 used 0.35 # Guide and Wavefront scensor partrol angles with respect to PA dpatrol_w1min = 290 dpatrol_w1max = 95 dpatrol_w2min = 115 dpatrol_w2max = 275 dpatrol_g2min = 205 dpatrol_g2max = 5 dpatrol_g1min = 25 dpatrol_g1max = 185 dpatrol_w1targ = 15 dpatrol_w2targ = 195 dpatrol_g1targ = 105 dpatrol_g2targ = 285 # stellar catalog, SDSSDR9, USNOA2, 2MASS, CWISE, USNOB1, GAIA, TIC catalog = GAIA # skip the actual shuffling, just preload the data from SDSS cache_only = False # preferably pick guide and WFS stars according to what field # for SDSS DR9 1 = u, 2 = g, 3 = r, 4 = i , 5 = z # for USNO A2 2 = B, 3 = R gppickcol = 2 wfspickcol = 2 # force guide and WFS stars to particular star (0 == no force) force_gp1 = 0 force_gp2 = 0 force_wfs1 = 0 force_wfs2 = 0 # visualize result in SDSS image to picture format visualize = True visualize_ACAM = True SDSS_FC_options = 'GL' # flip in y needed for some versions of matplotlib yflip = True [visualisation] # visualisation options visualize_probestars = False # if True/yes/on, do not show the boxes for the original position of the IFUs, # but only the one after shuffling. If not found default to False no_original_ifu_pos = False [offsets] # section with the angle offsets in degrees for the various parts of the focal # plane assembly. The offset should be 0 degree for all of them. The overall 90 # degrees rotation is already accounted for in the code acam = 1.07 fplane = 0 probes = %(fplane)s [directories] # cache directory cache = cache # directory where to stick the images images = images # acam directory acam_images = ACAMimages # guide probes and wavefront sensor images gp_images = gp_wfs # ds9 regions files ds9_regions = regions # HET Commands hetcommands = HETcommands [ds9] # ds9/pyds9 customisations # set the xpa_method. If this option is not present, the method is set to local xpa_method = local [MagLimits] #MEC: note that the 'nstars' values are never actually used #MEC: minsep was 0.01667 degrees (1 arcmin); changed to (22.6/2)*SQRT(2) = 16 arcsec #default number, minimum separation and u,g,r,i,z magnitude limits of the 1st WF sensors stars wfs1_magadd = 0.0 wfs1_nstars = 1 wfs1_minsep = 0.0028 wfs1_magmin = 9.5,9.5,9.5,9.2,9.7 wfs1_magmax = 16.0,16.0,16.0,16.0,16.0 #default number, minimum separation in degrees, and u,g,r,i,z magnitude limits of the 2nd WF sensors stars wfs2_magadd = 0.0 wfs2_nstars = 1 wfs2_minsep = 0.0028 wfs2_magmin = 9.5,9.5,9.5,9.2,9.7 wfs2_magmax = 16.0,16.0,16.0,16.0,16.0 #default number, minimum separation in degrees, and u,g,r,i,z magnitude limits of the 1st guide probe stars guide1_magadd = 0.0 guide1_nstars = 1 guide1_minsep = 0.0028 guide1_magmin = 12.5,14.5,14.5,14.2,12.7 guide1_magmax = 26.0,18.0,18.0,18.0,18.0 #default number, minimum separation in degrees, and u,g,r,i,z magnitude limits of the 2nd guide probe stars guide2_magadd = 0.0 guide2_nstars = 1 guide2_minsep = 0.0028 guide2_magmin = 12.5,14.5,14.5,14.2,12.7 guide2_magmax = 26.0,18.0,18.0,18.0,18.0 #default number, minimum separation in degrees, and u,g,r,i,z magnitude limits of the calibration stars in IFUs ifu_magadd = 0.0 ifu_nstars = 1 ifu_minsep = 0.0028 ifu_magmin = 5.0,5.0,5.0,5.0,5.0 ifu_magmax = 23.0,20.0,20.0,26.0,26.0 #default number, minimum separation in degrees, and u,g,r,i,z magnitude limits of the ACAM stars acam_magadd = 0.0 acam_nstars = 1 acam_minsep = 0.0028 acam_magmin = 10.0,10.0,10.0,10.0,10.0 acam_magmax = 19.0,19.0,19.0,19.0,19.0 # minimum separation in degrees, and u,g,r,i,z magnitude limits for bright stars in focal plane fplane_magadd = 0.0 fplane_nstars = 0 fplane_minsep = 0. fplane_magmin = -10.0,-10.0,-10.0,-10.0,-10.0 fplane_magmax = 6.0,6.0,6.0,6.0,6.0
fplane.txt # IFUSLOT X_FP Y_FP SPECID SPECSLOT IFUID IFUROT PLATESC 000 0.0 0.0 900 900 900 0.0 1.0 056 -49.8 -148.7 998 998 998 0.0 1.0 066 49.8 -151.3 999 999 999 0.0 1.0 033 -250.0 150.0 310 257 002 0.0 1.0 034 -250.0 50.0 304 256 003 0.0 1.0 035 -250.0 -50.0 302 235 041 0.0 1.0 036 -250.0 -150.0 311 245 053 0.0 1.0 037 -250.0 -250.0 313 255 010 0.0 1.0 043 -150.0 150.0 306 228 057 0.0 1.0 044 -150.0 50.0 202 238 074 0.0 1.0 045 -150.0 -50.0 305 248 056 0.0 1.0 046 -150.0 -150.0 309 258 005 0.0 1.0 073 150.5 149.7 037 151 031 0.0 1.0 074 150.3 49.9 307 131 076 0.0 1.0 075 149.5 -50.0 047 132 075 0.0 1.0 076 149.6 -150.3 025 154 032 0.0 1.0 083 250.7 149.8 024 137 023 0.0 1.0 084 250.0 49.5 041 152 015 0.0 1.0 085 249.9 -50.2 027 122 001 0.0 1.0 086 249.5 -150.6 017 135 022 0.0 1.0 093 350.0 147.9 008 157 054 0.0 1.0 094 350.3 49.5 032 155 028 0.0 1.0 095 350.1 -50.0 020 158 004 0.0 1.0 096 349.7 -151.0 038 134 014 0.0 1.0 103 450.3 149.0 013 152 019 0.0 1.0 104 450.2 49.0 016 153 026 0.0 1.0 105 450.0 -51.0 051 138 051 0.0 1.0 106 449.7 -151.0 012 136 033 0.0 1.0 555 3.3 -73.2 901 901 901 0.0 1.0 600 -35.0 10.1 902 902 902 0.0 1.0 601 -61.2 -18.0 903 903 903 0.0 1.0 602 -65.2 -13.7 904 904 904 0.0 1.0 603 -25.2 15.2 905 905 905 0.0 1.0 604 -29.2 19.6 906 906 906 0.0 1.0 610 -55.5 -8.6 907 907 907 0.0 1.0 611 -33.2 -20.8 908 908 908 0.0 1.0 612 -28.4 -17.3 909 909 909 0.0 1.0 613 -24.6 -12.9 910 910 910 0.0 1.0 614 -65.9 14.4 911 911 911 0.0 1.0 615 -62.1 19.0 912 912 912 0.0 1.0 616 -57.3 22.4 913 913 913 0.0 1.0 # 013 -450.0 150.0 00 000 000 0.0 1.0 # 014 -450.0 50.0 00 000 000 0.0 1.0 # 015 -450.0 -50.0 00 000 000 0.0 1.0 # 016 -450.0 -150.0 00 000 000 0.0 1.0 # 021 -350.0 350.0 00 000 000 0.0 1.0 # 022 -350.0 250.0 00 000 000 0.0 1.0 # 023 -350.0 150.0 00 000 000 0.0 1.0 # 024 -350.0 50.0 00 000 000 0.0 1.0 # 025 -350.0 -50.0 00 000 000 0.0 1.0 # 026 -350.0 -150.0 00 000 000 0.0 1.0 # 027 -350.0 -250.0 00 000 000 0.0 1.0 # 028 -350.0 -350.0 00 000 000 0.0 1.0 # 030 -250.0 450.0 00 000 000 0.0 1.0 # 031 -250.0 350.0 00 000 000 0.0 1.0 # 032 -250.0 250.0 00 000 000 0.0 1.0 # 035 -250.0 -50.0 00 000 000 0.0 1.0 # 036 -250.0 -150.0 00 000 000 0.0 1.0 # 037 -250.0 -250.0 00 000 000 0.0 1.0 # 038 -250.0 -350.0 00 000 000 0.0 1.0 # 039 -250.0 -450.0 00 000 000 0.0 1.0 # 040 -150.0 450.0 00 000 000 0.0 1.0 # 041 -150.0 350.0 00 000 000 0.0 1.0 # 042 -150.0 250.0 00 000 000 0.0 1.0 # 047 -150.0 -250.0 00 000 000 0.0 1.0 # 048 -150.0 -350.0 00 000 000 0.0 1.0 # 049 -150.0 -450.0 00 000 000 0.0 1.0 # 050 -50.0 450.0 00 000 000 0.0 1.0 # 051 -50.0 350.0 00 000 000 0.0 1.0 # 052 -50.0 250.0 00 000 000 0.0 1.0 # 053 -50.0 150.0 00 000 000 0.0 1.0 # 057 -59.2 -250.6 00 000 000 0.0 1.0 # 058 -50.0 -350.0 00 000 000 0.0 1.0 # 059 -50.0 -450.0 00 000 000 0.0 1.0 # 060 50.0 450.0 00 000 000 0.0 1.0 # 061 50.0 350.0 00 000 000 0.0 1.0 # 062 50.0 250.0 00 000 000 0.0 1.0 # 063 50.0 150.0 00 000 000 0.0 1.0 # 067 50.0 -250.0 00 000 000 0.0 1.0 # 068 50.0 -350.0 00 000 000 0.0 1.0 # 069 50.0 -450.0 00 000 000 0.0 1.0 # 070 150.0 450.0 00 000 000 0.0 1.0 # 071 150.0 350.0 00 000 000 0.0 1.0 # 072 150.0 250.0 00 000 000 0.0 1.0 # 077 150.0 -250.0 00 000 000 0.0 1.0 # 078 150.0 -350.0 00 000 000 0.0 1.0 # 079 150.0 -450.0 00 000 000 0.0 1.0 # 080 250.0 450.0 00 000 000 0.0 1.0 # 081 250.0 350.0 00 000 000 0.0 1.0 # 082 250.0 250.0 00 000 000 0.0 1.0 # 087 250.0 -250.0 00 000 000 0.0 1.0 # 088 250.0 -350.0 00 000 000 0.0 1.0 # 089 250.0 -450.0 00 000 000 0.0 1.0 # 091 350.0 350.0 00 000 000 0.0 1.0 # 092 350.0 250.0 00 000 000 0.0 1.0 # 097 350.0 -250.0 00 000 000 0.0 1.0 # 098 350.0 -350.0 00 000 000 0.0 1.0