Skip to content

Download and Installation

David Boas edited this page Sep 29, 2022 · 37 revisions
Clone this wiki locally

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, source file code from Homer3 release.
  • Use a folder navigation tool, such as File Explorer (Windows) or Finder (MAC), to navigate to the folder containing the downloaded zip dirctory. Unzip it.
  • Open MATLAB and in the Command Window or Current Folder window change the current folder to the unzipped AtlasViewer root folder. Then in the Command Window, type
 >> setpaths

This will set all the required Matlab search paths for Homer3. NOTE: This step is required only once in a single MATLAB session.

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.