FEDMIX - Eshmun

Eshmun is part of the FEDMix project: Fusible evolutionary deep neural network mixture learning. See project's page information: https://www.esciencecenter.nl/projects/fedmix/

'Eshmun' is a standalone, and robust medical image analysis developed with C++, Qt, and VTK that you can use, collaborate with the development and extend.

• Installable binaries for:
  • Mac
  • Windows
  • Linux
• Load DICOM images

TechStack:

• C++ v17
• Qt v5.15
• LLVM v11.1
• clang v11.1 (clang-format - Google style, AStyle)
• VTK v9

Continuous Integration across Windows, macOS, and Linux

More info here

Application screenshots

Development

You can clone this repository
git clone https://github.com/FEDMix/eshmun.git
and edit the code with your preferent IDE

• QTCreator. Used for Open Source
• VSCode

Installation on MacOS

Install with homebrew:

brew install llvm@11 cmake vtk@9 qt@5

you may need to install xcode-select --install and link qt for cmake:

brew link --force qt@5
sudo ln -s /usr/local/Cellar/qt@5/5.15.2/mkspecs /usr/local/mkspecs
sudo ln -s /usr/local/Cellar/qt@5/5.15.2/plugins /usr/local/plugins

Installation on Linux

Linux & WSL2:
wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 11

sudo apt-get install clang-format-11
sudo apt-get install clang-tidy-11

curl https://gist.githubusercontent.com/junkdog/70231d6953592cd6f27def59fe19e50d/raw/92f0e73d2558402b7316021c1ab408b30e534de6/update-alternatives-clang.sh > update-alternatives-clang.sh
chmod u+x update-alternatives-clang.sh
sudo ./update-alternatives-clang.sh 11 1

Build the application

From the command line

$ mkdir build #Create build folder if doesn't exist
$ cd build #And follow the sequential steps inside the build folder

# Create the 'make' file inside the build folder for your operative system.
$ cmake .. 
# if you have different version on you computer you can specify the installation path of qt5 with
$ cmake -DCMAKE_PREFIX_PATH="/usr/local/opt/qt5" ..

# Create the binary compiled
$ make

# Run the application
$./src/eshmun  

With QT Creator

Open the txt file CMakeLists.txt
and run with
 

Configure your project. Be sure that all versions are linked correctly.
 

You have to uncheck the Add build library search path to DYLD_LIBRARY_PATH and DYLD_FRAMEWORK_PATH option from the Run section in the Projects tab:
 

Run the tests

If using Qt creator:

Contributor Covenant Code of Conduct

https://github.com/FEDMix/eshmun/blob/feature/readme/CODE_OF_CONDUCT.rst

License

Apache 2