Installation Guide¶
FitsGeo works under any operating system with Python 3 interpreter and pip tool.
If you are familiar with Python and pip tool, simply type following command to install the FitsGeo package:
$ pip install fitsgeo
or:
$ pip3 install fitsgeo
If you have both Python 2 and Python 3 versions.
If you are a less advanced user, read the rest of the page.
Installation guide is divided in two parts: prerequisites (mainly Python installation) and main package installation.
Prerequisites — Python interpreter¶
First user need to check if Python interpreter is already installed. Try if one of the following commands (printing Python version) works:
$ python --version
$ python3 --version
Command python
invokes either Python 2 or 3, while python3
invokes only Python 3.
FitsGeo supports only modern Python 3 versions starting from version 3.7. Please check if interpreter version is supported.
If none of python
and python3
commands are present, then Python interpreter has to be installed. It is better to use the newest available version.
Python 3 installation¶
The best way to install Python under Linux is to use package manager:
apt-get install python3
for Debian and Ubuntudnf install python3
for Fedorayum install python3
for CentOS and SLC
On some systems instructions mentioned above have to be prefixed with sudo
command.
For Windows or macOS please visit official Python webpage for installation instructions.
Prerequisites — pip tool¶
pip is a tool for installing and managing Python packages. This tool automatically downloads the packages from central Internet repository and installs them.
Try the following commands (printing pip version) in console, to make sure that pip tool is installed:
$ pip --version
$ pip3 --version
In a similar way to Python interpreter pip is a tool for Python 2 or 3, while pip3 works exclusively for Python 3. If none of these commands are present, then pip has to be installed.
pip installation¶
Follow the package installation for your Linux system. On some systems instructions mentioned below have to be prefixed with sudo
command:
apt-get install python3-pip
for Debian and Ubuntudnf install python3-pip
for Fedorayum install python3-pip
for CentOS and SLC
For Windows and macOS please visit official Python webpage for installation instructions.
Installation FitsGeo via pip¶
After you get Python and pip tool FitsGeo package can be installed. On some systems commands mentioned below have to be prefixed with sudo
command:
$ pip install fitsgeo
To upgrade the FitsGeo to newer version, simply type:
$ pip install --upgrade fitsgeo
To completely remove FitsGeo from your system, use following command:
$ pip uninstall fitsgeo
Now FitsGeo package should be installed for all users and can be invoked in Python script by typing:
import fitsgeo
Getting FitsGeo via GitHub¶
Alternative way of getting FitsGeo is to clone repository from GitHub.
FitsGeo can be downloaded directly from github webpage using the web browser or via command line:
$ git clone https://github.com/GordoNice/fitsgeo.git
Make sure that git is installed.
Now one can use FitsGeo from root directory, or, FitsGeo can be installed from command line from root directory via pip:
$ pip install .
Still, it is recommended to use installation using pip tool, described above. It makes it easy upgrade and uninstallation procedures.
Getting FitsGeo examples¶
All scripts with examples located in examples
directory of GitHub FitsGeo repository. Detailed explanation of examples’ code provided in User’s Guide.