Image Evaluation Tools

ISET 3.0

  1. Purchase, Download and Install ISET
  2. Path Management
  3. License and Key Installation
  4. WARNINGS

 

Purchase, Download and Install

  1. Contact ImagEval to obtain the password to unzip the downloaded software and to purchase a ISET License number .
  2. Once you have downloaded and unzipped ISET-3.0, there remain a few steps you should follow to install the program.

 

Path Management

The main purpose of these instructions is to make sure that your MATLAB® path is set up correctly for your version of MATLAB®. 

We refer to the location of the ISET-3.0 directory on your system as ISETDIR.  For example, this might be ‘C:\MATLAB7\work\ISET-3.0’.

1.  [Required]. ISET-3.0 is distributed containing MEX-files that are compiled for different versions of MATLAB®.  We recommend that you keep only the directory with MEX-files that are appropriate for your MATLAB® version.  To do this 

You only need to do this once.

2.  [Required]. Next, you must set the MATLAB® path to include the directories containing ISET-3.0 functions.  The function (isetPath.m), located in ISETDIR, automates the process of setting the MATLAB® path. 

After you start MATLAB®, you should type

cd ISETDIR
isetPath(pwd) 

This will include the ISET-3.0 functions on your path for this session.

3.  [Optional] Notice that to run isetPath(), you had to change to the ISETDIR.  That is because isetPath() may not always be on your MATLAB® path.  We have a suggestion about how you should manage your MATLAB® paths.  We have found this method helpful because in our work we use many different MATLAB® packages.

Now, whenever MATLAB® starts, it will have the directory ‘C:\MATLAB7\work\paths’ on its path.  Hence, you can run isetPath(ISETDIR) without changing to the ISET-3.0 directory. The ISET-3.0 routines will be added to your MATLAB® path for that session. 

We suggest that you create functions like isetPath() to control the MATLAB® path when you are running other packages.

4.  Finally, if you would like to include the ISET-3.0 directories on your path every time you open up MATLAB®, you can follow the following simple procedure.

Create a script in a file called ‘startup.m’ and place it inside of ‘C:\MATLAB7\work\paths’.  Each time you start MATLAB®, this script will be invoked.  If the script contains the lines

isetPath(ISETDIR);

the ISET-3.0 functions will be added to your path each time you start MATLAB®.  If you would like to be given the option of running ISET-3.0 or another package, the startup.m file might contain simple code such as

isetDir = 'C:\MATLAB7\work\ISET-3.0;
pdcDir = 'c:\MATLAB7\work\PDC; 
R = input('Enter: 1 (ISET) or 2 (PDC) or 3(NONE):'); 
switch R  
case 1
isetPath(isetDir);
case 2
pdcPath(pdcDir);
otherwise
disp('No ISET, PDC or VISTA set.')
end 
clear R

 

License and Key Installation

To use ISET, open MATLAB®

cd (change directory) to the ISET-3.0 directory
type "d=pwd;"
then type "isetPath(d)"
then type "ISET"

The main ISET window will open.  Before you can run ISET,

  1. Select the "Store License" option from the Initialize menu in the main ISET window
    Type in the license number that we sent you
  2. Select the "Get Key" option from the Initialize menu
    This will open a web browser : Answer all the questions and submit
    Be sure to use your correct user name, correct email address, and organization
    This will be compared to information in our database and if it matches, you will be sent a key via email.  After you recieve your license key, copy the key and ....
  3. Select the "Store Key"
    Paste the key into the window that is opened and select "OK"
  4. Select the "Verify License and Key" option in the main ISET menu

You only need to follow the procedure described above the first time you launch ISET.
Thereafter, you only need to set your isetPath and type ISET.

Microsoft Visual C Libraries (dll)

ISET requires certain system libraries relating to Visual C be in the WINDOWS\SYSTEM2 folder. These dlls are present on most systems, but we have had reports of cases in which the libraries are absent. If ISET does not run properly, please check to see that these two libraries (msvcp70.dll and msvcr70.dll) are in the WINDOWS\SYSTEM32 folder.

If these file are NOT in your system folder, then copy them from the ISET distribution to the WINDOWS\SYSTEM32 folder. Specifically, copy

ISET-3.0\dll70\msvcp70.dll
ISET-3.0\dll70\msvcr70.dll
 
to

WINDOWS\SYSTEM32

 

Mathworks Software Bug

The Mathworks web-site reports a problem with the Image Processing Toolbox (version 5.0 and 5.0.1). This problem concerns the important function imshow.m. An explanation of the software bug and a corrected copy of imshow.m can be obtained from Mathworks.

WARNING: If you are running the MATLAB® Image Processing Toolbox versions 5.0 and 5.0.1, you must correct this problem for ISET 1.0 to work properly. (Type "ver" in the Matlab command window to determine version of the Image Processing Toolbox. ) There is no need to change imshow.m for versions 4.2 or 5.0.2.

The Mathworks instructions for how to correct the problem are clear and involve the following steps:
1. Using Windows, browse to your directory C:\MATLAB701\toolbox\images\imuitools
2. In that directory, rename the file imshow.m to imshow.m.old
3. Place the corrected version of imshow.m (which you can download now) in that directory
4. The next time you start MATLAB®, type: rehash toolboxcache.