astrodom 2.1.36

Astroimaging Catalogue Software

Astrodom

AstroDom is a culling tool for deep sky imaging sessions and an archive for cataloging images.
In a standard imaging workflow, Astrodom helps finding the best frames for image processing and stores the information about a target that can be retrieved at any time.

Support

Search for AstroDom server on Discord.

Astrodom user manual: https://github.com/fenriques/AstroDom/wiki/AstroDom-User-Manual

Features

• Scan folders for FITS file and import in an intenal searchable database
• Calculate important features like FWHM, Eccentricity and SNR fitting the stars with gaussian functions
• Reject images that are below a threshold
• Image data are stored in a database. When original files are deleted or zipped, the user can always retrieve information from the database

Install AstroDom

AstroDom is developed using Python's QT bindings (PyQT) and thus can run on Linux, Windows and MacOS platforms.

AstroDom is all about presenting data, so a high definition display (1920x1080 or higher) is recommended.

Download exe files from:

https://github.com/fenriques/AstroDom/releases

Install AstroDom via pip

AstroDom runs in a python virtual environment (venv), to check which versions are installed, on a terminal window:

python --version
virtualenv --version

Installation of the Python interpreter and venv is not in scope with this document, you find online step by step instruction for your platform.

AstroDom requires Python version 3.12.

Install and Run AstroDom

To install AstroDom, create a directory anywhere on your file system where AstroDom files and data will be saved . Any name is ok, but 'astrodom' is recommended.

Script based installation

Download the install and run scripts to 'astrodom' folder:

https://github.com/fenriques/AstroDom/tree/master/astrodom/rsc/scripts/

Launch the .sh (Linux) or .bat (Win) install script from a terminal window.

Then to run AstroDom, execute the run script. Do not move the run script outside of the 'astrodom' directory; rather create a desktop icon to launch this script.

Manual installation

As an alternative to script installation, you can follow these steps: Install on Linux:

cd astrodom
python3 -m venv venv
source ./venv/bin/activate
pip3 install astrodom --upgrade --no-cache-dir

Install on Windows:

 cd astrodom
 venv\Scripts\activate
 python -m pip install astrodom --upgrade --no-cache-dir

Run on Linux:

cd astrodom
source ./venv/bin/activate
cd ./venv/lib/python3.12/site-packages
python -m astrodom

Run on Windows:

cd astrodom
venv\Scripts\activate 
cd venv\Lib\site-packages
python -m astrodom

Installation Notes:

On Linux remember to make script executables: chmod +x *.sh On Linux depending on the python version you could need to update commands both in the manual and script installation. For example ' cd ./venv/lib/python3.7/site-packages' instead of ' cd ./venv/lib/python3.6/site-packages'. On Windows you could need to change DPI settings if the character are too small.

Manual installation to avoid version conflicts:

Try these steps if you get errors due to your python version conflicting with libraries version. Tested with python v 3.12

Check that python and venv and pip are installed
Open a terminal and create a directory named Astrodom, then cd to it
Download from the Astrodom project home page on github all the files as .zip, then unzip in the Astrodom directory
Create a venv: python -m venv venv (you might have to add the python version number e.g. pyrhon3.12 -m venv venv)
activate the virtual env: venv\Scripts\activate  (win) or  source ./venv/bin/activate (linux)
Manually install all the packages in requirements.txt, without the version number, e.g. pip install astropy
Repeat for all other packages
cd venv\Lib\site-packages
Run Astrodom: python -m astrodom

Use a terminal window for all commands except for downloading Astrodom sources

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or suggestions, please open an issue.

Happy stargazing!