HowToBuild

From FarsightWiki
(Difference between revisions)
Jump to: navigation, search
m
(Download FARSIGHT source code)
 
(14 intermediate revisions by 6 users not shown)
Line 4: Line 4:
 
Popular choices are gcc/g++ on Linux, Microsoft Visual Studio 2008/2010 on Windows, and XCode* on Mac OS X.   
 
Popular choices are gcc/g++ on Linux, Microsoft Visual Studio 2008/2010 on Windows, and XCode* on Mac OS X.   
  
<span style="font-size:75%">*To install XCode/gcc on Mac OS X you may need to install the XCode development environment. This software should be available on your OS reinstall/recovery disk. At this time only XCode 3.2 is supported as CMake still does not generate appropriate project files for XCode 4</span>
+
<span style="font-size:75%">*To install XCode/gcc on Mac OS X you may need to install the XCode development environment.</span>
  
 
=== Install CMake ===
 
=== Install CMake ===
Line 10: Line 10:
 
[http://cmake.org/cmake/resources/software.html CMake] is a tool which generates the makefiles under Linux, the Visual Studio Solution files (.sln) under Windows, or the XCode project files (.xcodeproj) under Mac OS X. It aims to allow developers to build their projects across different platforms with a minimum of reconfiguration.
 
[http://cmake.org/cmake/resources/software.html CMake] is a tool which generates the makefiles under Linux, the Visual Studio Solution files (.sln) under Windows, or the XCode project files (.xcodeproj) under Mac OS X. It aims to allow developers to build their projects across different platforms with a minimum of reconfiguration.
  
<span style="font-size:125%; color:red">Note: If you want to take advantage of multicore building in Visual Studio, you can append /MP'''n''', where '''n''' is the number of processors you have. (ie. /MP16 for the Dell T5500 Workstations in the lab) to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS at each CMake configuration screen.</span>
+
<span style="font-size:125%; color:red">Note: If you want to take advantage of multicore building in Visual Studio, you can append /MP to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS at each CMake configuration screen.</span>
  
To check the number of processors your computer has, call up the command prompt, type <tt>"echo NUMBER_OF_PROCESSORS"</tt>, and the next line will result in a number.  Using a number greater than the number of processors you have will seriously slow down the computer.
+
=== Install Git ===
  
=== Install Subversion ===
+
# Download [[http://git-scm.com/ Git]]. [[Image:downloadGIT.jpg|center|frame|[http://git-scm.com/ Download Git]]]
SVN is a version control system used to manage the source code of FARSIGHT.  
+
# When it ask for "Adjusting your PATH environment: How would you like to use Git from the command line", select: <tt>Run Git from the Windows Command Prompt</tt>.
 +
# When it ask for "Configuring the line ending conversions: How should Git treat line endings in text files", select: <tt>Checkout Windows-style, commit Unix-style line endings</tt>.
  
[http://tortoisesvn.net/ TortoiseSVN x64] is a popular choice for Windows that integrates into the OS.
+
<center>[[Image:GITsetup.jpg|Make sure the 2nd option is selected.]][[Image:GITsetup2.jpg|Make sure the 1st option is selected.]]</center>
 
+
[[Image:TortoiseSVN.jpg|center|frame|[http://tortoisesvn.net/ Download the latest TortoiseSVN x64]]]
+
 
+
Linux & Mac developers typically use the command-line tool '''svn'''.
+
  
 
=== Download FARSIGHT source code ===
 
=== Download FARSIGHT source code ===
  
FARSIGHT's SVN Repository is located at:
+
FARSIGHT's Git Repository is located at:
https://farsight-svn.ee.uh.edu/repos/farsight/
+
 
+
The main line of development is in the "trunk" subdirectory.  If you're not interested in downloading test data or branch versions, you can download only the source code by appending "/trunk" to the above path.
+
 
+
https://farsight-svn.ee.uh.edu/repos/farsight/trunk
+
 
+
==== Windows ====
+
 
+
# Go to C:\Lab
+
# Right-click to view the folder menu.
+
# Click <tt>SVN Checkout</tt> and a window will pop up.
+
You can check out a copy of FARSIGHT from the following location:
+
 
+
[[Image:svncheckoutFarsight.jpg|center|frame|SVN Checkout Farsight to the desired folder.]]
+
  
[[Image:DownloadFarsightfinish.jpg‎|center|TortoiseSVN]]
+
https://github.com/RoysamLab/Farsight-toolkit.git
  
 
=== Build FARSIGHT ===
 
=== Build FARSIGHT ===

Latest revision as of 22:42, 5 November 2015

When building FARSIGHT for the first time you will need to set up a development environment. FARSIGHT utilizes several large source libraries so ensure that you have at least 25 GiB of HDD space.

Contents

Choose a Compiler For Your OS

Popular choices are gcc/g++ on Linux, Microsoft Visual Studio 2008/2010 on Windows, and XCode* on Mac OS X.

*To install XCode/gcc on Mac OS X you may need to install the XCode development environment.

Install CMake

CMake is a tool which generates the makefiles under Linux, the Visual Studio Solution files (.sln) under Windows, or the XCode project files (.xcodeproj) under Mac OS X. It aims to allow developers to build their projects across different platforms with a minimum of reconfiguration.

Note: If you want to take advantage of multicore building in Visual Studio, you can append /MP to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS at each CMake configuration screen.

Install Git

  1. Download [Git].
  2. When it ask for "Adjusting your PATH environment: How would you like to use Git from the command line", select: Run Git from the Windows Command Prompt.
  3. When it ask for "Configuring the line ending conversions: How should Git treat line endings in text files", select: Checkout Windows-style, commit Unix-style line endings.
Make sure the 2nd option is selected.Make sure the 1st option is selected.

Download FARSIGHT source code

FARSIGHT's Git Repository is located at:

https://github.com/RoysamLab/Farsight-toolkit.git

Build FARSIGHT

FARSIGHT depends on Qt, Boost, ITK, VTK, and VXL.

FARSIGHT's SuperBuild system can automatically download & build these dependencies for you.

Please follow the ManualBuild instructions if you'd prefer to setup these dependencies by hand.

What's next?

Checking the Quality Dashboard

When you start contributing code you can monitor if code and tests you build are compiling correctly on the dashboard machines here: http://cdash.org/CDash/index.php?project=Farsight

Submitting results to the Dashboard

You can also submit an experimental build or set up automated builds .

Personal tools