Download and Installation

Installing and running Homer3 if you do NOT have MATLAB:

Homer3 can be used via the MATLAB Runtime Environment if you do not own a MATLAB license.

Windows:

• Download and install the 64-bit MATLAB Runtime R2019b (9.7) for Windows from the Mathworks website.
• Download and install the Homer3 release from GitHub. Be sure to download the .zip file that matches your platform!
• Navigate to the homer3_install folder you have just downloaded and unzipped.
• 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 the 64-bit MATLAB Runtime R2019b (9.7) for Mac from the Mathworks website.
• Download and install the Homer3 release from GitHub. Be sure to download the .zip file that matches your platform!
• In Finder, navigate to the homer3_install folder you have just downloaded and unzipped.
• 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.

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 from source in MATLAB:

Homer3 is open-source MATLAB software and can easily be run from source with the MATLAB application.

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.

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.