Following paragraphs document how to take images with **RTS2**. It is assumed that you have everything installed, and **RTS2**, including CCD drivers, runs on your computer.
The examples given here assume that your camera name in **RTS2** system is **C0**. If your camera is called differently, please use its name.
====== rts2-xfocusc ======
//rts2-xfocusc// displays CCD image on XWindow scree. If you have XWindows installed (graphical desktop on Linux), and you are either physically setting in front of the machine with camera or you are using ssh with the machine, //rts2-xfocusc// is the quickest way how to check that CCD is working. To take 2 second exposures, you will type:
rts2-xfocusc -d C0 -e 2
See attached example of the output:
user@host:~$ rts2-xfocusc -d C0 -e 2
2009-06-08T15:23:48.180 app 2 Cannot find value 'astrometry_devices' in section 'imgproc'.
Cannot open horizon file
Display opened succesfully
2009-06-08T15:23:48.473 app 2 Cannot find value 'ter_xoa' in section 'C0'.
2009-06-08T15:23:48.473 app 2 Cannot find value 'ter_yoa' in section 'C0'.
2009-06-08T15:23:48.473 app 2 Cannot find value 'instrume' in section 'C0'.
2009-06-08T15:23:48.473 app 2 Cannot find value 'telescop' in section 'C0'.
2009-06-08T15:23:48.473 app 2 Cannot find value 'origin' in section 'C0'.
Get conn: C0
State changed (C0): value:0 idle | SHUTTER_CLEARED | COOLING_OFF (0)
State changed (C0): value:0 EXPOSING | SHUTTER_CLEARED | COOLING_OFF | BLOCK TELESCOPE MOVEMENT (67108865)
2009-06-08T15:23:50.252 app 2 Cannot find value 'environment' in section 'C0'.
State changed (C0): value:0 READING | SHUTTER_CLEARED | COOLING_OFF (2)
2009-06-08T15:23:52.549 app 8 exposureEnd C0
Get data : [1024x1024]
Create ximage 1024x1024
Ximage created
Window median:94 stdev 0.6745 low:91 hig:97
State changed (C0): value:0 EXPOSING | 0 READING | SHUTTER_CLEARED | COOLING_OFF | BLOCK TELESCOPE MOVEMENT (67108867)
State changed (C0): value:0 EXPOSING | SHUTTER_CLEARED | COOLING_OFF | BLOCK TELESCOPE MOVEMENT (67108865)
State changed (C0): value:0 READING | SHUTTER_CLEARED | COOLING_OFF (2)
2009-06-08T15:23:54.985 app 8 exposureEnd C0
For more options (you can change binning, do sub-window images, takes darks,..) please consult //rts2-xfocusc -h//.
====== rts2-focusd ======
//rts2-focusd// is similar to rts2-xfocusc. The only difference is that it will not use XWindows display to display images. By default it will save images in current directory, using //_--.fits// as file name. Please consult //rts2-focusc -h// for more details.
====== rts2-scriptexec ======
//rts2-scriptexec// can be used to execute **RTS2** scripts on camera. Scripts are complex, yet simple "programs" used to take exposure, set various variables, etc.. Please consult //man rts2.script// for more details about **RTS2** scripts.
The following example will take 2 20 seconds exposure, then change telescope named T0 offsets by 2 degrees in both RA and DEC, will take 2 10 seconds exposures, change filter to 2nd filter, and will take 11 1 seconds exposures, followed by darks for 1, 10 and 20 seconds:
user@host:~# rts2-scriptexec -d C0 -s 'for 2 { E 20 } T0.WOFFS+=(2,2) for 2 { E 10 } filter=2 for 11 { E 1 } D 1 D 10 D 20'
The resulting images are saved as //_--.fits// to the current directory. If you will try to modify script, please bear in mind that you need to put space around brackets - e.g. this:
user@host:~# rts2-scriptexec -d C0 -s 'for 2 {E 20}'
is wrong, while this:
user@host:~# rts2-scriptexec -d C0 -s 'for 2 { E 20 }'
is correct.