Getting Started on Linux

Getting the MieSimulatorGUI App from GitHub:

Compressed Application Package:

• Download the latest "MieSimulatorGUI_vX_X.tar.xz" file.
• Type
  • ./MieSimulatorGUI_vX_X.sh & to execute (Version 1.1 and after) .
  • ./MieSimulator_vX_X & to execute (Up to version 1.0.8).
    If Qt is not installed, you may have to install Qt. Bring up a terminal window and type: sudo apt install qt6-base-dev. Depending on your Linux distribution, you may need to grant execute permissions by running the command chmod 755 MieSimulator_vX_X.

AppImage:

• Download the latest "MieSimulatorGUI_vX_X.AppImage".
• Type chmod 755 MieSimulatorGUI_vX_X.AppImage.
• If libfuse2t64 library is not available, type sudo apt install libfuse2t64.
• Double-click or type ./MieSimulatorGUI_vX_X.AppImage & to execute.

Getting the MieSimulatorGUI Source Code from GitHub:

Downloading and Installing Prerequisites

These instructions are for Ubuntu 16.04 or later users. If you have a different Linux install, you may have to use different syntax.

• Bring up a terminal window and type:

sudo apt-get update
sudo apt-get install gcc
sudo apt-get install libgl1-mesa-dev
sudo apt-get install mesa-common-dev
sudo apt-get install build-essential

• Download the latest source code by navigating to the GitHub repository and clicking Code > Local > Download ZIP. Extract the files to a directory of your choice.
• Go to the Qt download page and select the Qt 6 Desktop gcc 64-bit version or type sudo apt install qt6-base-dev to install it.
• You may also download Qt Creator at the same time or type sudo apt-get install qtcreator to install it.

Building the Project

• Launch Qt Creator and open the "MieSimulator.pro" file.
• In the next window, select proper project kit and click Configure Project.
• Select Build > Run qmake, and then select Build > Build Project "MieSimulatorGUI" or press CTRL+B.

Running Tests and the Application

• To run tests: Select Tools > Tests > Run All Tests.
• To run the application: Select Build > Run or press CTRL+R.

Building and Running Tests from the Command Line

• Install Qt
• Open Terminal
• From the root directory of the project (where MieSimulatorGUI.pro is located), run the following commands:

chmod +x MieSimulatorGUI.pro
mkdir -p build
cd build
qmake ../MieSimulatorGUI.pro
make -j$(nproc)
cd test
chmod +x MieSimulatorGUI_test
./MieSimulatorGUI_test

Note:
- If you get lGL error, bring up a terminal window and type "sudo apt-get install libgl1-mesa-dev" to install "GL" library.
- If you get any errors, check whether Qt and its debugger is working properly (Generate a sample Qt program and run).