Astrobs-Tools/README.md

Astronomical Observation Tools

Astronomical Observation Tools (Astrobs Tools) is composed of:

• SCOPE: a code to get the sky coordinate limits from observation constraints;
• EQUATOR: a software to organize targets before observations.

Requirements

Astrobs Tools requires Python 3.10 or newer

Setup

First step is to initialize a virtual environment for the software with:

python3 -m venv ./venv

Then install the required packages with:

source activate.sh && pip install -r requirements.txt && deactivate

You may also require to authorize the execution of Astrobs Tools with:

chmod u+x Astrobs-Tools.sh 

Usage

To launch Astrobs tools, simply execute:

./Astrobs-Tools.sh

Then select the desired code

SCOPE

...

EQUATOR

First, select a configuration file (if none, default is selected). Then, select the action you wish to perform.

Available commands (not case sensitive):

• help, h, ?: show this page
• quit, exit, q: quit the current code (WARNING: this does not save the current state!)
• write, save: write the current table in a file (no options available yet)
• read [filename], open [filename]: loads the file "filename" in the current table (no additional options available yet)
• calibration, calib: adds a calibration in the target list
• simbad [object name], object [object name]: add an object from simbad
• search [ra] [dec] [radius], region [ra] [dec] [radius]: search a region centred on the ra/dec coordinates, with a given radius (coordinates should be expressed as 12h30m30s, 90d30m30s or 90.555d)
• sidereal, st: computes the sidereal time for each target
• sequence, seq: computes the sequence order for each target
• check: check if all targets are in the observation field

General actions:

• cancel, back: cancels the current action
• yes, y, 1: yes
• no, n, 0, or anything else: no
• all, *: select all
• done, ok: confirm, save the current state and quit