doc/en/tutorials.rst

   1 Examples
   2 ########
   3 .. index:: single: example
   4 .. index:: single: python
   5
   6 One will find here the instructions python for some characteristic configurations. The associated data files are downloadable. It is necessary to think of adapting the value of the variable ``data_dir``: it is the directory in which the files med will have been recorded.
   7 It is in the directory ``dircase`` that the files will be written resulting from the successive adaptations. This directory is created by default in ``/tmp``.
   8
   9 Loading of the module HOMARD
  10 ****************************
  11 .. index:: single: YACS
  12
  13 The loading of the module HOMARD is done in a way similar to the other modules.
  14
  15  ::
  16
  17   import HOMARD
  18   homard = salome.lcc.FindOrLoadComponent('FactoryServer','HOMARD')
  19   homard.SetCurrentStudy(salome.myStudy)
  20
  21 To use the module HOMARD within a distributed scheme YACS, the loading is made as follows:
  22
  23  ::
  24
  25   import HOMARD
  26   my_container.load_component_Library('HOMARD')
  27   homard = my_container.create_component_instance('HOMARD',0)
  28   homard.SetCurrentStudy(salome.myStudy)
  29
  30 Uniform refinement
  31 ******************
  32 .. index:: single: refinement;uniform
  33
  34 One will make here three successive uniform refinements of the mesh contained in the file ``tutorial_1.00.med``. Some notes:
  35   * the same hypothesis is used with each iteration
  36   * the produced mesh always bears the same name. That does not pose a problem because it is stored in different files.
  37
  38
  39 .. literalinclude:: ../files/tutorial_1.py
  40    :lines: 52-85
  41
  42 .. note::
  43   Download the files
  44
  45   * :download:`initial mesh<../files/tutorial_1.00.med.gz>`
  46   * :download:`python script<../files/tutorial_1.py>`
  47   * :download:`python script for the compression<../files/tutorial_util.py>`
  48
  49
  50
  51 Refinement by zones
  52 *******************
  53 .. index:: single: zone
  54
  55 One proceeds here to refinement according to zones. To pass from the initial mesh to the mesh 'M_1', one uses a box framing the z=1 plane and a sphere centered on the origin with radius 1.05. Then to pass from the mesh 'M_1' to the mesh 'M_2', one replaces the sphere by a box framing the cube on side 0.5, pointing on the origin and the meshes in the very first zone are unrefined.
  56
  57 .. literalinclude:: ../files/tutorial_2.py
  58    :lines: 52-95
  59
  60 .. note::
  61   Download the files
  62
  63   * :download:`initial mesh<../files/tutorial_2.00.med.gz>`
  64   * :download:`python script<../files/tutorial_2.py>`
  65   * :download:`python script for the compression<../files/tutorial_util.py>`
  66
  67
  68 Refinement driven by a field
  69 ****************************
  70 .. index:: single: field
  71
  72 One proceeds here to refinement according to a field. The hypotheses are used to define the name of the field and the thresholds of refinement/unefinement. The input of the file and the instants is made in the iteration. Fields on the nodes or the elements are interpolated.
  73 To adapt the H_1 mesh resulting from the Iter_1 iteration, two alternatives are applied. In the first, Iter_2, the field is a scalar field of indicators of error and one cuts out the 1.5% of elements where the error is largest. In the second alternative, Iter_2_bis, one is based on a vector field and one examines the jump of this vector between an element and its neighbors: one will cut out where the infinite standard of this jump is higher than the absolute threshold of 0.0001.
  74
  75 .. literalinclude:: ../files/tutorial_3.py
  76    :lines: 52-124
  77
  78 .. note::
  79   Download the files
  80
  81   * :download:`mesh and field stage 0<../files/tutorial_3.00.med.gz>`
  82   * :download:`mesh and field stage 1<../files/tutorial_3.01.med.gz>`
  83   * :download:`python script<../files/tutorial_3.py>`
  84   * :download:`python script for the compression<../files/tutorial_util.py>`
  85
  86
  87 Non plane boundaries
  88 ********************
  89 .. index:: single: field
  90 .. index:: single: YACS
  91
  92 One tests the follow-up of the curved borders here: analytical borders to describe various surfaces of the pipes and a discrete border to describe the intersecting lines of the two pipes. The driving of refinement is the following: uniform refinement of all the elements contained in indicated groups. One starts by refining the inner faces with the pipes; then, one refines continuation twice the external faces with the pipes.
  93 Scheme YACS carrying out this adaptation is downloadable.
  94
  95 .. literalinclude:: ../files/tutorial_4.py
  96    :lines: 52-111
  97
  98 .. note::
  99   Download the files
 100
 101   * :download:`initial mesh<../files/tutorial_4.00.med.gz>`
 102   * :download:`mesh of the discrete boundary<../files/tutorial_4.fr.med.gz>`
 103   * :download:`python script<../files/tutorial_4.py>`
 104   * :download:`python script for the compression<../files/tutorial_util.py>`
 105   * :download:`YACS scheme<../files/tutorial_4.xml>`
 106
 107
 108 Specific instructions for a 2D mesh
 109 ***********************************
 110 .. index:: single: 2D
 111
 112 The instructions to adapt a 2D mesh are exactly identical to those necessary to the adaptation of a 3D mesh. The only exception relates to refinement according to geometrical zones: different functions are used to be able to define 2D zones. One gives the 2D coordinates zones, by specifying the orientation of the plane of the mesh.
 113 In the case presented here, one for the first time refines all the elements contained in a bored disk, then in one second iteration, all the elements contained in a rectangle. One will note the use of the follow-up of the circular borders of the field.
 114
 115 .. literalinclude:: ../files/tutorial_5.py
 116    :lines: 52-95
 117
 118 .. note::
 119   Download the files
 120
 121   * :download:`initial mesh<../files/tutorial_5.00.med.gz>`
 122   * :download:`mesh of the discrete boundary<../files/tutorial_5.fr.med.gz>`
 123   * :download:`python script<../files/tutorial_5.py>`
 124   * :download:`python script for the compression<../files/tutorial_util.py>`
 125
 126
 127 .. toctree::
 128    :maxdepth: 2