Homer Gui setup

From LIBISIS
Jump to: navigation, search

Standalone Version Installation

  • Download the homer gui standalone zip file
  • If this is the first time you have installed homer then download and run MCRInstaller.exe on your computer. This requires administration rights. Upgrades do not require this step.
  • Unzip all files to a folder of your choice
  • Set the environment variable for the .dll folder as described below.
  • Homer is now installed. Run the file homer.exe to start homer. DO NOT change the location of this file (or the names of files and folders). If required, create shortcuts.
  • See the Instrument Setup instructions below.


Setting Up The Environment Variable

  • Go to the system control panel
  • Click the "Advanced" tab
  • Click on the environment variables button
  • If you have administrator privileges, then edit the variable named path in the system variables and append the following to the value:
  ;<path of homer>\dll
 e.g. ;c:\homer\dll
  • if you do not have adimistrator privileges, click "new" under the user variables part and add the variable named path and value as above.


Matlab / Libisis version

This is typically contained in the folder applications/homer_gui . In matlab, when running libisis simply type

  • >> homer_ver0

To open the homer gui. See instrument setup instructions below.

Instrument Setup

To set up the Homer GUI interface you must define instrument related directories in the text files located in the instrument_setup folder contained in the main folder. Each instrument has it's own text file. There is also a file called required_fields.txt that contains the field names that MUST be entered. This may also be changed (but not deleted).

For each instrument, there are five directories which need to be defined.


input/output directories

  • datadir -> this is where your raw data is kept
  • spedir -> this is where homer will write the SPE file to


parameter directories

  • mapdir -> this is where your instrument map files are kept
  • maskdir -> this is where your instrument mask files are kept
  • paramdir -> this is where your instrument parameter files are kept


These files for each instrument are supplied with the libisis distribution in ./matlab/Instrument_files. An example set for the mari instrument is defined below, there are many other values which are defined in this file, ask your instrument scientist if there are any particular default settings which have been changed for your experiment, such as whitebeam integration limits or background subtraction limits.


   datadir='C:\mprogs\RAW\';
   mapdir='C:\mprogs\libisis\Instrument_files\mari_files\';
   maskdir='C:\mprogs\libisis\Instrument_files\mari_files\';
   spedir='C:\mprogs\mari_spe\';   
   paramdir='C:\mprogs\libisis\Instrument_files\mari_files\';