Developer Manual

The SlicerAstro functionality is implemented as multiple plug-in modules, bundled as one downloadable extension as shown in figure:

Doxygen

Doxygen documentation is available at the following link.

3DSlicer developer manual

Before starting developing for SlicerAstro and 3DSlicer, it is advisable to navigate at the following link, where it is possible to find many resources such as tutorial and instructions (e.g., how's to use QtCreator and QtDesigner with 3DSlicer).

Build 3DSlicer and SlicerAstro

Common Prerequisites

Ubuntu 18.04

1. 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
2. compile qt5.10 following this link

High sierra 10.13.4

1. Install brew (tested with 1.6.6)
2. Install the following with brew: cmake (tested with 3.11.2), Git (2.17.0), Svn (1.10.0)
3. Install Xcode (9.4)
4. Xquartz (https://www.xquartz.org/ 2.7.11)
5. Install qt5.11 with brew (this can not be used for packing. For packing is needed to compile qt from source)

Configure and generate Slicer solution files

1. git clone https://github.com/Slicer/Slicer.git
2. mkdir Slicer-SuperBuild-Debug
3. cd Slicer-SuperBuild-Debug
4. cmake -DCMAKE_BUILD_TYPE:STRING=Debug -DSlicer_VTK_VERSION_MAJOR=9 -DSlicer_REQUIRED_QT_VERSION=5.10 -DQt5_DIR=path/qt/lib/cmake/Qt5 ../Slicer
5. for High Sierra add: -DSlicer_USE_PYTHONQT_WITH_TCL=OFF -DCMAKE_OSX_DEPLOYMENT_TARGET=10.13
6. if Qt has not been built from source (e.g., in this case the high sierra one) add: -DSlicer_USE_SYSTEM_QT:BOOL=1
7. make -j 8 (8 is the number of cores)
8. git clone https://github.com/Punzo/SlicerAstro.git
9. mkdir SlicerAstro-Build-Debug
10. cd SlicerAstro-Build-Debug
11. cmake -DSLicer_DIR=/path/Slicer-SuperBuild-Debug/Slicer-build -DCMAKE_BUILD_TYPE:STRING=Debug ../SlicerAstro
12. for High Sierra add: -DCMAKE_OSX_DEPLOYMENT_TARGET=10.13
13. make -j 8
14. Start 3DSlicer and add SlicerAstro modules in the 3DSlicer Settings (modules):
15. Restart 3DSlicer with the option: --launcher-additional-settings /path/SlicerAstro-SuperBuild-Debug/inner-build/AdditionalLauncherSettings.ini

Testing

It is possible to lunch automated tests by typing the following command in the inner-builds (Slicer-SuperBuild-Debug/Slicer-build and SlicerAstro-SuperBuild-Debug/inner-build):

ctest -j8

Packing

For generating binaries:

cpack -j8

SlicerAstro is an extension of 3DSlicer. Therefore to incorporate SlicerAstro binaries in 3DSlicer, the files has 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:

1. CustomSlicerGenerator
2. SlicerCustomAppTemplate by Kitware

Continuous Integration

3DSlicer and SlicerAstro builds and tests are available every day at the following links:

1. 3DSlicer download page and check Get-SlicerAstro link;
2. 3DSlicer CDash.

Additional build information

Additional 3DSlicer build instructions are available at the following link.