Developer Manual
The SlicerAstro functionality is implemented as multiple plug-in modules, bundled as one downloadable extension as shown in the figure below:
SlicerAstro Doxygen
SlicerAstro Doxygen documentation.
3DSlicer Doxygen
3DSlicer Doxygen documentation.
3DSlicer Developer manual
Before starting developing software for SlicerAstro and 3DSlicer, it is advisable to consult the developer manual. This provides many resources such as tutorials and instructions (e.g., how's to use QtCreator and QtDesigner with 3DSlicer).
3DSlicer Developer meetings
Slicer developer meetings are open to everyone, feel free to join.
3DSlicer Discussion forum
The most effective way to get help from the community.
3DSlicer FAQ
Set of common development questions/answers.
3DSlicer and SlicerAstro are built every day by Kitware on their factory machines (see CDash). Here we provide a guide (updated up to July 2018) how to compile 3DSlicer and SlicerAstro for people interested in developing SlicerAstro. However we advice people only interested in using SlicerAstro to not go through the effort to compile Slicer but instead use the binary distribution.
sudo apt install subversion git-core git-svn make gcc g++ cmake cmake-curses-gui libxt-dev libgl1-mesa-dev libglu1-mesa-dev libfontconfig-dev libxrender-dev libncurses5-dev libosmesa6-dev bison build-essential flex gperf ibgstreamer-plugins-base1.0-dev libasound2-dev libatkmm-1.6-dev libbz2-dev libcap-dev libcups2-dev libdrm-dev libegl1-mesa-dev libfontconfig1-dev libfreetype6-dev libgcrypt11-dev libglib2.0-0 libglib2.0-dev libglu1-mesa-dev libgstreamer1.0-dev libice6 libicu-dev libnss3-dev libpci-dev libpulse-dev libsm6 libxcb-sync0-dev libssl-dev libudev-dev libx11-dev libx11-xcb-dev libxcb-composite0 libxcb-composite0-dev libxcb-cursor-dev libxcb-cursor0 libxcb-damage0 libxcb-damage0-dev libxcb-dpms0 libxcb-dpms0-dev libxcb-dri2-0 libxcb-dri2-0-dev libxcb-dri3-0 libxcb-dri3-dev libxcb-ewmh-dev libxcb-ewmh2 libxcb-glx0 libxcb-glx0-dev libxcb-icccm4 libxcb-icccm4-dev libxcb-image0 libxcb-image0-dev libxcb-keysyms1 libxcb-keysyms1-dev libxcb-present-dev libxcb-present0 libxcb-randr0 libxcb-randr0-dev libxcb-record0 libxcb-record0-dev libxcb-render-util0 libxcb-render-util0-dev libxcb-render0 libxcb-render0-dev libxcb-res0 libxcb-res0-dev libxcb-screensaver0 libxcb-screensaver0-dev libxcb-shape0 libxcb-shape0-dev libxcb-shm0 libxcb-shm0-dev libxcb-sync-dev libxcb-sync-dev libxcb-sync1 libxcb-util-dev libxcb-util0-dev libxcb-util1 libxcb-xf86dri0 libxcb-xf86dri0-dev libxcb-xfixes0 libxcb-xfixes0-dev libxcb-xinerama0 libxcb-xinerama0-dev libxcb-xkb-dev libxcb-xkb1 libxcb-xtest0 libxcb-xtest0-dev libxcb-xv0 libxcb-xv0-dev libxcb-xvmc0 libxcb-xvmc0-dev libxcb1 libxcb1-dev libxcomposite-dev libxcursor-dev libxdamage-dev libxext-dev libxfixes-dev libxi-dev libxrandr-dev libxslt1-dev libxss-dev libxtst-dev libpthread-stubs0-dev libpthread-workqueue0 libpthread-workqueue-dev perl python ruby gyp ninja-build libsrtp0-dev libwebp-dev libjsoncpp-dev libopus-dev libminizip-dev libavutil-dev libavformat-dev libavcodec-dev libevent-dev libwayland-dev libwayland-egl1-mesa libwayland-server0 libgles2-mesa-dev libxkbcommon-dev- compile qt5.11.2 following this link
- Install brew (tested with 1.6.6)
- Install the following with brew: cmake (tested with 3.11.2), Git (2.17.0), Svn (1.10.0)
- Install Xcode (9.4)
- Xquartz (https://www.xquartz.org/ 2.7.11)
- Install qt5.11 with brew. This can not be used for packing binaries. For packing binaries one must compile qt from source (see link), however, with this configuration, the compilation of Qt5.10 didn't work.
git clone https://github.com/Slicer/Slicer.git-
mkdir Slicer-SuperBuild-Debug(be aware that for MacOS the long building path can break the compilation; navigate to the following link for further details) cd Slicer-SuperBuild-Debugcmake -DCMAKE_BUILD_TYPE:STRING=Debug -DSlicer_VTK_VERSION_MAJOR=8 -DSlicer_REQUIRED_QT_VERSION=5.11 -DQt5_DIR=path/qt/lib/cmake/Qt5 ../Slicer- for High Sierra add:
-DSlicer_USE_PYTHONQT_WITH_TCL=OFF -DCMAKE_OSX_DEPLOYMENT_TARGET=10.13 - if Qt has not been built from source (e.g., in this case for High Sierra) add:
-DSlicer_USE_SYSTEM_QT:BOOL=1 -
make -j 8(8 is the number of cores) git clone https://github.com/Punzo/SlicerAstro.gitmkdir SlicerAstro-Build-Debugcd SlicerAstro-Build-Debugcmake -DSlicer_DIR=/path/Slicer-SuperBuild-Debug/Slicer-build -DCMAKE_BUILD_TYPE:STRING=Debug ../SlicerAstro- for High Sierra add:
-DCMAKE_OSX_DEPLOYMENT_TARGET=10.13 make -j 8- Start 3DSlicer and add SlicerAstro modules in the 3DSlicer Settings (modules):
- Restart 3DSlicer with the option:
--launcher-additional-settings /path/SlicerAstro-SuperBuild-Debug/inner-build/AdditionalLauncherSettings.ini
It is possible to run automated tests by typing the following command in the inner-build folders (Slicer-SuperBuild-Debug/Slicer-build and SlicerAstro-SuperBuild-Debug/inner-build):
ctest -j8
For generating binaries (again in the inner-build folders):
cpack -j8
SlicerAstro is an extension of 3DSlicer. Therefore to incorporate SlicerAstro binaries in 3DSlicer, the files have to be moved inside the 3DSlicer package. The SlicerAstro binaries can be included in the 3DSlicer package using the following feature in the extension manager:
Additional utilities at:
3DSlicer and SlicerAstro builds and tests are available every day at the following links:
- 3DSlicer download page and check Get-SlicerAstro link;
- 3DSlicer CDash.
CustomSlicerGenerator can be used to create custom binaries of SlicerAstro using the binaries compiled by the kitware factory machines avoiding the build process (CDash). **Currently not working, see commit)
Slicer is an OpenGL application and the ssh protocol does not support running scripts on a server. To solve this problem one can run Slicer in a docker image on a server (e.g., for making videos of many sources).
How's to create an OpenGL docker image:
SlicerAstro-Docker-OpenGL
Additional 3DSlicer build instructions are available at the following link.
