Difference between revisions of "SimpleITK/GettingStarted/Visual guide to building on Linux"

From KitwarePublic
Jump to navigationJump to search
m (Added more steps, still a work in progress)
m (Added more to step 4)
Line 39: Line 39:
 
  sudo apt-get install cmake gcc g++ git giggle python ipython monodevelop
 
  sudo apt-get install cmake gcc g++ git giggle python ipython monodevelop
  
Confirm that you want to install the install the packages, then wait for the tools to be installed.
+
Confirm that you want to install the packages (press "y"), then wait for the installation to complete.
  
Alternatively, you could choose to manually select each software package using the Software Manager (Menu > Software Manager).
+
Alternatively, you could manually select each software package from the Software Manager (Menu > Software Manager).
  
 
== Step 3: Get SimpleITK source code ==
 
== Step 3: Get SimpleITK source code ==
Line 63: Line 63:
 
The next step is to start building.
 
The next step is to start building.
  
The recommended way to build using the so-called "Super Build":
+
The recommended way to build is via the so-called "super build":
 
  mkdir Build
 
  mkdir Build
 
  cd Build
 
  cd Build
 
  cmake ../SuperBuild
 
  cmake ../SuperBuild
  
 +
The SuperBuild generates make files which takes care of downloading and building ITK, SWIG, and Lua, as well as SimpleITK. On my system, by default, wrappers were generated for C# and Lua.
 +
 +
To start the (long) build process, type:
 
  make
 
  make
 +
 +
On my laptop (Acer Aspire 5755G, Intel® Core™ i7-2630QM CPU @ 2.00GHz × 8, 2GB RAM) the build took over 2 hours.

Revision as of 03:13, 4 February 2012

This guide gives detailed instructions for building SimpleITK on Linux. It is written for beginners getting started with SimpleITK.

Why Linux?

  • Linux is freely available
  • It has all the required tools
  • Did I mention it is free?

Step 1: Get Linux

The first step is to install a Linux distribution. Some popular ones are:

There are many online tutorials explaining how to install your chosen Linux distribution:

If you are a Windows user, you may consider running Linux on a virtual machine. Some popular virtual machine environments are:

Again, there are heaps of tutorials:

This guide uses Linux Mint 12, but the steps are very similar for other Linux distributions.

Step 2: Install build tools

The next step is to install the required build tools.

Open a terminal window (Menu > Terminal) and run the following command:

sudo apt-get install cmake gcc g++ git giggle python ipython monodevelop

Confirm that you want to install the packages (press "y"), then wait for the installation to complete.

Alternatively, you could manually select each software package from the Software Manager (Menu > Software Manager).

Step 3: Get SimpleITK source code

The next step is to get the SimpleITK source code using git.

Decide where you want to put the source code. I'm putting mine in home/ITK:

cd ~
mkdir ITK
cd ITK

Now download the SimpleITK source code, by entering the following command in the Terminal:

git clone --recursive  http://itk.org/SimpleITK.git

Now go into the SimpleITK directory:

cd SimpleITK

Have a look at the directory structure:

ls -l

Step 4: Build SimpleITK

The next step is to start building.

The recommended way to build is via the so-called "super build":

mkdir Build
cd Build
cmake ../SuperBuild

The SuperBuild generates make files which takes care of downloading and building ITK, SWIG, and Lua, as well as SimpleITK. On my system, by default, wrappers were generated for C# and Lua.

To start the (long) build process, type:

make

On my laptop (Acer Aspire 5755G, Intel® Core™ i7-2630QM CPU @ 2.00GHz × 8, 2GB RAM) the build took over 2 hours.