Skip to content

Latest commit

 

History

History
160 lines (125 loc) · 4.7 KB

README.md

File metadata and controls

160 lines (125 loc) · 4.7 KB
Raw

DomeCat

A Tool to Explore Astronomical Databases and Transform Data into Planetarium Formats

The Virtual Observatory provides a valuable source for presentations in digital planetaria. However, importing data into planetaria can be a time-consuming process because the data must be selected, downloaded and transformed into a format used in digital planetaria. The later step is typically done by means of ad-hoc scripts. DomeCat is a user-friendly tool that can perform such steps on a single graphical user interface (GUI). Additionally, includes a database to keep track of the transformed data and runtime of the procesess.

gui ubuntu

Installation

The easiest way to run DomeCat is by downloading an executable file for Ubuntu, Windows or MacOSX. The latest releases can be found here.

Compile under Linux and OSX

  1. Install if not installed and venv
apt install python3.9-dev python3.9-venv
  1. Clone this repository.
git clone https://github.com/Venustiano/DomeCat.git
cd ./DomeCat/src
  1. Run
source ./domecat-env.sh

This script will create and activate a virtual environment env, install the required packages and run python domecat.py

  1. If everything went fine, you'll see the GUI.

  2. When you are done close the app. Your current directory will be the root of the repository.

  3. Deactivate the environment.

deactivate

Building the DomeCat app under Ubuntu and OSX

  1. Activate the virtual environment
source ./env/bin/activate
  1. Run the following command
pyinstaller --onefile --add-data "./env/lib/python3.9/site-packages/astroquery/CITATION:astroquery/" --add-data "./config/*:config/" ./domecat.py
  1. Run the app
./dist/domecat

Compile under Windows

  1. In a powershell window, clone this repository
git clone https://github.com/Venustiano/DomeCat.git
cd ./DomeCat/src

  1. Install if necessary and make sure you add python to the PATH

  2. Create a virtual environment

python -m venv env/
  1. Activate the virtual environment
.\env\Scripts\activate.ps1
  1. If the above command does not work run as administrator in a different powershell window
powershell Set-ExecutionPolicy -Scope "CurrentUser" -ExecutionPolicy "RemoteSigned"
  1. Install the sciserver python libraries.
cd ./env/
git clone http://github.com/sciserver/SciScript-Python.git
cd SciScript-Python/py3
python setup.py install
cd ..\..\..\
  1. Install the required packages
pip install -r .\requirements.txt
  1. Run Domecat
python .\domecat.py
  1. After stopping DomeCat, deactivate the environment.
deactivate

Building the DomeCat app under Windows

  1. Activate the virtual environment
.\env\Scripts\activate.ps1
  1. Run the following command
pyinstaller.exe --onefile --add-data "./env/Lib/site-packages/astroquery/CITATION;astroquery/" --add-data "./config/*;config/" ./domecat.py
  1. Run the app
.\dist\domecat.exe

Usage

Credits

License

License

Acknowledgements

The development of DomeCat was undertaken as part of the Target Field Lab, with financial contributions from Samenwerkingsverband Noord Nederland (SNN), the European Regional Development Fund (ERDF), and the Dutch Ministry of Economic Affairs and Climate Policy (EZK).