#################################
# FMOS OPE FILE TEMPLATE
# Prepared by Kentaro Aoki, Naoyuki Tamura
# Ver. January 12, 2015.
#################################
OBSERVATION_FILE_NAME=S15B_001_PILASTNAME.OPE
OBSERVATION_FILE_TYPE=OPE
OBSERVATION_START_DATE=2015.02.05
OBSERVATION_START_TIME=18:00:00
OBSERVATION_END_DATE=2015.02.06
OBSERVATION_END_TIME=07:00:00
#######################################
# DO NOT EDIT THE TWO LINES BELOW.
#######################################
DEF_FMOS_SPEC=OBE_ID=FMOS OBE_MODE=SPEC
DEF_FMOS_SUBR=OBE_ID=FMOS OBE_MODE=SUBROUTINE
##########################################################
# LIST NAMES & COORDINATES OF YOUR TARGET FIELDS.
# Note:
# This is not for commands but just for sky monitor.
##########################################################
SSA22=OBJECT=SSA22 RA=221700.00 DEC=+001900.00 EQUINOX=2000.0
##########################################
# LIST S2O FILE NAMES FOR SETUPFIELD.
# Note:
# "NBS" - Normal Beam Switching
# "CBS" - Cross Beam Switching
# "PAS" - Point & Stare
##########################################
S2O_SSA22_NBS=S2O=S11B_001_PILASTNAME_SSA22_NBS.S2O
S2O_SSA22_CBS=S2O=S11B_001_PILASTNAME_SSA22_CBS.S2O
S2O_SSA22_PAS=S2O=S11B_001_PILASTNAME_SSA22_PAS.S2O
##############################################################
# COMMANDS FOR ON-SKY OBSERVATION.
# (Observers may edit parameters for their observations.)
##############################################################
## TEST IF THE NECESSARY INFO IS EXTRACTED FROM A .S2O FILE.
TESTS2O $DEF_FMOS_SPEC $S2O_SSA22_CBS
## JUST TO LOAD S2O FILE
LOADS2O $DEF_FMOS_SPEC $S2O_SSA22_CBS
## JUST TO CHECK SKY CONDITION
CHECKSKY $DEF_FMOS_SPEC $S2O_SSA22_CBS NCH=1 NOTEL=0
## NORMAL BEAM SWITCHING
# IF FOCUSING IS NECESSARY:
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_NBS MAXIT_HOME=1 MAXIT_OBJ=4 NCH=1 OBSD=S2O
EXEC FMOS ECH_CHECK_FOCUS $S2O_SSA22_NBS MINFOC=4.0 MAXFOC=4.5 NPOINTS=6
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_NBS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
# IF FOCUSING IS NOT NECESSARY:
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_NBS MAXIT_HOME=1 MAXIT_OBJ=7 NCH=2 OBSD=S2O
# ALWAYS WORTH TAKING A SHORT TEST EXPOSURE ...
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=0 MODE1=CDS NEXP2=1 EXPTIME2=0 MODE2=CDS OBJECT=TEST
# TAKE EXPOSURES WITH BEAM SWITCHING:
NORMALBS $DEF_FMOS_SPEC BS_DRA1=10 BS_DDEC1=-10 NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=SSA22_NBS
# CORRECTION SHOULD BE APPLIED TO FIBER POSITION EVERY ~30 MIN.
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_NBS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
## CROSS BEAM SWITCHING
# IF FOCUSING IS NECESSARY:
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_CBS MAXIT_HOME=1 MAXIT_OBJ=4 NCH=1 OBSD=S2O
EXEC FMOS ECH_CHECK_FOCUS $S2O_SSA22_CBS MINFOC=4.0 MAXFOC=4.5 NPOINTS=6
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_CBS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
# IF FOCUSING IS NOT NECESSARY:
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_CBS MAXIT_HOME=1 MAXIT_OBJ=7 NCH=2 OBSD=S2O
# ALWAYS WORTH TAKING A SHORT TEST EXPOSURE ...
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=0 MODE1=CDS NEXP2=1 EXPTIME2=0 MODE2=CDS OBJECT=TEST
# TAKE EXPOSURES WITH BEAM SWITCHING:
CROSSBS $DEF_FMOS_SPEC $S2O_SSA22_CBS NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=SSA22_CBS
# CORRECTION SHOULD BE APPLIED TO FIBER POSITION EVERY ~30 MIN.
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_CBS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
## POINT & STARE
# IF FOCUSING IS NECESSARY:
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_PAS MAXIT_HOME=1 MAXIT_OBJ=4 NCH=1 OBSD=S2O
EXEC FMOS ECH_CHECK_FOCUS $S2O_SSA22_PAS MINFOC=4.0 MAXFOC=4.5 NPOINTS=6
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_PAS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
# IF FOCUSING IS NOT NECESSARY:
SETUPFIELD $DEF_FMOS_SPEC $S2O_SSA22_PAS MAXIT_HOME=1 MAXIT_OBJ=7 NCH=2 OBSD=S2O
# ALWAYS WORTH TAKING A SHORT TEST EXPOSURE ...
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=0 MODE1=CDS NEXP2=1 EXPTIME2=0 MODE2=CDS OBJECT=TEST
# TAKE EXPOSURES:
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=SSA22_PAS
# CORRECTION SHOULD BE APPLIED TO FIBER POSITION EVERY ~30 MIN.
SETUPFIELD_NEW $DEF_FMOS_SPEC $S2O_SSA22_PAS MAXIT_HOME=0 MAXIT_OBJ=3 NCH=2 TELPOS=KEEP OBSD=S2O
##################################################################
# COMMANDS FOR FLAT, ARC, & DARK DATA ACQUISITION.
# (Observers may edit the parameters for their observations.)
##################################################################
### SPINE CONFIGURATION FOR DOMEFLAT & CAL
# Give an approximate time (in seconds from Jan 1 1970 UT) of observing the field to STARTTMOFOBS.
# This time can be calculated by the 'date' command.
# e.g. date --date '06 February 2015 8:00:00' -u +%s
EXEC FMOS ECH_CONFIGURE_FIELD FILENAME=HOME.S2O STARTTMOFOBS=0 OBSDURATION=S2O MAXITERATIONS=1 RMS=0 SLEW=1
EXEC FMOS ECH_CONFIGURE_FIELD FILENAME=TARGET.S2O STARTTMOFOBS=0 OBSDURATION=S2O MAXITERATIONS=3 RMS=0 SLEW=1
## If you issue a configure_field with SLEW=0 mistakenly, try this to get Echidna back under control.
EXEC FMOS ECH_TELESCOPE_SLEW_COMPLETED
### DOMEFLAT AND CAL EXPOSURES
## EXPOSURE SEQUENCE:
## (1) SPINE CONFIGURATION FOR FIELD #1
## (2) DOMEFLAT_OFF
## (3) CAL (INSROT=+90)
## (4) DOMEFLAT_ON (INSROT=+90)
## (5) DOMEFLAT_ON (INSROT=-90)
## (6) CAL (INSROT=-90) # You can skip in case of low-reso mode
## (7) SPINE CONFIGURATION FOR FIELD #2
## (8) CHECK LATENT
## (9) DOMEFLAT_OFF
## (10) CAL (INSROT=-90) # You can skip in case of low-reso mode
## (11) DOMEFLAT_ON (INSROT=-90)
## (12) DOMEFLAT_ON (INSROT=+90)
## (13) CAL (INSROT=+90)
## (14) REPEAT (7)-(13) FOR OTHER FIELDS IF ANY.
### DOMEFLAT: 4x600W, 5.1A, WITH TOP SCREEN CLOSED
## DOMEFLAT_OFF
## SET EXPTIME TO THE SAME VALUE AS FOR DOMEFLAT_ON.
GETOFFFLAT $DEF_FMOS_SPEC NEXP1=3 EXPTIME1=20 MODE1=CDS NEXP2=3 EXPTIME2=20 MODE2=CDS
## ThAr CAL LAMP "P2(FRONT)" WITH 15MA
## NOTE: "FeAr" SHOWS ON/OFF ON INTEGGUI BUT NO NEED TO WORRY.
# IRS1:
# LR - 20 sec
# HR - 30 sec
# IRS2:
# LR - 40 sec
# HR - 60 sec
GETCOMPARISON $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=30 MODE1=CDS NEXP2=1 EXPTIME2=60 MODE2=CDS OBJECT=THAR
## DOMEFLAT_ON - TAKE EXPOSURES AT INSROT = +90, -90.
# IRS1: <= 30000 ADU AT THE BRIGHT END.
# LR - 50V, 20 sec
# JS - 100V. 30 sec
# JL - 80V, 30 sec
# HS - 80V, 20 sec
# HL - 100V, 20 sec
# IRS2: <= 20000 ADU AT THE BRIGHT END.
# LR - 50V, 40 sec
# JS - 100V, 60 sec --> 2000-12000 ADU varing with x
# JL - 80V, 30 sec (50V, 60 sec --> ~7000 ADU)
# HS - 80V, 20 sec (50V, 60 sec --> ~10000 ADU)
# HL - 100V, 20 sec (50V, 60 sec --> ~5000 ADU)
GETONFLAT $DEF_FMOS_SPEC NEXP1=3 EXPTIME1=20 MODE1=CDS NEXP2=3 EXPTIME2=20 MODE2=CDS
### DARK EXPOSURES
GETDARK $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=0 MODE1=CDS NEXP2=0 EXPTIME2=0 MODE2=CDS
GETDARK $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=60 MODE1=RAMP NEXP2=1 EXPTIME2=60 MODE2=RAMP
#################################################
# BELOW ARE COMMANDS TO TEST THE INSTRUMENT.
# NO NEED TO EDIT.
#################################################
## ECHIDNA
EXEC FMOS ECH_FI_SPINE SPINEID=123
## IRS1 MESSIA INITIALIZATION
EXEC FMOS IRS1_HAWAII_INIT
## COMMAND FLOW IN BEAMSWITCHING
## MAYBE USEFUL WHEN NORMAL/CROSSBS IS TERMINATED HALFWAY WITH AN ERROR.
# NBS
SETUPFIELD $DEF_FMOS_SPEC $S2O_SSA22_NBS MAXIT_HOME=0 MAXIT_OBJ=0 NCH=0 TELPOS=KEEP OBSD=S2O
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=ON
EXEC TSC AG_TRACKING MOTOR=OFF F_SELECT=P_IR CALC_REGION=FMOS
EXEC FMOS ECH_AG_CMD ACTION=STOP
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=PRE MODE=OFF
TELOFFSET $DEF_FMOS_SUBR RA_OFFSET=0 DEC_OFFSET=10
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=POST
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=OFF
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=PRE MODE=ON
TELOFFSET $DEF_FMOS_SUBR RA_OFFSET=0 DEC_OFFSET=-10
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=POST
EXEC FMOS ECH_AG_CMD ACTION=START
EXEC TSC AG_TRACKING MOTOR=ON F_SELECT=P_IR CALC_REGION=FMOS
# CBS
SETUPFIELD $DEF_FMOS_SPEC $S2O_SSA22_CBS MAXIT_HOME=0 MAXIT_OBJ=0 NCH=0 TELPOS=KEEP OBSD=S2O
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=POS1
EXEC TSC AG_TRACKING MOTOR=OFF F_SELECT=P_IR CALC_REGION=FMOS
EXEC FMOS ECH_AG_CMD ACTION=STOP
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=PRE MODE=SET2
TELOFFSET $DEF_FMOS_SUBR RA_OFFSET=!FMS.ECH.BS.DRA DEC_OFFSET=!FMS.ECH.BS.DDEC
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=POST
## EXECUTE THE NEXT LINE IF NECESSARY
#CHECKFIELD $DEF_FMOS_SUBR NCH=1 ISET=2
EXEC FMOS ECH_AG_CMD ACTION=START
EXEC TSC AG_TRACKING MOTOR=ON F_SELECT=P_IR CALC_REGION=FMOS
GETOBJECTN $DEF_FMOS_SPEC NEXP1=1 EXPTIME1=900 MODE1=RAMP NEXP2=1 EXPTIME2=900 MODE2=RAMP OBJECT=POS2
EXEC TSC AG_TRACKING MOTOR=OFF F_SELECT=P_IR CALC_REGION=FMOS
EXEC FMOS ECH_AG_CMD ACTION=STOP
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=PRE MODE=SET1
TELOFFSET $DEF_FMOS_SUBR RA_OFFSET=(-1*(!FMS.ECH.BS.DRA)) DEC_OFFSET=(-1*(!FMS.ECH.BS.DDEC))
EXEC FMOS ECH_AG_CMD ACTION=BEAMSW NOTIFY=POST
EXEC FMOS ECH_AG_CMD ACTION=START
EXEC TSC AG_TRACKING MOTOR=ON F_SELECT=P_IR CALC_REGION=FMOS