View source for Homer Gui setup

== Standalone Version Installation==

* Download the homer gui standalone zip file
* Unzip all files to a folder of your choice
* Double click "homer_pkg.exe" and follow the onscreen instructions. 
* 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. 
* Set the environment variable for the .dll folder as described 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:

<tt> ;<path of homer>\dll</tt>

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.


<gallery caption="Sample gallery" widths="100px" heights="100px" perrow="6">
image:to_system_1.jpg
image:to_system_2.jpg
image:advanced.jpg
image:environ_var.jpg
image:path.jpg
</gallery>


[[image:to_system_1.jpg|none|thumb]][[image:advanced.jpg|none|thumb]] 
[[image:environ_var.jpg|none|thumb]] [[image:path.jpg|none|thumb]]

== Matlab / Libisis version ==

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

* <tt> >> homer_ver0</tt>

To open the homer gui


== Instrument Setup ==

To set up the Homer GUI interface you must define instrument related directories in the text files located in the <tt>instrument_setup</tt> 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

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

parameter directories

* indat.mapdir -> this is where your instrument map files are kept
* indat.maskdir -> this is where your instrument mask files are kept
* indat paramdir -> this is where your instrument parameter files are kept
These files for each instrument are supplied with the libisis distribution in <tt>./matlab/Instrument_files</tt>. 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.

<pre>
if strcmp(instname,'mar')
:
   indat.datadir='C:\mprogs\RAW\';
   indat.mapdir='C:\mprogs\libisis\Instrument_files\mari_files\';
   indat.maskdir='C:\mprogs\libisis\Instrument_files\mari_files\';
   indat.spedir='C:\mprogs\mari_spe\'; % defines the directory to output SPE files to
   indat.paramdir='C:\mprogs\libisis\Instrument_files\mari_files\';
:
end
</pre>