Setting up targets Notes

Using target_setup

Making changes to shuffle's shuffle.cfg

For 1) you need to copy target_setup.json and shuffle.cfg to your directory and update target_setup.json for value "SHUFFLE_CFG"

If you want to update some targets first use shdata_clean and then target_setup

[sir@nossy:scripts 14:55 > shdata_clean -h
usage: shdata_clean [-h] [-idx IDX] [-prg PRG] [-cat CAT] [-active]
                    [-setup SETUP] [-queue QUEUE]

Remove shuffle data

optional arguments:
  -h, --help    show this help message and exit
  -idx IDX      remove data for specific idx
  -prg PRG      remove data for specific program
  -cat CAT      remove data for object from catalog or entire catalog data.
                With only this argument data for whole catalog will be
                deleted. Choices are: bsc, bvri, f10, f11, f12, f13, f14, f15,
                f16, f17, f18, f8, f9, glob, gp, open, rv, s14, s15, s16, s17,
                s18, s19, s20, spc, tell, ugriz
  -active       remove data for all active targets
  -setup SETUP  remove data for specific intrument configuration
  -queue QUEUE  set queue to 'cur' or 'new'. default 'cur'

• make a directory in /home/mcs/astronomer/YY-T for the program number, e.g. /home/mcs/astronomer/16-2/UT16-2-003/
• You may find finding charts at /data1/mcs/hydra/docs on mcs. These can be used to assist in finding the target with gstar.

Using do_shuffle

• run target_setup as : target_setup <queue index> <E|W> <-to> <-log> (check other arguments as target_setup -h)
  Example: target_setup 435 E -to. Argument "-to" tell script to create TO web page with finding chart
• target_setup runs do_shuffle in background if target data is missing
• to use target_setup for catalogs use format: target_setup 10 E -cat spc this will calculate data for target #10 from Spectroscopic Standards catalog

:::::::::::::::::: original approach ::::::::::::::::::::

• start with an appropriate directory, e.g. 16-2/UT16-2-008/
• execute the startup script shuffle_config It will ask if you want to over-write any previous shuffle.cfg or fplane.txt files. Answer "y" to both.
• to get help with do_shuffle just do a do_shuffle --help
• example of a request do_shuffle -v 00:58:21.01 +00:13:12.20 0 0 066 0 0 SHELA_CL1147C_E for an east visit to LRS2-R.
• example of a request for DEC < 0 Note the quotes and extra space

do_shuffle -v 00:58:21.01 " -00:13:12.20" 0 1 056 0 0 SHELA_CL1147C_E for a west visit to LRS2-B.

• if you want to select guide and wfs stars based on brightness instead of speed add the --use_brightness true command line option

do_shuffle -v --use_brightness true 00:58:21.01 +00:13:12.20 0 0 066 0 0 SHELA_CL1147C_E

• fake ACAM charts are located in ACAMimages directory
• commands for setting up the trajectory and the guide probes is located in the HETcommands directory.
  • The HETcommands file .e.g:

    # test1_056_E
    \cp -f ACAMimages/test1_056_E.jpg /data1/nossy/www/html/noss/htopx2/acam_dss.jpg
    syscmd -T -v 'load_trajectory(ra=12.2051, dec=13.185049, equinox=2000.0, dir="EAST" )'
    syscmd -T -v 'Guider1_set_position( ra=12.1973, dec=13.072918 , trajectory="next" )'
    syscmd -T -v 'Guider2_set_position( ra=12.2135, dec=13.290404 , trajectory="next" )'
    syscmd -T -v 'WFS1_set_position( ra=12.2108, dec=13.051876 , trajectory="next" )'
    syscmd -T -v 'WFS2_set_position( ra=12.2004, dec=13.314189 , trajectory="next" )'
    

  • The lines from the cp to the WFS2_set_position should be sent to TCS before asking the TO to move to the next target. The TO should have "probes" checked on their TCS Go Next section.
  • If you need to select a different star or change your mind after the TO has hit Go Next then wait for the probes to finish moving (as seen on the Probe Assembly TCS tab) you will need to change trajectory="next" to trajectory="current" or just remove that option all together since "current" is the default.

• if you want to specify an Az for do_shuffle you can use the --az flag, e.g. do_shuffle -v --use_brightness true --az 10 18:20:22.04 +66:13:38.06 0 0 056 0 0 fcs14_J18203+6613

• If you need the small images of the probe stars, use the following in the shuffle.cfg file: visualize_probestars = True

• If you get an error about Insufficient stars in patrol region for one of the probes try adding 2 magnitudes to its selection via the --magadd option example: do_shuffle -v --wfs2_magadd 2 14:20:25.80 +52:28:00.12 0 1 000 0 0 EGSN27_W

• "magadd" can be applied to target_setup for the ACAM as well, as in: target_setup 47 E -to -shargs "--acam_magadd 5"
  • but note that if you already ran target_setup, you must first delete it with shdata_clean -idx 47

updating shuffle

• run /opt/het/hetdex/src/Virus/hetdexshuffle/install.sh as hetdex user