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.
Search for AstroDom server on Discord.
Astrodom user manual: https://github.com/fenriques/AstroDom/wiki/AstroDom-User-Manual
- 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
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
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.
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.
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.
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
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.
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
This project is licensed under the MIT License. See the LICENSE file for details.
For any questions or suggestions, please open an issue.
Happy stargazing!