RTK/Users: Difference between revisions

From Openrtk
Jump to navigation Jump to search
Line 40: Line 40:


== Step 2 - Building RTK ==
== Step 2 - Building RTK ==
Like ITK, in order to build RTK you would need to install [CMake www.cmake.org]. CMake supports out of source build so we recommend to create a binary directory 'RTK-bin'
  mkdir RTK-bin
  cd RTK-bin
  cmake ../RTK
When CMake asks for the ITK_DIR, specify the binary directory where ITK is built.
  ITK_DIR /path to directory/ITK-bin


== Step 3 - Building an example application with RTK ==
== Step 3 - Building an example application with RTK ==

Revision as of 08:26, 27 August 2012

User's guide

What is RTK?

RTK is an open source C++ library, not an executable. This means that you must write code that uses RTK and compile it before you will obtain something that you can run and get a result from. It also means that you can adapt or extend RTK to address your problem at hand. To facilitate this over multiple operating systems, compilers, and system configurations, RTK itself must be built from its source code. RTK is based on The Insight Toolkit, therefore you would need to get, configure and compile The Insight Toolkit first.

The three steps to starting to work with RTK are therefore:

  1. Download and Build the ITK source
  2. Download/Obtain/Get the RTK source
  3. Build the RTK library
  4. Write your own code that uses RTK and build it, linking to the RTK library.

In the next sections we describe each of this steps.

Requirements

In order to compile RTK you will need the following:

  • GIT (in order to get the software)
  • CMake (in order to configure RTK)
  • C/C++ compiler

Step 0 - Getting ITK

RTK currently uses ITK 3.20.

We recommend to look into the ITK wiki in order to compile ITK for your system. The documentation for ITK should be fairly straight forward. Moreover, the concepts for building ITK are very similar to those for RTK. In order to get ITK 3.20 from git:

 git clone git://itk.org/ITK.git
 cd ITK
 git checkout release-3.20

One important CMake option to make sure is enabled is the ITK_USE_REVIEW which should be set to ON when running CMake on ITK.

 ITK_USE_REVIEW ON

Step 1 - Getting RTK

This page documents how to download RTK through Git. Follow the ITK Git download instructions to install Git.

To get the latest source code for RTK:

 git clone git://github.com/SimonRit/RTK.git

Step 2 - Building RTK

Like ITK, in order to build RTK you would need to install [CMake www.cmake.org]. CMake supports out of source build so we recommend to create a binary directory 'RTK-bin'

 mkdir RTK-bin
 cd RTK-bin
 cmake ../RTK

When CMake asks for the ITK_DIR, specify the binary directory where ITK is built.

 ITK_DIR /path to directory/ITK-bin

Step 3 - Building an example application with RTK