Apache Point Observatory now offers TUI with full Python 3.x support. Users are encouraged to upgrade their system to the most recent version of Python 3.x. Support for TUI v2.6.0 and earlier has been discontinued.
Install the latest version of Python 3.x on your system from Python.org. Update the pip package by doing pip install --upgrade pip from the command line.
Many modern Linux distributions have package-managing software. Use of those utilities is encouraged. Consult your distro's documentation for more information. Install Python 3.x on your system and update the pip package by doing pip install --upgrade pip from the command line.
Download the latest version of Python 3.x from Python.org and install it on your system.
In MacOS, open Finder, and open the /Applications/Utilities folder, then double-click Terminal.
Linux window managers include a terminal as a standard application. For example, GNOME Terminal can be accessed by hitting the Super Key, then typing "Terminal", and clicking the application icon.
The Windows command line is accessed from the Start Menu and typing "cmd", then clicking the "Command Prompt" application.
TUI 3.x needs the following packages to run:
* astropy
* matplotlib
* numpy
* pillow
* twisted
* pyobjc (MacOS only)
* pywin32 (Windows only)
From a commandline, do the following command: pip install astropy matplotlib numpy pillow twisted.
On some platforms, administrative privileges are needed to do a system-wide package install. In these cases, it's OK to run pip install --user <package names here>.
On some Windows platforms, pip can be executed by doing py -m pip install <package names here> from the Windows command line. However, most of the time the aforementioned commands will work.
Most Python distributions include pre-compiled TclTk support, but not always. Double check to make sure the package tkinter is installed and available to Python by doing python -m tkinter. If not, consult your OS documentation to resolve the issue.
The following Python Packages and external software are optional, but increase the functionality of TUI3. Those are:
* The Python pygame package
* SAOImageDS9
* XPA Library
If standard TUI sound output is desired, then install pygame by doing a pip install pygame from the command line. Note that for Mac and Linux platforms, the installation of pygame is required by the setup.py script.
Open a browser and go to the TUI3 repo. Select the most recent source release in the upper-corner, and then download a zip file. Unzip to a suitable source directory.
If you have the git command line interface installed, navigate to a suitable source directory and do a git clone --branch <most recent release> --recurse-submodules https://github.com/ApachePointObservatory/TUI3.git.
In your terminal window, navigate to the newly created TUI3 directory and issue the command python setup.py install. Issue the command runtuiWithLog.py or runtui.py to run TUI.
Note that superuser privileges are needed to do a system-wide installation (recommended).
If your user account doesn't have administrative privileges, TUI3 can be installed in user context by appending the --prefix <path to your desired user installation of TUI> to the end of the aforementioned installation command. TUI's installation path will then need to be added to the PYTHONPATH environment variable.
From the TUI3 root directory, do python3 setup.py py2app. A dmg image will be created in the dist/ directory. Navigate to that file, open it, and drag-and-drop the TUI.app object into the Applications Folder in Finder. TUI3 should now be available in Finder.
For M1 and M2 ARM64 architectures, we build TUI as an x86_64 application and allow the Rosetta translation layer to handle everything. Make sure to install all dependent packages in an x86_64 environment by doing arch -x86_64 pip3 install <package-name>. Then, from the TUI3 root directory, do arch -x86_64 python3 setup.py py2app --arch x86_64 to build TUI.
From the command prompt, navigate to the TUI3 directory and run python setup.py install. The TUI3 executable should be installed in C:\Users\<your user directory>\AppData\Local\Programs\Python\Python<version>\Scripts\runtui.exe. Navigate to it in File Explorer, right-click runtui.exe and click "Send to -> Desktop (create shortcut)". The resulting desktop shortcut can be double-clicked to run TUI3.
We want to hear from you! Contact us if you find a bug.