AstroScheduller 1.0.x

The AstroScheduller project is developing a user-friendly Python package with an algorithm for planning astronomical observations. This project was taken from a previous project AstroScheduller.py.

Using PiPI to install:

The most recent stable version of AstroScheduller Package is available on PyPI. Using the following command to install the package and the required packages will automatically be installed:

pip install AstroScheduller

If you already have an older version of AstroScheduller installed, as AstroScheduller is currently in active update, we strongly recommend that you often update the package as follows

pip install --upgrade astroscheduller

The AstroScheduller GUI uses a package called Tkinter, which is required since AstroScheduller v1.0.0. **This package will not be able to install automatically by PyPI. **If you are using the Anaconda, the Tkinter Package might be included in the distribution. To check if Tkinter has been already installed, try the following:

Python 3.8.10 | packaged by conda-forge 
Type "help", "copyright", "credits" or "license" for more information.
>>> import tkinter

If Tkinter is not installed, an exception will be thrown. Then, the Tkinter installation would be as the following:

# For Ubuntu: 
sudo apt-get update && sudo apt-get install python3-tk

# For MacOS: 
## You should first install the Homebrew software, then install the Tkinter. 
## Using the command as follows: 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" && brew install python-tk

For more information about the installation, see Getting Started: Installation

Demo on Google Colab:

• Introduction to AstroScheduller
• AstroScheduller Examples

Documentations

• AstroScheduller Documentation Homepage
• Appendix: Technical Documentation for AstroSchedullerGo

To-do

See todo.md.

License

The AstroScheduller Project and AstroSchedullerGo are released as open source projects under the MIT license. See LICENSE for more information.

Acknowledgement

We are deeply grateful to the researchers and students at the Shanghai Astronomical Observatory of the Chinese Academy of Sciences for their thoughtful discussions and work on testing the algorithm.