Salome HOME
Join modifications from branch BR_DEBUG_3_2_0b1 05Jun06
[modules/med.git] / README
1 This is the Med Memory package V3.2.0
2
3 I : Major evolution of the Med Memory package between V2.2.x and V3.2.x :
4 =========================================================================
5
6 The Med Memory may be used as a stand alone package with only the C++ and the
7 python layers (adding --without-kernel at the configure step). In this case
8 there are no links with the SALOME KERNEL.
9
10 In this version,
11
12 - mesh defined with polygones/polyhedra mixed with usual types of cells;
13
14 - the Med File drivers of the Med Memory support the V2.1 as well as the
15   V2.2 versions of the Med File layer. The requirement of the Salome platform
16   is only Med File V2.2, the V2.1 version is emberked in the Med Memory.
17
18 - Using the Med file (V2.1 and V2.2) and GIBI drivers; fields laying on a
19   partial support;
20
21 - Fields defined on cells mesh with multiple gauss points,
22
23 may be mounted in memory and treated.
24
25 With all those new functionalities, most of the Med Memory client codes
26 based on previous releases of the Med Memory should work; but minor changes
27 should be done for the get/set field classes methods:
28
29 - the getValue() and the setValue(T *) methods take no MED_EN::medModeSwitch
30   parameter;
31 - the getValueI (resp. setValueI) should be replaced by getRow(int )
32   (resp. setRow(int ,T*) if the field is in full interlacing mode (using the
33   method getInterlacingType() of the classe FIELD_). If the field is stored in
34   no interlacing mode getValueIJ (resp. setValueIJ) should be replaced by
35   getColumn(int ) (resp. setColumn(int ,T*)).
36
37 Intensive debugging was carried throughout the entire Med Memory C++ Layer:
38
39   - especially on the major user's C++ classes (such as MED, MESH,
40     SUPPORT and FIELD);
41
42   - the C++ drivers classes on those major classes. Especially the
43     Med File and the GIBI drivers are read/write ones. The VTK drivers
44     are only for the writing; and finally the PORFLOW drivers may only
45     be used for the MESH class in the reading mode.
46
47 The Med Client layer of the Med Memory has been tested in a full
48 Server/Client configuration.
49
50 II : MedMemory building and installation :
51 =========================================
52
53 It's very simple :
54
55 ./configure --prefix=path_to_your_installation_directory
56 make
57 make install
58
59 eventually if the user or the installer needs to build an installation of Med
60 Memory as a stand alone package, he may use the configure option
61 --without-kernel. By default the full debug options are set:
62       - compilation using -g option
63       - Med Memory debugging information history using -D_DEBUG_ option.
64
65 The user may get all configure option with :
66   ./configure --help
67
68 The user may set optimization option :
69   ./configure --enable-production --disable-debug (use compiler flags -O)
70
71 In order to avoid most of the problem the user or the installer should first
72 check the HDF5HOME and the MED2HOME environment variables. This version of
73 Med Memory with Med File V2.2.2, V2.2.3, as well as V2.3.0 but with the
74 version of HDF5 V1.6.3. In the installation of Med File you should take care
75 of the $HDF5HOME environement variable. This warning is especially intended
76 to the user of The Med Memory in stand alone (without the SALOME KERNEL
77 component).
78
79 III : MedMemory testing :
80 =========================
81
82 After installation of the Med Memory; the user may find a large set of test
83 files in Med File V2.1, V2.2, GIBI format.
84
85 To check the Med Memory installation, in the directory
86 path_to_your_installation_directory/bin/salome you may find a set of python
87 scripts and test executable. To ckeck the deep layers (C++, Python) of the Med
88 Memory, the installer may run:
89
90 - testMedMemGeneral.py,
91 - medMeshing_test.py
92 - test_profil_MedFieldDriver.py
93 - testGaussLocalization.py
94 - med_field_anal.py
95 - test_MEDMEM_MeshingFlica
96 - test_MEDMEM_Meshing_poly
97 - test_MEDMEM_MeshingPoly
98
99 To check the upper layer (CORBA, Client), the installer may run in the SALOME
100 Python consol:
101
102  - Med_Gen_test.py
103  - medClient_test.py
104  - testMedAlliances1.py
105  - testMedAlliances.py
106  - testMeshAlliances.py