FOCAS Operation Commands

Introduction

FOCAS and Subaru telescope will be operated based on the "Operation Procedure File".

Following information is required to make the procedure file. Observers are asked to give the information before the observing night to the observatory staff, who will make a final operation procedure file based on the information provided by the observers.

Do not worry! The contents can be changed even during the observation, just before executing the command. Note, however, it is much better to prepare the procedure files before the beginning of the observation for a smooth operation during the night.

Please copy the following two sections of templates (Object list and Observing commands) into your editor, and modify them (add/delete/modify lines according to your purpose) with the FOCAS operation keywords and standard star list. Send your object list and observing commands to SA (hattori@subaru.naoj.org).

For details of each command, see here.

General Descriptions

The settings are made of the following categories.

Examples

Modify the templates by substituting '(...)' from the keyword list.

[Template] OBJ_OBJ1=Object="OBJECT NAME 1" RA=123456.7 DEC=-123456.7 Equinox=2000.0 InsRot_PA=45

--->
[Modified] OBJ_NGC1234=Object="NGC 1234" RA=123456.7 DEC=-123456.7 Equinox=2000.0 InsRot_PA=12.3
[Meaning ] Define object alias "OBJ_NGC1234" as the target (NGC 1243) whose coordinates are RA=12h34m56.7s DEC=-12d34m56.7s and the position angle of the slit (or image) is 12.3 degree from the north (toward east).
 
[Template] SetupField $DEF_IMAG $MASK_NONE $FILTER_(FILTER) $OBJ_(YOUR_TARGET) SHIFT_SEC=(POINTING_OFFSET_ARCSEC) AUTOGUIDE=(YES OR NO)
--->
[Modified] SetupField $DEF_IMAG $MASK_NONE $FILTER_NONE $PSTD_SA92_245 SHIFT_SEC=-20 AUTOGUIDE=YES
[Meaning ] Move the telescope to SA92_245 (as defined in the standard star list) for target acquisition. The target will be placed at 20 arcsec toward chip 2 from the CCD gap. A guide star acquisition will be done in this command.
[Template] GetStandard $DEF_IMAG $FILTER_(FILTER) $CCD_(BINNING) $PSTD_STAR1 Exptime=(EXPTIME)
--->
[Modified] GetStandard $DEF_IMAG $FILTER_BB_R $CCD_1X1 $PSTD_SA92_245 Exptime=5
[Meaning ] Expose the target (SA92_245) for 5 sec through a broadband R filter with a CCD binning of 1X1.

Notes


#Template starts here.

#Object List Template

OBJ_OBJ1=Object="OBJECT NAME 1" RA=123456.7 DEC=-123456.7 Equinox=2000.0 InsRot_PA=45
OBJ_OBJ2=Object="OBJECT NAME 2" RA=234567.8 DEC=123456.7 Equinox=2000.0 InsRot_PA=-45
OBJ_OBJn=Object="OBJECT NAME n" RA=??????.?? DEC=??????.?? Equinox=2000.0 InsRot_PA=??
#Insrot_PA: FOCAS PA in imag mode (slit PA in spec mode) in degree.
#Insrot_PA=0 for N-S slit or North top imaging. 90 for E-W slit or E top imaging.
#RA=hhmmss.ss DEC=(-)ddmmss.ss. Do not forget to put "-" if negative DEC.
#You may use any unique alias names such as "OBJ_NGC1234" or "OBJ_HD123456".

# END OF OBJECT DEFINITION

#Observing Command Template

#See here for additional information of each command.

# Copy commands for multiple objects/exposures/pointings as needed.

### FLATS

## Dome Flat Spec
GetDomeflat $DEF_SPEC $DEF_DOMEFLAT $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME) VOLT=(LAMP_VOLTAGE)
## Dome Flat Imag
GetDomeflat $DEF_IMAG $DEF_DOMEFLAT $MASK_NONE $FILTER_(FILTER) $CCD_(BINNING) Exptime=(EXPTIME) VOLT=(LAMP_VOLTAGE)


## Sky Flat Imag
GetSkyflat $DEF_IMAG $MASK_NONE $FILTER_(FILTER) $CCD_(BINNING) Object=Skyflat Exptime=(EXPTIME)

##### Spec Observations

#1a Pointing (Long Slit)
SetupField $DEF_SPEC $FILTER_NONE $OBJ_(YOUR_TARGET) $MASK_(SLIT) $POINTING_SPEC_(POSITION) Exptime=(EXPTIME) AUTOGUIDE=(YES OR NO)
#2a Exposure (Long Slit)
GetObject $DEF_SPEC $OBJ_(YOUR_TARGET) $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME)

#1b Pointing (MOS)
SetupField $DEF_MOS $FILTER_NONE $OBJ_(YOUR_TARGET) $MASK_(MOS)
#2b Exposure (MOS)
GetObject $DEF_MOS $OBJ_(YOUR_TARGET) $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME)

#3 Nodding
MoveGuide $DEF_TOOL slit_sec=(arcsec) InsRot_PA=(move direction in deg)
# Calibration Lamp (Long Slit)
SetupComparison  $DEF_CAL $DEF_TOOL
GetComparison  $DEF_SPEC $DEF_CAL $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME) $CAL_FILTER_(COLOR)
ShutdownComparison $DEF_TOOL

# Calibration ARC Lamp (MOS --- while tracking telescope on target)
SetupComparison  $DEF_CAL $DEF_TOOL
GetComparison  $DEF_MOS $DEF_CAL $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME) $CAL_FILTER_(COLOR)
ShutdownComparison $DEF_TOOL

# Calibration ARC Lamp (MOS --- if you take after closing dome and telescope pointing to zenith)

SetupComparison  $DEF_CAL $DEF_TOOL
GetComparison_MASKMOVE  $DEF_MOS $DEF_CAL $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME) $CAL_FILTER_(COLOR)
ShutdownComparison $DEF_TOOL

## Spec Standard Star
#1 Pointing
SetupField $DEF_SPEC $SSTD_(YOUR_STDSTAR) $MASK_(SLIT) $POINTING_SPEC_(POSITION) Exptime=(EXPTIME) $FILTER_(FILTER) AUTOGUIDE=(YES OR NO)
#2 Exposure
GetStandard $DEF_SPEC $SSTD_(YOUR_STDSTAR) $MASK_(SLIT) $SPEC_(CONFIG) $CCD_(BINNING) Exptime=(EXPTIME)

##### Imag Observation

#1 Pointing
SetupField $DEF_IMAG $MASK_NONE $FILTER_(FILTER) $OBJ_(YOUR_TARGET) SHIFT_SEC=(POINTING_OFFSET_ARCSEC) AUTOGUIDE=(YES OR NO)
#2 Exposure
GetObject $DEF_IMAG $FILTER_(FILTER) $CCD_(BINNING) $OBJ_(YOUR_TARGET) Exptime=(EXPTIME)
#3 Dithering
# for larger movement (>4 arcsec)

MoveGuide0 $DEF_TOOL Delta_RA=(arcsec in RA) Delta_DEC=(arcsec in DEC)
# for smaller movement with higher accuracy (<4 arcsec)
MoveGuide3 $DEF_TOOL Delta_RA=(arcsec in RA) Delta_DEC=(arcsec in DEC)
## Imag Standard Star
#1 Pointing
SetupField  $DEF_IMAG $MASK_NONE $FILTER_(FILTER) $PSTD_(YOUR_STDSTAR) SHIFT_SEC=(POINTING_OFFSET_ARCSEC) AUTOGUIDE=(YES OR NO)
#2 Exposure
GetStandard $DEF_IMAG $FILTER_(FILTER) $CCD_(BINNING) $PSTD_(YOUR_STDSTAR) Exptime=(EXPTIME)

##### Bias

GetBias $DEF_IMAG $CCD_(BINNING) OBJECT=BIAS

#Template ends here.


List of available FOCAS Modes

List of keywords for substituting '(...)' within templates shown above

### Slit Mask Settings ###
# No MASK
$MASK_NONE
# Long slit (LS) at field center
# MASK_LS(SLITWIDTH)
$MASK_LS02
$MASK_LS04
$MASK_LS06
$MASK_LS08
$MASK_LS10
$MASK_LS20
# Long slit (LS) at offset position (good for red part of 300B spectrum)
# MASK_LS(SLITWIDTH)_OFFSET
$MASK_LS02_OFFSET
$MASK_LS04_OFFSET
$MASK_LS06_OFFSET
$MASK_LS08_OFFSET
$MASK_LS10_OFFSET
$MASK_LS20_OFFSET
### CAL FILTERS: CAL_FILTER_(COLOR)_(OFFSET or NONE) ####
# for bright red part of Th-Ar (mainly Ar)
$CAL_FILTER_RED
#for faint blue part of Th-Ar (mainly Th)
$CAL_FILTER_BLUE
#Only for OFFSET slits
$CAL_FILTER_RED_OFFSET
### CCD Binning: CCD_(BINNING X)X(BINNING Y)=CCD_(Space binning)X(Dispersion binning) ###
$CCD_1X1
$CCD_2X1
$CCD_3X1
$CCD_4X1
$CCD_2X2
$CCD_3X2
$CCD_4X2
$CCD_1X3
$CCD_2X3
$CCD_3X3
$CCD_4X3
$CCD_1X4
$CCD_2X4
$CCD_3X4
$CCD_4X4
### Pointing Information ###
# Pointing Position for Spec
# For Central Slit: Pointing_SPEC_CHIP(1, 2, or 12)
#Pointing on Chip 1
$POINTING_SPEC_CHIP1
#Pointing on Chip 2
$POINTING_SPEC_CHIP2
#Pointing between Chip 1 and 2
$POINTING_SPEC_CHIP12
# For Offset Slit: Pointing_SPEC_CHIP(1, 2, or 12)_OFFSET
#Pointing on Chip 1
$POINTING_SPEC_CHIP1_OFFSET
#Pointing on Chip 2
$POINTING_SPEC_CHIP2_OFFSET
#Pointing between Chip 1 and 2
$POINTING_SPEC_CHIP12_OFFSET
### Spec Settings (Grism + Filter) ###
# SPEC_(GRISM)_(ORDER)_(BLUE or RED)_(ORDERCUT WAVELENGTH)

# VPH 650_600
$SPEC_600_650_1ST_47

# Echelle (single order mode)
$SPEC_ECH_2ND_Z
$SPEC_ECH_2ND_I

$SPEC_300B_1ST_RED_58
$SPEC_300B_1ST_RED_47
$SPEC_300B_1ST_BLUE_60
$SPEC_300B_1ST_BLUE_50
$SPEC_300B_1ST_BLUE_NONE
$SPEC_300R_1ST_RED_58
$SPEC_300R_1ST_RED_47
$SPEC_300R_1ST_BLUE_60
$SPEC_300R_1ST_BLUE_50
$SPEC_300R_2ND_BLUE_60
$SPEC_150_1ST_RED_58
$SPEC_150_1ST_RED_47
$SPEC_150_1ST_BLUE_60
$SPEC_150_1ST_BLUE_50
$SPEC_75_1ST_RED_58
$SPEC_75_1ST_RED_47
$SPEC_75_1ST_BLUE_60
$SPEC_75_1ST_BLUE_50

### Filter Settings ###
# No filter
$FILTER_NONE
# Broad Band (BB) #
$FILTER_BB_U
$FILTER_BB_B
$FILTER_BB_V
$FILTER_BB_R
$FILTER_BB_I
# Narrow Band (NB) #
$FILTER_NB_373
$FILTER_NB_386
$FILTER_NB_487
$FILTER_NB_502
$FILTER_NB_512
$FILTER_NB_642
$FILTER_NB_658
$FILTER_NB_670


Pre-defined Standard Stars

This is not a complete list of standard stars at all. You can add your favorite stars by using the object list template shown above.

See also a list at APO



Alias
Field/Star name
## Photometric Standards (PSTD): See here for FOCAS Bonus Field
$PSTD_SA92_245
SA92-245
$PSTD_SA92_498
SA92-498
$PSTD_PG0220
PG0220+132
$PSTD_PG0231
PG0231+051
$PSTD_SA95_102
SA95-102
$PSTD_SA95_105
SA95-105
$PSTD_SA98_634
SA98_634
$PSTD_RUBIN149
RUBIN149
$PSTD_RUBIN152
RUBIN152
$PSTD_PG0918
PG0918+029
$PSTD_PG0942
PG0942-029
$PSTD_SA101_429 
SA101-429
$PSTD_PG1047 
PG1047+003
$PSTD_PG1323 
PG1323-086
$PSTD_PG1525 
PG1525-071
$PSTD_PG1528 
PG1528+062
$PSTD_SA107_213 
SA107-213
$PSTD_SA107_599 
SA107-599
$PSTD_SA107_611
SA107-611
$PSTD_SA107_639
SA107-639
$PSTD_PG1633
PG1633+099
$PSTD_PG1657
PG1657+078
$PSTD_SA110_504 
SA110-504
$PSTD_MARK_A 
MARK_A
$PSTD_PG2213 
PG2213-006
$PSTD_PG2331 
PG2331+055
## Spectroscopic Standards (SSTD)
$SSTD_WOLF1346 
Wolf1346
$SSTD_FEIGE110 
Feige110
$SSTD_PG0216 
PG0216+032
$SSTD_PG0310 
PG0310+014
$SSTD_PG0846 
PG0846+249
$SSTD_PG2213 
PG2213-006
$SSTD_HD186293 
HD186293
$SSTD_PG0934 
PG0934+554
$SSTD_HZ14 
Hz14
# [1um extension --- recommended for red spectra]
$SSTD_G191 
G191B2B
$SSTD_HILTNER600 
Hiltner600
$SSTD_PG0823 
PG0823+546
$SSTD_FEIGE34 
Feige34
$SSTD_GD140 
GD140
$SSTD_FEIGE66 
Feige66
$SSTD_FEIGE67 
Feige67