ITK/Examples/Instructions/ForUsers: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
(Added remote module documentation)
(Updated remote module instructions)
 
(One intermediate revision by the same user not shown)
Line 26: Line 26:
If you are really excited about learning ITK and are tired of downloading individual examples over and over, you can download them all at the same time and build them all together.
If you are really excited about learning ITK and are tired of downloading individual examples over and over, you can download them all at the same time and build them all together.


* [http://www.gitorious.org/itkwikiexamples/itkwikiexamples/archive-tarball/master Download a tar file] containing all examples. '''NOTE:''' If you get a message to try again later, hit the refresh button on your browser.
* [https://github.com/InsightSoftwareConsortium/ITKWikiExamples/archive/master.zip Download a zip file] containing all examples.  
: Extract the tarball to ''WikiExamples''.
: Unzip the zip file to ''ITKWikiExamples''.
:or
:or
* Keep an active connection to the examples.
* Keep an active connection to the examples.
# Install [http://git-scm.com/ git]
# Install [http://git-scm.com/ git]
# Clone the examples repository
# Clone the examples repository
<pre>git clone git://gitorious.org/itkwikiexamples/itkwikiexamples.git ITKWikiExamples</pre>
<pre>git clone git@github.com:InsightSoftwareConsortium/ITKWikiExamples.git ITKWikiExamples</pre>
===You have your own versions of VTK and ITK===
===You have your own versions of VTK and ITK===
* Make a directory to hold the binaries
* Make a directory to hold the binaries
Line 54: Line 54:
===Build as an ITKv4 Remote Module===
===Build as an ITKv4 Remote Module===
* Enable fetching
* Enable fetching
# Go to: http://gitorious.org/itkwikiexamples/itkwikiexamples/blobs/master/WikiExamples.remote.cmake
# Go to: https://github.com/InsightSoftwareConsortium/ITKWikiExamples/raw/master/WikiExamples.remote.cmake
# Right click on the "Raw blob data" button and select "Save Link As..."
# Right click on the "Raw" button and select "Save Link As..."
# Save the file in: YOUR_ITK_SOURCE_DIR/Modules/Remote
# Save the file in: YOUR_ITK_SOURCE_DIR/Modules/Remote


Line 63: Line 63:
# Configure
# Configure


* Fetch ITKWikiExamples
* Fetch ITK Wiki Examples '''NOTE: Only for ITK 4.4 and earlier'''
# Open the highlighted (red) cmake entry
# Open the highlighted (red) cmake entry
# Check the Fetch_WikiExamples box
# Check the Fetch_WikiExamples box
# Configure
# Configure


* Enable ITKWikiExampes
* Enable ITK Wiki Exampes
# Configure (yes, do it again)
# Configure (yes, do it again)
# Open the highlighted (red) cmake entry
# Open the highlighted (red) cmake entry
# Check the Module_ITKSkullStrip box
# Check the Module_WikiExamples box
# Configure
# Configure
# Generate
# Generate
Line 79: Line 79:
From your itk build directory
From your itk build directory
* Configure
* Configure
# cmake -DFetch_WikiExamples=ON YOUR_ITK_SOURCE_DIR
# cmake -DFetch_WikiExamples=ON YOUR_ITK_SOURCE_DIR '''NOTE: Only for ITK 4.4 and earlier'''
# cmake -DModule_ITKWikiExamples=ON YOUR_ITK_SOURCE_DIR
# cmake -DModule_WikiExamples=ON YOUR_ITK_SOURCE_DIR


====Once you have configured with the cmake gui or command line====
====Once you have configured with the cmake gui or command line====
Line 103: Line 103:
<pre>
<pre>
cd ITKWikiExamples
cd ITKWikiExamples
git pull git@gitorious.org:itkwikiexamples/itkwikiexamples.git
git pull
cd ../ITKWikiExamples-build
cd ../ITKWikiExamples-build
cmake ../ITKWikiExamples
cmake ../ITKWikiExamples

Latest revision as of 17:50, 17 August 2013

If you want to use ITK Examples you have several options. If you are a Wiki Example Developer, go here or a Wiki Example Administrator go here.

Build a single example

  1. Follow the instructions at the bottom of the example. These instructions tell how to download, extract, configure, compile and run the example.

From here, the instructions are operating system specific:

Linux

From your build directory, run

ccmake YourSourceDirectory (to create a Unix Makefile)

or

ccmake YourSourceDirectory -G YourIDE (e.g. KDevelop3)
  1. Press 'c' to configure.
  2. If CMake finds the correct location of your VTK binary build (the VTK_DIR cmake variable), and/or the ITK binary build (the ITK_DIR cmake variable) great! If not, use the arrow keys to scroll down to VTK_DIR, press enter, type the location of your VTK binary build (likely something like /home/yourname/bin/VTK), and press enter.
  3. Press 'c' again to reconfigure
  4. Press 'g' to generate
  5. If you generated a Unix Makefile, type 'make' in your build directory
  6. If you generated a project for an IDE, open the project file with your IDE

Windows

  1. Open CMake
  2. Select your CMakeLists.txt file
  3. Select your build system
  4. Click "Generate"

Build all of the examples

If you are really excited about learning ITK and are tired of downloading individual examples over and over, you can download them all at the same time and build them all together.

Unzip the zip file to ITKWikiExamples.
or
  • Keep an active connection to the examples.
  1. Install git
  2. Clone the examples repository
git clone git@github.com:InsightSoftwareConsortium/ITKWikiExamples.git ITKWikiExamples

You have your own versions of VTK and ITK

  • Make a directory to hold the binaries
mkdir ITKWikiExamples-build
  • From this build directory, run 'cmake'. You will be prompted for the location of your VTK and ITK binary builds.
cd ITKWikiExamples-build
ccmake ../ITKWikiExamples
make

Use the Superbuild to build a proper VTK and ITK

The ITKWikiExamples Superbuild will grab the proper versions of VTK and ITK and build all of the examples. To take advantage of the Superbuild, you will need to install git.

mkdir ITKWikiExamples-Superbuild
  • From this build directory, run 'ccmake'.
cd ITKWikiExamples-Superbuild
ccmake ../ITKWikiExamples/Superbuild
make

Build as an ITKv4 Remote Module

  • Enable fetching
  1. Go to: https://github.com/InsightSoftwareConsortium/ITKWikiExamples/raw/master/WikiExamples.remote.cmake
  2. Right click on the "Raw" button and select "Save Link As..."
  3. Save the file in: YOUR_ITK_SOURCE_DIR/Modules/Remote

If you use an interactive cmake (ccmake, cmake-gui or cmakesetup)

  • Configure
  1. Go to your itk build directory and run cmake
  2. Configure
  • Fetch ITK Wiki Examples NOTE: Only for ITK 4.4 and earlier
  1. Open the highlighted (red) cmake entry
  2. Check the Fetch_WikiExamples box
  3. Configure
  • Enable ITK Wiki Exampes
  1. Configure (yes, do it again)
  2. Open the highlighted (red) cmake entry
  3. Check the Module_WikiExamples box
  4. Configure
  5. Generate
  6. Exit cmake

If you use cmake from the command line

From your itk build directory

  • Configure
  1. cmake -DFetch_WikiExamples=ON YOUR_ITK_SOURCE_DIR NOTE: Only for ITK 4.4 and earlier
  2. cmake -DModule_WikiExamples=ON YOUR_ITK_SOURCE_DIR

Once you have configured with the cmake gui or command line


  • Build ITKWikiExamples
 From your itk build directory
  1. make
  • Test ITKWikiExamples if testing is ON
  1. cd your itk build directory
  2. cd Modules/Remote/WikiExamples
  3. ctest

Find a class or method using google

Type the following into the google search bar

site:itk.org/Wiki/ITK/Examples itkMedianImageFilter
or
site:itk.org/Wiki/ITK/Examples SetRadius

Update the examples repository

If you cloned the examples repository, you can get the latest updates:

cd ITKWikiExamples
git pull
cd ../ITKWikiExamples-build
cmake ../ITKWikiExamples
make

Run all of the examples

ctest