guitastrolib / guitastro_device_ascomcam

Blame view

README.md 1.87 KB
Edit Raw Normal View History
d8ef96d6   Alain Klotz   First 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
# Guitastro Device ASCOMCAM library

GUITAstro stands for General Use of Instruments and Telescopes in ASTROnomy.

GuitAstro is a Python module that provides classes and methods to write easily Python scripts for astronomical observations. 

[GIT repository: https://gitlab.irap.omp.eu/guitastrolib/guitastro.git](https://gitlab.irap.omp.eu/guitastrolib/guitastro.git)

Guitastro device Ascomcam complete Guitastro to provide access to ASCOMCAM camera drivers:

[GIT repository: https://gitlab.irap.omp.eu/guitastrolib/guitastro_device_ascomcam.git](https://gitlab.irap.omp.eu/guitastrolib/guitastro_device_ascomcam.git)

## Few basic examples of use

First example: To connect a Ascomcam controler and acquire an image:
```
import guitastro
import guitastro_device_ascomcam

dev = Device_Ascomcam("ASCOMCAM", name="Ascomcam")
dev.open(True)
dev.commandstring("camera SET exptime 0.1")
dev.commandstring("camera DO ACQ START")
while True:
9a189eb1   Alain Klotz   Update README.md 
25
 
    timer = dev.commandstring("camera GET timer")
d8ef96d6   Alain Klotz   First 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
 
    if timer == -1:
        break
    time.sleep(1)
ima = dev.component('camera').ima
ima.save("my_image.fit")
```

## Guitastro functionalities

GuitAstro device Ascomcam wraps the driver functions dispatched into the classes:

- **Device_Ascomcam**: Manage device Ascomcam drivers.

This class inheritate from the classes Component* of Guitastro.
As a consequece, it is needed to install Guitastro before using Guitastro Ascomcam.
Moreover, this class imports internally a Python wrapper to use the SDK ascomcam libraries provided by Finger Lakes Instruments.
You need to compile the python wrapper *wrapper_ascomcam*:

```
$ cd guitastro_device_ascomcam/src/wrapper_ascomcam
$ python setup.py build_ext --inplace
```

A complete documentation can be generated from .rst files in the folder doc/doc_rst

## Support and contact

The main author is alain.klotz@irap.omp.eu