• Before you start
• Prepare Python environment
  • Method 1 (recommended)
  • Method 2 (not recommended)
• Download Gepard
• Build cython modules
• Start Gepard
• Errors and solutions
  • Errors related to the compiling process
  • Errors related to Gepard operation

Before you start

Installing and launching GEPARD requires a minimal knowledge of command line navigation. Everything you need can be found here.

Prepare Python environment

Method 1 (recommended)

Download Miniconda from https://docs.conda.io/en/latest/miniconda.html. Choose the Python 3.8 version and follow the installer instructions. For help regarding installation, please refer to the Anaconda installation guide.

Download the yml file for your operating system: GepardEnv-windows.yml (Windows), GepardEnv.yml (Linux)

Open the Anacoda prompt, navigate to the folder you stored the yml file and type the following command, replacing xxx.yml with the name of the file you just downloaded:

conda env create -f xxx.yml

You have now created a new environment that contains everything you need to run GEPARD. To activate the new environment (assuming you are working in Windows) type:

conda activate GepardEnv-windows

The compilation of tsp modules and running GEPARD will need to be performed in this environment.

We strongly advise against modifying this environment for any purpose as this could interfere with the functionality of GEPARD.

Method 2 (not recommended)

Download Anaconda from https://www.anaconda.com/download. Choose the Python 3.8 version and follow the installer instructions. For help regarding installation, please refer to the Anaconda installation guide. Anaconda includes most of the required python libraries, however some packages need to be installed manually. To do that, start an Anaconda prompt from the Start Menu (Windows) or re-open a terminal (Linux, MacOS) and type the following:

pip install opencv-python  
conda install scikit-image dill cython

Download Gepard

Download the Gepard bundle from the repository at https://gitlab.ipfdd.de/GEPARD/gepard. Be careful to download the master branch, unless you know what you're doing:

Extract all files into your preferred location. You should now have created a folder named gepard-master. You can rename the folder if you wish.

Build cython modules

The following step requires a C compiler. On Windows you will need to install Build Tools for Visual Studio. Most Linux distributions include GCC.

In the Anaconda prompt (Windows) or the terminal (Linux, MacOS), navigate to the folder gepard\cythonModules. Then type:

python setuptsp.py

and

python setup_getMaxRect.py 

If a compiler is not available in your system, the command will produce an error. The exact wording depends on your operating system.

Start Gepard

In the Anaconda prompt (Windows) or terminal (Linux, MacOS) navigate to downloaded folder. Finally, the two gepard modules are launched respectively with:

python -m gepard

and

python -m gepardevaluation

Errors and solutions

Errors related to the compiling process

Import error: cannot import name 'tsp' from 'gepard.external': The tsp module has not been compiled (properly). Try compiling again or use a pre-compiled module.

error: command 'gcc' failed with exit status 1 (Linux): Your system's C-compiler, gcc, is not installed or not up to date. Install the corresponding packages or update your system and try again. If that doesn't work, the issue might be Anaconda not linking to the external gcc compiler. Try again after installing the Anaconda compiler with:

conda install gcc_linux-64

ModuleNotFoundError: No module named 'Cython' (Windows): Install or update Visual Studio Build Tools and try compiling again.

Errors related to Gepard operation

no module named gepard: Please make sure that you are attempting to start Gepard from its parent folder, i.e. the location containing the folder "gepard" and "gepardevaluation".

ImportError: cannot import name 'tsp': If your setup includes multiple Anaconda environments, tsp build and gepard operation must be done in the same environment.

Gepard launches in simulated mode despite setting raman_interface = RENISHAW_CONTROL: Please make sure you have set measTemplatePath properly. (See Configuration for more details)