Download and Installation

Download

See also: Updating Homer3 with Git

Download the Homer3 repository using git. Alternatively, go to Homer3 home page and click the green "Clone or download" button on right. Then click "Download ZIP" right below the green button. Once you have downloaded the zip file, unzip it.

In addition to this if you do NOT have Matlab installed on your computer you will want to be able to run the executable that is included in the project. To do this follow this additional step:

Windows:

Download and install the 64-bit MATLAB Runtime R2019b (9.7) for Windows from the Mathworks website.

Mac:

Download and install the 64-bit MATLAB Runtime R2019b (9.7) for Mac from the Mathworks website.

Installation

Installing and running Homer3 if you do NOT have Matlab:

Windows:

• Download and install Homer3 and MATLAB Runtime for Windows (R2019b version is recommended).
• In File Browser (or Windows Explorer in older Windows versions) navigate to the homer3 root folder you have just downloaded and unzipped.
• Go into the Install folder and find and unzip the file homer3_install_win.zip. Please make sure that the unzipped folder is called homer3_install. If this folder already existed because of an older version, then you must rename that folder before unzipping this new install file.
• Go into the newly created homer3_install folder and double click on the file setup.bat. This should start the installation process. When it finishes you should see a Homer3 icon on your Desktop.
• You can now execute Homer3 by double clicking the Homer3 icon on the desktop.

Mac:

• Download and install Homer3 and MATLAB Runtime for Mac (R2019b version is recommended).
• In Finder navigate to the homer3 root folder you have just downloaded and unzipped.
• Go into the Install folder and find and unzip the file homer3_install_mac.zip. Please make sure that the unzipped folder is called homer3_install. If this folder already existed because of an older version, then you must rename that folder before unzipping this new install file.
• Go into the newly created homer3_install folder and double click on the file setup.command. This should start the installation process. When it finishes you should see a Homer3.command icon on your Desktop along with a link to a sample data folder called 'SubjDataSample'.
• You can now execute Homer3 by double clicking the Homer3.command icon on the desktop.

For either Mac or Windows Homer3 it will open by default in the sample subject folder that came with the installation. You will be asked to choose a processing options config file. Select the only one available, test_process.cfg. Once selected Homer3 should open the test.snirf data file. You are now ready to use Homer3 to work with this data.

Installing and running Homer3 if you have Matlab:

Open Matlab and in the command window, change the current folder to the Homer3 root folder that you downloaded. In the command window, type

 >> setpaths

This will set all the required matlab search paths for Homer3. Note: this step should be done every time a new Matlab session is started.

At this point you should be ready to start Homer3 from the Matlab command window.

To run:

• Type Homer3 in the command window.

• Navigate to a subject folder and select to open it.

• Homer3 will ask you to choose a processing options config file. If you do not have one to select, click the CANCEL button and a default config file will be generated for you.