README
1
2----------------------------------------------------------------------
3 Introduction
4----------------------------------------------------------------------
5
6 * This is a MEX (Matlab EXecutable) interface for G+SMO.
7
8----------------------------------------------------------------------
9 Dependecies
10----------------------------------------------------------------------
11
12 To generate the .mex files, you need mex (comes with MATLAB).
13
14 To use the .mex files in MATLAB, you need MATLAB.
15
16----------------------------------------------------------------------
17 Source tree
18----------------------------------------------------------------------
19
20 ./ : contains this file (README) and a license file for the
21 classHandle.
22
23 /include : contains relevant headers (currently only a header for
24 safe memory treatment of classes, authored by Oliver
25 Woodward, see license.txt).
26
27 src/ : contains the mex source class definitions (gateways between
28 C++ and MATLAB).
29
30 m/ : constains mostly MATLAB class definitions file. Each of these
31 call the relevant mex file. Also contains a test script
32 testTHBSplineBasis.m.
33
34----------------------------------------------------------------------
35 Using the Gismo class in MATLAB
36----------------------------------------------------------------------
37
38 * Make sure that the gs* methods are in the MATLAB path.
39
40 * To construct an instance of gsTHBSplineBasis from an input file:
41 > hbs = gsTHBSplineBasis(file);
42
43 * To inspect the available methods for that class:
44 > methods(hbs);
45
46 * To get help on the method 'support':
47 > help gsTHBSplineBasis/support
48
49 * To test the gsTHBSplineBasis:
50 > gsTestTHBSplineBasis
51
52----------------------------------------------------------------------
53 Notes
54----------------------------------------------------------------------
55
56 * All type-checking is done in the m-files, while practically no
57 validations of the input and output arguments are performed in the
58 mex-file 'work horse'.
59
60----------------------------------------------------------------------
61 Issues
62----------------------------------------------------------------------
63
64 * If you experience linking problems relating to libstdc++.so and
65 GLIBCXX:
66
67 -> This could be because Matlab uses an old shared object file
68 (e.g. /usr/local/matlab/R2012a/sys/os/glnx86/libstdc++.so.6). This
69 could perhaps be resolved by replacing that link with a link to
70 a newer shared object file in your installation
71 (e.g. /usr/lib/i386-linux-gnu/libstdc++.so.6). Or even better:
72 by enforcing the use of this at the time of linking.
73
74 * If you experience errors like "Unknown symbol: _ZN" when running a
75 mex function:
76
77 -> In Linux, try updating the LD_LIBRARY_PATH to include the
78 directory in which the gismo shared library (libgismo.so) is
79 located. In bash:
80
81 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/shared/library/folder
82
83 This pertains to the development phase. When gismo is installed,
84 the shared library should be found without any difficulties.
85
86----------------------------------------------------------------------
87 Author: Peter Noertoft
88----------------------------------------------------------------------
89