Welcome in the GuitAstro module documentation

1. What is GuitAstro ?

GuitAstro is a Python module that provides classes and methods to write scripts for astronomical observations. GuitAstro wraps the classical astronomical Python modules (AstroPy, etc.) and adds functionalities.

GuitAstro is inspired by the software AudeLA written from 1999 by astronomers of the Toulouse region (France).

Why the name GuitAstro?

• Official version: General Use of Instruments and Telescopes in ASTROnomy.
• Legendary version: GUITalens ASTROnomy

2. Download Guitastro

The source code of Guitastro is available using Git. Windows users can install Tortoige Git which is user friendly.

You can get Guitastro anywhere in your computer. The examples of this guide consider to place Guitastro in the folder Documents of your user. If the user is xxx for linux you have to install guitastro in the folder /home/xxx/Documents. For Windows users it corresponds to C:\Users\xxx\Documents

Clone the code from the Git repository https://gitlab.irap.omp.eu/guitastrolib/guitastro.git.

For Linux users, the following git clone command will copy all the files of the Guitastro code in the current directory:

cd ~/Documents
git config --global http.sslVerify false
git clone https://gitlab.irap.omp.eu/guitastrolib/guitastro.git

For Windows users using Tortoise, open a file explorer (Win+E), create and select a folder where the code will be downloaded. The contextual menu of the file explorer allows to "Git Clone". A window opens. Fill the URL entry by https://gitlab.irap.omp.eu/guitastrolib/guitastro.git and the Directory entry by C:\Users\xxx\Documents\guitastro. Push OK.

For Windows users, if you prefer to use the command line instead of Tortoise, open a Powershell with Win+R (Open: powershell) and put:

cd C:\Users\xxx\Documents
git config --global http.sslVerify false
git clone https://gitlab.irap.omp.eu/guitastrolib/guitastro.git

3. Python installation

There two main ways to install Python:

• Using default Python installation. Not recommanded.

• Using Anaconda and virtual environments. Recommanded.

4. Install Guitastro

There two main ways to install GuitAstro:

• Record GuitAstro as a module using setup.py. This method is good to use GuitAstro but is not adapted to develop GuitAstro.

• Only apply requirements. This method is good for developers of Guitastro code but is less convenient to import Guitastro.

5. External resources

5.1. Resources for Linux

To use Ima.calibwcs you have to install ASTAP and its quad files. Download the astap_amd64.deb and:

sudo apt-get install ./astap_amd64.deb

To use Ima.calibwcs you have to install Astrometry.net and its quad files:

sudo apt install astrometry.net
sudo apt install astrometry-data-tycho2
sudo apt install astrometry-data-2mass

5.2. Resources for Windows

To use Ima.calibwcs you have to install ASTAP and its quad files.

6. Some very simple tests

7. Example collection

8. User guide to program with guitastro Python classes

Describe how to instanciate guitastro classes to use them in a personal Python code.

9. Class and method documentation

For developers of Python code of GuitAstro:

The classes of GuitAstro.