 
Basics, Building SPICE Applications (MATLAB)
===========================================================================
 
   May 25, 2007
 
 
Note About HTML Links
--------------------------------------------------------
 
   The HTML version of this lesson may contain links pointing to various
   HTML documents provided with the Toolkit. All of these links are
   relative and, in order to function, require this document to be in a
   certain location in the Toolkit HTML documentation directory tree.
 
   In order for the links to be resolved, create a subdirectory called
   ``lessons'' under the ``doc/html'' directory of the Toolkit tree and
   copy this document to that subdirectory before loading it into a Web
   browser.
 
 
Environment Set-up
--------------------------------------------------------
 
   Use of Mice from MATLAB requires the Mice source and library directories
   exist in the MATLAB search path. MATLAB provides a programatic command
   to add directories to the search path, "addpath."
 
 
Unix/Linux
 
   Assume Mice is installed at /naif/mice/. The corresponding path to the
   Mice library being /naif/mice/lib; the path to the Mice source files
   being /naif/mice/src/mice.
 
      >> addpath( '/naif/mice/lib')
      >> addpath( '/naif/mice/src/mice')
 
 
Windows
 
   Assume Mice is installed at C:\naif\mice\. The corresponding path to the
   Mice library being C:\naif\mice\lib; the path to the Mice source files
   being C:\naif\mice\src\mice.
 
      >> addpath( 'C:\naif\mice\lib')
      >> addpath( 'C:\naif\mice\src\mice')
 
 
Confirm MATLAB can access Mice:
 
      >> which mice
 
   A proper response shows a path to the Mice interface library, similar
   to:
 
      /naif/mice/lib/mice.mexmaci
 
   The response
 
      'mice' not found.
 
   indicates the MATLAB search path does not include the Mice diectories
   ``src/mice'' and ``lib.''
 
 
A simple example program
--------------------------------------------------------
 
   This script calls the Mice function 'cspice_tkvrsn' then outputs the
   return value.
 
   File tk_ver.m:
 
      function tk_ver()
 
         disp( ['Toolkit version : ' cspice_tkvrsn('TOOLKIT') ] )
 
   From MATLAB, execute the function:
 
      >> tk_ver
      Toolkit version : CSPICE_N0061
 
