HowToBuild

Revision as of 16:26, 9 April 2012 (view source) Matt McCormick (Talk | contribs) (→Download FARSIGHT source code) ← Older edit		Revision as of 00:55, 16 February 2013 (view source) Hocheung20 (Talk | contribs) (→Download FARSIGHT source code) Newer edit →
Line 24:		Line 24:
	FARSIGHT's SVN Repository is located at:		FARSIGHT's SVN 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://bia-10.ee.uh.edu/Farsight.git
−	https://farsight-svn.ee.uh.edu/repos/farsight/trunk	+	The testing data is located at:
−	If subversion gives you a warning about an untrusted source, please accept the exception. Farsight currently does not have a signed certificate for its SSL service.	+	https://bia-10.ee.uh.edu/FarsightData.git
−	==== Windows ====	+	If Git gives you a warning about a certificate error, prepend GIT_SSL_NO_VERIFY=true when you are cloning the repository and then immediately after cloning, execute "git config http.sslVerify false".
−	# Go to C:\Lab\farsight_src	+	cd <farsight_src>
−	# Right-click to view the folder menu.	+	GIT_SSL_NO_VERIFY=true git clone https://bia-10.ee.uh.edu/Farsight.git .
−	# Click <tt>SVN Checkout</tt> and a window will pop up.	+	git config http.sslVerify false
−		+
−	[[Image:svncheckoutFarsight.jpg|center|frame|SVN Checkout Farsight to the desired folder.]]	+
−		+
−	[[Image:DownloadFarsightfinish.jpg‎|center|TortoiseSVN]]	+
	=== Build FARSIGHT ===		=== Build FARSIGHT ===

---

Revision as of 00:55, 16 February 2013

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 1 Choose a Compiler For Your OS 2 Install CMake 3 Install Subversion 4 Download FARSIGHT source code 5 Build FARSIGHT 6 What's next? 6.1 Checking the Quality Dashboard 6.2 Submitting results to the Dashboard

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 Subversion

SVN is a version control system used to manage the source code of FARSIGHT.

TortoiseSVN x64 is a popular choice for Windows that integrates into the OS.

Linux & Mac developers typically use the command-line tool svn.

Download FARSIGHT source code

FARSIGHT's SVN Repository is located at:

https://bia-10.ee.uh.edu/Farsight.git

The testing data is located at:

https://bia-10.ee.uh.edu/FarsightData.git

If Git gives you a warning about a certificate error, prepend GIT_SSL_NO_VERIFY=true when you are cloning the repository and then immediately after cloning, execute "git config http.sslVerify false".

cd <farsight_src>
GIT_SSL_NO_VERIFY=true git clone https://bia-10.ee.uh.edu/Farsight.git .
git config http.sslVerify false

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 .