Cate at its core is a Python package that provides Cate's command-line interface (CLI) and application programming interface (API). In addition, the Python package provides a visualisation and processing service for Cate Desktop, Cate's graphical user interface (GUI).
For Cate Desktop, we provide an installer for the Windows, Mac OS X, and Linux operating systems. The Cate Desktop installer will also ensure the Cate Python package is installed. If it can't find an existing or compatible Cate Python package, it will install a new or update an existing one.
Hardware: It is recommended to use an up-to-date computer, with at least 8GB of RAM and a multi-core CPU. The most important bottlenecks will first be the data transfer rate from local data caches into the executing program, so it is advised to use fast solid state disks. Secondly, the internet connection speed matters, because Cate will frequently have to download data from remote services in order to cache it locally.
Operating Systems: Cate is supposed to work on up-to-date Windows, Mac OS X, and Linux operating systems.
Installing Cate Desktop (GUI)
First time installs
The Cate Desktop installer for your platform is available from the Cate website.
Should the website be unavailable, you can get the installer directly from the releases page in Cate Desktop's GitHub repository:
cate-desktop-2.x.y.dmgand for OS X;
All Cate Desktop installers are quite light-weight and executed by double clicking them.
They don't require any extra user input up to the point where no existing or compatible Cate Python package is found. In this case, Cate's Setup process is run:
You can just click Next button to use Automatic setup with default settings. To see what these settings are, you could select User-defined setup and press Next in which case the default settings are shown:
Pressing Next will perform the following setup steps for a new Cate Python package:
- Downloading a Miniconda installer;
- Running the Miniconda in installer in the background to install a dedicated Python environment;
- Installing the Python conda package
cate-cliinto that environment.
For an existing, outdated Cate Python package it will just update it to the required version and also update all required 3rd-party Python packages.
After successful installation, press End to start Cate Desktop:
Should you encounter any problems with the setup, please consider filing an error report in the Cate issue tracker.
By default, Cate Desktop is supposed to keep itself up-to-date automatically. Once the update is installed, Cate Desktop might detect an outdated Cate Python package. In this case the Setup process described above is run again to update the Python package to the required version.
In case the update procedure fails, uninstall Cate Desktop, then download the latest version for your operating system and install again.
The auto-update feature of Cate Desktop can be disabled in the Preferences:
Installing Cate (CLI, API)
First time installs
If you haven't yet installed either of the two, we recommend you install Miniconda for Python 3 first.
With Miniconda/Anaconda installed and accessible (installation path should be on
PATH environment variable)
open a shell / terminal window (Windows users type "cmd" in search field of start menu).
The steps are:
- create a dedicate Python environment for Cate so it doesn't interfere with other Python packages you might already have installed;
- activate that newly create Python environment for Cate;
- install the Cate Python package;
- test the installation by invoking the Cate command-line interface.
Mac OS / Linux:
$ conda env create -n cate-env $ source activate cate-env $ conda install -c conda-forge -c ccitools cate-cli $ cate --help
> conda env create -n cate-env > activate cate-env > conda install -c conda-forge -c ccitools cate-cli > cate --help
You can easily update an existing Cate installation using the
cate upd command:
$ cate upd
Or you use Conda to install the latest version:
$ conda update -c conda-forge -c ccitools cate-cli
Installing from Sources
If you are a developer you may wish to build and install Cate from Python sources. In this case, please follow the instructions given in the Cate README on GitHub.
After building and installing the Cate Python package from sources you can build an run Cate Desktop from sources by following the instructions given in the Cate Desktop README on GitHub.