TubeTK/Slicer: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
No edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 6: Line 6:
|-
|-
| style="background:#efefef;" align="left" valign="top" width="150px" |  
| style="background:#efefef;" align="left" valign="top" width="150px" |  
'''[[TubeTK|Home]]'''
*[[TubeTK/About|About]]
*[[TubeTK/Images|Image Gallery]]
*[[TubeTK/Data|Data and Publications]]
<br>
<br>
<b>[http://public.kitware.com/Wiki/TubeTK Home]</b>
----
*[[TubeTK/About | About]]
*[[TubeTK/Events | Events]]
*[[TubeTK/Images | Image Gallery]]
*[[TubeTK/Data | Data and Publications]]
<br>
<br>
<hr>
'''For Users'''
* [[TubeTK/Installation|Installation]]
* [[TubeTK/Documentation|Methods & Apps]]
* [[TubeTK/Slicer|TubeTK with 3D Slicer]]
* [[TubeTK/OsiriX|TubeTK with OsiriX]]
<br>
<br>
<b>For Users</b>
----
* [[TubeTK/Installation | Installation]]
* [[TubeTK/Documentation | Methods & Apps]]
* [[TubeTK/Slicer | TubeTK with Slicer]]
* [[TubeTK/ImageJ | TubeTK with ImageJ]]
<br>
<br>
<hr>
'''For Developers'''
* [[TubeTK/Development|Development Docs]]
<br>
<br>
<b>For Developers</b>
----
* [[TubeTK/Development | Development Docs]]
<br>
<br>
<hr>
'''[https://github.com/TubeTK/TubeTK/issues Report Bugs<br>Request Features]'''
<br>
<br>
<b>[[TubeTK/Team | Contact Us]]</b>
<br>
----
<br>
'''[[TubeTK/Contact|Contact Us]]'''


| width="800px" align="left" |  
| width="800px" align="left" |  
= TubeTK in 3D Slicer =
= TubeTK in 3D Slicer =


* Please use [http://www.slicer.org/slicerWiki/index.php/Slicer4 Slicer4]
== Overview ==
* Note that there are different instructions for '''users''' and '''developers'''
** For now, TubeTK must be built from source:  [[TubeTK/Development | See the TubeTK developers page for instructions to build and extend TubeTK]]
** '''Users''': Download a pre-compiled version of Slicer
** '''Developers''': Build Slicer from source


== Users ==
Slicer 3D is the recommended platform for using TubeTK.  Using TubeTK stand-alone from the command-line is also well supported.


=== Download 3D Slicer ===
You must first install Slicer, and then build TubeTK using that installed version of Slicer to provide the dependencies for TubeTK (e.g., ITK, VTK, CTK).
* Download from http://download.slicer.org/
* Choose your operating system: Windows, Mac OS X, Linux
* Choose stable release or nightly build


=== Add TubeTK's Command Line Modules ===
== Details ==
* Run Slicer
* Edit -> Application Settings -> Additional module paths (click >> to the right of the box, then the Add button)
* Select '''<YourTubeTKBuildDirectory>'''/TubeTK-Build/lib/TubeTK/Plugins/


=== Restart 3D Slicer ===
=== Get CMake ===
* On restart, the TubeTK modules will now be in the list of modules.  All TubeTK module names end with (TubeTK)


== Developers ==
Install the current stable release of CMake
* Download binaries from http://www.cmake.org


=== Build 3D Slicer ===
=== Get 3D Slicer ===
* Build Slicer4 according to the [http://www.slicer.org/slicerWiki/index.php/Slicer4_Build_instructions Slicer4 Build Instructions]
Install the current stable release of Slicer
* '''Download 3D Slicer Binaries:''' from http://download.slicer.org/
* '''Or, build 3D Slicer from source:''' [http://www.slicer.org/slicerWiki/index.php/Documentation/4.0/Developers/Build_Instructions Slicer4 Build Instructions]
** Configuration recommendations:
*** In CMake, turn-on advanced options and change BUILD_TYPE to Release
*** In CMake, change Slicer_USE_PYTHONQT_WITH_TCL to OFF


=== Add TubeTK's Command Line Modules ===
=== Get Boost (optional) ===
* Copy the TubeTK plugins to Slicer's plugins directory. TubeTK plugins include the substring 'tube':
Boost is used by select TubeTK applications.
cp '''<YourTubeTKBuildDirectory>'''/TubeTK-Build/lib/TubeTK/Plugins/*tube*  
* Boost must be built from source to resolve linking errors on 64 bit machines on current binaries for Boost
    '''<YourSlicerBuildDirectory>'''/Slicer-build/lib/Slicer3/Plugins
* Version 1.54 or later is needed
* Download from http://www.boost.org/


=== Add TubeTK's Slicer python modules ===
=== Build TubeTK using Slicer ===
* Copy all of TubeTK's slicer python modules to Slicer's QTScriptableModules directory:
TubeTK will use Slicer's ITK, VTK, and other libraries during its build process, to ensure compatibility with Slicer.
cp '''<YourTubeTKSourceDirectory>'''/Applications/SlicerModules/*.py
* In CMake, set the following options
    '''<YourSlicerSourceDirectory>'''/QTScriptedModules/Scripts
** BUILD_TYPE = Release
* Add TubeTK's slicer python modules to the list in '''<YourSlicerSourceDirectory>'''/QTScriptedModules/Scripts/CMakeLists.txt
** USE_SLICER_MODULES = True
* Re-build Slicer


=== Run 3D Slicer ===
=== Configure Slicer to load TubeTK's modules ===
cd '''<YourSlicerBuildDirectory>'''/Slicer-build
Run Slicer
./Slicer
* Edit -> Application Settings -> Modules -> Additional module paths (click >> to the right of the box, then the Add button)
* Select '''<YourTubeTKBuildDirectory>'''/TubeTK-Build/lib/TubeTK/Plugins/
* Restart Slicer


* The TubeTK modules will now be in the list of modules
=== Restart 3D Slicer ===
* On restart, the TubeTK modules will now be in the list of modules.  All TubeTK module names end with (TubeTK)


|}
|}
[[Category:TubeTK|Slicer]]

Latest revision as of 14:20, 6 January 2015

__NOTITLE__


TubeTK Header.jpg

Home




For Users




For Developers




Report Bugs
Request Features




Contact Us

TubeTK in 3D Slicer

Overview

Slicer 3D is the recommended platform for using TubeTK. Using TubeTK stand-alone from the command-line is also well supported.

You must first install Slicer, and then build TubeTK using that installed version of Slicer to provide the dependencies for TubeTK (e.g., ITK, VTK, CTK).

Details

Get CMake

Install the current stable release of CMake

Get 3D Slicer

Install the current stable release of Slicer

  • Download 3D Slicer Binaries: from http://download.slicer.org/
  • Or, build 3D Slicer from source: Slicer4 Build Instructions
    • Configuration recommendations:
      • In CMake, turn-on advanced options and change BUILD_TYPE to Release
      • In CMake, change Slicer_USE_PYTHONQT_WITH_TCL to OFF

Get Boost (optional)

Boost is used by select TubeTK applications.

  • Boost must be built from source to resolve linking errors on 64 bit machines on current binaries for Boost
  • Version 1.54 or later is needed
  • Download from http://www.boost.org/

Build TubeTK using Slicer

TubeTK will use Slicer's ITK, VTK, and other libraries during its build process, to ensure compatibility with Slicer.

  • In CMake, set the following options
    • BUILD_TYPE = Release
    • USE_SLICER_MODULES = True

Configure Slicer to load TubeTK's modules

Run Slicer

  • Edit -> Application Settings -> Modules -> Additional module paths (click >> to the right of the box, then the Add button)
  • Select <YourTubeTKBuildDirectory>/TubeTK-Build/lib/TubeTK/Plugins/
  • Restart Slicer

Restart 3D Slicer

  • On restart, the TubeTK modules will now be in the list of modules. All TubeTK module names end with (TubeTK)