= Download HeuristicLab =

== System Requirements == 
HeuristicLab is based on the [http://www.microsoft.com/net Microsoft .NET Framework]. In order to be able to run HeuristicLab properly, you have to downland and install the following software packages:
 * [http://www.microsoft.com/downloads/details.aspx?familyid=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en Microsoft .NET Framework 3.5]
 * [http://www.microsoft.com/downloads/details.aspx?familyid=AB99342F-5D1A-413D-8319-81DA479AB0D7&displaylang=en Microsoft .NET Framework 3.5 Service Pack 1]
 * [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=130f7986-bf49-4fe5-9ca8-910ae6ea442c Microsoft Chart Controls for Microsoft .NET Framework 3.5]

Please note, that we don't have any experience in using HeuristicLab with [http://www.mono-project.com Mono] and are therefore also unable to provide any support. If you have gained any experience with Mono and HeuristicLab, we would be thankful for any kind of feedback. 

== License ==
HeuristicLab is free software: you can redistribute it and/or modify it under the terms of the [http://www.gnu.org/licenses/gpl.html GNU General Public License (GPL)] as published by the Free Software Foundation, either version 3 of the license, or (at your option) any later version.

HeuristicLab is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the [http://www.gnu.org/licenses/gpl.html GNU General Public License] for more details.

== Download Binaries ==
The latest stable version of HeuristicLab is '''3.3.0'''. ZIP archives containing the binaries of HeuristicLab 3.3.0 for 32 and 64 bit systems are attached to this page:
 * [attachment:"HeuristicLab 3.3.0 (x86).zip" Download HeuristicLab 3.3.0 binaries for 32 bit systems]
 * [attachment:"HeuristicLab 3.3.0 (x64).zip" Download HeuristicLab 3.3.0 binaries for 64 bit systems]

== Download Starter Kit ==
The HeuristicLab Starter Kit contains several algorithm and problem files which can be loaded and executed immediately. Download the Starter Kit and start exploring HeuristicLab right away.
 * [attachment:"HeuristicLab 3.3.0 Starter Kit.zip" Download HeuristicLab 3.3.0 Starter Kit]

== Build Sources ==

Prerequisites:
 * .NET 3.5 SDK
 * Visual Studio 2008
 * TortoiseSVN

To build HL3 from source you need to have the binary-path of TortoiseSVN in your $PATH. The usual location is "c:\Program Files\TortoiseSVN\bin".

To build the solution the first time, follow these steps
 1. Open the main solution file "!HeuristicLab.sln" in [https://sources.heuristiclab.com/trac/hl3/core/browser/trunk/sources trunk/sources].
 1. Open the "!HeuristicLab" project and duplicate the file !CustomPostBuildTemplate_UpdateLocalInstallation.cmd
 1. Rename this file to !CustomPostBuild.cmd
 1. Open this file and change the target path there to the path where you'd like to export the built sources to (the default is to overwrite the assemblies in the default installation path)
 1. Hit F6 or select "Build>Build Solution" in Visual Studio

If you have !HeuristicLab plugins in your own solution, you should add the installation assemblies to the assembly reference path.
At the bottom you find two registry files (one for 32bit and the other for 64bit Windows) that will register !HeuristicLab's default installation path as system wide assembly reference path. Edit this file to point to your installation path. Alternatively you can specify a reference path in your project properties.