Installing Eureqa - Revision history

Mnguyen: /* On Windows using Visual Studio 2010 and Matlab */

2012-02-10T23:34:58Z

On Windows using Visual Studio 2010 and Matlab

← Older revision		Revision as of 23:34, 10 February 2012
Line 28:		Line 28:
	* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''		* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''
	* If you are using a '''64-bit system''', you need to change the ''Solution Platform" from ''Win32'' to ''x64''.		* If you are using a '''64-bit system''', you need to change the ''Solution Platform" from ''Win32'' to ''x64''.
	* OPTIONAL STEP: Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).		* OPTIONAL STEP: Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item). Matlab 2010a and later do not have this file.
	* Create a .def file with the following text (Project -> Add New Item)		* Create a .def file with the following text (Project -> Add New Item)
	<code>		<code>

Mnguyen: /* On Windows using Visual Studio 2010 and Matlab 2009b */

2012-02-10T23:07:13Z

On Windows using Visual Studio 2010 and Matlab 2009b

← Older revision		Revision as of 23:07, 10 February 2012
Line 17:		Line 17:
	* When the building process is done you will have a eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.		* When the building process is done you will have a eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.

	===On Windows using Visual Studio 2010 and Matlab ~~2009b~~===		===On Windows using Visual Studio 2010 and Matlab===

	~~Note that these installation instructions require a file (mexversion.rc) which is not available in later versions of Matlab. We have yet to find a solution :).~~ These instructions are based on these [http://coachk.cs.ucf.edu/GPGPU/Compiling_a_MEX_file_with_Visual_Studio2.htm instructions] and came about with the help of [http://sumo.intec.ugent.be/?q=joerir Joeri Ruyssinck].		These instructions are based on these [http://coachk.cs.ucf.edu/GPGPU/Compiling_a_MEX_file_with_Visual_Studio2.htm instructions] and came about with the help of [http://sumo.intec.ugent.be/?q=joerir Joeri Ruyssinck].

	* Install the Boost C++ libraries for Windows ([http://www.boost.org Boost.org]) following the "Getting started instructions". Alternatively you can watch this [http://www.youtube.com/watch?v=5AmwIwedTCM youtube video]. Note that if you are working on a 64-bit system you need to add this "address-model=64" option to the build options.		* Install the Boost C++ libraries for Windows ([http://www.boost.org Boost.org]) following the "Getting started instructions". Alternatively you can watch this [http://www.youtube.com/watch?v=5AmwIwedTCM youtube video]. Note that if you are working on a '''64-bit system''' you need to add this "address-model=64" option to the build options.
	* This [http://stackoverflow.com/questions/2629421/how-to-use-boost-in-visual-studio-2010 website] also has instructions on how to install Boost.		* This [http://stackoverflow.com/questions/2629421/how-to-use-boost-in-visual-studio-2010 website] also has instructions on how to install Boost.
	* Start Visual Studio		* Start Visual Studio
Line 28:		Line 28:
	* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''		* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''
	* If you are using a '''64-bit system''', you need to change the ''Solution Platform" from ''Win32'' to ''x64''.		* If you are using a '''64-bit system''', you need to change the ''Solution Platform" from ''Win32'' to ''x64''.
	* Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).		* OPTIONAL STEP: Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).
	* Create a .def file with the following text (Project -> Add New Item)		* Create a .def file with the following text (Project -> Add New Item)
	<code>		<code>

Mnguyen: /* On Windows using Visual Studio 2010 and Matlab 2009b */

2012-02-10T23:03:23Z

On Windows using Visual Studio 2010 and Matlab 2009b

← Older revision		Revision as of 23:03, 10 February 2012
Line 27:		Line 27:
	* Name the project ''eureqa_select''		* Name the project ''eureqa_select''
	* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''		* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''
	* If you are using a 64-bit system, you need to change the ''Solution Platform" from ''Win32'' to ''x64''.		* If you are using a '''64-bit system''', you need to change the ''Solution Platform" from ''Win32'' to ''x64''.
	* Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).		* Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).
	* Create a .def file with the following text (Project -> Add New Item)		* Create a .def file with the following text (Project -> Add New Item)
Line 34:		Line 34:
	EXPORTS mexFunction		EXPORTS mexFunction
	</code>		</code>
	if you are using a 32-bit system. ~~Otherwise~~ change the extension to mexw64		if you are using a 32-bit system. If you are using a '''64-bit system''' change the extension to mexw64

	* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the eureqa_select.cpp file.		* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the eureqa_select.cpp file.

Mnguyen: /* On Windows using Visual Studio 2010 and Matlab 2009b */

2012-02-10T23:02:37Z

On Windows using Visual Studio 2010 and Matlab 2009b

Mnguyen: /* On Windows using Visual Studio 2010 and Matlab 2009b */

2012-02-09T14:09:18Z

On Windows using Visual Studio 2010 and Matlab 2009b

← Older revision		Revision as of 14:09, 9 February 2012
Line 35:		Line 35:
	if you are using a 32-bit system. Otherwise change the extension to mexw64		if you are using a 32-bit system. Otherwise change the extension to mexw64

	* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the ~~eureqa_select_SUMO~~.cpp file.		* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the eureqa_select.cpp file.
	* Right click on eureqa_select in the Solution Explorer and select Properties		* Right click on eureqa_select in the Solution Explorer and select Properties
	** In C/C++ General add to "Additional Include Directory" the Matlab include directory (MatlabRoot\extern\include), the Eureqa API (the folder that contains the folder ''eureqa'', ''examples'' and the ''server'' folder) and the Boost include files		** In C/C++ General add to "Additional Include Directory" the Matlab include directory (MatlabRoot\extern\include), the Eureqa API (the folder that contains the folder ''eureqa'', ''examples'' and the ''server'' folder) and the Boost include files

Mnguyen: /* On linux */

2012-02-09T14:08:52Z

On linux

← Older revision		Revision as of 14:08, 9 February 2012
Line 15:		Line 15:
	* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets		* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets
	* Type in <code>make</code> in a linux terminal and the building process should start		* Type in <code>make</code> in a linux terminal and the building process should start
	* When the building process is done you will have eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.		* When the building process is done you will have a eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.

	===On Windows using Visual Studio 2010 and Matlab 2009b===		===On Windows using Visual Studio 2010 and Matlab 2009b===

Mnguyen: /* On linux */

2012-02-09T14:08:26Z

On linux

← Older revision		Revision as of 14:08, 9 February 2012
Line 14:		Line 14:
	* Extract the eureqa_select.zip which you can find in the EureqaModel folder		* Extract the eureqa_select.zip which you can find in the EureqaModel folder
	* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets		* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets
	* Edit Makefile to change FILE = eureqa_select -> FILE = '''eureqa_select_SUMO'''
	* Type in <code>make</code> in a linux terminal and the building process should start		* Type in <code>make</code> in a linux terminal and the building process should start
	* When the building process is done you will have eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.		* When the building process is done you will have eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.
	* Rename the mex file to eureqa_select.mexglx/mexa64

	===On Windows using Visual Studio 2010 and Matlab 2009b===		===On Windows using Visual Studio 2010 and Matlab 2009b===

Mnguyen: /* Installation */

2012-02-09T14:08:11Z

Installation

← Older revision		Revision as of 14:08, 9 February 2012
Line 5:		Line 5:
	* Go to [http://creativemachines.cornell.edu/eureqa the Eureqa website] and download the latest Eureqa standalone server for your operating system		* Go to [http://creativemachines.cornell.edu/eureqa the Eureqa website] and download the latest Eureqa standalone server for your operating system
	* Place the Eureqa server in the @EureqaFactory folder which is located in the src folder of the SUMO root.		* Place the Eureqa server in the @EureqaFactory folder which is located in the src folder of the SUMO root.
	* Make sure you have a mex compilation of the '''~~eureqa_select_SUMO~~.cpp''' which is based on code from Johannes Jenkner (which you can find [http://www.mathworks.com/matlabcentral/fileexchange/32225-interface-with-eureqa-featuring-symbolic-regression here]). There are two possibilities either the required mex file is already included with your SUMO installation in the contrib folder (a subfolder of the src folder) or you have to build it your self. You can check whether the mex is present by first configuring the toolbox (in the Matlab console type <code>configure</code> from the SUMO root) and then typing in <code>eureqa_select</code>. You will either see an instruction on how to the eureqa_select function or you will get an "Undefined function or variable 'eureqa_select'" error which means you will have to build or obtain the proper mex files.		* Make sure you have a mex compilation of the modified '''eureqa_select.cpp''' which is based on code from Johannes Jenkner (which you can find [http://www.mathworks.com/matlabcentral/fileexchange/32225-interface-with-eureqa-featuring-symbolic-regression here]). There are two possibilities either the required mex file is already included with your SUMO installation in the contrib folder (a subfolder of the src folder) or you have to build it your self. You can check whether the mex is present by first configuring the toolbox (in the Matlab console type <code>configure</code> from the SUMO root) and then typing in <code>eureqa_select</code>. You will either see an instruction on how to the eureqa_select function or you will get an "Undefined function or variable 'eureqa_select'" error which means you will have to build or obtain the proper mex files.

	==Building the mex files yourself==		==Building the mex files yourself==

Mnguyen: /* On linux */

2012-02-09T12:37:49Z

On linux

← Older revision		Revision as of 12:37, 9 February 2012
Line 16:		Line 16:
	* Edit Makefile to change FILE = eureqa_select -> FILE = '''eureqa_select_SUMO'''		* Edit Makefile to change FILE = eureqa_select -> FILE = '''eureqa_select_SUMO'''
	* Type in <code>make</code> in a linux terminal and the building process should start		* Type in <code>make</code> in a linux terminal and the building process should start
	* When the building process is done you will have ~~eureqa_select~~.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.		* When the building process is done you will have eureqa_select_SUMO.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.
			* Rename the mex file to eureqa_select.mexglx/mexa64

	===On Windows using Visual Studio 2010 and Matlab 2009b===		===On Windows using Visual Studio 2010 and Matlab 2009b===

Mnguyen: /* On linux */

2012-02-09T12:30:20Z

On linux

← Older revision		Revision as of 12:30, 9 February 2012
Line 14:		Line 14:
	* Extract the eureqa_select.zip which you can find in the EureqaModel folder		* Extract the eureqa_select.zip which you can find in the EureqaModel folder
	* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets		* Edit the Makefile to point to your Matlab install, the Boost include files, the Boost library files and the Eureqa API files. Note that you don't need the "<" and ">" brackets
	* Edit Makefile to change FILE = eureqa_select -> FILE = eureqa_select_SUMO		* Edit Makefile to change FILE = eureqa_select -> FILE = '''eureqa_select_SUMO'''
	* Type in <code>make</code> in a linux terminal and the building process should start		* Type in <code>make</code> in a linux terminal and the building process should start
	* When the building process is done you will have eureqa_select.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.		* When the building process is done you will have eureqa_select.mexglx file or a eureqa_select.mexa64 depending on your system architecture to put in the contrib folder.


	===On Windows using Visual Studio 2010 and Matlab 2009b===		===On Windows using Visual Studio 2010 and Matlab 2009b===

← Older revision		Revision as of 23:02, 10 February 2012
Line 26:		Line 26:
	* Create a new Win32 project -> click next and select empty project		* Create a new Win32 project -> click next and select empty project
	* Name the project ''eureqa_select''		* Name the project ''eureqa_select''
	* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost.		* Make sure you are working in ''Release'' mode if you only build the ''release'' version of Boost. You can change this in the ''Solution Configurations''
			* If you are using a 64-bit system, you need to change the ''Solution Platform" from ''Win32'' to ''x64''.
	* Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).		* Add mexversion.rc (matlab root\extern\include) to your project (Project -> Add Existing Item).
	* Create a .def file with the following text (Project -> Add New Item)		* Create a .def file with the following text (Project -> Add New Item)
Line 37:		Line 38:
	* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the eureqa_select.cpp file.		* Right click on "Resource Files" in the Solution Explorer and select add Existing Item and browse to the eureqa_select.cpp file.
	* Right click on eureqa_select in the Solution Explorer and select Properties		* Right click on eureqa_select in the Solution Explorer and select Properties
	** In C/C++ General add to "Additional Include Directory" the Matlab include directory (MatlabRoot\extern\include), the Eureqa API (the folder that contains the folder ''eureqa'', ''examples'' and the ''server'' folder) and the Boost include files		** In '''C/C++ General''' add to "Additional Include Directory" the Matlab include directory (MatlabRoot\extern\include), the Eureqa API (the folder that contains the folder ''eureqa'', ''examples'' and the ''server'' folder) and the Boost include files
	** In C/C++ Preprocessor properties add MATLAB_MEX_FILE as preprocessor definition		** In '''C/C++ Preprocessor properties''' add MATLAB_MEX_FILE as preprocessor definition
	** Under Linker General properties add to "Additional Library Directories" the folder MatlabRoot\extern\lib\win32 or win64\microsoft and the Boost library folder (BoostRoot\stage\lib)		** Under '''Linker General properties''' add to "Additional Library Directories" the folder MatlabRoot\extern\lib\win32 or win64\microsoft and the Boost library folder (BoostRoot\stage\lib)
	** Under Linker General properties change the value of Output File to ''$(OutDir)$(TargetName).mexw32/64'' depending on your architecture		** Under '''Linker General properties''' change the value of Output File to ''$(OutDir)$(TargetName).mexw32/64'' depending on your architecture
	** In Linker Input properties add to Additional Dependencies: ''libmx.lib'', ''libmat.lib'', ''libmex.lib'' and ''libboost_serialization-vc100-mt-1_48.lib'' (which should be in the Boost library folder).		** In '''Linker Input properties''' add to Additional Dependencies: ''libmx.lib'', ''libmat.lib'', ''libmex.lib'' and ''libboost_serialization-vc100-mt-1_48.lib'' (which should be in the Boost library folder).
	** Under Linker Command Line add: /export:mexFunction /dll		** Under '''Linker Command Line''' add: /export:mexFunction /dll
	* Click apply and wait for Visual Studio to process all this		* Click apply and wait for Visual Studio to process all this