Setup instructions¶
Preamble¶
acacia is written in Python and was developped on a Linux platform. Provided you can use Python and can install modules on your computer, it should be possible to run on most OS or a Linux server.
On this page, we explain how to set up your Linux or Windows machine to use acacia.
Note
acacia
requires Python 3. It may work with Python 2.7, but it’s best not to try your luck.
Installing Anaconda¶
We recommend running acacia
in Anaconda.
If you are using a Linux machine, open a terminal window, change directory to the location you’d like to install Anaconda Python, and run the following commands:
wget https://repo.anaconda.com/archive/Anaconda3-2018.12-Linux-x86_64.sh
bash Anaconda3-2018.12-Linux-x86_64.sh
Once complete, you’ll need to add this version of Python to your .bashrc file as follows (replacing ~/
with your installation directory):
# Substitute root for the path to your system's installation and .bashrc file.
echo 'export PATH="~/anaconda3/bin:$PATH"' >> ~/.bashrc
exec -l $SHELL
If this has functioned, on executing python
in a terminal window, you should see the following:
Python 2.7.12 |Anaconda custom (64-bit)| (default, Jul 2 2016, 17:42:40)
[GCC 4.4.7 20120313 (Red Hat 4.4.7-1)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
Anaconda is brought to you by Continuum Analytics.
Please check out: http://continuum.io/thanks and https://anaconda.org
>>>
For Windows users, go to the Anaconda website ) and download the installer for your version of Windows (64-bit or 32-bit). Once the download is finished, run the installer. This may take a while, but when it is done you will be able to open the Anaconda Prompt, which functions like a linux terminal and has Anaconda conveniently installed.
Setting up your Anaconda environment¶
To ensure you are working with the appropriate version of Python as well as the correct modules, we recommend that you create an Anaconda virtual environment set up for running acacia
. This is done by running the following commands in your terminal or the Anaconda prompt (recommended procedure):
conda create -n acacia -c conda-forge python=3.7 tqdm scikit-learn scikit-image pyshp gdal
Note
the GDAL package is notoriously temperamental. If this step fails, try again and add ` openssl=1.0` at the end of the line
Activate the acacia
environment whenever opening a new terminal window by running this command:
conda activate acacia
Note
Remember to activate the acacia
environment whenever you want to use acacia
.
If you are SURE you won’t use anything else than acacia, you can do without virtual environments. In this case, just type:
conda install -c conda-forge python=3.7 tqdm scikit-image pyshp gdal
Acacia is primarily a Graphical User Interface. to use the acacia GUI, you need an extra package called PyQt5. To install it, type:
pip install pyqt5
Installing acacia¶
acacia
does not require installation apart from what you’ve already done. Congratulations, you are ready to use acacia
!