Getting started with Homer3

Installing and running Homer3 if you do NOT have MATLAB:

Windows:

• Download and install the 64-bit MATLAB Runtime R2017b (9.3) for Windows from the Mathworks website. Other versions of the MATLAB Runtime environment are not supported!
• Download the latest release for Windows, the win...zip file from Homer3 release release from GitHub.
• In File Explorer, navigate to folder containing the downloaded zip file, right click on it and select the zip tool to unzip it.
• Go into the newly unzipped homer3_install folder and double click on the file setup.bat (DO NOT click on setup.exe). This should start the installation process. When it finishes you should see an Homer3 icon on your Desktop.
• You can now execute the Homer3 by double-clicking the Homer3 shortcut on the Desktop.

Mac:

Modern MacOS security features may prevent you from running the Homer3 installation executable. To circumvent them:

• Open Terminal and execute the following command:

sudo spctl --master-disable

• Open System Preferences and navigate to System & Privacy / General
• Click the lock symbol at the bottom of the dialog and enter administrator password, then select "Anywhere" option at the bottom of the dialog.

You will need administrator privileges on the Mac you are using to do this. If you cannot get them, you will need to run Homer3 from source in MATLAB or install it via a Windows virtual machine.

• Download and install the 64-bit MATLAB Runtime R2017b (9.3) for Mac from the Mathworks website. Other versions of the MATLAB Runtime environment are not supported!
• Download the latest release for Mac, the mac...zip file from Homer3 release release from GitHub.
• In Finder, navigate to folder containing the downloaded zip file and double click on it to unzip it.
• Go into the newly unzipped homer3_install folder and double click on the file setup.command (DO NOT click on setup with the matlab icon). This should start the installation process. When it finishes you should see an Homer3 icon on your Desktop.
• You can now execute the Homer3 by double-clicking the Homer3.command shortcut on the Desktop.

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. It is highly recommended that you use MATLAB version R2017b because some Homer3 display features do not work as well in later MATLAB version.

• Download the latest Homer3 source release, the Source code file from Homer3 release.
• Open MATLAB and 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 is required each time the MATLAB application is started.

At this point you should be ready to start Homer3 from the MATLAB command window by running

 >> Homer3

Then, navigate to a folder and select it to open it.