Op. Manuals

KOOLS Opeartion Manual

Index of Manuals


KOOLS: Kyoto Okayama Optical Low-dispersion Spectrograph

Operation Manuals

See also: Trouble Shooting Guide.

Overall structure of KOOLS software



KOOLS UI is usually invoked from a simple sh script "startkools.sh". see Startup Procedure.

There are three tabs in the KOOLS UI.

"KOOLS" tab


In "KOOLS" tab, messia control commands (executing exposures) and commands to move KOOLS optical elements such as filters, grisms and the focal plane unit are available.

"Telescope" tab

KOOLS UI, Telescope tab

In "Telescope" tab, real-time status of telescope parameters (RA, DEC, HA, Zenith Distabce, focus etc.) are indicated (they should be updated every 1 second). Also, you can send motion commands to the telescope (and to the auto guider if required).

"Others" tab

KOOLS UI, Others tab

In "Others" tab, three special functions are provided. The first is telescope focus adjustment. The second is Nod and Shuffle operation. The last is a batch job interface which is still in a premature status.

Typical Observation Sequence



  1. Check the status of KOOLS: vacuum, cooler, Messia
  2. Turn on the telescope and the dome
  3. Turn off vacuum gauge and turn on auto guider CCD
  4. Turn off air-conditioners of the dome and lights at the upper dome and visitor gallery
  5. Confirm Mirror covers are closed and move the telescope to the rest position
  6. Turn the dome slit angle to 90 degree and open the slit
  7. Open the mirror covers
  8. Focusing: Select any object close to the zenith and point the telescope and execute focusing.
  9. Observation (spectroscopy):
    • Select an object and point the telescope (from cont74)
    • Imaging to check a field of view
    • Roughly move the object to the expected position, using "Move Telescope" in "Telescope" tab in KOOLS UI
    • Load observing field DSS2 fits in skycat on agbox
    • Align FOV box in skycat with actual KOOLS FOV (shift+left-click)
    • Select a guide star and move probe in skycat (shift+right-click)
    • start "movie" mode in ag on agbox and confirm the guide star is seen in the area. Move the guide box to the star position (by left-click) and start guiding
    • Take an test image in KOOLS and measure the target position. Move the object to the exact slit position by "Move Telescope and Guide" in "Telescope" tab in KOOLS UI
    • Insert the slit to the expected position. After moving the slit with KOOLS UI, move the slit by executing the command:
       cd prog/motor
       ruby socket_motor_command.rb "move foc_slide xxx"
      (xxx is the number of motor pulses. 1pix in 2bin = 22.2 pulses.)
    • Confirm the object is falling on the slit
    • Insert disperser and execute exposure(s)
    • take HCT: use gunit on agbox. Refer a list of exposure time
  10. Close mirror covers at zenith and move to the rest position
  11. Close the dome slit
  12. Move the telescope and the dome to Dome-Flat position
  13. Open mirror covers
  14. Turn on the dome flat lamp(from agbox)
  15. Obtain dome-flat images
  16. Turn off the dome flat lamp
  17. Move telescope to zenith
  18. Close the mirror covers
  19. Turn on vacuum gauge and turn off auto guider CCD
  20. Turn on air-conditioners of the dome and lights at the upper dome and visitor gallery
  21. Turn off the telescope and the dome



Operation Procedure Manual by Ms. Hayama, Kobe Univ.

  1. KOOLSの状態確認: 真空度, 冷凍機, Messia
  2. 望遠鏡、ドームの電源ON
  3. 真空ゲージを停止, オートガイダーCCD ON
  4. ドームの空調を停止, ドーム上部とビジターギャラリーの電灯OFF
  5. ミラーカバーが閉まっていることを確認し, 望遠鏡をレスト位置に
  6. ドーム角度を90度にしてスリットを開ける
  7. ミラーカバーを開ける
  8. フォーカス: 天頂に近い任意の天体を選び, 望遠鏡を向ける. フォーカス合わせを実行
  9. 観測 (分光の場合):
    • 天体を選び望遠鏡を向ける(cont74から)
    • 視野確認のため撮像を行う
    • スリットの予定位置におおまかに天体を持ってくるように, KOOLS UIの"Telescope"タブの"Move Telescope"で望遠鏡を動かす
    • agbox上のskycatで対象天体の視野(finding chart)のDSS2画像をロードする
    • skycat上の視野がKOOLSの実際の視野と合致するようにguider FOVを調整 (shift+left-click)
    • ガイド星を選択しプローブを動かす(skycat上で) (shift+right-click)
    • agbox上のagで"movie"モードを始め, ガイド星がオートガイダーCCD視野内に見えることを確認. 左クリックでガイドボックスを星の位置に動かしてガイドを開始する.
    • テスト画像をKOOLSで取得しターゲット位置を測る. 天体をスリット位置に正確にもっていくため, KOOLS UIの"Telescope" タブの"Move Telescope and Guide"で移動する
    • スリットを入れる. KOOLS UIで使用するスリットを入れた後, イメージングで位置を確認して, 以下のコマンドで正確な位置にもっていく:
       cd prog/motor
       ruby socket_motor_command.rb "move foc_slide xxx"
      (xxx はモーターパルスの数. 1pix in 2bin = 22.2 pulses.)
    • 天体がスリットに落ちていることを確認
    • ディスパーザーを入れて露出を開始
    • HCTを取得: agbox上のgunitを使用. list of exposure timesを参照
  10. ミラーカバーを閉めて望遠鏡をrest位置へ
  11. ドームスリットを閉める
  12. 望遠鏡, ドームをDome-Flat位置に移動
  13. ミラーカバーを開ける
  14. ドームフラットランプをつける(from agbox)
  15. ドームフラット画像を取得
  16. ドームフラットランプを消す
  17. 望遠鏡を天頂に向ける
  18. ミラーカバーを閉める
  19. 真空計をつけ, オートガイダーCCDを消す
  20. ドーム空調を入れる. ドーム上部とビジターギャラリーの電灯を入れる
  21. 望遠鏡とドームの電源を落とす

Read-out Pattern and Overscan

(as of 20090126)

readout typewidth(x)height(y)x-starty-startoverscan
spec 20981000 113892049:2098
spec.2bin 1074 500 113891025:1074
spec.1x2 2098 500 113892049:2098
full 20984096 1 12049:2098

Also, there is a program "partial_read" to define arbitrary read-out pattern. Refer Development section.

Back to top of this page

Slit Alignment and Wavelength Coverage

Available Slits

  • There are 4 available slits (as of 200904), and three of them can be installed at the same time:
    1. slit100: 1.0"
    2. slit140: 1.4"
    3. slit180: 1.8"
    4. slit300: 3.0"

Adjustment of Slit Position, Peak Wavelength, Wavelength Coverage

  • Peak wavelength and wavelenth coverage can be changed by moving a slit position.
  • Moving Focal Plane Unit (FPU) to adjust a slit position:
    Example. move FPU by -1000 pulse:
    cd ~/prog/motor
    ruby socket_motor_command.rb "move foc_slide -1000"
  • FPU 2pix(=1pix at 2bin) = 22.2 pulse.

Please use Wavelength Coverage Calculator to find the approximate coverage of the grism and to know the wavelength region affected by CCD bad columns.

HCT Calibration

see HCT page.

Typical Exposure Times

[20071205, 20080103]

Dome Flats

Grism / FilterSlitbinningExptimeFlat
No.56"2bin 3
VPH683+Y496"2bin 5
B-- -- 5AC
V-- -- 3AC, ND
V--2bin 1AC, ND
R-- -- 20DC=255
I-- -- 15DC=255

HCT (FeNeAr)

Grism / FilterSlitbinningExptime

Back to top of this page

Nod and Shuffle

  • KOOLS GUIの"Others"タブから実行.
  • Nod and Shuffle: KOOLS GUIで行う. Nod distanceのxは, slitがCCDに 対して垂直でない時に使用する. 以前は1pix程度入れていた(服部君による). 300sec積分してnodして300sec.というユニットを6回くらい行うのが標準. [20050904]

Back to top of this page


  • 望遠鏡副鏡の主鏡からの距離を動かして調整する. KOOLS GUIの"Others"タブから実行.
  • KOOLS FOCUSモード: 表示画像の下から上へ, telelescope focus値大→小[20130711]
  • 望遠鏡Focus値: 20130711: -10.5mmくらい. ステップは0.05-0.1mm刻みで[20130711]
  • 望遠鏡focusは、-で副鏡が主鏡から遠ざかる方向へに動く.

KOOLS Operation

  • FoV direction (PA=90deg):
  • PAを+に回すとKOOLS視野は時計回りに回転する
  • KOOLS CCD: 1pixel=0."334
  • 積分中に露出を止めたいとき: Messia ServerのウインドウでCtrl+Cを押す. 読み出したい時は, Ctrl+Cで止めた後,
    ./m localhost 'readout spec.2bin'
    などとする. このとき保存されるフレームナンバーが一つ進んでしまうので注意.
  • KOOLS GUI上ではCCD読み出し中に光学系モーターの制御が可能だが, これを行うと読み出した画像にノイズが入る可能性が高いので注意.
Log Sheet
Hartmann Test
  • Hartmann Masks (HART1, HART2) are installed in filter wheel.
  • HART1 (下が通る), HART2 (上が通る)を使用. 得られたスペクトルでHART1が左の場合, カメラレンズのモーター pulse+方向(=デュワーから遠ざかる方向).
  • カメラレンズを動かすには、motorserverが立ち上がった状態で
    cd /home/messia/prog/motor/
    ruby socket_motor_command.rb "move camera 25"

Back to top of this page

Data Backup

Currently data backup (to an OAO file server) has been made by OAO observatory staff. Users are not requested to make data copy for the observatory, but your own set of copies should be made by yourself (using scp). Thus the follwoing procedures are not for users but for observatory staff.

  • data are stored in sanjigen:/home/messia/data/
  • create date directory, i.e., 20071127 (for 27th Nov. 2007) and move kls*.fits to that directory. No file which does not match the naming convension (kls??????.fits), i.e., quick look images, should not be placed within these directories.
  • run md5sum command (as "messia" account)
    cd /home/messia/data
    md5sum ./20071127/kls*.fits >> list2007.md5
  • switch to "kools" account
    su - kools
  • copy to /net/nas2
    cd /home/messia/data
    cp -pr 20071127 /net/nas2/ObsData/KOOLS/
    cp -p obs2007-11-27.log /net/nas2/ObsData/KOOLS/obslog/
  • check md5sums
    cd /net/nas2/ObsData/KOOLS/
    md5sum -c /home/messia/data/list2007.md5 

Information on data reduction

Back to top of this page

back to Manual Index Page