Difference between revisions of "Homer Gui setup"

From LIBISIS
Jump to navigation Jump to search
m
m
 
(23 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Standalone Version Installation==
 
== Standalone Version Installation==
  
−
* Download the homer gui standalone zip file
+
* [[Download and setup LIBISIS#Download Stand Alone Homer|Download the homer gui standalone zip file]]
−
* Unzip all files
+
* 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.
−
* Double click "mcrinstall.exe" And follow the onscreen instructions. This creates the matlab runtime components so that libraries required by homer are installed.
+
* Unzip all files to a folder of your choice
−
* Run the file homer_ver0.exe to start homer
+
* 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:
 +
 +
  <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="Setting The Environment Variable In Pictures" widths="100px" heights="100px" perrow="6">
 +
image:to_system_1.jpg|open system
 +
image:to_system_2.jpg|system
 +
image:advanced.jpg|click advanced tab
 +
image:environ_var.jpg|click environment variables
 +
image:path.jpg|change the path variable
 +
</gallery>
  
 
== Matlab / Libisis version ==
 
== Matlab / Libisis version ==
Line 13: Line 40:
 
* <tt> >> homer_ver0</tt>
 
* <tt> >> homer_ver0</tt>
  
−
To open the homer gui
+
To open the homer gui. See instrument setup instructions below.
−
 
 
  
 
== Instrument Setup ==
 
== Instrument Setup ==
Line 22: Line 48:
 
For each instrument, there are five directories which need to be defined.  
 
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  
+
===input/output directories===
−
* indat.spedir -> this is where homer will write the SPE file to
+
 
 +
* 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
  
−
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.
 
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>
 
<pre>
−
if strcmp(instname,'mar')
+
   datadir='C:\mprogs\RAW\';
−
:
+
   mapdir='C:\mprogs\libisis\Instrument_files\mari_files\';
−
   indat.datadir='C:\mprogs\RAW\';
+
   maskdir='C:\mprogs\libisis\Instrument_files\mari_files\';
−
   indat.mapdir='C:\mprogs\libisis\Instrument_files\mari_files\';
+
   spedir='C:\mprogs\mari_spe\';  
−
   indat.maskdir='C:\mprogs\libisis\Instrument_files\mari_files\';
+
   paramdir='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>
 
</pre>

Latest revision as of 12:57, 28 August 2008

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.


  • Setting The Environment Variable In Pictures

  • open system

  • system

  • click advanced tab

  • click environment variables

  • change the path variable

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\';
Retrieved from "http://libisis.org/index.php?title=Homer_Gui_setup&oldid=2788"