# Created by Octave 3.2.4, Tue Nov 23 12:52:24 2010 EST <mockbuild@jetta.math.Princeton.EDU.private>
# name: cache
# type: cell
# rows: 3
# columns: 19
# name: <cell-element>
# type: string
# elements: 1
# length: 5
apply
# name: <cell-element>
# type: string
# elements: 1
# length: 1498
 -- Loadable Function: RETURN_VALUE = apply
          (@FUNCTION_HANDLE,CELL_ARRAY_OF_ARGS)
 -- Loadable Function: RETURN_VALUE = apply (@FUNCTION_HANDLE)
     Apply calls the function FUNCTION_HANDLE with the arguments of the
     cell array CELL_ARRAY_OF_ARGS which contains the actual arguments
     arg1,arg2,..., argn to the function, in that order. Apply invokes
     the function as FUNCTION_HANDLE(arg1, arg2, ... ,argn), where the
     arguments are extracted from each elements of the 1-row cell array
     CELL_ARRAY_OF_ARGS.

     Apply also works on array of function handles if FUNCTION_HANDLE
     is passed as a cell array of a handles; in this case apply,
     evaluates each function (using the handle) with the same arguments.

     The cell-array argument is optional second argument, in the form
     of a 1-row with multiple elements. The elements of the cell-array
     form the actual arguments supplied when invoking the  function
     FUNCTION_HANDLE.

     The return value depends on the function invoked, and the validity
     of the arguments.

            z=apply(@sqrt,cell([1,2; 3,4]));
            z=apply(@apply,cell(@sqrt,cell([1,2; 3,4])));
            apply(@sum,cell([1,2,3,4]))
            apply(@max,cell([1,2,3,4]))
            apply(@min,cell([1,2,3,4]))

     In first case, apply computes the sqrt of the matrix [1,2; 3,4];
     The second example is meta-apply, using apply on itself.  The rest
     of the examples invoke sum, max, min respectively.


# name: <cell-element>
# type: string
# elements: 1
# length: 80
Apply calls the function FUNCTION_HANDLE with the arguments of the cell
array CE

# name: <cell-element>
# type: string
# elements: 1
# length: 4
asci
# name: <cell-element>
# type: string
# elements: 1
# length: 688
 -- Function: [STRING] = asci ([COLUMNS])
     If this function is called without any input argument and without
     any output argument then print a nice ASCI-table (excluding
     special characters with hexcode 0x00 to 0x20) on screen with four
     columns per default. If this function is called with one output
     argument then return an ASCI-table string and don't print anything
     on screen. Finally, if this function is called with one input
     argument of type scalar then either print (no output argument) or
     return (one output argument) an ASCI-table with a number of
     columns given in COLUMNS.

     For example,
          A = asci (3);
          disp (A);


# name: <cell-element>
# type: string
# elements: 1
# length: 80
If this function is called without any input argument and without any
output arg

# name: <cell-element>
# type: string
# elements: 1
# length: 9
csv2latex
# name: <cell-element>
# type: string
# elements: 1
# length: 137
 You should have received a copy of the GNU General Public License
 along with this program; If not, see <http://www.gnu.org/licenses/>.

# name: <cell-element>
# type: string
# elements: 1
# length: 80
 You should have received a copy of the GNU General Public License
 along with t

# name: <cell-element>
# type: string
# elements: 1
# length: 4
grep
# name: <cell-element>
# type: string
# elements: 1
# length: 299
 -- Function File: [Y,F] =  grep ( x )
     This function is just to save typing and improve readability, as
     in foo(find(foo(:,p)),p) vs. grep(foo(:,p))

     You can use grep as follows,
          y = grep(x) = x(find(x))
          [y,f] = [x(find(x)),find(x)]

     See also: find, strfind



# name: <cell-element>
# type: string
# elements: 1
# length: 80
This function is just to save typing and improve readability, as in
foo(find(foo

# name: <cell-element>
# type: string
# elements: 1
# length: 12
infoskeleton
# name: <cell-element>
# type: string
# elements: 1
# length: 371
 -- Function File: infoskeleton (PROTOTYPE, INDEX_STR, SEE_ALSO)
     The function INFOSKELETON generates TeXinfo skeleton documentation
     of the given PROTOTYPE. Optionally INDEX_STR and SEE_ALSO can be
     specified.

     Usage of this function is typically,
          infoskeleton('[V,Q] = eig( A )','linear algebra','eigs, chol, qr, det')

     See also: info



# name: <cell-element>
# type: string
# elements: 1
# length: 80
The function INFOSKELETON generates TeXinfo skeleton documentation of
the given 

# name: <cell-element>
# type: string
# elements: 1
# length: 3
inz
# name: <cell-element>
# type: string
# elements: 1
# length: 264
 -- Function File: [ Y,F] = inz ( X )
     This function is just to save typing and improve readability, as in
     foo(find(foo(:,p)),p)  vs.  inz(foo(:,p))  y = inz(x) ==
     x(find(x)) - Indices of Non-Zeros [y,f] = [x(find(x)),find(x)]

     See also: grep



# name: <cell-element>
# type: string
# elements: 1
# length: 80
This function is just to save typing and improve readability, as in
foo(find(foo

# name: <cell-element>
# type: string
# elements: 1
# length: 3
map
# name: <cell-element>
# type: string
# elements: 1
# length: 1209
 -- Function File: RESULT =  map ( fun_handle, varargin )
     usage: result = map ( FUN_HANDLE, ARG1, ... )

     map, like Lisp's ( & numerous other language's ) function for
     iterating the result of a function applied to each of the data
     structure's elements in turn. The results are stored in the
     corresponding input's place. For now, just will work with cells and
     matrices, but support for structs are intended for future versions.
     Also, only "prefix" functions ( like "min(a,b,c,...)" ) are
     supported. FUN_HANDLE can either be a function name string or a
     function handle (recommended).

     Example:

          octave> A
          A
          {
            [1,1] = 0.0096243
            [2,1] = 0.82781
            [1,2] = 0.052571
            [2,2] = 0.84645
          }
          octave> B
          B =
          {
            [1,1] = 0.75563
            [2,1] = 0.84858
            [1,2] = 0.16765
            [2,2] = 0.85477
          }
          octave> map(@min,A,B)
          ans =
          {
            [1,1] = 0.0096243
            [2,1] = 0.82781
            [1,2] = 0.052571
            [2,2] = 0.84645
          }

     See also: reduce, match, apply



# name: <cell-element>
# type: string
# elements: 1
# length: 41
usage: result = map ( FUN_HANDLE, ARG1, .

# name: <cell-element>
# type: string
# elements: 1
# length: 5
match
# name: <cell-element>
# type: string
# elements: 1
# length: 922
 -- Function File: RESULT =  match ( FUN_HANDLE, ITERABLE )
     match is filter, like Lisp's ( & numerous other language's )
     function for Python has a built-in filter function which takes two
     arguments, a function and a list, and returns a list. 'match'
     performs the same operation like filter in Python. The match
     applies the function to each of the element in the ITERABLE and
     collects that the result of a function applied to each of the data
     structure's elements in turn, and the return values are collected
     as a list of input arguments, whenever the function-result is
     'true' in Octave sense. Anything (1,true,?) evaluating to true,
     the argument is saved into the return value.

     FUN_HANDLE can either be a function name string or a function
     handle (recommended).

     Typically you can use it as,
          match(@(x) ( x >= 1 ), [-1 0 1 2])
          [1, 2]


# name: <cell-element>
# type: string
# elements: 1
# length: 80
match is filter, like Lisp's ( & numerous other language's ) function
for Python

# name: <cell-element>
# type: string
# elements: 1
# length: 3
nze
# name: <cell-element>
# type: string
# elements: 1
# length: 295
 -- Function File: [Y,F] =  nze ( x )
     This function is just to save typing and improve readability, as in
     foo(find(foo(:,p)),p)  vs.  nze(foo(:,p))

                y = nze(x) ==  x(find(x)) - Non-Zero Elements
            [y,f] =        == [x(find(x)),find(x)]

     See also: grep



# name: <cell-element>
# type: string
# elements: 1
# length: 80
This function is just to save typing and improve readability, as in
foo(find(foo

# name: <cell-element>
# type: string
# elements: 1
# length: 12
read_options
# name: <cell-element>
# type: string
# elements: 1
# length: 1926
 -- Function File: [OP,NREAD] =  read_options ( args, varargin )
     The function read_options parses arguments to a function as,
     [ops,nread] = read_options (args,...) - Read options

     The input being ARGS a list of options and values.  The options
     can be any of the following,

     'op0'    , string : Space-separated names of opt taking no
     argument  <">

     'op1'    , string : Space-separated names of opt taking one
     argument <">

     'extra'  , string : Name of nameless trailing arguments.
      <">

     'default', struct : Struct holding default option values
     <none>

     'prefix' , int    : If false, only accept whole opt names.
     Otherwise, <0>                     recognize opt from first chars,
     and choose                     shortest if many opts start alike.

     'nocase' , int    : If set, ignore case in option names
       <0>

     'quiet'  , int    : Behavior when a non-string or unknown opt is
     met  <0>              0    - Produce an error              1    -
     Return quietly (can be diagnosed by checking 'nread')

     'skipnan', int    : Ignore NaNs if there is a default value.
     Note : At least one of 'op0' or 'op1' should be specified.

     The output variables are, OPS      : struct : Struct whose
     key/values are option names/values NREAD    : int    : Number of
     elements of args that were read

     USAGE
          # Define options and defaults
          op0 = "is_man is_plane flies"
          default = struct ("is_man",1, "flies",0);

                                       # Read the options

          s = read_options (list (all_va_args), "op0",op0,"default",default)

                                       # Create variables w/ same name as options

          [is_man, is_plane, flies] = getfields (s,"is_man", "is_plane", "flies")
          pre 2.1.39 function [op,nread] = read_options (args, ...)

     See also



# name: <cell-element>
# type: string
# elements: 1
# length: 80
The function read_options parses arguments to a function as,
[ops,nread] = read_

# name: <cell-element>
# type: string
# elements: 1
# length: 6
reduce
# name: <cell-element>
# type: string
# elements: 1
# length: 959
 -- Function File: X = reduce (FUNCTION, SEQUENCE,INITIALIZER)
 -- Function File: X = reduce (FUNCTION, SEQUENCE)
     Implements the 'reduce' operator like in Lisp, or Python.  Apply
     function of two arguments cumulatively to the items of sequence,
     from left to right, so as to reduce the sequence to a single
     value. For example, reduce(@(x,y)(x+y), [1, 2, 3, 4, 5])
     calculates ((((1+2)+3)+4)+5).  The left argument, x, is the
     accumulated value and the right argument, y, is the update value
     from the sequence. If the optional initializer is present, it is
     placed before the items of the sequence in the calculation, and
     serves as a default when the sequence is empty. If initializer is
     not given and sequence contains only one item, the first item is
     returned.

          	reduce(@add,[1:10])
          	=> 55
               reduce(@(x,y)(x*y),[1:7])
          	=> 5040  (actually, 7!)

     See also: map



# name: <cell-element>
# type: string
# elements: 1
# length: 57
Implements the 'reduce' operator like in Lisp, or Python.

# name: <cell-element>
# type: string
# elements: 1
# length: 9
rotparams
# name: <cell-element>
# type: string
# elements: 1
# length: 466
 -- Function File: [VSTACKED, ASTACKED] =  rotparams ( rstacked )
     The function w = rotparams (r)            - Inverse to rotv().
     Using, W    = rotparams(R)  is such that  rotv(w)*r' == eye(3).

     If used as, [v,a]=rotparams(r) ,  idem, with v (1 x 3) s.t. w ==
     a*v.

     0 <= norm(w)==a <= pi

     :-O !!  Does not check if 'r' is a rotation matrix.

     Ignores matrices with zero rows or with NaNs. (returns 0 for them)

     See also: rotv



# name: <cell-element>
# type: string
# elements: 1
# length: 62
The function w = rotparams (r)            - Inverse to rotv().

# name: <cell-element>
# type: string
# elements: 1
# length: 4
rotv
# name: <cell-element>
# type: string
# elements: 1
# length: 489
 -- Function File: R =  rotv ( v, ang )
     The functionrotv calculates a Matrix of rotation about V w/ angle
     |v| r = rotv(v [,ang])

     Returns the rotation matrix w/ axis v, and angle, in radians,
     norm(v) or ang (if present).

     rotv(v) == w'*w + cos(a) * (eye(3)-w'*w) - sin(a) * crossmat(w)

     where a = norm (v) and w = v/a.

     v and ang may be vertically stacked : If 'v' is 2x3, then rotv( v
     ) == [rotv(v(1,:)); rotv(v(2,:))]


     See also: rotparams



# name: <cell-element>
# type: string
# elements: 1
# length: 80
The functionrotv calculates a Matrix of rotation about V w/ angle |v| r
= rotv(v

# name: <cell-element>
# type: string
# elements: 1
# length: 10
slurp_file
# name: <cell-element>
# type: string
# elements: 1
# length: 309
 -- Function File: S =  slurp_file ( f )
     slurp_file return a whole text file F as a string S.

     F : string : filename S : string : contents of the file

     If F is not an absolute filename, and is not an immediately
     accessible file, slurp_file () will look for F in the path.

     See also



# name: <cell-element>
# type: string
# elements: 1
# length: 52
slurp_file return a whole text file F as a string S.

# name: <cell-element>
# type: string
# elements: 1
# length: 9
temp_name
# name: <cell-element>
# type: string
# elements: 1
# length: 519
 -- Function File: N =  temp_name ( rootname, quick )
     name = temp_name(rootname, quick=1) - Return a name that is not
     used

     Returns a name, suitable for defining a new function, script or
     global variable, of the form

     [rootname,number]

     Default rootname is "temp_name_"

     "quick" is an optional parameter, which defaults to 1. If it is
     false, temp_name() will find the smallest acceptable number for
     the name.  Otherwise, a hopefully quicker method is used.

     See also



# name: <cell-element>
# type: string
# elements: 1
# length: 69
name = temp_name(rootname, quick=1) - Return a name that is not used


# name: <cell-element>
# type: string
# elements: 1
# length: 5
units
# name: <cell-element>
# type: string
# elements: 1
# length: 804
 -- Function File:  units (FROMUNIT, TOUNIT)
 -- Function File:  units (FROMUNIT, TOUNIT, X)
     Return the conversion factor from FROMUNIT to TOUNIT measurements.

     This is an octave interface to the *GNU Units* program which comes
     with an annotated, extendable database defining over two thousand
     measurement units.  See `man units' or
     `http://www.gnu.org/software/units' for more information.  If the
     optional argument X is supplied, return that argument multiplied
     by the conversion factor.  Nonlinear conversions such as
     Fahrenheit to Celsius are not currently supported.  For example, to
     convert three values from miles per hour into meters per second:

          units ("mile/hr", "m/sec", [30, 55, 75])
          ans =

            13.411  24.587  33.528


# name: <cell-element>
# type: string
# elements: 1
# length: 66
Return the conversion factor from FROMUNIT to TOUNIT measurements.

# name: <cell-element>
# type: string
# elements: 1
# length: 8
xmlwrite
# name: <cell-element>
# type: string
# elements: 1
# length: 210
 -- Function File: NB = xmlwrite (FILENAME, VALUE)
 -- Function File: NB = xmlwrite (FD, VALUE, [NAME])
     Write a VALUE into FILENAME (FD) as a XML file.

     The number of elements (NB) or 0 is returned.


# name: <cell-element>
# type: string
# elements: 1
# length: 47
Write a VALUE into FILENAME (FD) as a XML file.

# name: <cell-element>
# type: string
# elements: 1
# length: 6
zagzig
# name: <cell-element>
# type: string
# elements: 1
# length: 627
 -- Function File:  zagzig (MTRX)
     Returns zagzig walk-off of the elements of MTRX.  Essentially it
     walks the matrix in a Z-fashion.

     mat =   1   4   7   2   5   8   3   6   9 then zagzag(mat) gives
     the output, [1 4 2 3 5 7 8 6 9], by walking as shown in the figure
     from pt 1 in that order of output.  The argument MTRX should be a
     MxN matrix. One use of zagzig the use with picking up DCT
     coefficients like in the JPEG algorithm for compression.

     An example of zagzig use:
          mat = reshape(1:9,3,3);
          zagzag(mat)
          ans =[1 4 2 3 5 7 8 6 9]


   See also: zigzag


# name: <cell-element>
# type: string
# elements: 1
# length: 48
Returns zagzig walk-off of the elements of MTRX.

# name: <cell-element>
# type: string
# elements: 1
# length: 6
zigzag
# name: <cell-element>
# type: string
# elements: 1
# length: 550
 -- Function File:  zigzag (MTRX)
     Returns zigzag walk-off of the elements of MTRX.  Essentially it
     walks the matrix in a Z-fashion.

     mat =   1   4   7   2   5   8   3   6   9 then zigzag(mat) gives
     the output, [1   2   4   7   5   3   6   8   9], by walking as
     shown in the figure from pt 1 in that order of output.  The
     argument MTRX should be a MxN matrix

     An example of zagzig use:
          mat = reshape(1:9,3,3);
          zigzag(mat)
          ans =[1   2   4   7   5   3   6   8   9]


   See also: zagzig


# name: <cell-element>
# type: string
# elements: 1
# length: 48
Returns zigzag walk-off of the elements of MTRX.

