Differences

This shows you the differences between two versions of the page.

--- neuroelf_installation [2011/05/12 18:32] – added installation video jochen
+++ neuroelf_installation [2011/08/15 14:09] (current) – Updated text for Windows MEX compiler selection jochen
@@ Line 10: / Line 10: @@
 ===== Process =====
-{{ youtube>DktIMfu9UM8?320x180| NeuroElf v0.9c installation (video demonstration)}}
+{{ youtube>DktIMfu9UM8?320x204| NeuroElf v0.9c installation (video demonstration)}}
 To install NeuroElf, please download the current version from the [[http://neuroelf.net/|main page]] (either the installer or flat folder/snapshot).
@@ Line 59: / Line 59: @@
   * whereas many toolboxes require to add several folders to the path, NeuroElf only needs it main folder to be added
   * the [[xff]] format files (text files that contain the instructions on how exactly to read/write different file formats) are parsed only once and the result is stored under ''_files/cache/cache.mat''; it is thus important that this folder is writable to the toolbox (particularly when the format files are updated!)
-  * additional files can be created by using [[neuroelf_makefiles]] (see its page for settings); but as this might take quite a while to complete with full settings, there is a prepared file for download containing all files: [[http://neureolf.net/NeuroElf_v09c_colin_aux.zip|NeuroElf_v09c_colin_aux.zip]] --after downloading the files from this archive should be unzipped into the ''_files/colin'' subfolder of the installation
+  * additional files can be created by using [[neuroelf_makefiles]] (see its page for settings); but as this might take quite a while to complete with full settings, there is a prepared file for download containing all files: [[http://neuroelf.net/NeuroElf_v09c_colin_aux.zip|NeuroElf_v09c_colin_aux.zip]] --after downloading the files from this archive should be unzipped into the ''_files/colin'' subfolder of the installation
   * support for [[http://www.gnu.org/software/octave/|GNU Octave]] is very preliminary (reading, altering, and writing files should work, but no GUI functionality is available!)
+===== Errors / warnings during installation =====
+Given that the setup function (''neuroelf_setup'') will try to compile some C-based code into MEX files (see [[NeuroElf MEX files]] for infos), it is possible that you will see some warning or error messages in case your system doesn't have a functional compiler installed or setup in Matlab. These error messages should only occur the first time you set up a particular NeuroElf version!
+In that case, the setup function will try to copy the MEX files that come with the package into the NeuroElf installation folder, after which all subsequent routines should work without further problems.
+**Note: On Windows machines that don't have a compiler installed, the ''mex'' function still asks to select a compiler and upon selecting "none" (0), the function exits without error. One user reported that it might be necessary to 1.) keep selecting ''0'' for each of the MEX files to be compiled, which is about 30 times, during the installation of NeuroElf (''NeuroElf_v0XY -i'' internally runs ''neuroelf_setup'') and then 2.) manually re-run the ''neuroelf_setup'' function again so that the MEX files are properly copied into the installation folder.**
+If you receive further warning/error messages about missing MEX files, the platform you're using is not supported (as of yet) by pre-built MEX files, and I would like to ask you to get in touch with me (at info _at_ neuroelf _dot_ net), so that I can add support for this platform by adding compiled files accordingly (for which I might require your assistance and some patience...).
 ===== Installation folder structure =====