Download and setup LIBISIS

By downloading any of the files below, you accept the terms of the Matlab MCR Library License included with the distribution. Read the COPYING.rtf file in the License folder for information about which components may or may not be changed or redistributed.

If you have any problems, email the libisis-users mailing list.

Download Stand Alone Homer

• If you do not have matlab it is possible to download an executable which will run the homer GUI standalone
• Homer software created by Dr. Dickon Champion, standalone installation developed by Dean Whittaker. MCRInstaller and Matlab (c) The MathWorks, Inc. 1984-2008

Windows	Linux	MacOS
Stand Alone Homer - the standalone homer zip file MCRInstaller - required for the first run of homer.	not available	not available

you must set up Homer properly in order for it to work. Run the MCRInstaller once on your computer, if updating your homer installation, it is not required.

Install Stand Alone Homer

• The First time you download homer:
  • Download the MCRInstaller file above
  • Run the MCRInstaller.exe file and follow the on-screen instructions
• Download the homer zip file above
• Unzip to directory of your choice
• Run homer.exe to start homer.

Requirements

• 1GB RAM memory
• 40MB free hard drive space
• Administrative Rights for Installation.

Download LIBISIS

• Download the latest libisis build for your version of matlab,(currently the only download will work with Matlab 2007a or later)

Windows	Linux	MacOS
Matlab Ver 7.1 Matlab 2006a Matlab 2006b Matlab 2007a Matlab 2007b	not available at the moment, requires extra rpms	not available at the moment

Windows

• Unpack this file into C:\mprogs or a directory of your choice eg X:\analysis

Requirements

• Matlab 2007a (or later)
• 1GB RAM memory
• 40MB free hard drive space

Setup Paths

• Copy the libisis_start.m file into C:\mprogs or into the directory where your matlab starts

This bit need to be added to libisis_start.m

%%------------------------------------------------------------------------------
STRING = [ipath '/matlab/homer_gui/instrument_setup'];
    if(isdir(STRING))
        addpath (STRING);
    end 
%%-------------------------------------------------------------------------------

do not edit required_fields.txt - only edit the maps.txt or merlin.txt files

• there are two ways you can make sure the paths are set in the matlab instance
  • call the libisis_start function from the command line, with the name of the libisis directory which was unpacked see the example below
  • or you can add the line below into your startup.m, the path to the libisis_start function must of course be in the matlab path, so you may have to add C:\mprogs or X:\analysis to the path in the startup.m already

>> libisis_start('C:\mprogs\libisis_2008_01_18_1356')
>>
>> libisis_start('X:\analysis\libisis_2008_01_18_1356')

Setup Memory Usage

Sometimes when we are treating large datasets, such as on MAPS, we cannot load all the data into the memory of the computer at once, we need to 'chunk' the data into smaller pieces. We therefore need to set the default number of workspaces in each 'chunk' to treat at any one time during the population of an IXTrunfile and the total amount of memory to allow the computer to use.

If the memory required for the number of workspaces in each chunk is greater than that defined then the number of workspaces is reduced until it fits in the memory or a failure status is raised. These two values are defined in ./matlab/homer/default_homer_nchunk.m which needs to be edited to suit the memory needs of your computer. Tests have shown that LIBISIS will populate data fastest when it is chunked in groups of 100 workspaces, so this is the default value in the file.

function nchunk=default_homer_nchunk
% nchunk = default_homer_nchunk
% nchunk is a two membered array
% the first element is the default number of workspaces to be treated at 
% one time, and the second element is the maximum amount of memory (in MB)
% that you want the computer to use
nchunk=int32([100,500]);