Setting up the SMappe (Python) on Linux

Please note that the "prefix" in the smapper_environment.yml file specifies the path where the Conda environment will be created when you use the "conda env create" command. Typically, this path is defined as a relative or absolute file system path to the directory where you want the environment to be located.

If you wish to change the location of the environment during recreation, you can specify a new "prefix" in the smapper_environment.yml file.

For instance:

prefix: /path/to/new/environment/location

Simply replace /path/to/new/environment/location with the desired directory path where you want the environment to be created when you execute "conda env create -f environment.yml."

The prefix in your environment.yml file specifies the path where the Conda environment will be created. In this case, the prefix is set to /home/ubuntu/anaconda/envs/geo_env. This means that when you create a new environment from this YAML file using conda env create -f smapper_environment.yml, it will generate the "geo_env" Conda environment at that specific location.

Thus, the defined prefix indicates that the "geo_env" environment will be created in the directory /home/ubuntu/anaconda/envs/geo_env. This is a useful feature if you want to specify a particular location for your Conda environment.

To set up your Linux distribution for the use of SMapper-Tool, please follow these steps:

1. Install the Anaconda package manager by following these steps:

   • Go to the following website: Anaconda Individual Edition
   • Download the installer for your Linux distribution.
   • Open the terminal and navigate to the directory where the installer was downloaded.
   • Run the following command to start the installation:

      codebash Anaconda3-2022.10-Linux-x86_64.sh

   • Follow the prompts and accept the license agreement to complete the installation.
   • After the installation finishes, add Anaconda to your system's PATH by running the following command:

      codeecho 'export PATH="/home/username/anaconda3/bin:$PATH"' >> ~/.bashrc

     Note: Change the "/home/username" directory to your directory.

   • Close the terminal and open a new one to apply the changes.

2. Update Conda:

   Open a terminal and run the following command:

    codeconda update -n base -c defaults conda

3. Install Geopandas in a newly created environment:

   Open a terminal and run the following commands one by one:

   conda create -n geo_env
   conda activate geo_env
   conda config --env --add channels conda-forge
   conda config --env --set channel_priority strict
   conda install python=3.9 geopandas
   

4. Install Ttkwidgets:

   You need to install the package "ttkwidgets" in your conda environment "geo_env".

   Note: Activate the Conda Environment “geo_env” beforehand.

    codeconda activate geo_env

   Assuming your "geo_env" environment is currently enabled, you can install ttkwidgets using Conda with the following command:

    codeconda install -c gagphil1 ttkwidgets

   Note: You may need to install the new fonts for Tkinter on your system.

    codeconda install -c conda-forge tk=*=xft_*

5. Install Cartopy:

   You need to install the package "Cartopy" in your conda environment "geo_env". Open a terminal and run the following command:

    codeconda install -c conda-forge cartopy

6. Install reportlab:

   Open a terminal and run the following command:

    codeconda install -c conda-forge reportlab

7. Install pillow:

   Open a terminal and run the following command:

    codeconda install -c conda-forge pillow

Once you have completed the installation steps, you can run the tool by following these instructions:

1. Open a command-line window and navigate to the main folder that contains the main.py file.

2. If you haven't already done so, activate the environment created earlier by running the following command:

    codeconda activate geo_env

3. Run the tool using Python by executing the following command:

    codepython main.py

This will launch the tool, and you can start testing it. If you encounter any questions or problems during the setup process, please contact us via email at support-smapper(at)uni-koeln.de.