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

AppImage:

  • Download the latest "MieSimulatorGUI_vX_X.AppImage".
  • 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.

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