Skip to content

Latest commit

 

History

History
128 lines (83 loc) · 3.8 KB

README.md

File metadata and controls

128 lines (83 loc) · 3.8 KB
Raw

FEDMIX - Eshmun

ci

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/

image

'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

Frame 19

Frame 20

Frame 18

Development

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

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
 

image

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

image

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:
 

image

Run the tests

If using Qt creator:

image

Contributor Covenant Code of Conduct

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

License

Apache 2