Getting Started on Linux - VirtualPhotonics/MieSimulatorGUI GitHub Wiki

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).