Salome HOME
9f4d616d25c3edd182baed8b9ee8b1fcab7bc6d2
[modules/smesh.git] / src / SMESH / SMESH_MesherHelper.cxx
1 // Copyright (C) 2007-2015  CEA/DEN, EDF R&D, OPEN CASCADE
2 //
3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
5 //
6 // This library is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU Lesser General Public
8 // License as published by the Free Software Foundation; either
9 // version 2.1 of the License, or (at your option) any later version.
10 //
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 // Lesser General Public License for more details.
15 //
16 // You should have received a copy of the GNU Lesser General Public
17 // License along with this library; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
19 //
20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21 //
22
23 // File:      SMESH_MesherHelper.cxx
24 // Created:   15.02.06 15:22:41
25 // Author:    Sergey KUUL
26 //
27 #include "SMESH_MesherHelper.hxx"
28
29 #include "SMDS_EdgePosition.hxx"
30 #include "SMDS_FaceOfNodes.hxx"
31 #include "SMDS_FacePosition.hxx" 
32 #include "SMDS_IteratorOnIterators.hxx"
33 #include "SMDS_VolumeTool.hxx"
34 #include "SMESH_Block.hxx"
35 #include "SMESH_HypoFilter.hxx"
36 #include "SMESH_MeshAlgos.hxx"
37 #include "SMESH_ProxyMesh.hxx"
38 #include "SMESH_subMesh.hxx"
39
40 #include <BRepAdaptor_Curve.hxx>
41 #include <BRepAdaptor_Surface.hxx>
42 #include <BRepTools.hxx>
43 #include <BRep_Tool.hxx>
44 #include <Geom2d_Curve.hxx>
45 #include <GeomAPI_ProjectPointOnCurve.hxx>
46 #include <GeomAPI_ProjectPointOnSurf.hxx>
47 #include <Geom_Curve.hxx>
48 #include <Geom_RectangularTrimmedSurface.hxx>
49 #include <Geom_Surface.hxx>
50 #include <ShapeAnalysis.hxx>
51 #include <TopExp.hxx>
52 #include <TopExp_Explorer.hxx>
53 #include <TopTools_ListIteratorOfListOfShape.hxx>
54 #include <TopTools_MapIteratorOfMapOfShape.hxx>
55 #include <TopTools_MapOfShape.hxx>
56 #include <TopoDS.hxx>
57 #include <gp_Ax3.hxx>
58 #include <gp_Pnt2d.hxx>
59 #include <gp_Trsf.hxx>
60
61 #include <Standard_Failure.hxx>
62 #include <Standard_ErrorHandler.hxx>
63
64 #include <utilities.h>
65
66 #include <limits>
67
68 using namespace std;
69
70 #define RETURN_BAD_RESULT(msg) { MESSAGE(msg); return false; }
71
72 namespace {
73
74   inline SMESH_TNodeXYZ XYZ(const SMDS_MeshNode* n) { return SMESH_TNodeXYZ(n); }
75
76   enum { U_periodic = 1, V_periodic = 2 };
77 }
78
79 //================================================================================
80 /*!
81  * \brief Constructor
82  */
83 //================================================================================
84
85 SMESH_MesherHelper::SMESH_MesherHelper(SMESH_Mesh& theMesh)
86   : myParIndex(0),
87     myMesh(&theMesh),
88     myShapeID(0),
89     myCreateQuadratic(false),
90     myCreateBiQuadratic(false),
91     myFixNodeParameters(false)
92 {
93   myPar1[0] = myPar2[0] = myPar1[1] = myPar2[1] = 0;
94   mySetElemOnShape = ( ! myMesh->HasShapeToMesh() );
95 }
96
97 //=======================================================================
98 //function : ~SMESH_MesherHelper
99 //purpose  : 
100 //=======================================================================
101
102 SMESH_MesherHelper::~SMESH_MesherHelper()
103 {
104   {
105     TID2ProjectorOnSurf::iterator i_proj = myFace2Projector.begin();
106     for ( ; i_proj != myFace2Projector.end(); ++i_proj )
107       delete i_proj->second;
108   }
109   {
110     TID2ProjectorOnCurve::iterator i_proj = myEdge2Projector.begin();
111     for ( ; i_proj != myEdge2Projector.end(); ++i_proj )
112       delete i_proj->second;
113   }
114 }
115
116 //=======================================================================
117 //function : IsQuadraticSubMesh
118 //purpose  : Check submesh for given shape: if all elements on this shape 
119 //           are quadratic, quadratic elements will be created.
120 //           Also fill myTLinkNodeMap
121 //=======================================================================
122
123 bool SMESH_MesherHelper::IsQuadraticSubMesh(const TopoDS_Shape& aSh)
124 {
125   SMESHDS_Mesh* meshDS = GetMeshDS();
126   // we can create quadratic elements only if all elements
127   // created on sub-shapes of given shape are quadratic
128   // also we have to fill myTLinkNodeMap
129   myCreateQuadratic = true;
130   mySeamShapeIds.clear();
131   myDegenShapeIds.clear();
132   TopAbs_ShapeEnum subType( aSh.ShapeType()==TopAbs_FACE ? TopAbs_EDGE : TopAbs_FACE );
133   if ( aSh.ShapeType()==TopAbs_COMPOUND )
134   {
135     TopoDS_Iterator subIt( aSh );
136     if ( subIt.More() )
137       subType = ( subIt.Value().ShapeType()==TopAbs_FACE ) ? TopAbs_EDGE : TopAbs_FACE;
138   }
139   SMDSAbs_ElementType elemType( subType==TopAbs_FACE ? SMDSAbs_Face : SMDSAbs_Edge );
140
141
142   int nbOldLinks = myTLinkNodeMap.size();
143
144   if ( !myMesh->HasShapeToMesh() )
145   {
146     if (( myCreateQuadratic = myMesh->NbFaces( ORDER_QUADRATIC )))
147     {
148       SMDS_FaceIteratorPtr fIt = meshDS->facesIterator();
149       while ( fIt->more() )
150         AddTLinks( static_cast< const SMDS_MeshFace* >( fIt->next() ));
151     }
152   }
153   else
154   {
155     TopExp_Explorer exp( aSh, subType );
156     TopTools_MapOfShape checkedSubShapes;
157     for (; exp.More() && myCreateQuadratic; exp.Next()) {
158       if ( !checkedSubShapes.Add( exp.Current() ))
159         continue; // needed if aSh is compound of solids
160       if ( SMESHDS_SubMesh * subMesh = meshDS->MeshElements( exp.Current() )) {
161         if ( SMDS_ElemIteratorPtr it = subMesh->GetElements() ) {
162           while(it->more()) {
163             const SMDS_MeshElement* e = it->next();
164             if ( e->GetType() != elemType || !e->IsQuadratic() ) {
165               myCreateQuadratic = false;
166               break;
167             }
168             else {
169               // fill TLinkNodeMap
170               switch ( e->NbCornerNodes() ) {
171               case 2:
172                 AddTLinkNode(e->GetNode(0),e->GetNode(1),e->GetNode(2)); break;
173               case 3:
174                 AddTLinkNode(e->GetNode(0),e->GetNode(1),e->GetNode(3));
175                 AddTLinkNode(e->GetNode(1),e->GetNode(2),e->GetNode(4));
176                 AddTLinkNode(e->GetNode(2),e->GetNode(0),e->GetNode(5)); break;
177               case 4:
178                 AddTLinkNode(e->GetNode(0),e->GetNode(1),e->GetNode(4));
179                 AddTLinkNode(e->GetNode(1),e->GetNode(2),e->GetNode(5));
180                 AddTLinkNode(e->GetNode(2),e->GetNode(3),e->GetNode(6));
181                 AddTLinkNode(e->GetNode(3),e->GetNode(0),e->GetNode(7));
182                 break;
183               default:
184                 myCreateQuadratic = false;
185                 break;
186               }
187             }
188           }
189         }
190       }
191     }
192   }
193
194   // if ( nbOldLinks == myTLinkNodeMap.size() ) -- 0023068
195   //   myCreateQuadratic = false;
196
197   if(!myCreateQuadratic) {
198     myTLinkNodeMap.clear();
199   }
200   SetSubShape( aSh );
201
202   return myCreateQuadratic;
203 }
204
205 //=======================================================================
206 //function : SetSubShape
207 //purpose  : Set geometry to make elements on
208 //=======================================================================
209
210 void SMESH_MesherHelper::SetSubShape(const int aShID)
211 {
212   if ( aShID == myShapeID )
213     return;
214   if ( aShID > 0 )
215     SetSubShape( GetMeshDS()->IndexToShape( aShID ));
216   else
217     SetSubShape( TopoDS_Shape() );
218 }
219
220 //=======================================================================
221 //function : SetSubShape
222 //purpose  : Set geometry to create elements on
223 //=======================================================================
224
225 void SMESH_MesherHelper::SetSubShape(const TopoDS_Shape& aSh)
226 {
227   if ( myShape.IsSame( aSh ))
228     return;
229
230   myShape = aSh;
231   mySeamShapeIds.clear();
232   myDegenShapeIds.clear();
233
234   if ( myShape.IsNull() ) {
235     myShapeID  = 0;
236     return;
237   }
238   SMESHDS_Mesh* meshDS = GetMeshDS();
239   myShapeID = meshDS->ShapeToIndex(aSh);
240   myParIndex = 0;
241
242   // treatment of periodic faces
243   for ( TopExp_Explorer eF( aSh, TopAbs_FACE ); eF.More(); eF.Next() )
244   {
245     const TopoDS_Face& face = TopoDS::Face( eF.Current() );
246     BRepAdaptor_Surface surf( face, false );
247     if ( surf.IsUPeriodic() || surf.IsUClosed() ) {
248       myParIndex |= U_periodic;
249       myPar1[0] = surf.FirstUParameter();
250       myPar2[0] = surf.LastUParameter();
251     }
252     if ( surf.IsVPeriodic() || surf.IsVClosed() ) {
253       myParIndex |= V_periodic;
254       myPar1[1] = surf.FirstVParameter();
255       myPar2[1] = surf.LastVParameter();
256     }
257
258     gp_Pnt2d uv1, uv2;
259     for (TopExp_Explorer exp( face, TopAbs_EDGE ); exp.More(); exp.Next())
260     {
261       // look for a "seam" edge, a real seam or an edge on period boundary
262       TopoDS_Edge edge = TopoDS::Edge( exp.Current() );
263       const int edgeID = meshDS->ShapeToIndex( edge );
264       if ( myParIndex )
265       {
266         BRep_Tool::UVPoints( edge, face, uv1, uv2 );
267         const double du = Abs( uv1.Coord(1) - uv2.Coord(1) );
268         const double dv = Abs( uv1.Coord(2) - uv2.Coord(2) );
269
270         bool isSeam = BRep_Tool::IsClosed( edge, face );
271         if ( isSeam ) // real seam - having two pcurves on face
272         {
273           // pcurve can lie not on pediod boundary (22582, mesh_Quadratic_01/C9)
274           if ( du < dv )
275           {
276             double u1 = uv1.Coord(1);
277             edge.Reverse();
278             BRep_Tool::UVPoints( edge, face, uv1, uv2 );
279             double u2 = uv1.Coord(1);
280             myPar1[0] = Min( u1, u2 );
281             myPar2[0] = Max( u1, u2 );
282           }
283           else
284           {
285             double v1 = uv1.Coord(2);
286             edge.Reverse();
287             BRep_Tool::UVPoints( edge, face, uv1, uv2 );
288             double v2 = uv1.Coord(2);
289             myPar1[1] = Min( v1, v2 );
290             myPar2[1] = Max( v1, v2 );
291           }
292         }
293         else //if ( !isSeam )
294         {
295           // one pcurve but on period boundary (22772, mesh_Quadratic_01/D1)
296           if      (( myParIndex & U_periodic ) && du < Precision::PConfusion() )
297           {
298             isSeam = ( Abs( uv1.Coord(1) - myPar1[0] ) < Precision::PConfusion() ||
299                        Abs( uv1.Coord(1) - myPar2[0] ) < Precision::PConfusion() );
300           }
301           else if (( myParIndex & V_periodic ) && dv < Precision::PConfusion() )
302           {
303             isSeam = ( Abs( uv1.Coord(2) - myPar1[1] ) < Precision::PConfusion() ||
304                        Abs( uv1.Coord(2) - myPar2[1] ) < Precision::PConfusion() );
305           }
306           if ( isSeam ) // vertices are on period boundary, check a middle point (23032)
307           {
308             double f,l, r = 0.2345;
309             Handle(Geom2d_Curve) C2d = BRep_Tool::CurveOnSurface( edge, face, f, l );
310             uv2 = C2d->Value( f * r + l * ( 1.-r ));
311             if ( du < Precision::PConfusion() )
312               isSeam = ( Abs( uv1.Coord(1) - uv2.Coord(1) ) < Precision::PConfusion() );
313             else
314               isSeam = ( Abs( uv1.Coord(2) - uv2.Coord(2) ) < Precision::PConfusion() );
315           }
316         }
317         if ( isSeam )
318         {
319           // store seam shape indices, negative if shape encounters twice ('real seam')
320           mySeamShapeIds.insert( IsSeamShape( edgeID ) ? -edgeID : edgeID );
321           for ( TopExp_Explorer v( edge, TopAbs_VERTEX ); v.More(); v.Next() ) {
322             int vertexID = meshDS->ShapeToIndex( v.Current() );
323             mySeamShapeIds.insert( IsSeamShape( vertexID ) ? -vertexID : vertexID );
324           }
325         }
326       }
327       // look for a degenerated edge
328       if ( SMESH_Algo::isDegenerated( edge )) {
329         myDegenShapeIds.insert( edgeID );
330         for ( TopExp_Explorer v( edge, TopAbs_VERTEX ); v.More(); v.Next() )
331           myDegenShapeIds.insert( meshDS->ShapeToIndex( v.Current() ));
332       }
333       if ( !BRep_Tool::SameParameter( edge ) ||
334            !BRep_Tool::SameRange( edge ))
335       {
336         setPosOnShapeValidity( edgeID, false );
337       }
338     }
339   }
340 }
341
342 //=======================================================================
343 //function : GetNodeUVneedInFaceNode
344 //purpose  : Check if inFaceNode argument is necessary for call GetNodeUV(F,..)
345 //           Return true if the face is periodic.
346 //           If F is Null, answer about sub-shape set through IsQuadraticSubMesh() or
347 //           * SetSubShape()
348 //=======================================================================
349
350 bool SMESH_MesherHelper::GetNodeUVneedInFaceNode(const TopoDS_Face& F) const
351 {
352   if ( F.IsNull() ) return !mySeamShapeIds.empty();
353
354   if ( !F.IsNull() && !myShape.IsNull() && myShape.IsSame( F ))
355     return !mySeamShapeIds.empty();
356
357   TopLoc_Location loc;
358   Handle(Geom_Surface) aSurface = BRep_Tool::Surface( F,loc );
359   if ( !aSurface.IsNull() )
360     return ( aSurface->IsUPeriodic() || aSurface->IsVPeriodic() );
361
362   return false;
363 }
364
365 //=======================================================================
366 //function : IsMedium
367 //purpose  : 
368 //=======================================================================
369
370 bool SMESH_MesherHelper::IsMedium(const SMDS_MeshNode*      node,
371                                   const SMDSAbs_ElementType typeToCheck)
372 {
373   return SMESH_MeshEditor::IsMedium( node, typeToCheck );
374 }
375
376 //=======================================================================
377 //function : GetSubShapeByNode
378 //purpose  : Return support shape of a node
379 //=======================================================================
380
381 TopoDS_Shape SMESH_MesherHelper::GetSubShapeByNode(const SMDS_MeshNode* node,
382                                                    const SMESHDS_Mesh*  meshDS)
383 {
384   int shapeID = node ? node->getshapeId() : 0;
385   if ( 0 < shapeID && shapeID <= meshDS->MaxShapeIndex() )
386     return meshDS->IndexToShape( shapeID );
387   else
388     return TopoDS_Shape();
389 }
390
391
392 //=======================================================================
393 //function : AddTLinkNode
394 //purpose  : add a link in my data structure
395 //=======================================================================
396
397 void SMESH_MesherHelper::AddTLinkNode(const SMDS_MeshNode* n1,
398                                       const SMDS_MeshNode* n2,
399                                       const SMDS_MeshNode* n12)
400 {
401   // add new record to map
402   SMESH_TLink link( n1, n2 );
403   myTLinkNodeMap.insert( make_pair(link,n12));
404 }
405
406 //================================================================================
407 /*!
408  * \brief Add quadratic links of edge to own data structure
409  */
410 //================================================================================
411
412 bool SMESH_MesherHelper::AddTLinks(const SMDS_MeshEdge* edge)
413 {
414   if ( edge && edge->IsQuadratic() )
415     AddTLinkNode(edge->GetNode(0), edge->GetNode(1), edge->GetNode(2));
416   else
417     return false;
418   return true;
419 }
420
421 //================================================================================
422 /*!
423  * \brief Add quadratic links of face to own data structure
424  */
425 //================================================================================
426
427 bool SMESH_MesherHelper::AddTLinks(const SMDS_MeshFace* f)
428 {
429   bool isQuad = true;
430   if ( !f->IsPoly() )
431     switch ( f->NbNodes() ) {
432     case 7:
433       // myMapWithCentralNode.insert
434       //   ( make_pair( TBiQuad( f->GetNode(0),f->GetNode(1),f->GetNode(2) ),
435       //                f->GetNode(6)));
436       // break; -- add medium nodes as well
437     case 6:
438       AddTLinkNode(f->GetNode(0),f->GetNode(1),f->GetNode(3));
439       AddTLinkNode(f->GetNode(1),f->GetNode(2),f->GetNode(4));
440       AddTLinkNode(f->GetNode(2),f->GetNode(0),f->GetNode(5)); break;
441
442     case 9:
443       // myMapWithCentralNode.insert
444       //   ( make_pair( TBiQuad( f->GetNode(0),f->GetNode(1),f->GetNode(2),f->GetNode(3) ),
445       //                f->GetNode(8)));
446       // break; -- add medium nodes as well
447     case 8:
448       AddTLinkNode(f->GetNode(0),f->GetNode(1),f->GetNode(4));
449       AddTLinkNode(f->GetNode(1),f->GetNode(2),f->GetNode(5));
450       AddTLinkNode(f->GetNode(2),f->GetNode(3),f->GetNode(6));
451       AddTLinkNode(f->GetNode(3),f->GetNode(0),f->GetNode(7)); break;
452     default:;
453       isQuad = false;
454     }
455   return isQuad;
456 }
457
458 //================================================================================
459 /*!
460  * \brief Add quadratic links of volume to own data structure
461  */
462 //================================================================================
463
464 bool SMESH_MesherHelper::AddTLinks(const SMDS_MeshVolume* volume)
465 {
466   if ( volume->IsQuadratic() )
467   {
468     SMDS_VolumeTool vTool( volume );
469     const SMDS_MeshNode** nodes = vTool.GetNodes();
470     set<int> addedLinks;
471     for ( int iF = 1; iF < vTool.NbFaces(); ++iF )
472     {
473       const int nbN = vTool.NbFaceNodes( iF );
474       const int* iNodes = vTool.GetFaceNodesIndices( iF );
475       for ( int i = 0; i < nbN; )
476       {
477         int iN1  = iNodes[i++];
478         int iN12 = iNodes[i++];
479         int iN2  = iNodes[i];
480         if ( iN1 > iN2 ) std::swap( iN1, iN2 );
481         int linkID = iN1 * vTool.NbNodes() + iN2;
482         pair< set<int>::iterator, bool > it_isNew = addedLinks.insert( linkID );
483         if ( it_isNew.second )
484           AddTLinkNode( nodes[iN1], nodes[iN2], nodes[iN12] );
485         else
486           addedLinks.erase( it_isNew.first ); // each link encounters only twice
487       }
488       if ( vTool.NbNodes() == 27 )
489       {
490         const SMDS_MeshNode* nFCenter = nodes[ vTool.GetCenterNodeIndex( iF )];
491         if ( nFCenter->GetPosition()->GetTypeOfPosition() == SMDS_TOP_3DSPACE )
492           myMapWithCentralNode.insert
493             ( make_pair( TBiQuad( nodes[ iNodes[0]], nodes[ iNodes[1]],
494                                   nodes[ iNodes[2]], nodes[ iNodes[3]] ),
495                          nFCenter ));
496       }
497     }
498     return true;
499   }
500   return false;
501 }
502
503 //================================================================================
504 /*!
505  * \brief Return true if position of nodes on the shape hasn't yet been checked or
506  * the positions proved to be invalid
507  */
508 //================================================================================
509
510 bool SMESH_MesherHelper::toCheckPosOnShape(int shapeID ) const
511 {
512   map< int,bool >::const_iterator id_ok = myNodePosShapesValidity.find( shapeID );
513   return ( id_ok == myNodePosShapesValidity.end() || !id_ok->second );
514 }
515
516 //================================================================================
517 /*!
518  * \brief Set validity of positions of nodes on the shape.
519  * Once set, validity is not changed
520  */
521 //================================================================================
522
523 void SMESH_MesherHelper::setPosOnShapeValidity(int shapeID, bool ok ) const
524 {
525   std::map< int,bool >::iterator sh_ok = 
526     ((SMESH_MesherHelper*)this)->myNodePosShapesValidity.insert( make_pair( shapeID, ok)).first;
527   if ( !ok )
528     sh_ok->second = ok;
529 }
530
531 //=======================================================================
532 //function : ToFixNodeParameters
533 //purpose  : Enables fixing node parameters on EDGEs and FACEs in 
534 //           GetNodeU(...,check=true), GetNodeUV(...,check=true), CheckNodeUV() and
535 //           CheckNodeU() in case if a node lies on a shape set via SetSubShape().
536 //           Default is False
537 //=======================================================================
538
539 void SMESH_MesherHelper::ToFixNodeParameters(bool toFix)
540 {
541   myFixNodeParameters = toFix;
542 }
543
544
545 //=======================================================================
546 //function : getUVOnSeam
547 //purpose  : Select UV on either of 2 pcurves of a seam edge, closest to the given UV
548 //=======================================================================
549
550 gp_Pnt2d SMESH_MesherHelper::getUVOnSeam( const gp_Pnt2d& uv1, const gp_Pnt2d& uv2 ) const
551 {
552   gp_Pnt2d result = uv1;
553   for ( int i = U_periodic; i <= V_periodic ; ++i )
554   {
555     if ( myParIndex & i )
556     {
557       double p1 = uv1.Coord( i );
558       double dp1 = Abs( p1-myPar1[i-1]), dp2 = Abs( p1-myPar2[i-1]);
559       if ( myParIndex == i ||
560            dp1 < ( myPar2[i-1] - myPar1[i-1] ) / 100. ||
561            dp2 < ( myPar2[i-1] - myPar1[i-1] ) / 100. )
562       {
563         double p2 = uv2.Coord( i );
564         double p1Alt = ( dp1 < dp2 ) ? myPar2[i-1] : myPar1[i-1];
565         if ( Abs( p2 - p1 ) > Abs( p2 - p1Alt ))
566           result.SetCoord( i, p1Alt );
567       }
568     }
569   }
570   return result;
571 }
572
573 //=======================================================================
574 //function : GetNodeUV
575 //purpose  : Return node UV on face
576 //=======================================================================
577
578 gp_XY SMESH_MesherHelper::GetNodeUV(const TopoDS_Face&   F,
579                                     const SMDS_MeshNode* n,
580                                     const SMDS_MeshNode* n2,
581                                     bool*                check) const
582 {
583   gp_Pnt2d uv( Precision::Infinite(), Precision::Infinite() );
584
585   const SMDS_PositionPtr Pos = n->GetPosition();
586   bool uvOK = false;
587   if ( Pos->GetTypeOfPosition() == SMDS_TOP_FACE )
588   {
589     // node has position on face
590     const SMDS_FacePosition* fpos = static_cast<const SMDS_FacePosition*>( Pos );
591     uv.SetCoord( fpos->GetUParameter(), fpos->GetVParameter() );
592     if ( check )
593       uvOK = CheckNodeUV( F, n, uv.ChangeCoord(), 2.*getFaceMaxTol( F )); // 2. from 22830
594   }
595   else if ( Pos->GetTypeOfPosition() == SMDS_TOP_EDGE )
596   {
597     // node has position on EDGE => it is needed to find
598     // corresponding EDGE from FACE, get pcurve for this
599     // EDGE and retrieve value from this pcurve
600     const SMDS_EdgePosition* epos = static_cast<const SMDS_EdgePosition*>( Pos );
601     const int              edgeID = n->getshapeId();
602     const TopoDS_Edge& E = TopoDS::Edge( GetMeshDS()->IndexToShape( edgeID ));
603     double f, l, u = epos->GetUParameter();
604     Handle(Geom2d_Curve) C2d = BRep_Tool::CurveOnSurface( E, F, f, l );
605     bool validU = ( !C2d.IsNull() && ( f < u ) && ( u < l ));
606     if ( validU ) uv = C2d->Value( u );
607     else          uv.SetCoord( Precision::Infinite(),0.);
608     if ( check || !validU )
609       uvOK = CheckNodeUV( F, n, uv.ChangeCoord(), 2.*getFaceMaxTol( F ),/*force=*/ !validU );
610
611     // for a node on a seam EDGE select one of UVs on 2 pcurves
612     if ( n2 && IsSeamShape( edgeID ))
613     {
614       uv = getUVOnSeam( uv, GetNodeUV( F, n2, 0, check ));
615     }
616     else
617     { // adjust uv to period
618       TopLoc_Location loc;
619       Handle(Geom_Surface) S = BRep_Tool::Surface(F,loc);
620       Standard_Boolean isUPeriodic = S->IsUPeriodic();
621       Standard_Boolean isVPeriodic = S->IsVPeriodic();
622       gp_Pnt2d newUV = uv;
623       if ( isUPeriodic || isVPeriodic ) {
624         Standard_Real UF,UL,VF,VL;
625         S->Bounds(UF,UL,VF,VL);
626         if ( isUPeriodic ) newUV.SetX( uv.X() + ShapeAnalysis::AdjustToPeriod(uv.X(),UF,UL));
627         if ( isVPeriodic ) newUV.SetY( uv.Y() + ShapeAnalysis::AdjustToPeriod(uv.Y(),VF,VL));
628
629         if ( n2 )
630         {
631           gp_Pnt2d uv2 = GetNodeUV( F, n2, 0, check );
632           if ( isUPeriodic && Abs( uv.X()-uv2.X() ) < Abs( newUV.X()-uv2.X() ))
633             newUV.SetX( uv.X() );
634           if ( isVPeriodic && Abs( uv.Y()-uv2.Y() ) < Abs( newUV.Y()-uv2.Y() ))
635             newUV.SetY( uv.Y() );
636         }
637       }
638       uv = newUV;
639     }
640   }
641   else if ( Pos->GetTypeOfPosition() == SMDS_TOP_VERTEX )
642   {
643     if ( int vertexID = n->getshapeId() ) {
644       const TopoDS_Vertex& V = TopoDS::Vertex(GetMeshDS()->IndexToShape(vertexID));
645       try {
646         uv = BRep_Tool::Parameters( V, F );
647         uvOK = true;
648       }
649       catch (Standard_Failure& exc) {
650       }
651       if ( !uvOK ) {
652         for ( TopExp_Explorer vert(F,TopAbs_VERTEX); !uvOK && vert.More(); vert.Next() )
653           uvOK = ( V == vert.Current() );
654         if ( !uvOK ) {
655           MESSAGE ( "SMESH_MesherHelper::GetNodeUV(); Vertex " << vertexID
656                     << " not in face " << GetMeshDS()->ShapeToIndex( F ) );
657           // get UV of a vertex closest to the node
658           double dist = 1e100;
659           gp_Pnt pn = XYZ( n );
660           for ( TopExp_Explorer vert( F,TopAbs_VERTEX ); !uvOK && vert.More(); vert.Next() ) {
661             TopoDS_Vertex curV = TopoDS::Vertex( vert.Current() );
662             gp_Pnt p = BRep_Tool::Pnt( curV );
663             double curDist = p.SquareDistance( pn );
664             if ( curDist < dist ) {
665               dist = curDist;
666               uv = BRep_Tool::Parameters( curV, F );
667               uvOK = ( dist < DBL_MIN );
668             }
669           }
670         }
671         else {
672           uvOK = false;
673           TopTools_ListIteratorOfListOfShape it( myMesh->GetAncestors( V ));
674           for ( ; it.More(); it.Next() ) {
675             if ( it.Value().ShapeType() == TopAbs_EDGE ) {
676               const TopoDS_Edge & edge = TopoDS::Edge( it.Value() );
677               double f,l;
678               Handle(Geom2d_Curve) C2d = BRep_Tool::CurveOnSurface(edge, F, f, l);
679               if ( !C2d.IsNull() ) {
680                 double u = ( V == TopExp::FirstVertex( edge ) ) ?  f : l;
681                 uv = C2d->Value( u );
682                 uvOK = true;
683                 break;
684               }
685             }
686           }
687         }
688       }
689       if ( n2 && IsSeamShape( vertexID ))
690       {
691         bool isSeam = ( myShape.IsSame( F ));
692         if ( !isSeam ) {
693           SMESH_MesherHelper h( *myMesh );
694           h.SetSubShape( F );
695           isSeam = IsSeamShape( vertexID );
696         }
697
698         if ( isSeam )
699           uv = getUVOnSeam( uv, GetNodeUV( F, n2, 0 ));
700       }
701     }
702   }
703   else
704   {
705     uvOK = CheckNodeUV( F, n, uv.ChangeCoord(), 2.*getFaceMaxTol( F ));
706   }
707
708   if ( check && !uvOK )
709     *check = uvOK;
710
711   return uv.XY();
712 }
713
714 //=======================================================================
715 //function : CheckNodeUV
716 //purpose  : Check and fix node UV on a face
717 //=======================================================================
718
719 bool SMESH_MesherHelper::CheckNodeUV(const TopoDS_Face&   F,
720                                      const SMDS_MeshNode* n,
721                                      gp_XY&               uv,
722                                      const double         tol,
723                                      const bool           force,
724                                      double               distXYZ[4]) const
725 {
726   int  shapeID = n->getshapeId();
727   bool infinit;
728   if (( infinit = ( Precision::IsInfinite( uv.X() ) || Precision::IsInfinite( uv.Y() ))) ||
729       ( force ) ||
730       ( uv.X() == 0. && uv.Y() == 0. ) ||
731       ( toCheckPosOnShape( shapeID )))
732   {
733     // check that uv is correct
734     TopLoc_Location loc;
735     Handle(Geom_Surface) surface = BRep_Tool::Surface( F,loc );
736     gp_Pnt nodePnt = XYZ( n ), surfPnt(0,0,0);
737     double dist = 0;
738     if ( !loc.IsIdentity() ) nodePnt.Transform( loc.Transformation().Inverted() );
739     if ( infinit ||
740          (dist = nodePnt.Distance( surfPnt = surface->Value( uv.X(), uv.Y() ))) > tol )
741     {
742       setPosOnShapeValidity( shapeID, false );
743       if ( !infinit && distXYZ ) {
744         surfPnt.Transform( loc );
745         distXYZ[0] = dist;
746         distXYZ[1] = surfPnt.X(); distXYZ[2] = surfPnt.Y(); distXYZ[3]=surfPnt.Z();
747       }
748       // uv incorrect, project the node to surface
749       GeomAPI_ProjectPointOnSurf& projector = GetProjector( F, loc, tol );
750       projector.Perform( nodePnt );
751       if ( !projector.IsDone() || projector.NbPoints() < 1 )
752       {
753         MESSAGE( "SMESH_MesherHelper::CheckNodeUV() failed to project" );
754         return false;
755       }
756       Quantity_Parameter U,V;
757       projector.LowerDistanceParameters(U,V);
758       uv.SetCoord( U,V );
759       surfPnt = surface->Value( U, V );
760       dist = nodePnt.Distance( surfPnt );
761       if ( distXYZ ) {
762         surfPnt.Transform( loc );
763         distXYZ[0] = dist;
764         distXYZ[1] = surfPnt.X(); distXYZ[2] = surfPnt.Y(); distXYZ[3]=surfPnt.Z();
765       }
766       if ( dist > tol )
767       {
768         MESSAGE( "SMESH_MesherHelper::CheckNodeUV(), invalid projection" );
769         return false;
770       }
771       // store the fixed UV on the face
772       if ( myShape.IsSame(F) && shapeID == myShapeID && myFixNodeParameters )
773         const_cast<SMDS_MeshNode*>(n)->SetPosition
774           ( SMDS_PositionPtr( new SMDS_FacePosition( U, V )));
775     }
776     else if ( myShape.IsSame(F) && uv.Modulus() > numeric_limits<double>::min() )
777     {
778       setPosOnShapeValidity( shapeID, true );
779     }
780   }
781   return true;
782 }
783
784 //=======================================================================
785 //function : GetProjector
786 //purpose  : Return projector intitialized by given face without location, which is returned
787 //=======================================================================
788
789 GeomAPI_ProjectPointOnSurf& SMESH_MesherHelper::GetProjector(const TopoDS_Face& F,
790                                                              TopLoc_Location&   loc,
791                                                              double             tol ) const
792 {
793   Handle(Geom_Surface) surface = BRep_Tool::Surface( F,loc );
794   int faceID = GetMeshDS()->ShapeToIndex( F );
795   TID2ProjectorOnSurf& i2proj = const_cast< TID2ProjectorOnSurf&>( myFace2Projector );
796   TID2ProjectorOnSurf::iterator i_proj = i2proj.find( faceID );
797   if ( i_proj == i2proj.end() )
798   {
799     if ( tol == 0 ) tol = BRep_Tool::Tolerance( F );
800     double U1, U2, V1, V2;
801     surface->Bounds(U1, U2, V1, V2);
802     GeomAPI_ProjectPointOnSurf* proj = new GeomAPI_ProjectPointOnSurf();
803     proj->Init( surface, U1, U2, V1, V2, tol );
804     i_proj = i2proj.insert( make_pair( faceID, proj )).first;
805   }
806   return *( i_proj->second );
807 }
808
809 namespace
810 {
811   gp_XY AverageUV(const gp_XY& uv1, const gp_XY& uv2) { return ( uv1 + uv2 ) / 2.; }
812   gp_XY_FunPtr(Added); // define gp_XY_Added pointer to function calling gp_XY::Added(gp_XY)
813   gp_XY_FunPtr(Subtracted); 
814 }
815
816 //=======================================================================
817 //function : ApplyIn2D
818 //purpose  : Perform given operation on two 2d points in parameric space of given surface.
819 //           It takes into account period of the surface. Use gp_XY_FunPtr macro
820 //           to easily define pointer to function of gp_XY class.
821 //=======================================================================
822
823 gp_XY SMESH_MesherHelper::ApplyIn2D(Handle(Geom_Surface) surface,
824                                     const gp_XY&         uv1,
825                                     const gp_XY&         uv2,
826                                     xyFunPtr             fun,
827                                     const bool           resultInPeriod)
828 {
829   if ( surface->IsKind(STANDARD_TYPE(Geom_RectangularTrimmedSurface )))
830     surface = Handle(Geom_RectangularTrimmedSurface)::DownCast( surface )->BasisSurface();
831   Standard_Boolean isUPeriodic = surface.IsNull() ? false : surface->IsUPeriodic();
832   Standard_Boolean isVPeriodic = surface.IsNull() ? false : surface->IsVPeriodic();
833   if ( !isUPeriodic && !isVPeriodic )
834     return fun(uv1,uv2);
835
836   // move uv2 not far than half-period from uv1
837   double u2 = 
838     uv2.X()+(isUPeriodic ? ShapeAnalysis::AdjustByPeriod(uv2.X(),uv1.X(),surface->UPeriod()) :0);
839   double v2 = 
840     uv2.Y()+(isVPeriodic ? ShapeAnalysis::AdjustByPeriod(uv2.Y(),uv1.Y(),surface->VPeriod()) :0);
841
842   // execute operation
843   gp_XY res = fun( uv1, gp_XY(u2,v2) );
844
845   // move result within period
846   if ( resultInPeriod )
847   {
848     Standard_Real UF,UL,VF,VL;
849     surface->Bounds(UF,UL,VF,VL);
850     if ( isUPeriodic )
851       res.SetX( res.X() + ShapeAnalysis::AdjustToPeriod(res.X(),UF,UL));
852     if ( isVPeriodic )
853       res.SetY( res.Y() + ShapeAnalysis::AdjustToPeriod(res.Y(),VF,VL));
854   }
855
856   return res;
857 }
858
859 //=======================================================================
860 //function : AdjustByPeriod
861 //purpose  : Move node positions on a FACE within surface period
862 //=======================================================================
863
864 void SMESH_MesherHelper::AdjustByPeriod( const TopoDS_Face& face, gp_XY uv[], const int nbUV )
865 {
866   SMESH_MesherHelper h( *myMesh ), *ph = face.IsSame( myShape ) ? this : &h;
867   ph->SetSubShape( face );
868
869   for ( int iCoo = U_periodic; iCoo <= V_periodic; ++iCoo )
870     if ( ph->GetPeriodicIndex() & iCoo )
871     {
872       const double period = ( ph->myPar2[iCoo-1] - ph->myPar1[iCoo-1] );
873       const double xRef = uv[0].Coord( iCoo );
874       for ( int i = 1; i < nbUV; ++i )
875       {
876         double x = uv[i].Coord( iCoo );
877         double dx = ShapeAnalysis::AdjustByPeriod( x, xRef, period );
878         uv[i].SetCoord( iCoo, x + dx );
879       }
880     }
881 }
882
883 //=======================================================================
884 //function : GetMiddleUV
885 //purpose  : Return middle UV taking in account surface period
886 //=======================================================================
887
888 gp_XY SMESH_MesherHelper::GetMiddleUV(const Handle(Geom_Surface)& surface,
889                                       const gp_XY&                p1,
890                                       const gp_XY&                p2)
891 {
892   // NOTE:
893   // the proper place of getting basic surface seems to be in ApplyIn2D()
894   // but we put it here to decrease a risk of regressions just before releasing a version
895   // Handle(Geom_Surface) surf = surface;
896   // while ( !surf.IsNull() && surf->IsKind(STANDARD_TYPE(Geom_RectangularTrimmedSurface )))
897   //   surf = Handle(Geom_RectangularTrimmedSurface)::DownCast( surf )->BasisSurface();
898
899   return ApplyIn2D( surface, p1, p2, & AverageUV );
900 }
901
902 //=======================================================================
903 //function : GetCenterUV
904 //purpose  : Return UV for the central node of a biquadratic triangle
905 //=======================================================================
906
907 gp_XY SMESH_MesherHelper::GetCenterUV(const gp_XY& uv1,
908                                       const gp_XY& uv2, 
909                                       const gp_XY& uv3, 
910                                       const gp_XY& uv12,
911                                       const gp_XY& uv23,
912                                       const gp_XY& uv31,
913                                       bool *       isBadTria/*=0*/)
914 {
915   bool badTria;
916   gp_XY uvAvg = ( uv12 + uv23 + uv31 ) / 3.;
917
918   if      (( badTria = (( uvAvg - uv1 ) * ( uvAvg - uv23 ) > 0 )))
919     uvAvg = ( uv1 + uv23 ) / 2.;
920   else if (( badTria = (( uvAvg - uv2 ) * ( uvAvg - uv31 ) > 0 )))
921     uvAvg = ( uv2 + uv31 ) / 2.;
922   else if (( badTria = (( uvAvg - uv3 ) * ( uvAvg - uv12 ) > 0 )))
923     uvAvg = ( uv3 + uv12 ) / 2.;
924
925   if ( isBadTria )
926     *isBadTria = badTria;
927   return uvAvg;
928 }
929
930 //=======================================================================
931 //function : GetNodeU
932 //purpose  : Return node U on edge
933 //=======================================================================
934
935 double SMESH_MesherHelper::GetNodeU(const TopoDS_Edge&   E,
936                                     const SMDS_MeshNode* n,
937                                     const SMDS_MeshNode* inEdgeNode,
938                                     bool*                check) const
939 {
940   double param = Precision::Infinite();
941
942   const SMDS_PositionPtr pos = n->GetPosition();
943   if ( pos->GetTypeOfPosition()==SMDS_TOP_EDGE )
944   {
945     const SMDS_EdgePosition* epos = static_cast<const SMDS_EdgePosition*>( pos );
946     param =  epos->GetUParameter();
947   }
948   else if( pos->GetTypeOfPosition() == SMDS_TOP_VERTEX )
949   {
950     if ( inEdgeNode && TopExp::FirstVertex( E ).IsSame( TopExp::LastVertex( E ))) // issue 0020128
951     {
952       Standard_Real f,l;
953       BRep_Tool::Range( E, f,l );
954       double uInEdge = GetNodeU( E, inEdgeNode );
955       param = ( fabs( uInEdge - f ) < fabs( l - uInEdge )) ? f : l;
956     }
957     else
958     {
959       SMESHDS_Mesh * meshDS = GetMeshDS();
960       int vertexID = n->getshapeId();
961       const TopoDS_Vertex& V = TopoDS::Vertex(meshDS->IndexToShape(vertexID));
962       param =  BRep_Tool::Parameter( V, E );
963     }
964   }
965   if ( check )
966   {
967     double tol = BRep_Tool::Tolerance( E );
968     double f,l;  BRep_Tool::Range( E, f,l );
969     bool force = ( param < f-tol || param > l+tol );
970     if ( !force && pos->GetTypeOfPosition()==SMDS_TOP_EDGE )
971       force = ( GetMeshDS()->ShapeToIndex( E ) != n->getshapeId() );
972
973     *check = CheckNodeU( E, n, param, 2*tol, force );
974   }
975   return param;
976 }
977
978 //=======================================================================
979 //function : CheckNodeU
980 //purpose  : Check and fix node U on an edge
981 //           Return false if U is bad and could not be fixed
982 //=======================================================================
983
984 bool SMESH_MesherHelper::CheckNodeU(const TopoDS_Edge&   E,
985                                     const SMDS_MeshNode* n,
986                                     double&              u,
987                                     const double         tol,
988                                     const bool           force,
989                                     double               distXYZ[4]) const
990 {
991   int  shapeID = n->getshapeId();
992   bool infinit;
993   if (( infinit = Precision::IsInfinite( u )) ||
994       ( force ) ||
995       ( u == 0. ) ||
996       ( toCheckPosOnShape( shapeID )))
997   {
998     TopLoc_Location loc; double f,l;
999     Handle(Geom_Curve) curve = BRep_Tool::Curve( E,loc,f,l );
1000     if ( curve.IsNull() ) // degenerated edge
1001     {
1002       if ( u+tol < f || u-tol > l )
1003       {
1004         double r = Max( 0.5, 1 - tol*n->GetID()); // to get a unique u on edge
1005         u =  f*r + l*(1-r);
1006       }
1007     }
1008     else
1009     {
1010       gp_Pnt nodePnt = SMESH_TNodeXYZ( n );
1011       if ( !loc.IsIdentity() ) nodePnt.Transform( loc.Transformation().Inverted() );
1012       gp_Pnt curvPnt;
1013       double dist = 2*tol;
1014       if ( !infinit )
1015       {
1016         curvPnt = curve->Value( u );
1017         dist    = nodePnt.Distance( curvPnt );
1018         if ( distXYZ ) {
1019           curvPnt.Transform( loc );
1020           distXYZ[0] = dist;
1021           distXYZ[1] = curvPnt.X(); distXYZ[2] = curvPnt.Y(); distXYZ[3]=curvPnt.Z();
1022         }
1023       }
1024       if ( dist > tol )
1025       {
1026         setPosOnShapeValidity( shapeID, false );
1027         // u incorrect, project the node to the curve
1028         int edgeID = GetMeshDS()->ShapeToIndex( E );
1029         TID2ProjectorOnCurve& i2proj = const_cast< TID2ProjectorOnCurve&>( myEdge2Projector );
1030         TID2ProjectorOnCurve::iterator i_proj =
1031           i2proj.insert( make_pair( edgeID, (GeomAPI_ProjectPointOnCurve*) 0 )).first;
1032         if ( !i_proj->second  )
1033         {
1034           i_proj->second = new GeomAPI_ProjectPointOnCurve();
1035           i_proj->second->Init( curve, f, l );
1036         }
1037         GeomAPI_ProjectPointOnCurve* projector = i_proj->second;
1038         projector->Perform( nodePnt );
1039         if ( projector->NbPoints() < 1 )
1040         {
1041           MESSAGE( "SMESH_MesherHelper::CheckNodeU() failed to project" );
1042           return false;
1043         }
1044         Quantity_Parameter U = projector->LowerDistanceParameter();
1045         u = double( U );
1046         MESSAGE(" f " << f << " l " << l << " u " << u);
1047         curvPnt = curve->Value( u );
1048         dist = nodePnt.Distance( curvPnt );
1049         if ( distXYZ ) {
1050           curvPnt.Transform( loc );
1051           distXYZ[0] = dist;
1052           distXYZ[1] = curvPnt.X(); distXYZ[2] = curvPnt.Y(); distXYZ[3]=curvPnt.Z();
1053         }
1054         if ( dist > tol )
1055         {
1056           MESSAGE( "SMESH_MesherHelper::CheckNodeU(), invalid projection" );
1057           MESSAGE("distance " << dist << " " << tol );
1058           return false;
1059         }
1060         // store the fixed U on the edge
1061         if ( myShape.IsSame(E) && shapeID == myShapeID && myFixNodeParameters )
1062           const_cast<SMDS_MeshNode*>(n)->SetPosition
1063             ( SMDS_PositionPtr( new SMDS_EdgePosition( U )));
1064       }
1065       else if ( fabs( u ) > numeric_limits<double>::min() )
1066       {
1067         setPosOnShapeValidity( shapeID, true );
1068       }
1069       if (( u < f-tol || u > l+tol ) && force )
1070       {
1071         MESSAGE("u < f-tol || u > l+tol  ; u " << u << " f " << f << " l " << l);
1072         // node is on vertex but is set on periodic but trimmed edge (issue 0020890)
1073         try
1074         {
1075           // do not use IsPeriodic() as Geom_TrimmedCurve::IsPeriodic () returns false
1076           double period = curve->Period();
1077           u = ( u < f ) ? u + period : u - period;
1078         }
1079         catch (Standard_Failure& exc)
1080         {
1081           return false;
1082         }
1083       }
1084     }
1085   }
1086   return true;
1087 }
1088
1089 //=======================================================================
1090 //function : GetMediumPos
1091 //purpose  : Return index and type of the shape  (EDGE or FACE only) to
1092 //           set a medium node on
1093 //param    : useCurSubShape - if true, returns the shape set via SetSubShape()
1094 //           if any
1095 //param    : expectedSupport - shape type corresponding to element being created,
1096 //                             e.g TopAbs_EDGE if SMDSAbs_Edge is created
1097 //                             basing on \a n1 and \a n2
1098 // Calling GetMediumPos() with useCurSubShape=true is OK only for the
1099 // case where the lower dim mesh is already constructed and converted to quadratic,
1100 // else, nodes on EDGEs are assigned to FACE, for example.
1101 //=======================================================================
1102
1103 std::pair<int, TopAbs_ShapeEnum>
1104 SMESH_MesherHelper::GetMediumPos(const SMDS_MeshNode* n1,
1105                                  const SMDS_MeshNode* n2,
1106                                  const bool           useCurSubShape,
1107                                  TopAbs_ShapeEnum     expectedSupport)
1108 {
1109   if ( useCurSubShape && !myShape.IsNull() )
1110     return std::make_pair( myShapeID, myShape.ShapeType() );
1111
1112   TopAbs_ShapeEnum shapeType = TopAbs_SHAPE;
1113   int              shapeID = -1;
1114   TopoDS_Shape     shape;
1115
1116   if (( myShapeID == n1->getshapeId() || myShapeID == n2->getshapeId() ) && myShapeID > 0 )
1117   {
1118     shapeType = myShape.ShapeType();
1119     shapeID   = myShapeID;
1120   }
1121   else if ( n1->getshapeId() == n2->getshapeId() )
1122   {
1123     shapeID = n2->getshapeId();
1124     shape = GetSubShapeByNode( n1, GetMeshDS() );
1125   }
1126   else // 2 different shapes
1127   {
1128     const SMDS_TypeOfPosition Pos1 = n1->GetPosition()->GetTypeOfPosition();
1129     const SMDS_TypeOfPosition Pos2 = n2->GetPosition()->GetTypeOfPosition();
1130
1131     if ( Pos1 == SMDS_TOP_3DSPACE || Pos2 == SMDS_TOP_3DSPACE )
1132     {
1133       // in SOLID
1134     }
1135     else if ( Pos1 == SMDS_TOP_FACE || Pos2 == SMDS_TOP_FACE )
1136     {
1137       // in FACE or SOLID
1138       if ( Pos1 != SMDS_TOP_FACE || Pos2 != SMDS_TOP_FACE ) // not 2 FACEs
1139       {
1140         if ( Pos1 != SMDS_TOP_FACE ) std::swap( n1,n2 );
1141         TopoDS_Shape F = GetSubShapeByNode( n1, GetMeshDS() );
1142         TopoDS_Shape S = GetSubShapeByNode( n2, GetMeshDS() );
1143         if ( IsSubShape( S, F ))
1144         {
1145           shapeType = TopAbs_FACE;
1146           shapeID   = n1->getshapeId();
1147         }
1148       }
1149     }
1150     else if ( Pos1 == SMDS_TOP_EDGE && Pos2 == SMDS_TOP_EDGE )
1151     {
1152       TopoDS_Shape E1 = GetSubShapeByNode( n1, GetMeshDS() );
1153       TopoDS_Shape E2 = GetSubShapeByNode( n2, GetMeshDS() );
1154       shape = GetCommonAncestor( E1, E2, *myMesh, TopAbs_FACE );
1155     }
1156     else if ( Pos1 == SMDS_TOP_VERTEX && Pos2 == SMDS_TOP_VERTEX )
1157     {
1158       TopoDS_Shape V1 = GetSubShapeByNode( n1, GetMeshDS() );
1159       TopoDS_Shape V2 = GetSubShapeByNode( n2, GetMeshDS() );
1160       shape = GetCommonAncestor( V1, V2, *myMesh, TopAbs_EDGE );
1161       if ( shape.IsNull() ) shape = GetCommonAncestor( V1, V2, *myMesh, TopAbs_FACE );
1162     }
1163     else // on VERTEX and EDGE
1164     {
1165       if ( Pos1 != SMDS_TOP_VERTEX ) std::swap( n1,n2 );
1166       TopoDS_Shape V = GetSubShapeByNode( n1, GetMeshDS() );
1167       TopoDS_Shape E = GetSubShapeByNode( n2, GetMeshDS() );
1168       if ( IsSubShape( V, E ))
1169         shape = E;
1170       else
1171         shape = GetCommonAncestor( V, E, *myMesh, TopAbs_FACE );
1172     }
1173   }
1174
1175   if ( !shape.IsNull() )
1176   {
1177     if ( shapeID < 1 )
1178       shapeID = GetMeshDS()->ShapeToIndex( shape );
1179     shapeType = shape.ShapeType(); // EDGE or FACE
1180
1181     if ( expectedSupport < shapeType &&
1182          expectedSupport != TopAbs_SHAPE &&
1183          !myShape.IsNull() &&
1184          myShape.ShapeType() == expectedSupport )
1185     {
1186       // e.g. a side of triangle connects nodes on the same EDGE but does not
1187       // lie on this EDGE (an arc with a coarse mesh)
1188       // =>  shapeType == TopAbs_EDGE, expectedSupport == TopAbs_FACE;
1189       // hope that myShape is a right shape, return it if the found shape
1190       // has converted elements of corresponding dim (segments in our example)
1191       int nbConvertedElems = 0;
1192       SMDSAbs_ElementType type = ( shapeType == TopAbs_FACE ? SMDSAbs_Face : SMDSAbs_Edge );
1193       for ( int iN = 0; iN < 2; ++iN )
1194       {
1195         const SMDS_MeshNode* n = iN ? n2 : n1;
1196         SMDS_ElemIteratorPtr it = n->GetInverseElementIterator( type );
1197         while ( it->more() )
1198         {
1199           const SMDS_MeshElement* elem = it->next();
1200           if ( elem->getshapeId() == shapeID &&
1201                elem->IsQuadratic() )
1202           {
1203             ++nbConvertedElems;
1204             break;
1205           }
1206         }
1207       }
1208       if ( nbConvertedElems == 2 )
1209       {
1210         shapeType = myShape.ShapeType();
1211         shapeID   = myShapeID;
1212       }
1213     }
1214   }
1215   return make_pair( shapeID, shapeType );
1216 }
1217
1218 //=======================================================================
1219 //function : GetCentralNode
1220 //purpose  : Return existing or create a new central node for a quardilateral
1221 //           quadratic face given its 8 nodes.
1222 //@param   : force3d - true means node creation in between the given nodes,
1223 //           else node position is found on a geometrical face if any.
1224 //=======================================================================
1225
1226 const SMDS_MeshNode* SMESH_MesherHelper::GetCentralNode(const SMDS_MeshNode* n1,
1227                                                         const SMDS_MeshNode* n2,
1228                                                         const SMDS_MeshNode* n3,
1229                                                         const SMDS_MeshNode* n4,
1230                                                         const SMDS_MeshNode* n12,
1231                                                         const SMDS_MeshNode* n23,
1232                                                         const SMDS_MeshNode* n34,
1233                                                         const SMDS_MeshNode* n41,
1234                                                         bool                 force3d)
1235 {
1236   SMDS_MeshNode *centralNode = 0; // central node to return
1237
1238   // Find an existing central node
1239
1240   TBiQuad keyOfMap(n1,n2,n3,n4);
1241   std::map<TBiQuad, const SMDS_MeshNode* >::iterator itMapCentralNode;
1242   itMapCentralNode = myMapWithCentralNode.find( keyOfMap );
1243   if ( itMapCentralNode != myMapWithCentralNode.end() ) 
1244   {
1245     return (*itMapCentralNode).second;
1246   }
1247
1248   // Get type of shape for the new central node
1249
1250   TopAbs_ShapeEnum shapeType = TopAbs_SHAPE;
1251   int              solidID = -1;
1252   int              faceID = -1;
1253   TopoDS_Shape     shape;
1254   TopTools_ListIteratorOfListOfShape it;
1255
1256   std::map< int, int > faceId2nbNodes;
1257   std::map< int, int > ::iterator itMapWithIdFace;
1258   
1259   SMESHDS_Mesh* meshDS = GetMeshDS();
1260   
1261   // check if a face lies on a FACE, i.e. its all corner nodes lie either on the FACE or
1262   // on sub-shapes of the FACE
1263   if ( GetMesh()->HasShapeToMesh() )
1264   {
1265     const SMDS_MeshNode* nodes[] = { n1, n2, n3, n4 };
1266     for(int i = 0; i < 4; i++)
1267     {
1268       shape = GetSubShapeByNode( nodes[i], meshDS );
1269       if ( shape.IsNull() ) break;
1270       if ( shape.ShapeType() == TopAbs_SOLID )
1271       {
1272         solidID   = nodes[i]->getshapeId();
1273         shapeType = TopAbs_SOLID;
1274         break;
1275       }
1276       if ( shape.ShapeType() == TopAbs_FACE )
1277       {
1278         faceID          = nodes[i]->getshapeId();
1279         itMapWithIdFace = faceId2nbNodes.insert( std::make_pair( faceID, 0 ) ).first;
1280         itMapWithIdFace->second++;
1281       }
1282       else
1283       {
1284         PShapeIteratorPtr it = GetAncestors( shape, *GetMesh(), TopAbs_FACE );
1285         while ( const TopoDS_Shape* face = it->next() )
1286         {
1287           faceID = meshDS->ShapeToIndex( *face );
1288           itMapWithIdFace = faceId2nbNodes.insert( std::make_pair( faceID, 0 )).first;
1289           itMapWithIdFace->second++;
1290         }
1291       }
1292     }
1293   }
1294   if ( solidID < 1 && !faceId2nbNodes.empty() ) // SOLID not found
1295   {
1296     // find ID of the FACE the four corner nodes belong to
1297     itMapWithIdFace = faceId2nbNodes.find( myShapeID ); // IPAL52698
1298     if ( itMapWithIdFace != faceId2nbNodes.end() &&
1299          itMapWithIdFace->second == 4 )
1300     {
1301       shapeType = TopAbs_FACE;
1302       faceID = myShapeID;
1303     }
1304     else
1305     {
1306       itMapWithIdFace = faceId2nbNodes.begin();
1307       for ( ; itMapWithIdFace != faceId2nbNodes.end(); ++itMapWithIdFace)
1308       {
1309         if ( itMapWithIdFace->second == 4 )
1310         {
1311           shapeType = TopAbs_FACE;
1312           faceID = (*itMapWithIdFace).first;
1313           break;
1314         }
1315       }
1316     }
1317   }
1318
1319   TopoDS_Face F;
1320   if ( shapeType == TopAbs_FACE )
1321   {
1322     F = TopoDS::Face( meshDS->IndexToShape( faceID ));
1323   }
1324
1325   // Create a node
1326
1327   gp_XY  uvAvg;
1328   gp_Pnt P;
1329   bool toCheck = true;
1330   if ( !F.IsNull() && !force3d )
1331   {
1332     gp_XY uv[8] = {
1333       GetNodeUV( F,n1,  n3, &toCheck ),
1334       GetNodeUV( F,n2,  n4, &toCheck ),
1335       GetNodeUV( F,n3,  n1, &toCheck ),
1336       GetNodeUV( F,n4,  n2, &toCheck ),
1337       GetNodeUV( F,n12, n3 ),
1338       GetNodeUV( F,n23, n4 ),
1339       GetNodeUV( F,n34, n2 ),
1340       GetNodeUV( F,n41, n2 )
1341     };
1342     AdjustByPeriod( F, uv, 8 ); // put uv[] within a period (IPAL52698)
1343
1344     uvAvg = calcTFI (0.5, 0.5, uv[0],uv[1],uv[2],uv[3], uv[4],uv[5],uv[6],uv[7] );
1345
1346     TopLoc_Location loc;
1347     Handle( Geom_Surface ) S = BRep_Tool::Surface( F, loc );
1348     P = S->Value( uvAvg.X(), uvAvg.Y() ).Transformed( loc );
1349     centralNode = meshDS->AddNode( P.X(), P.Y(), P.Z() );
1350     // if ( mySetElemOnShape ) node is not elem!
1351     meshDS->SetNodeOnFace( centralNode, faceID, uvAvg.X(), uvAvg.Y() );
1352   }
1353   else // ( force3d || F.IsNull() )
1354   {
1355     P = calcTFI (0.5, 0.5,
1356                  SMESH_TNodeXYZ(n1),  SMESH_TNodeXYZ(n2),
1357                  SMESH_TNodeXYZ(n3),  SMESH_TNodeXYZ(n4),
1358                  SMESH_TNodeXYZ(n12), SMESH_TNodeXYZ(n23),
1359                  SMESH_TNodeXYZ(n34), SMESH_TNodeXYZ(n41));
1360     centralNode = meshDS->AddNode( P.X(), P.Y(), P.Z() );
1361
1362     if ( !F.IsNull() ) // force3d
1363     {
1364       uvAvg = (GetNodeUV(F,n1,n3,&toCheck) +
1365                GetNodeUV(F,n2,n4,&toCheck) +
1366                GetNodeUV(F,n3,n1,&toCheck) +
1367                GetNodeUV(F,n4,n2,&toCheck)) / 4;
1368       //CheckNodeUV( F, centralNode, uvAvg, 2*BRep_Tool::Tolerance( F ), /*force=*/true);
1369       meshDS->SetNodeOnFace( centralNode, faceID, uvAvg.X(), uvAvg.Y() );
1370     }
1371     else if ( solidID > 0 )
1372     {
1373       meshDS->SetNodeInVolume( centralNode, solidID );
1374     }
1375     else if ( myShapeID > 0 && mySetElemOnShape )
1376     {
1377       meshDS->SetMeshElementOnShape( centralNode, myShapeID );
1378     }
1379   }
1380   myMapWithCentralNode.insert( std::make_pair( keyOfMap, centralNode ) );
1381   return centralNode;
1382 }
1383
1384 //=======================================================================
1385 //function : GetCentralNode
1386 //purpose  : Return existing or create a new central node for a
1387 //           quadratic triangle given its 6 nodes.
1388 //@param   : force3d - true means node creation in between the given nodes,
1389 //           else node position is found on a geometrical face if any.
1390 //=======================================================================
1391
1392 const SMDS_MeshNode* SMESH_MesherHelper::GetCentralNode(const SMDS_MeshNode* n1,
1393                                                         const SMDS_MeshNode* n2,
1394                                                         const SMDS_MeshNode* n3,
1395                                                         const SMDS_MeshNode* n12,
1396                                                         const SMDS_MeshNode* n23,
1397                                                         const SMDS_MeshNode* n31,
1398                                                         bool                 force3d)
1399 {
1400   SMDS_MeshNode *centralNode = 0; // central node to return
1401
1402   // Find an existing central node
1403
1404   TBiQuad keyOfMap(n1,n2,n3);
1405   std::map<TBiQuad, const SMDS_MeshNode* >::iterator itMapCentralNode;
1406   itMapCentralNode = myMapWithCentralNode.find( keyOfMap );
1407   if ( itMapCentralNode != myMapWithCentralNode.end() ) 
1408   {
1409     return (*itMapCentralNode).second;
1410   }
1411
1412   // Get type of shape for the new central node
1413
1414   TopAbs_ShapeEnum shapeType = TopAbs_SHAPE;
1415   int              solidID = -1;
1416   int              faceID = -1;
1417   TopoDS_Shape     shape;
1418   TopTools_ListIteratorOfListOfShape it;
1419
1420   std::map< int, int > faceId2nbNodes;
1421   std::map< int, int > ::iterator itMapWithIdFace;
1422   
1423   SMESHDS_Mesh* meshDS = GetMeshDS();
1424   
1425   // check if a face lies on a FACE, i.e. its all corner nodes lie either on the FACE or
1426   // on sub-shapes of the FACE
1427   if ( GetMesh()->HasShapeToMesh() )
1428   {
1429     const SMDS_MeshNode* nodes[] = { n1, n2, n3 };
1430     for(int i = 0; i < 3; i++)
1431     {
1432       shape = GetSubShapeByNode( nodes[i], meshDS );
1433       if ( shape.IsNull() ) break;
1434       if ( shape.ShapeType() == TopAbs_SOLID )
1435       {
1436         solidID   = nodes[i]->getshapeId();
1437         shapeType = TopAbs_SOLID;
1438         break;
1439       }
1440       if ( shape.ShapeType() == TopAbs_FACE )
1441       {
1442         faceID          = nodes[i]->getshapeId();
1443         itMapWithIdFace = faceId2nbNodes.insert( std::make_pair( faceID, 0 ) ).first;
1444         itMapWithIdFace->second++;
1445       }
1446       else
1447       {
1448         PShapeIteratorPtr it = GetAncestors(shape, *GetMesh(), TopAbs_FACE );
1449         while ( const TopoDS_Shape* face = it->next() )
1450         {
1451           faceID = meshDS->ShapeToIndex( *face );
1452           itMapWithIdFace = faceId2nbNodes.insert( std::make_pair( faceID, 0 ) ).first;
1453           itMapWithIdFace->second++;
1454         }
1455       }
1456     }
1457   }
1458   if ( solidID < 1 && !faceId2nbNodes.empty() ) // SOLID not found
1459   {
1460     // find ID of the FACE the four corner nodes belong to
1461     itMapWithIdFace = faceId2nbNodes.find( myShapeID ); // IPAL52698
1462     if ( itMapWithIdFace != faceId2nbNodes.end() &&
1463          itMapWithIdFace->second == 4 )
1464     {
1465       shapeType = TopAbs_FACE;
1466       faceID = myShapeID;
1467     }
1468     else
1469     {
1470       itMapWithIdFace = faceId2nbNodes.begin();
1471       for ( ; itMapWithIdFace != faceId2nbNodes.end(); ++itMapWithIdFace)
1472       {
1473         if ( itMapWithIdFace->second == 3 )
1474         {
1475           shapeType = TopAbs_FACE;
1476           faceID = (*itMapWithIdFace).first;
1477           break;
1478         }
1479       }
1480     }
1481   }
1482
1483   TopoDS_Face F;
1484   gp_XY       uvAvg;
1485
1486   if ( shapeType == TopAbs_FACE )
1487   {
1488     F = TopoDS::Face( meshDS->IndexToShape( faceID ));
1489     bool checkOK = true, badTria = false;
1490     gp_XY uv[6] = {
1491       GetNodeUV( F, n1, n23, &checkOK ),
1492       GetNodeUV( F, n2, n31, &checkOK ),
1493       GetNodeUV( F, n3, n12, &checkOK ),
1494       GetNodeUV( F, n12, n3, &checkOK ),
1495       GetNodeUV( F, n23, n1, &checkOK ),
1496       GetNodeUV( F, n31, n2, &checkOK )
1497     };
1498     AdjustByPeriod( F, uv, 6 ); // put uv[] within a period (IPAL52698)
1499
1500     uvAvg = GetCenterUV( uv[0],uv[1],uv[2], uv[3],uv[4],uv[5], &badTria );
1501
1502     if ( badTria || !checkOK )
1503       force3d = true;
1504   }
1505
1506   // Create a central node
1507
1508   gp_Pnt P;
1509   if ( !F.IsNull() && !force3d )
1510   {
1511     TopLoc_Location        loc;
1512     Handle( Geom_Surface ) S = BRep_Tool::Surface( F, loc );
1513     P = S->Value( uvAvg.X(), uvAvg.Y() ).Transformed( loc );
1514     centralNode = meshDS->AddNode( P.X(), P.Y(), P.Z() );
1515     // if ( mySetElemOnShape ) node is not elem!
1516     meshDS->SetNodeOnFace( centralNode, faceID, uvAvg.X(), uvAvg.Y() );
1517   }
1518   else // ( force3d || F.IsNull() )
1519   {
1520     P = ( SMESH_TNodeXYZ( n12 ) +
1521           SMESH_TNodeXYZ( n23 ) +
1522           SMESH_TNodeXYZ( n31 ) ) / 3;
1523     centralNode = meshDS->AddNode( P.X(), P.Y(), P.Z() );
1524
1525     if ( !F.IsNull() ) // force3d
1526     {
1527       meshDS->SetNodeOnFace( centralNode, faceID, uvAvg.X(), uvAvg.Y() );
1528     }
1529     else if ( solidID > 0 )
1530     {
1531       meshDS->SetNodeInVolume( centralNode, solidID );
1532     }
1533     else if ( myShapeID > 0 && mySetElemOnShape )
1534     {
1535       meshDS->SetMeshElementOnShape( centralNode, myShapeID );
1536     }
1537   }
1538   myMapWithCentralNode.insert( std::make_pair( keyOfMap, centralNode ) );
1539   return centralNode;
1540 }
1541
1542 //=======================================================================
1543 //function : GetMediumNode
1544 //purpose  : Return existing or create a new medium node between given ones
1545 //=======================================================================
1546
1547 const SMDS_MeshNode* SMESH_MesherHelper::GetMediumNode(const SMDS_MeshNode* n1,
1548                                                        const SMDS_MeshNode* n2,
1549                                                        bool                 force3d,
1550                                                        TopAbs_ShapeEnum     expectedSupport)
1551 {
1552   // Find existing node
1553
1554   SMESH_TLink link(n1,n2);
1555   ItTLinkNode itLN = myTLinkNodeMap.find( link );
1556   if ( itLN != myTLinkNodeMap.end() ) {
1557     return (*itLN).second;
1558   }
1559
1560   // Create medium node
1561
1562   SMDS_MeshNode* n12;
1563   SMESHDS_Mesh* meshDS = GetMeshDS();
1564
1565   if ( IsSeamShape( n1->getshapeId() ))
1566     // to get a correct UV of a node on seam, the second node must have checked UV
1567     std::swap( n1, n2 );
1568
1569   // get type of shape for the new medium node
1570   int faceID = -1, edgeID = -1;
1571   TopoDS_Edge E; double u [2];
1572   TopoDS_Face F; gp_XY  uv[2];
1573   bool uvOK[2] = { true, true };
1574   const bool useCurSubShape = ( !myShape.IsNull() && myShape.ShapeType() == TopAbs_EDGE );
1575
1576   pair<int, TopAbs_ShapeEnum> pos = GetMediumPos( n1, n2, useCurSubShape, expectedSupport );
1577
1578   // get positions of the given nodes on shapes
1579   if ( pos.second == TopAbs_FACE )
1580   {
1581     F = TopoDS::Face(meshDS->IndexToShape( faceID = pos.first ));
1582     uv[0] = GetNodeUV(F,n1,n2, force3d ? 0 : &uvOK[0]);
1583     uv[1] = GetNodeUV(F,n2,n1, force3d ? 0 : &uvOK[1]);
1584   }
1585   else if ( pos.second == TopAbs_EDGE )
1586   {
1587     const SMDS_PositionPtr Pos1 = n1->GetPosition();
1588     const SMDS_PositionPtr Pos2 = n2->GetPosition();
1589     if ( Pos1->GetTypeOfPosition()==SMDS_TOP_EDGE &&
1590          Pos2->GetTypeOfPosition()==SMDS_TOP_EDGE &&
1591          n1->getshapeId() != n2->getshapeId() )
1592     {
1593       // issue 0021006
1594       return getMediumNodeOnComposedWire(n1,n2,force3d);
1595     }
1596     E = TopoDS::Edge(meshDS->IndexToShape( edgeID = pos.first ));
1597     try {
1598       u[0] = GetNodeU(E,n1,n2, force3d ? 0 : &uvOK[0]);
1599       u[1] = GetNodeU(E,n2,n1, force3d ? 0 : &uvOK[1]);
1600     }
1601     catch ( Standard_Failure& f )
1602     {
1603       // issue 22502 / a node is on VERTEX not belonging to E
1604       // issue 22568 / both nodes are on non-connected VERTEXes
1605       return getMediumNodeOnComposedWire(n1,n2,force3d);
1606     }
1607   }
1608
1609   if ( !force3d & uvOK[0] && uvOK[1] )
1610   {
1611     // we try to create medium node using UV parameters of
1612     // nodes, else - medium between corresponding 3d points
1613     if( ! F.IsNull() )
1614     {
1615       //if ( uvOK[0] && uvOK[1] )
1616       {
1617         if ( IsDegenShape( n1->getshapeId() )) {
1618           if ( myParIndex & U_periodic ) uv[0].SetCoord( 1, uv[1].Coord( 1 ));
1619           else                           uv[0].SetCoord( 2, uv[1].Coord( 2 ));
1620         }
1621         else if ( IsDegenShape( n2->getshapeId() )) {
1622           if ( myParIndex & U_periodic ) uv[1].SetCoord( 1, uv[0].Coord( 1 ));
1623           else                           uv[1].SetCoord( 2, uv[0].Coord( 2 ));
1624         }
1625         TopLoc_Location loc;
1626         Handle(Geom_Surface) S = BRep_Tool::Surface(F,loc);
1627         gp_XY UV = GetMiddleUV( S, uv[0], uv[1] );
1628         gp_Pnt P = S->Value( UV.X(), UV.Y() ).Transformed(loc);
1629         n12 = meshDS->AddNode(P.X(), P.Y(), P.Z());
1630         // if ( mySetElemOnShape ) node is not elem!
1631         meshDS->SetNodeOnFace(n12, faceID, UV.X(), UV.Y());
1632         myTLinkNodeMap.insert(make_pair(link,n12));
1633         return n12;
1634       }
1635     }
1636     else if ( !E.IsNull() )
1637     {
1638       double f,l;
1639       Handle(Geom_Curve) C = BRep_Tool::Curve(E, f, l);
1640       if(!C.IsNull())
1641       {
1642         Standard_Boolean isPeriodic = C->IsPeriodic();
1643         double U;
1644         if(isPeriodic) {
1645           Standard_Real Period = C->Period();
1646           Standard_Real p = u[1]+ShapeAnalysis::AdjustByPeriod(u[1],u[0],Period);
1647           Standard_Real pmid = (u[0]+p)/2.;
1648           U = pmid+ShapeAnalysis::AdjustToPeriod(pmid,C->FirstParameter(),C->LastParameter());
1649         }
1650         else
1651           U = (u[0]+u[1])/2.;
1652
1653         gp_Pnt P = C->Value( U );
1654         n12 = meshDS->AddNode(P.X(), P.Y(), P.Z());
1655         //if ( mySetElemOnShape ) node is not elem!
1656         meshDS->SetNodeOnEdge(n12, edgeID, U);
1657         myTLinkNodeMap.insert(make_pair(link,n12));
1658         return n12;
1659       }
1660     }
1661   }
1662
1663   // 3d variant
1664   double x = ( n1->X() + n2->X() )/2.;
1665   double y = ( n1->Y() + n2->Y() )/2.;
1666   double z = ( n1->Z() + n2->Z() )/2.;
1667   n12 = meshDS->AddNode(x,y,z);
1668
1669   //if ( mySetElemOnShape ) node is not elem!
1670   {
1671     if ( !F.IsNull() )
1672     {
1673       gp_XY UV = ( uv[0] + uv[1] ) / 2.;
1674       CheckNodeUV( F, n12, UV, 2 * BRep_Tool::Tolerance( F ), /*force=*/true);
1675       meshDS->SetNodeOnFace(n12, faceID, UV.X(), UV.Y() );
1676     }
1677     else if ( !E.IsNull() )
1678     {
1679       double U = ( u[0] + u[1] ) / 2.;
1680       CheckNodeU( E, n12, U, 2 * BRep_Tool::Tolerance( E ), /*force=*/true);
1681       meshDS->SetNodeOnEdge(n12, edgeID, U);
1682     }
1683     else if ( myShapeID > 0 && mySetElemOnShape )
1684     {
1685       meshDS->SetMeshElementOnShape(n12, myShapeID);
1686     }
1687   }
1688
1689   myTLinkNodeMap.insert( make_pair( link, n12 ));
1690   return n12;
1691 }
1692
1693 //================================================================================
1694 /*!
1695  * \brief Makes a medium node if nodes reside different edges
1696  */
1697 //================================================================================
1698
1699 const SMDS_MeshNode* SMESH_MesherHelper::getMediumNodeOnComposedWire(const SMDS_MeshNode* n1,
1700                                                                      const SMDS_MeshNode* n2,
1701                                                                      bool                 force3d)
1702 {
1703   SMESH_TNodeXYZ p1( n1 ), p2( n2 );
1704   gp_Pnt      middle = 0.5 * p1 + 0.5 * p2;
1705   SMDS_MeshNode* n12 = AddNode( middle.X(), middle.Y(), middle.Z() );
1706
1707   // To find position on edge and 3D position for n12,
1708   // project <middle> to 2 edges and select projection most close to <middle>
1709
1710   TopoDS_Edge bestEdge;
1711   double u = 0, distMiddleProj = Precision::Infinite(), distXYZ[4], f,l;
1712
1713   // get shapes under the nodes
1714   TopoDS_Shape shape[2];
1715   int nbShapes = 0;
1716   for ( int is2nd = 0; is2nd < 2; ++is2nd )
1717   {
1718     const SMDS_MeshNode* n = is2nd ? n2 : n1;
1719     TopoDS_Shape S = GetSubShapeByNode( n, GetMeshDS() );
1720     if ( !S.IsNull() )
1721       shape[ nbShapes++ ] = S;
1722   }
1723   // get EDGEs
1724   vector< TopoDS_Shape > edges;
1725   for ( int iS = 0; iS < nbShapes; ++iS )
1726   {
1727     switch ( shape[iS].ShapeType() ) {
1728     case TopAbs_EDGE:
1729     {
1730       edges.push_back( shape[iS] );
1731       break;
1732     }
1733     case TopAbs_VERTEX:
1734     {
1735       TopoDS_Shape edge;
1736       if ( nbShapes == 2 && iS==0 && shape[1-iS].ShapeType() == TopAbs_VERTEX )
1737         edge = GetCommonAncestor( shape[iS], shape[1-iS], *myMesh, TopAbs_EDGE );
1738
1739       if ( edge.IsNull() )
1740       {
1741         PShapeIteratorPtr eIt = GetAncestors( shape[iS], *myMesh, TopAbs_EDGE );
1742         while( const TopoDS_Shape* e = eIt->next() )
1743           edges.push_back( *e );
1744       }
1745       break;
1746     }
1747     case TopAbs_FACE:
1748     {
1749       if ( nbShapes == 1 || shape[1-iS].ShapeType() < TopAbs_EDGE )
1750         for ( TopExp_Explorer e( shape[iS], TopAbs_EDGE ); e.More(); e.Next() )
1751           edges.push_back( e.Current() );
1752       break;
1753     }
1754     default:
1755       continue;
1756     }
1757   }
1758   // project to get U of projection and distance from middle to projection
1759   for ( size_t iE = 0; iE < edges.size(); ++iE )
1760   {
1761     const TopoDS_Edge& edge = TopoDS::Edge( edges[ iE ]);
1762     distXYZ[0] = distMiddleProj;
1763     double testU = 0;
1764     CheckNodeU( edge, n12, testU, 2 * BRep_Tool::Tolerance(edge), /*force=*/true, distXYZ );
1765     if ( distXYZ[0] < distMiddleProj )
1766     {
1767       distMiddleProj = distXYZ[0];
1768       u = testU;
1769       bestEdge = edge;
1770     }
1771   }
1772   // {
1773   //   // both projections failed; set n12 on the edge of n1 with U of a common vertex
1774   //   TopoDS_Vertex vCommon;
1775   //   if ( TopExp::CommonVertex( edges[0], edges[1], vCommon ))
1776   //     u = BRep_Tool::Parameter( vCommon, edges[0] );
1777   //   else
1778   //   {
1779   //     double f,l, u0 = GetNodeU( edges[0], n1 );
1780   //     BRep_Tool::Range( edges[0],f,l );
1781   //     u = ( fabs(u0-f) < fabs(u0-l) ) ? f : l;
1782   //   }
1783   //   iOkEdge = 0;
1784   //   distMiddleProj = 0;
1785   // }
1786
1787   if ( !bestEdge.IsNull() )
1788   {
1789     // move n12 to position of a successfull projection
1790     //double tol = BRep_Tool::Tolerance(edges[ iOkEdge ]);
1791     if ( !force3d /*&& distMiddleProj > 2*tol*/ )
1792     {
1793       TopLoc_Location loc;
1794       Handle(Geom_Curve) curve = BRep_Tool::Curve( bestEdge,loc,f,l );
1795       gp_Pnt p = curve->Value( u ).Transformed( loc );
1796       GetMeshDS()->MoveNode( n12, p.X(), p.Y(), p.Z() );
1797     }
1798     //if ( mySetElemOnShape ) node is not elem!
1799     {
1800       int edgeID = GetMeshDS()->ShapeToIndex( bestEdge );
1801       if ( edgeID != n12->getshapeId() )
1802         GetMeshDS()->UnSetNodeOnShape( n12 );
1803       GetMeshDS()->SetNodeOnEdge(n12, edgeID, u);
1804     }
1805   }
1806   myTLinkNodeMap.insert( make_pair( SMESH_TLink(n1,n2), n12 ));
1807
1808   return n12;
1809 }
1810
1811 //=======================================================================
1812 //function : AddNode
1813 //purpose  : Creates a node
1814 //=======================================================================
1815
1816 SMDS_MeshNode* SMESH_MesherHelper::AddNode(double x, double y, double z, int ID,
1817                                            double u, double v)
1818 {
1819   SMESHDS_Mesh * meshDS = GetMeshDS();
1820   SMDS_MeshNode* node = 0;
1821   if ( ID )
1822     node = meshDS->AddNodeWithID( x, y, z, ID );
1823   else
1824     node = meshDS->AddNode( x, y, z );
1825   if ( mySetElemOnShape && myShapeID > 0 ) { // node is not elem ?
1826     switch ( myShape.ShapeType() ) {
1827     case TopAbs_SOLID:  meshDS->SetNodeInVolume( node, myShapeID);       break;
1828     case TopAbs_SHELL:  meshDS->SetNodeInVolume( node, myShapeID);       break;
1829     case TopAbs_FACE:   meshDS->SetNodeOnFace(   node, myShapeID, u, v); break;
1830     case TopAbs_EDGE:   meshDS->SetNodeOnEdge(   node, myShapeID, u);    break;
1831     case TopAbs_VERTEX: meshDS->SetNodeOnVertex( node, myShapeID);       break;
1832     default: ;
1833     }
1834   }
1835   return node;
1836 }
1837
1838 //=======================================================================
1839 //function : AddEdge
1840 //purpose  : Creates quadratic or linear edge
1841 //=======================================================================
1842
1843 SMDS_MeshEdge* SMESH_MesherHelper::AddEdge(const SMDS_MeshNode* n1,
1844                                            const SMDS_MeshNode* n2,
1845                                            const int            id,
1846                                            const bool           force3d)
1847 {
1848   SMESHDS_Mesh * meshDS = GetMeshDS();
1849   
1850   SMDS_MeshEdge* edge = 0;
1851   if (myCreateQuadratic) {
1852     const SMDS_MeshNode* n12 = GetMediumNode(n1,n2,force3d);
1853     if(id)
1854       edge = meshDS->AddEdgeWithID(n1, n2, n12, id);
1855     else
1856       edge = meshDS->AddEdge(n1, n2, n12);
1857   }
1858   else {
1859     if(id)
1860       edge = meshDS->AddEdgeWithID(n1, n2, id);
1861     else
1862       edge = meshDS->AddEdge(n1, n2);
1863   }
1864
1865   if ( mySetElemOnShape && myShapeID > 0 )
1866     meshDS->SetMeshElementOnShape( edge, myShapeID );
1867
1868   return edge;
1869 }
1870
1871 //=======================================================================
1872 //function : AddFace
1873 //purpose  : Creates quadratic or linear triangle
1874 //=======================================================================
1875
1876 SMDS_MeshFace* SMESH_MesherHelper::AddFace(const SMDS_MeshNode* n1,
1877                                            const SMDS_MeshNode* n2,
1878                                            const SMDS_MeshNode* n3,
1879                                            const int id,
1880                                            const bool force3d)
1881 {
1882   SMESHDS_Mesh * meshDS = GetMeshDS();
1883   SMDS_MeshFace* elem = 0;
1884
1885   if( n1==n2 || n2==n3 || n3==n1 )
1886     return elem;
1887
1888   if(!myCreateQuadratic) {
1889     if(id)
1890       elem = meshDS->AddFaceWithID(n1, n2, n3, id);
1891     else
1892       elem = meshDS->AddFace(n1, n2, n3);
1893   }
1894   else {
1895     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_FACE );
1896     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_FACE );
1897     const SMDS_MeshNode* n31 = GetMediumNode( n3, n1, force3d, TopAbs_FACE );
1898     if(myCreateBiQuadratic)
1899     {
1900      const SMDS_MeshNode* nCenter = GetCentralNode(n1, n2, n3, n12, n23, n31, force3d);
1901      if(id)
1902        elem = meshDS->AddFaceWithID(n1, n2, n3, n12, n23, n31, nCenter, id);
1903      else
1904        elem = meshDS->AddFace(n1, n2, n3, n12, n23, n31, nCenter);
1905     }
1906     else
1907     {
1908       if(id)
1909         elem = meshDS->AddFaceWithID(n1, n2, n3, n12, n23, n31, id);
1910       else
1911         elem = meshDS->AddFace(n1, n2, n3, n12, n23, n31);
1912     }
1913   }
1914   if ( mySetElemOnShape && myShapeID > 0 )
1915     meshDS->SetMeshElementOnShape( elem, myShapeID );
1916
1917   return elem;
1918 }
1919
1920 //=======================================================================
1921 //function : AddFace
1922 //purpose  : Creates bi-quadratic, quadratic or linear quadrangle
1923 //=======================================================================
1924
1925 SMDS_MeshFace* SMESH_MesherHelper::AddFace(const SMDS_MeshNode* n1,
1926                                            const SMDS_MeshNode* n2,
1927                                            const SMDS_MeshNode* n3,
1928                                            const SMDS_MeshNode* n4,
1929                                            const int            id,
1930                                            const bool           force3d)
1931 {
1932   SMESHDS_Mesh * meshDS = GetMeshDS();
1933   SMDS_MeshFace* elem = 0;
1934
1935   if( n1==n2 ) {
1936     return AddFace(n1,n3,n4,id,force3d);
1937   }
1938   if( n1==n3 ) {
1939     return AddFace(n1,n2,n4,id,force3d);
1940   }
1941   if( n1==n4 ) {
1942     return AddFace(n1,n2,n3,id,force3d);
1943   }
1944   if( n2==n3 ) {
1945     return AddFace(n1,n2,n4,id,force3d);
1946   }
1947   if( n2==n4 ) {
1948     return AddFace(n1,n2,n3,id,force3d);
1949   }
1950   if( n3==n4 ) {
1951     return AddFace(n1,n2,n3,id,force3d);
1952   }
1953
1954   if(!myCreateQuadratic) {
1955     if(id)
1956       elem = meshDS->AddFaceWithID(n1, n2, n3, n4, id);
1957     else
1958       elem = meshDS->AddFace(n1, n2, n3, n4);
1959   }
1960   else {
1961     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_FACE );
1962     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_FACE );
1963     const SMDS_MeshNode* n34 = GetMediumNode( n3, n4, force3d, TopAbs_FACE );
1964     const SMDS_MeshNode* n41 = GetMediumNode( n4, n1, force3d, TopAbs_FACE );
1965     if(myCreateBiQuadratic)
1966     {
1967      const SMDS_MeshNode* nCenter = GetCentralNode(n1, n2, n3, n4, n12, n23, n34, n41, force3d);
1968      if(id)
1969        elem = meshDS->AddFaceWithID(n1, n2, n3, n4, n12, n23, n34, n41, nCenter, id);
1970      else
1971        elem = meshDS->AddFace(n1, n2, n3, n4, n12, n23, n34, n41, nCenter);
1972     }
1973     else
1974     {
1975       if(id)
1976         elem = meshDS->AddFaceWithID(n1, n2, n3, n4, n12, n23, n34, n41, id);
1977       else
1978         elem = meshDS->AddFace(n1, n2, n3, n4, n12, n23, n34, n41);
1979     }
1980   }
1981   if ( mySetElemOnShape && myShapeID > 0 )
1982     meshDS->SetMeshElementOnShape( elem, myShapeID );
1983
1984   return elem;
1985 }
1986
1987 //=======================================================================
1988 //function : AddPolygonalFace
1989 //purpose  : Creates polygon, with additional nodes in quadratic mesh
1990 //=======================================================================
1991
1992 SMDS_MeshFace* SMESH_MesherHelper::AddPolygonalFace (const vector<const SMDS_MeshNode*>& nodes,
1993                                                      const int                           id,
1994                                                      const bool                          force3d)
1995 {
1996   SMESHDS_Mesh * meshDS = GetMeshDS();
1997   SMDS_MeshFace* elem = 0;
1998
1999   if(!myCreateQuadratic)
2000   {
2001     if(id)
2002       elem = meshDS->AddPolygonalFaceWithID(nodes, id);
2003     else
2004       elem = meshDS->AddPolygonalFace(nodes);
2005   }
2006   else
2007   {
2008     vector<const SMDS_MeshNode*> newNodes( nodes.size() * 2 );
2009     newNodes = nodes;
2010     for ( int i = 0; i < nodes.size(); ++i )
2011     {
2012       const SMDS_MeshNode* n1 = nodes[i];
2013       const SMDS_MeshNode* n2 = nodes[(i+1)%nodes.size()];
2014       const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_FACE );
2015       newNodes.push_back( n12 );
2016     }
2017     if(id)
2018       elem = meshDS->AddQuadPolygonalFaceWithID(newNodes, id);
2019     else
2020       elem = meshDS->AddQuadPolygonalFace(newNodes);
2021   }
2022   if ( mySetElemOnShape && myShapeID > 0 )
2023     meshDS->SetMeshElementOnShape( elem, myShapeID );
2024
2025   return elem;
2026 }
2027
2028 //=======================================================================
2029 //function : AddVolume
2030 //purpose  : Creates quadratic or linear prism
2031 //=======================================================================
2032
2033 SMDS_MeshVolume* SMESH_MesherHelper::AddVolume(const SMDS_MeshNode* n1,
2034                                                const SMDS_MeshNode* n2,
2035                                                const SMDS_MeshNode* n3,
2036                                                const SMDS_MeshNode* n4,
2037                                                const SMDS_MeshNode* n5,
2038                                                const SMDS_MeshNode* n6,
2039                                                const int id,
2040                                                const bool force3d)
2041 {
2042   SMESHDS_Mesh * meshDS = GetMeshDS();
2043   SMDS_MeshVolume* elem = 0;
2044   if(!myCreateQuadratic) {
2045     if(id)
2046       elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n5, n6, id);
2047     else
2048       elem = meshDS->AddVolume(n1, n2, n3, n4, n5, n6);
2049   }
2050   else {
2051     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_SOLID );
2052     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_SOLID );
2053     const SMDS_MeshNode* n31 = GetMediumNode( n3, n1, force3d, TopAbs_SOLID );
2054
2055     const SMDS_MeshNode* n45 = GetMediumNode( n4, n5, force3d, TopAbs_SOLID );
2056     const SMDS_MeshNode* n56 = GetMediumNode( n5, n6, force3d, TopAbs_SOLID );
2057     const SMDS_MeshNode* n64 = GetMediumNode( n6, n4, force3d, TopAbs_SOLID );
2058
2059     const SMDS_MeshNode* n14 = GetMediumNode( n1, n4, force3d, TopAbs_SOLID );
2060     const SMDS_MeshNode* n25 = GetMediumNode( n2, n5, force3d, TopAbs_SOLID );
2061     const SMDS_MeshNode* n36 = GetMediumNode( n3, n6, force3d, TopAbs_SOLID );
2062
2063     if(id)
2064       elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n5, n6,
2065                                      n12, n23, n31, n45, n56, n64, n14, n25, n36, id);
2066     else
2067       elem = meshDS->AddVolume(n1, n2, n3, n4, n5, n6,
2068                                n12, n23, n31, n45, n56, n64, n14, n25, n36);
2069   }
2070   if ( mySetElemOnShape && myShapeID > 0 )
2071     meshDS->SetMeshElementOnShape( elem, myShapeID );
2072
2073   return elem;
2074 }
2075
2076 //=======================================================================
2077 //function : AddVolume
2078 //purpose  : Creates quadratic or linear tetrahedron
2079 //=======================================================================
2080
2081 SMDS_MeshVolume* SMESH_MesherHelper::AddVolume(const SMDS_MeshNode* n1,
2082                                                const SMDS_MeshNode* n2,
2083                                                const SMDS_MeshNode* n3,
2084                                                const SMDS_MeshNode* n4,
2085                                                const int id,
2086                                                const bool force3d)
2087 {
2088   SMESHDS_Mesh * meshDS = GetMeshDS();
2089   SMDS_MeshVolume* elem = 0;
2090   if(!myCreateQuadratic) {
2091     if(id)
2092       elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, id);
2093     else
2094       elem = meshDS->AddVolume(n1, n2, n3, n4);
2095   }
2096   else {
2097     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_SOLID );
2098     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_SOLID );
2099     const SMDS_MeshNode* n31 = GetMediumNode( n3, n1, force3d, TopAbs_SOLID );
2100
2101     const SMDS_MeshNode* n14 = GetMediumNode( n1, n4, force3d, TopAbs_SOLID );
2102     const SMDS_MeshNode* n24 = GetMediumNode( n2, n4, force3d, TopAbs_SOLID );
2103     const SMDS_MeshNode* n34 = GetMediumNode( n3, n4, force3d, TopAbs_SOLID );
2104
2105     if(id)
2106       elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n12, n23, n31, n14, n24, n34, id);
2107     else
2108       elem = meshDS->AddVolume(n1, n2, n3, n4, n12, n23, n31, n14, n24, n34);
2109   }
2110   if ( mySetElemOnShape && myShapeID > 0 )
2111     meshDS->SetMeshElementOnShape( elem, myShapeID );
2112
2113   return elem;
2114 }
2115
2116 //=======================================================================
2117 //function : AddVolume
2118 //purpose  : Creates quadratic or linear pyramid
2119 //=======================================================================
2120
2121 SMDS_MeshVolume* SMESH_MesherHelper::AddVolume(const SMDS_MeshNode* n1,
2122                                                const SMDS_MeshNode* n2,
2123                                                const SMDS_MeshNode* n3,
2124                                                const SMDS_MeshNode* n4,
2125                                                const SMDS_MeshNode* n5,
2126                                                const int id,
2127                                                const bool force3d)
2128 {
2129   SMDS_MeshVolume* elem = 0;
2130   if(!myCreateQuadratic) {
2131     if(id)
2132       elem = GetMeshDS()->AddVolumeWithID(n1, n2, n3, n4, n5, id);
2133     else
2134       elem = GetMeshDS()->AddVolume(n1, n2, n3, n4, n5);
2135   }
2136   else {
2137     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_SOLID );
2138     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_SOLID );
2139     const SMDS_MeshNode* n34 = GetMediumNode( n3, n4, force3d, TopAbs_SOLID );
2140     const SMDS_MeshNode* n41 = GetMediumNode( n4, n1, force3d, TopAbs_SOLID );
2141
2142     const SMDS_MeshNode* n15 = GetMediumNode( n1, n5, force3d, TopAbs_SOLID );
2143     const SMDS_MeshNode* n25 = GetMediumNode( n2, n5, force3d, TopAbs_SOLID );
2144     const SMDS_MeshNode* n35 = GetMediumNode( n3, n5, force3d, TopAbs_SOLID );
2145     const SMDS_MeshNode* n45 = GetMediumNode( n4, n5, force3d, TopAbs_SOLID );
2146
2147     if(id)
2148       elem = GetMeshDS()->AddVolumeWithID ( n1,  n2,  n3,  n4,  n5,
2149                                             n12, n23, n34, n41,
2150                                             n15, n25, n35, n45,
2151                                             id);
2152     else
2153       elem = GetMeshDS()->AddVolume( n1,  n2,  n3,  n4,  n5,
2154                                      n12, n23, n34, n41,
2155                                      n15, n25, n35, n45);
2156   }
2157   if ( mySetElemOnShape && myShapeID > 0 )
2158     GetMeshDS()->SetMeshElementOnShape( elem, myShapeID );
2159
2160   return elem;
2161 }
2162
2163 //=======================================================================
2164 //function : AddVolume
2165 //purpose  : Creates tri-quadratic, quadratic or linear hexahedron
2166 //=======================================================================
2167
2168 SMDS_MeshVolume* SMESH_MesherHelper::AddVolume(const SMDS_MeshNode* n1,
2169                                                const SMDS_MeshNode* n2,
2170                                                const SMDS_MeshNode* n3,
2171                                                const SMDS_MeshNode* n4,
2172                                                const SMDS_MeshNode* n5,
2173                                                const SMDS_MeshNode* n6,
2174                                                const SMDS_MeshNode* n7,
2175                                                const SMDS_MeshNode* n8,
2176                                                const int id,
2177                                                const bool force3d)
2178 {
2179   SMESHDS_Mesh * meshDS = GetMeshDS();
2180   SMDS_MeshVolume* elem = 0;
2181   if(!myCreateQuadratic) {
2182     if(id)
2183       elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n5, n6, n7, n8, id);
2184     else
2185       elem = meshDS->AddVolume(n1, n2, n3, n4, n5, n6, n7, n8);
2186   }
2187   else {
2188     const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_SOLID );
2189     const SMDS_MeshNode* n23 = GetMediumNode( n2, n3, force3d, TopAbs_SOLID );
2190     const SMDS_MeshNode* n34 = GetMediumNode( n3, n4, force3d, TopAbs_SOLID );
2191     const SMDS_MeshNode* n41 = GetMediumNode( n4, n1, force3d, TopAbs_SOLID );
2192
2193     const SMDS_MeshNode* n56 = GetMediumNode( n5, n6, force3d, TopAbs_SOLID );
2194     const SMDS_MeshNode* n67 = GetMediumNode( n6, n7, force3d, TopAbs_SOLID );
2195     const SMDS_MeshNode* n78 = GetMediumNode( n7, n8, force3d, TopAbs_SOLID );
2196     const SMDS_MeshNode* n85 = GetMediumNode( n8, n5, force3d, TopAbs_SOLID );
2197
2198     const SMDS_MeshNode* n15 = GetMediumNode( n1, n5, force3d, TopAbs_SOLID );
2199     const SMDS_MeshNode* n26 = GetMediumNode( n2, n6, force3d, TopAbs_SOLID );
2200     const SMDS_MeshNode* n37 = GetMediumNode( n3, n7, force3d, TopAbs_SOLID );
2201     const SMDS_MeshNode* n48 = GetMediumNode( n4, n8, force3d, TopAbs_SOLID );
2202     if ( myCreateBiQuadratic )
2203     {
2204       const SMDS_MeshNode* n1234 = GetCentralNode( n1,n2,n3,n4,n12,n23,n34,n41,force3d );
2205       const SMDS_MeshNode* n1256 = GetCentralNode( n1,n2,n5,n6,n12,n26,n56,n15,force3d );
2206       const SMDS_MeshNode* n2367 = GetCentralNode( n2,n3,n6,n7,n23,n37,n67,n26,force3d );
2207       const SMDS_MeshNode* n3478 = GetCentralNode( n3,n4,n7,n8,n34,n48,n78,n37,force3d );
2208       const SMDS_MeshNode* n1458 = GetCentralNode( n1,n4,n5,n8,n41,n48,n15,n85,force3d );
2209       const SMDS_MeshNode* n5678 = GetCentralNode( n5,n6,n7,n8,n56,n67,n78,n85,force3d );
2210
2211       vector<gp_XYZ> pointsOnShapes( SMESH_Block::ID_Shell );
2212
2213       pointsOnShapes[ SMESH_Block::ID_V000 ] = SMESH_TNodeXYZ( n4 );
2214       pointsOnShapes[ SMESH_Block::ID_V100 ] = SMESH_TNodeXYZ( n8 );
2215       pointsOnShapes[ SMESH_Block::ID_V010 ] = SMESH_TNodeXYZ( n3 );
2216       pointsOnShapes[ SMESH_Block::ID_V110 ] = SMESH_TNodeXYZ( n7 );
2217       pointsOnShapes[ SMESH_Block::ID_V001 ] = SMESH_TNodeXYZ( n1 );
2218       pointsOnShapes[ SMESH_Block::ID_V101 ] = SMESH_TNodeXYZ( n5 );
2219       pointsOnShapes[ SMESH_Block::ID_V011 ] = SMESH_TNodeXYZ( n2 );
2220       pointsOnShapes[ SMESH_Block::ID_V111 ] = SMESH_TNodeXYZ( n6 );
2221
2222       pointsOnShapes[ SMESH_Block::ID_Ex00 ] = SMESH_TNodeXYZ( n48 );
2223       pointsOnShapes[ SMESH_Block::ID_Ex10 ] = SMESH_TNodeXYZ( n37 );
2224       pointsOnShapes[ SMESH_Block::ID_E0y0 ] = SMESH_TNodeXYZ( n15 );
2225       pointsOnShapes[ SMESH_Block::ID_E1y0 ] = SMESH_TNodeXYZ( n26 );
2226       pointsOnShapes[ SMESH_Block::ID_Ex01 ] = SMESH_TNodeXYZ( n34 );
2227       pointsOnShapes[ SMESH_Block::ID_Ex11 ] = SMESH_TNodeXYZ( n78 );
2228       pointsOnShapes[ SMESH_Block::ID_E0y1 ] = SMESH_TNodeXYZ( n12 );
2229       pointsOnShapes[ SMESH_Block::ID_E1y1 ] = SMESH_TNodeXYZ( n56 );
2230       pointsOnShapes[ SMESH_Block::ID_E00z ] = SMESH_TNodeXYZ( n41 );
2231       pointsOnShapes[ SMESH_Block::ID_E10z ] = SMESH_TNodeXYZ( n85 );
2232       pointsOnShapes[ SMESH_Block::ID_E01z ] = SMESH_TNodeXYZ( n23 );
2233       pointsOnShapes[ SMESH_Block::ID_E11z ] = SMESH_TNodeXYZ( n67 );
2234
2235       pointsOnShapes[ SMESH_Block::ID_Fxy0 ] = SMESH_TNodeXYZ( n3478 );
2236       pointsOnShapes[ SMESH_Block::ID_Fxy1 ] = SMESH_TNodeXYZ( n1256 );
2237       pointsOnShapes[ SMESH_Block::ID_Fx0z ] = SMESH_TNodeXYZ( n1458 );
2238       pointsOnShapes[ SMESH_Block::ID_Fx1z ] = SMESH_TNodeXYZ( n2367 );
2239       pointsOnShapes[ SMESH_Block::ID_F0yz ] = SMESH_TNodeXYZ( n1234 );
2240       pointsOnShapes[ SMESH_Block::ID_F1yz ] = SMESH_TNodeXYZ( n5678 );
2241
2242       gp_XYZ centerCube(0.5, 0.5, 0.5);
2243       gp_XYZ nCenterElem;
2244       SMESH_Block::ShellPoint( centerCube, pointsOnShapes, nCenterElem );
2245       const SMDS_MeshNode* nCenter =
2246         meshDS->AddNode( nCenterElem.X(), nCenterElem.Y(), nCenterElem.Z() );
2247       meshDS->SetNodeInVolume( nCenter, myShapeID );
2248
2249       if(id)
2250         elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n5, n6, n7, n8,
2251                                        n12, n23, n34, n41, n56, n67,
2252                                        n78, n85, n15, n26, n37, n48,
2253                                        n1234, n1256, n2367, n3478, n1458, n5678, nCenter, id);
2254       else
2255         elem = meshDS->AddVolume(n1, n2, n3, n4, n5, n6, n7, n8,
2256                                  n12, n23, n34, n41, n56, n67,
2257                                  n78, n85, n15, n26, n37, n48,
2258                                  n1234, n1256, n2367, n3478, n1458, n5678, nCenter);
2259     }
2260     else
2261     {
2262       if(id)
2263         elem = meshDS->AddVolumeWithID(n1, n2, n3, n4, n5, n6, n7, n8,
2264                                        n12, n23, n34, n41, n56, n67,
2265                                        n78, n85, n15, n26, n37, n48, id);
2266       else
2267         elem = meshDS->AddVolume(n1, n2, n3, n4, n5, n6, n7, n8,
2268                                  n12, n23, n34, n41, n56, n67,
2269                                  n78, n85, n15, n26, n37, n48);
2270     }
2271   }
2272   if ( mySetElemOnShape && myShapeID > 0 )
2273     meshDS->SetMeshElementOnShape( elem, myShapeID );
2274
2275   return elem;
2276 }
2277
2278 //=======================================================================
2279 //function : AddVolume
2280 //purpose  : Creates LINEAR!!!!!!!!! octahedron
2281 //=======================================================================
2282
2283 SMDS_MeshVolume* SMESH_MesherHelper::AddVolume(const SMDS_MeshNode* n1,
2284                                                const SMDS_MeshNode* n2,
2285                                                const SMDS_MeshNode* n3,
2286                                                const SMDS_MeshNode* n4,
2287                                                const SMDS_MeshNode* n5,
2288                                                const SMDS_MeshNode* n6,
2289                                                const SMDS_MeshNode* n7,
2290                                                const SMDS_MeshNode* n8,
2291                                                const SMDS_MeshNode* n9,
2292                                                const SMDS_MeshNode* n10,
2293                                                const SMDS_MeshNode* n11,
2294                                                const SMDS_MeshNode* n12,
2295                                                const int id, 
2296                                                bool force3d)
2297 {
2298   SMESHDS_Mesh * meshDS = GetMeshDS();
2299   SMDS_MeshVolume* elem = 0;
2300   if(id)
2301     elem = meshDS->AddVolumeWithID(n1,n2,n3,n4,n5,n6,n7,n8,n9,n10,n11,n12,id);
2302   else
2303     elem = meshDS->AddVolume(n1,n2,n3,n4,n5,n6,n7,n8,n9,n10,n11,n12);
2304   if ( mySetElemOnShape && myShapeID > 0 )
2305     meshDS->SetMeshElementOnShape( elem, myShapeID );
2306   return elem;
2307 }
2308
2309 //=======================================================================
2310 //function : AddPolyhedralVolume
2311 //purpose  : Creates polyhedron. In quadratic mesh, adds medium nodes
2312 //=======================================================================
2313
2314 SMDS_MeshVolume*
2315 SMESH_MesherHelper::AddPolyhedralVolume (const std::vector<const SMDS_MeshNode*>& nodes,
2316                                          const std::vector<int>&                  quantities,
2317                                          const int                                id,
2318                                          const bool                               force3d)
2319 {
2320   SMESHDS_Mesh * meshDS = GetMeshDS();
2321   SMDS_MeshVolume* elem = 0;
2322   if(!myCreateQuadratic)
2323   {
2324     if(id)
2325       elem = meshDS->AddPolyhedralVolumeWithID(nodes, quantities, id);
2326     else
2327       elem = meshDS->AddPolyhedralVolume(nodes, quantities);
2328   }
2329   else
2330   {
2331     vector<const SMDS_MeshNode*> newNodes;
2332     vector<int> newQuantities;
2333     for ( int iFace=0, iN=0; iFace < quantities.size(); ++iFace)
2334     {
2335       int nbNodesInFace = quantities[iFace];
2336       newQuantities.push_back(0);
2337       for ( int i = 0; i < nbNodesInFace; ++i )
2338       {
2339         const SMDS_MeshNode* n1 = nodes[ iN + i ];
2340         newNodes.push_back( n1 );
2341         newQuantities.back()++;
2342         
2343         const SMDS_MeshNode* n2 = nodes[ iN + ( i+1==nbNodesInFace ? 0 : i+1 )];
2344 //         if ( n1->GetPosition()->GetTypeOfPosition() != SMDS_TOP_3DSPACE &&
2345 //              n2->GetPosition()->GetTypeOfPosition() != SMDS_TOP_3DSPACE )
2346         {
2347           const SMDS_MeshNode* n12 = GetMediumNode( n1, n2, force3d, TopAbs_SOLID );
2348           newNodes.push_back( n12 );
2349           newQuantities.back()++;
2350         }
2351       }
2352       iN += nbNodesInFace;
2353     }
2354     if(id)
2355       elem = meshDS->AddPolyhedralVolumeWithID( newNodes, newQuantities, id );
2356     else
2357       elem = meshDS->AddPolyhedralVolume( newNodes, newQuantities );
2358   }
2359   if ( mySetElemOnShape && myShapeID > 0 )
2360     meshDS->SetMeshElementOnShape( elem, myShapeID );
2361
2362   return elem;
2363 }
2364
2365 namespace
2366 {
2367   //================================================================================
2368   /*!
2369    * \brief Check if a node belongs to any face of sub-mesh
2370    */
2371   //================================================================================
2372
2373   bool isNodeInSubMesh( const SMDS_MeshNode* n, const SMESHDS_SubMesh* sm )
2374   {
2375     SMDS_ElemIteratorPtr fIt = n->GetInverseElementIterator( SMDSAbs_Face );
2376     while ( fIt->more() )
2377       if ( sm->Contains( fIt->next() ))
2378         return true;
2379     return false;
2380   }
2381 }
2382
2383 //=======================================================================
2384 //function : IsSameElemGeometry
2385 //purpose  : Returns true if all elements of a sub-mesh are of same shape
2386 //=======================================================================
2387
2388 bool SMESH_MesherHelper::IsSameElemGeometry(const SMESHDS_SubMesh* smDS,
2389                                             SMDSAbs_GeometryType   shape,
2390                                             const bool             nullSubMeshRes)
2391 {
2392   if ( !smDS ) return nullSubMeshRes;
2393
2394   SMDS_ElemIteratorPtr elemIt = smDS->GetElements();
2395   while ( elemIt->more() ) {
2396     const SMDS_MeshElement* e = elemIt->next();
2397     if ( e->GetGeomType() != shape )
2398       return false;
2399   }
2400   return true;
2401 }
2402
2403 //=======================================================================
2404 //function : LoadNodeColumns
2405 //purpose  : Load nodes bound to face into a map of node columns
2406 //=======================================================================
2407
2408 bool SMESH_MesherHelper::LoadNodeColumns(TParam2ColumnMap & theParam2ColumnMap,
2409                                          const TopoDS_Face& theFace,
2410                                          const TopoDS_Edge& theBaseEdge,
2411                                          SMESHDS_Mesh*      theMesh,
2412                                          SMESH_ProxyMesh*   theProxyMesh)
2413 {
2414   return LoadNodeColumns(theParam2ColumnMap,
2415                          theFace,
2416                          std::list<TopoDS_Edge>(1,theBaseEdge),
2417                          theMesh,
2418                          theProxyMesh);
2419 }
2420
2421 //=======================================================================
2422 //function : LoadNodeColumns
2423 //purpose  : Load nodes bound to face into a map of node columns
2424 //=======================================================================
2425
2426 bool SMESH_MesherHelper::LoadNodeColumns(TParam2ColumnMap &            theParam2ColumnMap,
2427                                          const TopoDS_Face&            theFace,
2428                                          const std::list<TopoDS_Edge>& theBaseSide,
2429                                          SMESHDS_Mesh*                 theMesh,
2430                                          SMESH_ProxyMesh*              theProxyMesh)
2431 {
2432   // get a right sub-mesh of theFace
2433
2434   const SMESHDS_SubMesh* faceSubMesh = 0;
2435   if ( theProxyMesh )
2436   {
2437     faceSubMesh = theProxyMesh->GetSubMesh( theFace );
2438     if ( !faceSubMesh ||
2439          faceSubMesh->NbElements() == 0 ||
2440          theProxyMesh->IsTemporary( faceSubMesh->GetElements()->next() ))
2441     {
2442       // can use a proxy sub-mesh with not temporary elements only
2443       faceSubMesh = 0;
2444       theProxyMesh = 0;
2445     }
2446   }
2447   if ( !faceSubMesh )
2448     faceSubMesh = theMesh->MeshElements( theFace );
2449   if ( !faceSubMesh || faceSubMesh->NbElements() == 0 )
2450     return false;
2451
2452   if ( theParam2ColumnMap.empty() )
2453   {
2454     // get data of edges for normalization of params
2455     vector< double > length;
2456     double fullLen = 0;
2457     list<TopoDS_Edge>::const_iterator edge;
2458     {
2459       for ( edge = theBaseSide.begin(); edge != theBaseSide.end(); ++edge )
2460       {
2461         double len = std::max( 1e-10, SMESH_Algo::EdgeLength( *edge ));
2462         fullLen += len;
2463         length.push_back( len );
2464       }
2465     }
2466
2467     // get nodes on theBaseEdge sorted by param on edge and initialize theParam2ColumnMap with them
2468     edge = theBaseSide.begin();
2469     for ( int iE = 0; edge != theBaseSide.end(); ++edge, ++iE )
2470     {
2471       map< double, const SMDS_MeshNode*> sortedBaseNN;
2472       SMESH_Algo::GetSortedNodesOnEdge( theMesh, *edge,/*noMedium=*/true, sortedBaseNN );
2473
2474       map< double, const SMDS_MeshNode*>::iterator u_n;
2475       // pb with mesh_Projection_2D_00/A1 fixed by adding expectedSupport arg to GetMediumPos()
2476       // so the following solution is commented (hope forever :)
2477       //
2478       // SMESH_Algo::GetSortedNodesOnEdge( theMesh, *edge,/*noMedium=*/true, sortedBaseNN,
2479       // // SMDSAbs_Edge here is needed to be coherent with
2480       // // StdMeshers_FaceSide used by Quadrangle to get nodes
2481       // // on EDGE; else pb in mesh_Projection_2D_00/A1 where a
2482       // // medium node on EDGE is medium in a triangle but not
2483       // // in a segment
2484       // SMDSAbs_Edge );
2485       // if ( faceSubMesh->GetElements()->next()->IsQuadratic() )
2486       //   // filter off nodes medium in faces on theFace (same pb with mesh_Projection_2D_00/A1)
2487       //   for ( u_n = sortedBaseNN.begin(); u_n != sortedBaseNN.end() ;     )
2488       //   {
2489       //     const SMDS_MeshNode* node = u_n->second;
2490       //     SMDS_ElemIteratorPtr faceIt = node->GetInverseElementIterator( SMDSAbs_Face );
2491       //     if ( faceIt->more() && node ) {
2492       //       const SMDS_MeshElement* face = faceIt->next();
2493       //       if ( faceSubMesh->Contains( face ) && face->IsMediumNode( node ))
2494       //         node = 0;
2495       //     }
2496       //     if ( !node )
2497       //       sortedBaseNN.erase( u_n++ );
2498       //     else
2499       //       ++u_n;
2500       //   }
2501       if ( sortedBaseNN.empty() ) continue;
2502
2503       u_n = sortedBaseNN.begin();
2504       if ( theProxyMesh ) // from sortedBaseNN remove nodes not shared by faces of faceSubMesh
2505       {
2506         const SMDS_MeshNode* n1 = (++sortedBaseNN.begin())->second;
2507         const SMDS_MeshNode* n2 = (++sortedBaseNN.rbegin())->second;
2508         bool allNodesAreProxy = ( n1 != theProxyMesh->GetProxyNode( n1 ) &&
2509                                   n2 != theProxyMesh->GetProxyNode( n2 ));
2510         if ( allNodesAreProxy )
2511           for ( u_n = sortedBaseNN.begin(); u_n != sortedBaseNN.end(); u_n++ )
2512             u_n->second = theProxyMesh->GetProxyNode( u_n->second );
2513
2514         if ( u_n = sortedBaseNN.begin(), !isNodeInSubMesh( u_n->second, faceSubMesh ))
2515         {
2516           while ( ++u_n != sortedBaseNN.end() && !isNodeInSubMesh( u_n->second, faceSubMesh ));
2517           sortedBaseNN.erase( sortedBaseNN.begin(), u_n );
2518         }
2519         if ( !sortedBaseNN.empty() )
2520           if ( u_n = --sortedBaseNN.end(), !isNodeInSubMesh( u_n->second, faceSubMesh ))
2521           {
2522             while ( u_n != sortedBaseNN.begin() && !isNodeInSubMesh( (--u_n)->second, faceSubMesh ));
2523             sortedBaseNN.erase( ++u_n, sortedBaseNN.end() );
2524           }
2525         if ( sortedBaseNN.empty() ) continue;
2526       }
2527
2528       double f, l;
2529       BRep_Tool::Range( *edge, f, l );
2530       if ( edge->Orientation() == TopAbs_REVERSED ) std::swap( f, l );
2531       const double coeff = 1. / ( l - f ) * length[iE] / fullLen;
2532       const double prevPar = theParam2ColumnMap.empty() ? 0 : theParam2ColumnMap.rbegin()->first;
2533       for ( u_n = sortedBaseNN.begin(); u_n != sortedBaseNN.end(); u_n++ )
2534       {
2535         double par = prevPar + coeff * ( u_n->first - f );
2536         TParam2ColumnMap::iterator u2nn =
2537           theParam2ColumnMap.insert( theParam2ColumnMap.end(), make_pair( par, TNodeColumn()));
2538         u2nn->second.push_back( u_n->second );
2539       }
2540     }
2541     if ( theParam2ColumnMap.size() < 2 )
2542       return false;
2543   }
2544
2545   // nb rows of nodes
2546   int prevNbRows     = theParam2ColumnMap.begin()->second.size(); // current, at least 1 here
2547   int expectedNbRows = faceSubMesh->NbElements() / ( theParam2ColumnMap.size()-1 ); // to be added
2548
2549   // fill theParam2ColumnMap column by column by passing from nodes on
2550   // theBaseEdge up via mesh faces on theFace
2551
2552   TParam2ColumnMap::iterator par_nVec_1, par_nVec_2;
2553   par_nVec_2 = theParam2ColumnMap.begin();
2554   par_nVec_1 = par_nVec_2++;
2555   TIDSortedElemSet emptySet, avoidSet;
2556   for ( ; par_nVec_2 != theParam2ColumnMap.end(); ++par_nVec_1, ++par_nVec_2 )
2557   {
2558     vector<const SMDS_MeshNode*>& nCol1 = par_nVec_1->second;
2559     vector<const SMDS_MeshNode*>& nCol2 = par_nVec_2->second;
2560     nCol1.resize( prevNbRows + expectedNbRows );
2561     nCol2.resize( prevNbRows + expectedNbRows );
2562
2563     int i1, i2, foundNbRows = 0;
2564     const SMDS_MeshNode *n1 = nCol1[ prevNbRows-1 ];
2565     const SMDS_MeshNode *n2 = nCol2[ prevNbRows-1 ];
2566     // find face sharing node n1 and n2 and belonging to faceSubMesh
2567     while ( const SMDS_MeshElement* face =
2568             SMESH_MeshAlgos::FindFaceInSet( n1, n2, emptySet, avoidSet, &i1, &i2))
2569     {
2570       if ( faceSubMesh->Contains( face ))
2571       {
2572         int nbNodes = face->NbCornerNodes();
2573         if ( nbNodes != 4 )
2574           return false;
2575         if ( foundNbRows + 1 > expectedNbRows )
2576           return false;
2577         n1 = face->GetNode( (i2+2) % 4 ); // opposite corner of quadrangle face
2578         n2 = face->GetNode( (i1+2) % 4 );
2579         nCol1[ prevNbRows + foundNbRows] = n1;
2580         nCol2[ prevNbRows + foundNbRows] = n2;
2581         ++foundNbRows;
2582       }
2583       avoidSet.insert( face );
2584     }
2585     if ( foundNbRows != expectedNbRows )
2586       return false;
2587     avoidSet.clear();
2588   }
2589   return ( theParam2ColumnMap.size() > 1 &&
2590            theParam2ColumnMap.begin()->second.size() == prevNbRows + expectedNbRows );
2591 }
2592
2593 namespace
2594 {
2595   //================================================================================
2596   /*!
2597    * \brief Return true if a node is at a corner of a 2D structured mesh of FACE
2598    */
2599   //================================================================================
2600
2601   bool isCornerOfStructure( const SMDS_MeshNode*   n,
2602                             const SMESHDS_SubMesh* faceSM,
2603                             SMESH_MesherHelper&    faceAnalyser )
2604   {
2605     int nbFacesInSM = 0;
2606     if ( n ) {
2607       SMDS_ElemIteratorPtr fIt = n->GetInverseElementIterator( SMDSAbs_Face );
2608       while ( fIt->more() )
2609         nbFacesInSM += faceSM->Contains( fIt->next() );
2610     }
2611     if ( nbFacesInSM == 1 )
2612       return true;
2613
2614     if ( nbFacesInSM == 2 && n->GetPosition()->GetTypeOfPosition() == SMDS_TOP_VERTEX )
2615     {
2616       return faceAnalyser.IsRealSeam( n->getshapeId() );
2617     }
2618     return false;
2619   }
2620 }
2621
2622 //=======================================================================
2623 //function : IsStructured
2624 //purpose  : Return true if 2D mesh on FACE is a structured rectangle
2625 //=======================================================================
2626
2627 bool SMESH_MesherHelper::IsStructured( SMESH_subMesh* faceSM )
2628 {
2629   SMESHDS_SubMesh* fSM = faceSM->GetSubMeshDS();
2630   if ( !fSM || fSM->NbElements() == 0 )
2631     return false;
2632
2633   list< TopoDS_Edge > edges;
2634   list< int > nbEdgesInWires;
2635   int nbWires = SMESH_Block::GetOrderedEdges( TopoDS::Face( faceSM->GetSubShape() ),
2636                                               edges, nbEdgesInWires );
2637   if ( nbWires != 1 /*|| nbEdgesInWires.front() != 4*/ ) // allow composite sides
2638     return false;
2639
2640   // algo: find corners of a structure and then analyze nb of faces and
2641   // length of structure sides
2642
2643   SMESHDS_Mesh* meshDS = faceSM->GetFather()->GetMeshDS();
2644   SMESH_MesherHelper faceAnalyser( *faceSM->GetFather() );
2645   faceAnalyser.SetSubShape( faceSM->GetSubShape() );
2646
2647   // rotate edges to get the first node being at corner
2648   // (in principle it's not necessary because so far none SALOME algo can make
2649   //  such a structured mesh that all corner nodes are not on VERTEXes)
2650   bool isCorner     = false;
2651   int nbRemainEdges = nbEdgesInWires.front();
2652   do {
2653     TopoDS_Vertex V = IthVertex( 0, edges.front() );
2654     isCorner = isCornerOfStructure( SMESH_Algo::VertexNode( V, meshDS ),
2655                                     fSM, faceAnalyser);
2656     if ( !isCorner ) {
2657       edges.splice( edges.end(), edges, edges.begin() );
2658       --nbRemainEdges;
2659     }
2660   }
2661   while ( !isCorner && nbRemainEdges > 0 );
2662
2663   if ( !isCorner )
2664     return false;
2665
2666   // get all nodes from EDGEs
2667   list< const SMDS_MeshNode* > nodes;
2668   list< TopoDS_Edge >::iterator edge = edges.begin();
2669   for ( ; edge != edges.end(); ++edge )
2670   {
2671     map< double, const SMDS_MeshNode* > u2Nodes;
2672     if ( !SMESH_Algo::GetSortedNodesOnEdge( meshDS, *edge,
2673                                             /*skipMedium=*/true, u2Nodes ))
2674       return false;
2675
2676     list< const SMDS_MeshNode* > edgeNodes;
2677     map< double, const SMDS_MeshNode* >::iterator u2n = u2Nodes.begin();
2678     for ( ; u2n != u2Nodes.end(); ++u2n )
2679       edgeNodes.push_back( u2n->second );
2680     if ( edge->Orientation() == TopAbs_REVERSED )
2681       edgeNodes.reverse();
2682
2683     if ( !nodes.empty() && nodes.back() == edgeNodes.front() )
2684       edgeNodes.pop_front();
2685     nodes.splice( nodes.end(), edgeNodes, edgeNodes.begin(), edgeNodes.end() );
2686   }
2687
2688   // get length of structured sides
2689   vector<int> nbEdgesInSide;
2690   int nbEdges = 0;
2691   list< const SMDS_MeshNode* >::iterator n = ++nodes.begin();
2692   for ( ; n != nodes.end(); ++n )
2693   {
2694     ++nbEdges;
2695     if ( isCornerOfStructure( *n, fSM, faceAnalyser )) {
2696       nbEdgesInSide.push_back( nbEdges );
2697       nbEdges = 0;
2698     }
2699   }
2700
2701   // checks
2702   if ( nbEdgesInSide.size() != 4 )
2703     return false;
2704   if ( nbEdgesInSide[0] != nbEdgesInSide[2] )
2705     return false;
2706   if ( nbEdgesInSide[1] != nbEdgesInSide[3] )
2707     return false;
2708   if ( nbEdgesInSide[0] * nbEdgesInSide[1] != fSM->NbElements() )
2709     return false;
2710
2711   return true;
2712 }
2713
2714 //=======================================================================
2715 //function : IsDistorted2D
2716 //purpose  : Return true if 2D mesh on FACE is ditorted
2717 //=======================================================================
2718
2719 bool SMESH_MesherHelper::IsDistorted2D( SMESH_subMesh* faceSM,
2720                                         bool           checkUV)
2721 {
2722   if ( !faceSM || faceSM->GetSubShape().ShapeType() != TopAbs_FACE )
2723     return false;
2724
2725   bool haveBadFaces = false;
2726
2727   SMESH_MesherHelper helper( *faceSM->GetFather() );
2728   helper.SetSubShape( faceSM->GetSubShape() );
2729
2730   const TopoDS_Face&  F = TopoDS::Face( faceSM->GetSubShape() );
2731   SMESHDS_SubMesh* smDS = helper.GetMeshDS()->MeshElements( F );
2732   if ( !smDS || smDS->NbElements() == 0 ) return false;
2733
2734   SMDS_ElemIteratorPtr faceIt = smDS->GetElements();
2735   double prevArea = 0;
2736   vector< const SMDS_MeshNode* > nodes;
2737   vector< gp_XY >                uv;
2738   bool* toCheckUV = checkUV ? & checkUV : 0;
2739   while ( faceIt->more() && !haveBadFaces )
2740   {
2741     const SMDS_MeshElement* face = faceIt->next();
2742
2743     // get nodes
2744     nodes.resize( face->NbCornerNodes() );
2745     SMDS_MeshElement::iterator n = face->begin_nodes();
2746     for ( size_t i = 0; i < nodes.size(); ++n, ++i )
2747       nodes[ i ] = *n;
2748
2749     // avoid elems on degenarate shapes as UV on them can be wrong
2750     if ( helper.HasDegeneratedEdges() )
2751     {
2752       bool isOnDegen = false;
2753       for ( size_t i = 0; ( i < nodes.size() && !isOnDegen ); ++i )
2754         isOnDegen = helper.IsDegenShape( nodes[ i ]->getshapeId() );
2755       if ( isOnDegen )
2756         continue;
2757     }
2758     // prepare to getting UVs
2759     const SMDS_MeshNode* inFaceNode = 0;
2760     if ( helper.HasSeam() ) {
2761       for ( size_t i = 0; ( i < nodes.size() && !inFaceNode ); ++i )
2762         if ( !helper.IsSeamShape( nodes[ i ]->getshapeId() ))
2763           inFaceNode = nodes[ i ];
2764       if ( !inFaceNode )
2765         continue;
2766     }
2767     // get UVs
2768     uv.resize( nodes.size() );
2769     for ( size_t i = 0; i < nodes.size(); ++i )
2770       uv[ i ] = helper.GetNodeUV( F, nodes[ i ], inFaceNode, toCheckUV );
2771
2772     // compare orientation of triangles
2773     double faceArea = 0;
2774     for ( int iT = 0, nbT = nodes.size()-2; iT < nbT; ++iT )
2775     {
2776       gp_XY v1 = uv[ iT+1 ] - uv[ 0 ];
2777       gp_XY v2 = uv[ iT+2 ] - uv[ 0 ];
2778       faceArea += v2 ^ v1;
2779     }
2780     haveBadFaces = ( faceArea * prevArea < 0 );
2781     prevArea = faceArea;
2782   }
2783
2784   return haveBadFaces;
2785 }
2786
2787 //================================================================================
2788 /*!
2789  * \brief Find out elements orientation on a geometrical face
2790  * \param theFace - The face correctly oriented in the shape being meshed
2791  * \retval bool - true if the face normal and the normal of first element
2792  *                in the correspoding submesh point in different directions
2793  */
2794 //================================================================================
2795
2796 bool SMESH_MesherHelper::IsReversedSubMesh (const TopoDS_Face& theFace)
2797 {
2798   if ( theFace.IsNull() )
2799     return false;
2800
2801   // find out orientation of a meshed face
2802   int faceID = GetMeshDS()->ShapeToIndex( theFace );
2803   TopoDS_Shape aMeshedFace = GetMeshDS()->IndexToShape( faceID );
2804   bool isReversed = ( theFace.Orientation() != aMeshedFace.Orientation() );
2805
2806   const SMESHDS_SubMesh * aSubMeshDSFace = GetMeshDS()->MeshElements( faceID );
2807   if ( !aSubMeshDSFace )
2808     return isReversed;
2809
2810   // find an element on a bounday of theFace
2811   SMDS_ElemIteratorPtr iteratorElem = aSubMeshDSFace->GetElements();
2812   const SMDS_MeshNode* nn[2];
2813   while ( iteratorElem->more() ) // loop on elements on theFace
2814   {
2815     const SMDS_MeshElement* elem = iteratorElem->next();
2816     if ( ! elem ) continue;
2817
2818     // look for 2 nodes on EDGE
2819     int nbNodes = elem->NbCornerNodes();
2820     nn[0] = elem->GetNode( nbNodes-1 );
2821     for ( int iN = 0; iN < nbNodes; ++iN )
2822     {
2823       nn[1] = elem->GetNode( iN );
2824       if ( nn[0]->GetPosition()->GetDim() < 2 &&
2825            nn[1]->GetPosition()->GetDim() < 2 )
2826       {
2827         TopoDS_Shape s0 = GetSubShapeByNode( nn[0], GetMeshDS() );
2828         TopoDS_Shape s1 = GetSubShapeByNode( nn[1], GetMeshDS() );
2829         TopoDS_Shape  E = GetCommonAncestor( s0, s1, *myMesh, TopAbs_EDGE );
2830         if ( !E.IsNull() && !s0.IsSame( s1 ))
2831         {
2832           // is E seam edge?
2833           int nb = 0;
2834           for ( TopExp_Explorer exp( theFace, TopAbs_EDGE ); exp.More(); exp.Next() )
2835             if ( E.IsSame( exp.Current() )) {
2836               ++nb;
2837               E = exp.Current(); // to know orientation
2838             }
2839           if ( nb == 1 )
2840           {
2841             bool ok = true;
2842             double u0 = GetNodeU( TopoDS::Edge( E ), nn[0], nn[1], &ok );
2843             double u1 = GetNodeU( TopoDS::Edge( E ), nn[1], nn[0], &ok );
2844             if ( ok )
2845             {
2846               isReversed = ( u0 > u1 );
2847               if ( E.Orientation() == TopAbs_REVERSED )
2848                 isReversed = !isReversed;
2849               return isReversed;
2850             }
2851           }
2852         }
2853       }
2854       nn[0] = nn[1];
2855     }
2856   }
2857
2858   // find an element with a good normal
2859   gp_Vec Ne;
2860   bool normalOK = false;
2861   gp_XY uv;
2862   iteratorElem = aSubMeshDSFace->GetElements();
2863   while ( !normalOK && iteratorElem->more() ) // loop on elements on theFace
2864   {
2865     const SMDS_MeshElement* elem = iteratorElem->next();
2866     if ( ! SMESH_MeshAlgos::FaceNormal( elem, const_cast<gp_XYZ&>( Ne.XYZ() ), /*normalized=*/0 ))
2867       continue;
2868     normalOK = true;
2869
2870     // get UV of a node inside theFACE
2871     SMDS_ElemIteratorPtr nodesIt = elem->nodesIterator();
2872     const SMDS_MeshNode* nInFace = 0;
2873     int iPosDim = SMDS_TOP_VERTEX;
2874     while ( nodesIt->more() ) // loop on nodes
2875     {
2876       const SMDS_MeshNode* n = static_cast<const SMDS_MeshNode*>( nodesIt->next() );
2877       if ( n->GetPosition()->GetTypeOfPosition() >= iPosDim )
2878       {
2879         nInFace = n;
2880         iPosDim = n->GetPosition()->GetTypeOfPosition();
2881       }
2882     }
2883     uv = GetNodeUV( theFace, nInFace, 0, &normalOK );
2884   }
2885   if ( !normalOK )
2886     return isReversed;
2887
2888   // face normal at node position
2889   TopLoc_Location loc;
2890   Handle(Geom_Surface) surf = BRep_Tool::Surface( theFace, loc );
2891   // if ( surf.IsNull() || surf->Continuity() < GeomAbs_C1 )
2892   // some surfaces not detected as GeomAbs_C1 are nevertheless correct for meshing
2893   if ( surf.IsNull() || surf->Continuity() < GeomAbs_C0 )
2894     return isReversed;
2895
2896   gp_Vec d1u, d1v; gp_Pnt p;
2897   surf->D1( uv.X(), uv.Y(), p, d1u, d1v );
2898   gp_Vec Nf = (d1u ^ d1v).Transformed( loc );
2899
2900   if ( theFace.Orientation() == TopAbs_REVERSED )
2901     Nf.Reverse();
2902
2903   return Ne * Nf < 0.;
2904 }
2905
2906 //=======================================================================
2907 //function : Count
2908 //purpose  : Count nb of sub-shapes
2909 //=======================================================================
2910
2911 int SMESH_MesherHelper::Count(const TopoDS_Shape&    shape,
2912                               const TopAbs_ShapeEnum type,
2913                               const bool             ignoreSame)
2914 {
2915   if ( ignoreSame ) {
2916     TopTools_IndexedMapOfShape map;
2917     TopExp::MapShapes( shape, type, map );
2918     return map.Extent();
2919   }
2920   else {
2921     int nb = 0;
2922     for ( TopExp_Explorer exp( shape, type ); exp.More(); exp.Next() )
2923       ++nb;
2924     return nb;
2925   }
2926 }
2927
2928 //=======================================================================
2929 //function : NbAncestors
2930 //purpose  : Return number of unique ancestors of the shape
2931 //=======================================================================
2932
2933 int SMESH_MesherHelper::NbAncestors(const TopoDS_Shape& shape,
2934                                     const SMESH_Mesh&   mesh,
2935                                     TopAbs_ShapeEnum    ancestorType/*=TopAbs_SHAPE*/)
2936 {
2937   TopTools_MapOfShape ancestors;
2938   TopTools_ListIteratorOfListOfShape ansIt( mesh.GetAncestors(shape) );
2939   for ( ; ansIt.More(); ansIt.Next() ) {
2940     if ( ancestorType == TopAbs_SHAPE || ansIt.Value().ShapeType() == ancestorType )
2941       ancestors.Add( ansIt.Value() );
2942   }
2943   return ancestors.Extent();
2944 }
2945
2946 //=======================================================================
2947 //function : GetSubShapeOri
2948 //purpose  : Return orientation of sub-shape in the main shape
2949 //=======================================================================
2950
2951 TopAbs_Orientation SMESH_MesherHelper::GetSubShapeOri(const TopoDS_Shape& shape,
2952                                                       const TopoDS_Shape& subShape)
2953 {
2954   TopAbs_Orientation ori = TopAbs_Orientation(-1);
2955   if ( !shape.IsNull() && !subShape.IsNull() )
2956   {
2957     TopExp_Explorer e( shape, subShape.ShapeType() );
2958     if ( shape.Orientation() >= TopAbs_INTERNAL ) // TopAbs_INTERNAL or TopAbs_EXTERNAL
2959       e.Init( shape.Oriented(TopAbs_FORWARD), subShape.ShapeType() );
2960     for ( ; e.More(); e.Next())
2961       if ( subShape.IsSame( e.Current() ))
2962         break;
2963     if ( e.More() )
2964       ori = e.Current().Orientation();
2965   }
2966   return ori;
2967 }
2968
2969 //=======================================================================
2970 //function : IsSubShape
2971 //purpose  : 
2972 //=======================================================================
2973
2974 bool SMESH_MesherHelper::IsSubShape( const TopoDS_Shape& shape,
2975                                      const TopoDS_Shape& mainShape )
2976 {
2977   if ( !shape.IsNull() && !mainShape.IsNull() )
2978   {
2979     for ( TopExp_Explorer exp( mainShape, shape.ShapeType());
2980           exp.More();
2981           exp.Next() )
2982       if ( shape.IsSame( exp.Current() ))
2983         return true;
2984   }
2985   SCRUTE((shape.IsNull()));
2986   SCRUTE((mainShape.IsNull()));
2987   return false;
2988 }
2989
2990 //=======================================================================
2991 //function : IsSubShape
2992 //purpose  : 
2993 //=======================================================================
2994
2995 bool SMESH_MesherHelper::IsSubShape( const TopoDS_Shape& shape, SMESH_Mesh* aMesh )
2996 {
2997   if ( shape.IsNull() || !aMesh )
2998     return false;
2999   return
3000     aMesh->GetMeshDS()->ShapeToIndex( shape ) ||
3001     // PAL16202
3002     (shape.ShapeType() == TopAbs_COMPOUND && aMesh->GetMeshDS()->IsGroupOfSubShapes( shape ));
3003 }
3004
3005 //=======================================================================
3006 //function : IsBlock
3007 //purpose  : 
3008 //=======================================================================
3009
3010 bool SMESH_MesherHelper::IsBlock( const TopoDS_Shape& shape )
3011 {
3012   if ( shape.IsNull() )
3013     return false;
3014
3015   TopoDS_Shell shell;
3016   TopExp_Explorer exp( shape, TopAbs_SHELL );
3017   if ( !exp.More() ) return false;
3018   shell = TopoDS::Shell( exp.Current() );
3019   if ( exp.Next(), exp.More() ) return false;
3020
3021   TopoDS_Vertex v;
3022   TopTools_IndexedMapOfOrientedShape map;
3023   return SMESH_Block::FindBlockShapes( shell, v, v, map );
3024 }
3025
3026
3027 //================================================================================
3028 /*!
3029  * \brief Return maximal tolerance of shape
3030  */
3031 //================================================================================
3032
3033 double SMESH_MesherHelper::MaxTolerance( const TopoDS_Shape& shape )
3034 {
3035   double tol = Precision::Confusion();
3036   TopExp_Explorer exp;
3037   for ( exp.Init( shape, TopAbs_FACE ); exp.More(); exp.Next() )
3038     tol = Max( tol, BRep_Tool::Tolerance( TopoDS::Face( exp.Current())));
3039   for ( exp.Init( shape, TopAbs_EDGE ); exp.More(); exp.Next() )
3040     tol = Max( tol, BRep_Tool::Tolerance( TopoDS::Edge( exp.Current())));
3041   for ( exp.Init( shape, TopAbs_VERTEX ); exp.More(); exp.Next() )
3042     tol = Max( tol, BRep_Tool::Tolerance( TopoDS::Vertex( exp.Current())));
3043
3044   return tol;
3045 }
3046
3047 //================================================================================
3048 /*!
3049  * \brief Return MaxTolerance( face ), probably cached
3050  */
3051 //================================================================================
3052
3053 double SMESH_MesherHelper::getFaceMaxTol( const TopoDS_Shape& face ) const
3054 {
3055   int faceID = GetMeshDS()->ShapeToIndex( face );
3056
3057   SMESH_MesherHelper* me = const_cast< SMESH_MesherHelper* >( this );
3058   double & tol = me->myFaceMaxTol.insert( make_pair( faceID, -1. )).first->second;
3059   if ( tol < 0 )
3060     tol = MaxTolerance( face );
3061
3062   return tol;
3063 }
3064
3065 //================================================================================
3066 /*!
3067  * \brief Return an angle between two EDGEs sharing a common VERTEX with reference
3068  *        of the FACE normal
3069  *  \return double - the angle (between -Pi and Pi), negative if the angle is concave,
3070  *                   1e100 in case of failure
3071  *  \waring Care about order of the EDGEs and their orientation to be as they are
3072  *          within the FACE! Don't pass degenerated EDGEs neither!
3073  */
3074 //================================================================================
3075
3076 double SMESH_MesherHelper::GetAngle( const TopoDS_Edge &   theE1,
3077                                      const TopoDS_Edge &   theE2,
3078                                      const TopoDS_Face &   theFace,
3079                                      const TopoDS_Vertex & theCommonV,
3080                                      gp_Vec*               theFaceNormal)
3081 {
3082   double angle = 1e100;
3083   try
3084   {
3085     double f,l;
3086     Handle(Geom_Curve)     c1 = BRep_Tool::Curve( theE1, f,l );
3087     Handle(Geom_Curve)     c2 = BRep_Tool::Curve( theE2, f,l );
3088     Handle(Geom2d_Curve) c2d1 = BRep_Tool::CurveOnSurface( theE1, theFace, f,l );
3089     Handle(Geom_Surface) surf = BRep_Tool::Surface( theFace );
3090     double                 p1 = BRep_Tool::Parameter( theCommonV, theE1 );
3091     double                 p2 = BRep_Tool::Parameter( theCommonV, theE2 );
3092     if ( c1.IsNull() || c2.IsNull() )
3093       return angle;
3094     gp_XY uv = c2d1->Value( p1 ).XY();
3095     gp_Vec du, dv; gp_Pnt p;
3096     surf->D1( uv.X(), uv.Y(), p, du, dv );
3097     gp_Vec vec1, vec2, vecRef = du ^ dv;
3098     int  nbLoops = 0;
3099     double p1tmp = p1;
3100     while ( vecRef.SquareMagnitude() < 1e-25 )
3101     {
3102       double dp = ( l - f ) / 1000.;
3103       p1tmp += dp * (( Abs( p1 - f ) > Abs( p1 - l )) ? -1. : +1.);
3104       uv = c2d1->Value( p1tmp ).XY();
3105       surf->D1( uv.X(), uv.Y(), p, du, dv );
3106       vecRef = du ^ dv;
3107       if ( ++nbLoops > 10 )
3108       {
3109 #ifdef _DEBUG_
3110         cout << "SMESH_MesherHelper::GetAngle(): Captured in a sigularity" << endl;
3111 #endif
3112         return angle;
3113       }
3114     }
3115     if ( theFace.Orientation() == TopAbs_REVERSED )
3116       vecRef.Reverse();
3117     if ( theFaceNormal ) *theFaceNormal = vecRef;
3118
3119     c1->D1( p1, p, vec1 );
3120     c2->D1( p2, p, vec2 );
3121     // TopoDS_Face F = theFace;
3122     // if ( F.Orientation() == TopAbs_INTERNAL )
3123     //   F.Orientation( TopAbs_FORWARD );
3124     if ( theE1.Orientation() /*GetSubShapeOri( F, theE1 )*/ == TopAbs_REVERSED )
3125       vec1.Reverse();
3126     if ( theE2.Orientation() /*GetSubShapeOri( F, theE2 )*/ == TopAbs_REVERSED )
3127       vec2.Reverse();
3128     angle = vec1.AngleWithRef( vec2, vecRef );
3129
3130     if ( Abs ( angle ) >= 0.99 * M_PI )
3131     {
3132       BRep_Tool::Range( theE1, f, l );
3133       p1 += 1e-7 * ( p1-f < l-p1 ? +1. : -1. );
3134       c1->D1( p1, p, vec1 );
3135       if ( theE1.Orientation() == TopAbs_REVERSED )
3136         vec1.Reverse();
3137       BRep_Tool::Range( theE2, f, l );
3138       p2 += 1e-7 * ( p2-f < l-p2 ? +1. : -1. );
3139       c2->D1( p2, p, vec2 );
3140       if ( theE2.Orientation() == TopAbs_REVERSED )
3141         vec2.Reverse();
3142       angle = vec1.AngleWithRef( vec2, vecRef );
3143     }
3144   }
3145   catch (...)
3146   {
3147   }
3148   return angle;
3149 }
3150
3151 //================================================================================
3152 /*!
3153  * \brief Check if the first and last vertices of an edge are the same
3154  * \param anEdge - the edge to check
3155  * \retval bool - true if same
3156  */
3157 //================================================================================
3158
3159 bool SMESH_MesherHelper::IsClosedEdge( const TopoDS_Edge& anEdge )
3160 {
3161   if ( anEdge.Orientation() >= TopAbs_INTERNAL )
3162     return IsClosedEdge( TopoDS::Edge( anEdge.Oriented( TopAbs_FORWARD )));
3163   return TopExp::FirstVertex( anEdge ).IsSame( TopExp::LastVertex( anEdge ));
3164 }
3165
3166 //================================================================================
3167 /*!
3168  * \brief Wrapper over TopExp::FirstVertex() and TopExp::LastVertex() fixing them
3169  *  in the case of INTERNAL edge
3170  */
3171 //================================================================================
3172
3173 TopoDS_Vertex SMESH_MesherHelper::IthVertex( const bool  is2nd,
3174                                              TopoDS_Edge anEdge,
3175                                              const bool  CumOri )
3176 {
3177   if ( anEdge.Orientation() >= TopAbs_INTERNAL )
3178     anEdge.Orientation( TopAbs_FORWARD );
3179
3180   const TopAbs_Orientation tgtOri = is2nd ? TopAbs_REVERSED : TopAbs_FORWARD;
3181   TopoDS_Iterator vIt( anEdge, CumOri );
3182   while ( vIt.More() && vIt.Value().Orientation() != tgtOri )
3183     vIt.Next();
3184
3185   return ( vIt.More() ? TopoDS::Vertex(vIt.Value()) : TopoDS_Vertex() );
3186 }
3187
3188 //================================================================================
3189 /*!
3190  * \brief Return type of shape contained in a group 
3191  *  \param group - a shape of type TopAbs_COMPOUND
3192  *  \param avoidCompound - not to return TopAbs_COMPOUND
3193  */
3194 //================================================================================
3195
3196 TopAbs_ShapeEnum SMESH_MesherHelper::GetGroupType(const TopoDS_Shape& group,
3197                                                   const bool          avoidCompound)
3198 {
3199   if ( !group.IsNull() )
3200   {
3201     if ( group.ShapeType() != TopAbs_COMPOUND )
3202       return group.ShapeType();
3203
3204     // iterate on a compound
3205     TopoDS_Iterator it( group );
3206     if ( it.More() )
3207       return avoidCompound ? GetGroupType( it.Value() ) : it.Value().ShapeType();
3208   }
3209   return TopAbs_SHAPE;
3210 }
3211
3212 //================================================================================
3213 /*!
3214  * \brief Returns a shape, to which a hypothesis used to mesh a given shape is assigned
3215  *  \param [in] hyp - the hypothesis
3216  *  \param [in] shape - the shape, for meshing which the \a hyp is used
3217  *  \param [in] mesh - the mesh
3218  *  \return TopoDS_Shape - the shape the \a hyp is assigned to
3219  */
3220 //================================================================================
3221
3222 TopoDS_Shape SMESH_MesherHelper::GetShapeOfHypothesis( const SMESHDS_Hypothesis * hyp,
3223                                                        const TopoDS_Shape&        shape,
3224                                                        SMESH_Mesh*                mesh)
3225 {
3226   const SMESH_Hypothesis* h = static_cast<const SMESH_Hypothesis*>( hyp );
3227   SMESH_HypoFilter hypFilter( SMESH_HypoFilter::Is( h ));
3228
3229   TopoDS_Shape shapeOfHyp;
3230   mesh->GetHypothesis( shape, hypFilter, /*checkAncestors=*/true, &shapeOfHyp );
3231   return shapeOfHyp;
3232 }
3233
3234 //=======================================================================
3235 //function : IsQuadraticMesh
3236 //purpose  : Check mesh without geometry for: if all elements on this shape are quadratic,
3237 //           quadratic elements will be created.
3238 //           Used then generated 3D mesh without geometry.
3239 //=======================================================================
3240
3241 SMESH_MesherHelper:: MType SMESH_MesherHelper::IsQuadraticMesh()
3242 {
3243   int NbAllEdgsAndFaces=0;
3244   int NbQuadFacesAndEdgs=0;
3245   int NbFacesAndEdges=0;
3246   //All faces and edges
3247   NbAllEdgsAndFaces = myMesh->NbEdges() + myMesh->NbFaces();
3248   if ( NbAllEdgsAndFaces == 0 )
3249     return SMESH_MesherHelper::LINEAR;
3250   
3251   //Quadratic faces and edges
3252   NbQuadFacesAndEdgs = myMesh->NbEdges(ORDER_QUADRATIC) + myMesh->NbFaces(ORDER_QUADRATIC);
3253
3254   //Linear faces and edges
3255   NbFacesAndEdges = myMesh->NbEdges(ORDER_LINEAR) + myMesh->NbFaces(ORDER_LINEAR);
3256   
3257   if (NbAllEdgsAndFaces == NbQuadFacesAndEdgs) {
3258     //Quadratic mesh
3259     return SMESH_MesherHelper::QUADRATIC;
3260   }
3261   else if (NbAllEdgsAndFaces == NbFacesAndEdges) {
3262     //Linear mesh
3263     return SMESH_MesherHelper::LINEAR;
3264   }
3265   else
3266     //Mesh with both type of elements
3267     return SMESH_MesherHelper::COMP;
3268 }
3269
3270 //=======================================================================
3271 //function : GetOtherParam
3272 //purpose  : Return an alternative parameter for a node on seam
3273 //=======================================================================
3274
3275 double SMESH_MesherHelper::GetOtherParam(const double param) const
3276 {
3277   int i = myParIndex & U_periodic ? 0 : 1;
3278   return fabs(param-myPar1[i]) < fabs(param-myPar2[i]) ? myPar2[i] : myPar1[i];
3279 }
3280
3281 namespace {
3282
3283   //=======================================================================
3284   /*!
3285    * \brief Iterator on ancestors of the given type
3286    */
3287   //=======================================================================
3288
3289   struct TAncestorsIterator : public SMDS_Iterator<const TopoDS_Shape*>
3290   {
3291     TopTools_ListIteratorOfListOfShape _ancIter;
3292     TopAbs_ShapeEnum                   _type;
3293     TopTools_MapOfShape                _encountered;
3294     TAncestorsIterator( const TopTools_ListOfShape& ancestors, TopAbs_ShapeEnum type)
3295       : _ancIter( ancestors ), _type( type )
3296     {
3297       if ( _ancIter.More() ) {
3298         if ( _ancIter.Value().ShapeType() != _type ) next();
3299         else _encountered.Add( _ancIter.Value() );
3300       }
3301     }
3302     virtual bool more()
3303     {
3304       return _ancIter.More();
3305     }
3306     virtual const TopoDS_Shape* next()
3307     {
3308       const TopoDS_Shape* s = _ancIter.More() ? & _ancIter.Value() : 0;
3309       if ( _ancIter.More() )
3310         for ( _ancIter.Next();  _ancIter.More(); _ancIter.Next())
3311           if ( _ancIter.Value().ShapeType() == _type && _encountered.Add( _ancIter.Value() ))
3312             break;
3313       return s;
3314     }
3315   };
3316
3317 } // namespace
3318
3319 //=======================================================================
3320 /*!
3321  * \brief Return iterator on ancestors of the given type
3322  */
3323 //=======================================================================
3324
3325 PShapeIteratorPtr SMESH_MesherHelper::GetAncestors(const TopoDS_Shape& shape,
3326                                                    const SMESH_Mesh&   mesh,
3327                                                    TopAbs_ShapeEnum    ancestorType)
3328 {
3329   return PShapeIteratorPtr( new TAncestorsIterator( mesh.GetAncestors(shape), ancestorType));
3330 }
3331
3332 //=======================================================================
3333 //function : GetCommonAncestor
3334 //purpose  : Find a common ancestors of two shapes of the given type
3335 //=======================================================================
3336
3337 TopoDS_Shape SMESH_MesherHelper::GetCommonAncestor(const TopoDS_Shape& shape1,
3338                                                    const TopoDS_Shape& shape2,
3339                                                    const SMESH_Mesh&   mesh,
3340                                                    TopAbs_ShapeEnum    ancestorType)
3341 {
3342   TopoDS_Shape commonAnc;
3343   if ( !shape1.IsNull() && !shape2.IsNull() )
3344   {
3345     if ( shape1.ShapeType() == ancestorType && IsSubShape( shape2, shape1 ))
3346       return shape1;
3347     if ( shape2.ShapeType() == ancestorType && IsSubShape( shape1, shape2 ))
3348       return shape2;
3349
3350     PShapeIteratorPtr ancIt = GetAncestors( shape1, mesh, ancestorType );
3351     while ( const TopoDS_Shape* anc = ancIt->next() )
3352       if ( IsSubShape( shape2, *anc ))
3353       {
3354         commonAnc = *anc;
3355         break;
3356       }
3357   }
3358   return commonAnc;
3359 }
3360
3361 //#include <Perf_Meter.hxx>
3362
3363 //=======================================================================
3364 namespace { // Structures used by FixQuadraticElements()
3365 //=======================================================================
3366
3367 #define __DMP__(txt) \
3368   // cout << txt
3369 #define MSG(txt) __DMP__(txt<<endl)
3370 #define MSGBEG(txt) __DMP__(txt)
3371
3372   //const double straightTol2 = 1e-33; // to detect straing links
3373   bool isStraightLink(double linkLen2, double middleNodeMove2)
3374   {
3375     // straight if <node move> < 1/15 * <link length>
3376     return middleNodeMove2 < 1/15./15. * linkLen2;
3377   }
3378
3379   struct QFace;
3380   // ---------------------------------------
3381   /*!
3382    * \brief Quadratic link knowing its faces
3383    */
3384   struct QLink: public SMESH_TLink
3385   {
3386     const SMDS_MeshNode*          _mediumNode;
3387     mutable vector<const QFace* > _faces;
3388     mutable gp_Vec                _nodeMove;
3389     mutable int                   _nbMoves;
3390     mutable bool                  _is2dFixed; // is moved along surface or in 3D
3391
3392     QLink(const SMDS_MeshNode* n1, const SMDS_MeshNode* n2, const SMDS_MeshNode* nm):
3393       SMESH_TLink( n1,n2 ), _mediumNode(nm), _nodeMove(0,0,0), _nbMoves(0) {
3394       _faces.reserve(4);
3395       _nodeMove = MediumPnt() - MiddlePnt();
3396       _is2dFixed = ( MediumPos() != SMDS_TOP_FACE );
3397     }
3398     void SetContinuesFaces() const;
3399     const QFace* GetContinuesFace( const QFace* face ) const;
3400     bool   OnBoundary() const;
3401     gp_XYZ MiddlePnt() const { return ( XYZ( node1() ) + XYZ( node2() )) / 2.; }
3402     gp_XYZ MediumPnt() const { return XYZ( _mediumNode ); }
3403
3404     SMDS_TypeOfPosition  MediumPos() const
3405     { return _mediumNode->GetPosition()->GetTypeOfPosition(); }
3406     SMDS_TypeOfPosition  EndPos(bool isSecond) const
3407     { return (isSecond ? node2() : node1())->GetPosition()->GetTypeOfPosition(); }
3408     const SMDS_MeshNode* EndPosNode(SMDS_TypeOfPosition pos) const
3409     { return EndPos(0) == pos ? node1() : EndPos(1) == pos ? node2() : 0; }
3410
3411     void Move(const gp_Vec& move, bool sum=false, bool is2dFixed=false) const
3412     { _nodeMove += move; _nbMoves += sum ? (_nbMoves==0) : 1; _is2dFixed |= is2dFixed; }
3413     gp_XYZ Move() const { return _nodeMove.XYZ() / _nbMoves; }
3414     bool IsMoved() const { return (_nbMoves > 0 /*&& !IsStraight()*/); }
3415     bool IsFixedOnSurface() const { return _is2dFixed; }
3416     bool IsStraight() const
3417     { return isStraightLink( (XYZ(node1())-XYZ(node2())).SquareModulus(),
3418                              _nodeMove.SquareMagnitude());
3419     }
3420     bool operator<(const QLink& other) const {
3421       return (node1()->GetID() == other.node1()->GetID() ?
3422               node2()->GetID() < other.node2()->GetID() :
3423               node1()->GetID() < other.node1()->GetID());
3424     }
3425 //     struct PtrComparator {
3426 //       bool operator() (const QLink* l1, const QLink* l2 ) const { return *l1 < *l2; }
3427 //     };
3428   };
3429   // ---------------------------------------------------------
3430   /*!
3431    * \brief Link in the chain of links; it connects two faces
3432    */
3433   struct TChainLink
3434   {
3435     const QLink*         _qlink;
3436     mutable const QFace* _qfaces[2];
3437
3438     TChainLink(const QLink* qlink=0):_qlink(qlink) {
3439       _qfaces[0] = _qfaces[1] = 0;
3440     }
3441     void SetFace(const QFace* face) const { int iF = _qfaces[0] ? 1 : 0; _qfaces[iF]=face; }
3442
3443     bool IsBoundary() const { return !_qfaces[1]; }
3444
3445     void RemoveFace( const QFace* face ) const
3446     { _qfaces[(face == _qfaces[1])] = 0; if (!_qfaces[0]) std::swap(_qfaces[0],_qfaces[1]); }
3447
3448     const QFace* NextFace( const QFace* f ) const
3449     { return _qfaces[0]==f ? _qfaces[1] : _qfaces[0]; }
3450
3451     const SMDS_MeshNode* NextNode( const SMDS_MeshNode* n ) const
3452     { return n == _qlink->node1() ? _qlink->node2() : _qlink->node1(); }
3453
3454     bool operator<(const TChainLink& other) const { return *_qlink < *other._qlink; }
3455
3456     operator bool() const { return (_qlink); }
3457
3458     const QLink* operator->() const { return _qlink; }
3459
3460     gp_Vec Normal() const;
3461
3462     bool IsStraight() const;
3463   };
3464   // --------------------------------------------------------------------
3465   typedef list< TChainLink > TChain;
3466   typedef set < TChainLink > TLinkSet;
3467   typedef TLinkSet::const_iterator TLinkInSet;
3468
3469   const int theFirstStep = 5;
3470
3471   enum { ERR_OK, ERR_TRI, ERR_PRISM, ERR_UNKNOWN }; // errors of QFace::GetLinkChain()
3472   // --------------------------------------------------------------------
3473   /*!
3474    * \brief Quadratic face shared by two volumes and bound by QLinks
3475    */
3476   struct QFace: public TIDSortedNodeSet
3477   {
3478     mutable const SMDS_MeshElement* _volumes[2];
3479     mutable vector< const QLink* >  _sides;
3480     mutable bool                    _sideIsAdded[4]; // added in chain of links
3481     gp_Vec                          _normal;
3482 #ifdef _DEBUG_
3483     mutable const SMDS_MeshElement* _face;
3484 #endif
3485
3486     QFace( const vector< const QLink*>& links, const SMDS_MeshElement* face=0 );
3487
3488     void SetVolume(const SMDS_MeshElement* v) const { _volumes[ _volumes[0] ? 1 : 0 ] = v; }
3489
3490     int NbVolumes() const { return !_volumes[0] ? 0 : !_volumes[1] ? 1 : 2; }
3491
3492     void AddSelfToLinks() const {
3493       for ( int i = 0; i < _sides.size(); ++i )
3494         _sides[i]->_faces.push_back( this );
3495     }
3496     int LinkIndex( const QLink* side ) const {
3497       for (int i=0; i<_sides.size(); ++i ) if ( _sides[i] == side ) return i;
3498       return -1;
3499     }
3500     bool GetLinkChain( int iSide, TChain& chain, SMDS_TypeOfPosition pos, int& err) const;
3501
3502     bool GetLinkChain( TChainLink& link, TChain& chain, SMDS_TypeOfPosition pos, int& err) const
3503     {
3504       int i = LinkIndex( link._qlink );
3505       if ( i < 0 ) return true;
3506       _sideIsAdded[i] = true;
3507       link.SetFace( this );
3508       // continue from opposite link
3509       return GetLinkChain( (i+2)%_sides.size(), chain, pos, err );
3510     }
3511     bool IsBoundary() const { return !_volumes[1]; }
3512
3513     bool Contains( const SMDS_MeshNode* node ) const { return count(node); }
3514
3515     bool IsSpoiled(const QLink* bentLink ) const;
3516
3517     TLinkInSet GetBoundaryLink( const TLinkSet&      links,
3518                                 const TChainLink&    avoidLink,
3519                                 TLinkInSet *         notBoundaryLink = 0,
3520                                 const SMDS_MeshNode* nodeToContain = 0,
3521                                 bool *               isAdjacentUsed = 0,
3522                                 int                  nbRecursionsLeft = -1) const;
3523
3524     TLinkInSet GetLinkByNode( const TLinkSet&      links,
3525                               const TChainLink&    avoidLink,
3526                               const SMDS_MeshNode* nodeToContain) const;
3527
3528     const SMDS_MeshNode* GetNodeInFace() const {
3529       for ( int iL = 0; iL < _sides.size(); ++iL )
3530         if ( _sides[iL]->MediumPos() == SMDS_TOP_FACE ) return _sides[iL]->_mediumNode;
3531       return 0;
3532     }
3533
3534     gp_Vec LinkNorm(const int i, SMESH_MesherHelper* theFaceHelper=0) const;
3535
3536     double MoveByBoundary( const TChainLink&   theLink,
3537                            const gp_Vec&       theRefVec,
3538                            const TLinkSet&     theLinks,
3539                            SMESH_MesherHelper* theFaceHelper=0,
3540                            const double        thePrevLen=0,
3541                            const int           theStep=theFirstStep,
3542                            gp_Vec*             theLinkNorm=0,
3543                            double              theSign=1.0) const;
3544   };
3545
3546   //================================================================================
3547   /*!
3548    * \brief Dump QLink and QFace
3549    */
3550   ostream& operator << (ostream& out, const QLink& l)
3551   {
3552     out <<"QLink nodes: "
3553         << l.node1()->GetID() << " - "
3554         << l._mediumNode->GetID() << " - "
3555         << l.node2()->GetID() << endl;
3556     return out;
3557   }
3558   ostream& operator << (ostream& out, const QFace& f)
3559   {
3560     out <<"QFace nodes: "/*<< &f << "  "*/;
3561     for ( TIDSortedNodeSet::const_iterator n = f.begin(); n != f.end(); ++n )
3562       out << (*n)->GetID() << " ";
3563     out << " \tvolumes: "
3564         << (f._volumes[0] ? f._volumes[0]->GetID() : 0) << " "
3565         << (f._volumes[1] ? f._volumes[1]->GetID() : 0);
3566     out << "  \tNormal: "<< f._normal.X() <<", "<<f._normal.Y() <<", "<<f._normal.Z() << endl;
3567     return out;
3568   }
3569
3570   //================================================================================
3571   /*!
3572    * \brief Construct QFace from QLinks 
3573    */
3574   //================================================================================
3575
3576   QFace::QFace( const vector< const QLink*>& links, const SMDS_MeshElement* face )
3577   {
3578     _volumes[0] = _volumes[1] = 0;
3579     _sides = links;
3580     _sideIsAdded[0]=_sideIsAdded[1]=_sideIsAdded[2]=_sideIsAdded[3]=false;
3581     _normal.SetCoord(0,0,0);
3582     for ( int i = 1; i < _sides.size(); ++i ) {
3583       const QLink *l1 = _sides[i-1], *l2 = _sides[i];
3584       insert( l1->node1() ); insert( l1->node2() );
3585       // compute normal
3586       gp_Vec v1( XYZ( l1->node2()), XYZ( l1->node1()));
3587       gp_Vec v2( XYZ( l2->node1()), XYZ( l2->node2()));
3588       if ( l1->node1() != l2->node1() && l1->node2() != l2->node2() )
3589         v1.Reverse(); 
3590       _normal += v1 ^ v2;
3591     }
3592     double normSqSize = _normal.SquareMagnitude();
3593     if ( normSqSize > numeric_limits<double>::min() )
3594       _normal /= sqrt( normSqSize );
3595     else
3596       _normal.SetCoord(1e-33,0,0);
3597
3598 #ifdef _DEBUG_
3599     _face = face;
3600 #endif
3601   }
3602   //================================================================================
3603   /*!
3604    * \brief Make up a chain of links
3605    *  \param iSide - link to add first
3606    *  \param chain - chain to fill in
3607    *  \param pos   - postion of medium nodes the links should have
3608    *  \param error - out, specifies what is wrong
3609    *  \retval bool - false if valid chain can't be built; "valid" means that links
3610    *                 of the chain belongs to rectangles bounding hexahedrons
3611    */
3612   //================================================================================
3613
3614   bool QFace::GetLinkChain( int iSide, TChain& chain, SMDS_TypeOfPosition pos, int& error) const
3615   {
3616     if ( iSide >= _sides.size() ) // wrong argument iSide
3617       return false;
3618     if ( _sideIsAdded[ iSide ]) // already in chain
3619       return true;
3620
3621     if ( _sides.size() != 4 ) { // triangle - visit all my continous faces
3622       MSGBEG( *this );
3623       TLinkSet links;
3624       list< const QFace* > faces( 1, this );
3625       while ( !faces.empty() ) {
3626         const QFace* face = faces.front();
3627         for ( int i = 0; i < face->_sides.size(); ++i ) {
3628           if ( !face->_sideIsAdded[i] && face->_sides[i] ) {
3629             face->_sideIsAdded[i] = true;
3630             // find a face side in the chain
3631             TLinkInSet chLink = links.insert( TChainLink(face->_sides[i])).first;
3632 //             TChain::iterator chLink = chain.begin();
3633 //             for ( ; chLink != chain.end(); ++chLink )
3634 //               if ( chLink->_qlink == face->_sides[i] )
3635 //                 break;
3636 //             if ( chLink == chain.end() )
3637 //               chLink = chain.insert( chain.begin(), TChainLink(face->_sides[i]));
3638             // add a face to a chained link and put a continues face in the queue
3639             chLink->SetFace( face );
3640             if ( face->_sides[i]->MediumPos() == pos )
3641               if ( const QFace* contFace = face->_sides[i]->GetContinuesFace( face ))
3642                 if ( contFace->_sides.size() == 3 )
3643                   faces.push_back( contFace );
3644           }
3645         }
3646         faces.pop_front();
3647       }
3648       if ( error < ERR_TRI )
3649         error = ERR_TRI;
3650       chain.insert( chain.end(), links.begin(),links.end() );
3651       return false;
3652     }
3653     _sideIsAdded[iSide] = true; // not to add this link to chain again
3654     const QLink* link = _sides[iSide];
3655     if ( !link)
3656       return true;
3657
3658     // add link into chain
3659     TChain::iterator chLink = chain.insert( chain.begin(), TChainLink(link));
3660     chLink->SetFace( this );
3661     MSGBEG( *this );
3662
3663     // propagate from a quadrangle to neighbour faces
3664     if ( link->MediumPos() >= pos ) {
3665       int nbLinkFaces = link->_faces.size();
3666       if ( nbLinkFaces == 4 || (/*nbLinkFaces < 4 && */link->OnBoundary())) {
3667         // hexahedral mesh or boundary quadrangles - goto a continous face
3668         if ( const QFace* f = link->GetContinuesFace( this ))
3669           if ( f->_sides.size() == 4 )
3670             return f->GetLinkChain( *chLink, chain, pos, error );
3671       }
3672       else {
3673         TChainLink chLink(link); // side face of prismatic mesh - visit all faces of iSide
3674         for ( int i = 0; i < nbLinkFaces; ++i )
3675           if ( link->_faces[i] )
3676             link->_faces[i]->GetLinkChain( chLink, chain, pos, error );
3677         if ( error < ERR_PRISM )
3678           error = ERR_PRISM;
3679         return false;
3680       }
3681     }
3682     return true;
3683   }
3684
3685   //================================================================================
3686   /*!
3687    * \brief Return a boundary link of the triangle face
3688    *  \param links - set of all links
3689    *  \param avoidLink - link not to return
3690    *  \param notBoundaryLink - out, neither the returned link nor avoidLink
3691    *  \param nodeToContain - node the returned link must contain; if provided, search
3692    *                         also performed on adjacent faces
3693    *  \param isAdjacentUsed - returns true if link is found in adjacent faces
3694    *  \param nbRecursionsLeft - to limit recursion
3695    */
3696   //================================================================================
3697
3698   TLinkInSet QFace::GetBoundaryLink( const TLinkSet&      links,
3699                                      const TChainLink&    avoidLink,
3700                                      TLinkInSet *         notBoundaryLink,
3701                                      const SMDS_MeshNode* nodeToContain,
3702                                      bool *               isAdjacentUsed,
3703                                      int                  nbRecursionsLeft) const
3704   {
3705     TLinkInSet linksEnd = links.end(), boundaryLink = linksEnd;
3706
3707     typedef list< pair< const QFace*, TLinkInSet > > TFaceLinkList;
3708     TFaceLinkList adjacentFaces;
3709
3710     for ( int iL = 0; iL < _sides.size(); ++iL )
3711     {
3712       if ( avoidLink._qlink == _sides[iL] )
3713         continue;
3714       TLinkInSet link = links.find( _sides[iL] );
3715       if ( link == linksEnd ) continue;
3716       if ( (*link)->MediumPos() > SMDS_TOP_FACE )
3717         continue; // We work on faces here, don't go inside a solid
3718
3719       // check link
3720       if ( link->IsBoundary() ) {
3721         if ( !nodeToContain ||
3722              (*link)->node1() == nodeToContain ||
3723              (*link)->node2() == nodeToContain )
3724         {
3725           boundaryLink = link;
3726           if ( !notBoundaryLink ) break;
3727         }
3728       }
3729       else if ( notBoundaryLink ) {
3730         *notBoundaryLink = link;
3731         if ( boundaryLink != linksEnd ) break;
3732       }
3733
3734       if ( boundaryLink == linksEnd && nodeToContain ) // collect adjacent faces
3735         if ( const QFace* adj = link->NextFace( this ))
3736           if ( adj->Contains( nodeToContain ))
3737             adjacentFaces.push_back( make_pair( adj, link ));
3738     }
3739
3740     if ( isAdjacentUsed ) *isAdjacentUsed = false;
3741     if ( boundaryLink == linksEnd && nodeToContain && nbRecursionsLeft) // check adjacent faces
3742     {
3743       if ( nbRecursionsLeft < 0 )
3744         nbRecursionsLeft = nodeToContain->NbInverseElements();
3745       TFaceLinkList::iterator adj = adjacentFaces.begin();
3746       for ( ; boundaryLink == linksEnd && adj != adjacentFaces.end(); ++adj )
3747         boundaryLink = adj->first->GetBoundaryLink( links, *(adj->second), 0, nodeToContain,
3748                                                     isAdjacentUsed, nbRecursionsLeft-1);
3749       if ( isAdjacentUsed ) *isAdjacentUsed = true;
3750     }
3751     return boundaryLink;
3752   }
3753   //================================================================================
3754   /*!
3755    * \brief Return a link ending at the given node but not avoidLink
3756    */
3757   //================================================================================
3758
3759   TLinkInSet QFace::GetLinkByNode( const TLinkSet&      links,
3760                                    const TChainLink&    avoidLink,
3761                                    const SMDS_MeshNode* nodeToContain) const
3762   {
3763     for ( int i = 0; i < _sides.size(); ++i )
3764       if ( avoidLink._qlink != _sides[i] &&
3765            (_sides[i]->node1() == nodeToContain || _sides[i]->node2() == nodeToContain ))
3766         return links.find( _sides[ i ]);
3767     return links.end();
3768   }
3769
3770   //================================================================================
3771   /*!
3772    * \brief Return normal to the i-th side pointing outside the face
3773    */
3774   //================================================================================
3775
3776   gp_Vec QFace::LinkNorm(const int i, SMESH_MesherHelper* /*uvHelper*/) const
3777   {
3778     gp_Vec   norm = _normal ^ gp_Vec( XYZ(_sides[i]->node1()), XYZ(_sides[i]->node2()));
3779     gp_XYZ    pIn = ( _sides[ (i+1)%3 ]->MiddlePnt() +
3780                       _sides[ (i+2)%3 ]->MiddlePnt() ) / 2.;
3781     gp_Vec vecOut = ( _sides[i]->MiddlePnt() - pIn );
3782
3783     if ( norm * vecOut < 0 )
3784       norm.Reverse();
3785     double mag2 = norm.SquareMagnitude();
3786     if ( mag2 > numeric_limits<double>::min() )
3787       norm /= sqrt( mag2 );
3788     return norm;
3789   }
3790   //================================================================================
3791   /*!
3792    * \brief Move medium node of theLink according to its distance from boundary
3793    *  \param theLink - link to fix
3794    *  \param theRefVec - movement of boundary
3795    *  \param theLinks - all adjacent links of continous triangles
3796    *  \param theFaceHelper - helper is not used so far
3797    *  \param thePrevLen - distance from the boundary
3798    *  \param theStep - number of steps till movement propagation limit
3799    *  \param theLinkNorm - out normal to theLink
3800    *  \param theSign - 1 or -1 depending on movement of boundary
3801    *  \retval double - distance from boundary to propagation limit or other boundary
3802    */
3803   //================================================================================
3804
3805   double QFace::MoveByBoundary( const TChainLink&   theLink,
3806                                 const gp_Vec&       theRefVec,
3807                                 const TLinkSet&     theLinks,
3808                                 SMESH_MesherHelper* theFaceHelper,
3809                                 const double        thePrevLen,
3810                                 const int           theStep,
3811                                 gp_Vec*             theLinkNorm,
3812                                 double              theSign) const
3813   {
3814     if ( !theStep )
3815       return thePrevLen; // propagation limit reached
3816
3817     int iL; // index of theLink
3818     for ( iL = 0; iL < _sides.size(); ++iL )
3819       if ( theLink._qlink == _sides[ iL ])
3820         break;
3821
3822     MSG(string(theStep,'.')<<" Ref( "<<theRefVec.X()<<","<<theRefVec.Y()<<","<<theRefVec.Z()<<" )"
3823         <<" thePrevLen " << thePrevLen);
3824     MSG(string(theStep,'.')<<" "<<*theLink._qlink);
3825
3826     gp_Vec linkNorm = -LinkNorm( iL/*, theFaceHelper*/ ); // normal to theLink
3827     double refProj = theRefVec * linkNorm; // project movement vector to normal of theLink
3828     if ( theStep == theFirstStep )
3829       theSign = refProj < 0. ? -1. : 1.;
3830     else if ( theSign * refProj < 0.4 * theRefVec.Magnitude())
3831       return thePrevLen; // to propagate movement forward only, not in side dir or backward
3832
3833     int iL1 = (iL + 1) % 3, iL2 = (iL + 2) % 3; // indices of the two other links of triangle
3834     TLinkInSet link1 = theLinks.find( _sides[iL1] );
3835     TLinkInSet link2 = theLinks.find( _sides[iL2] );
3836
3837     const QFace *f1 = 0, *f2 = 0;  // adjacent faces
3838     bool isBndLink1 = true, isBndLink2 = true;
3839     if ( link1 != theLinks.end() && link2 != theLinks.end() )
3840     {
3841       f1 = link1->NextFace( this );
3842       f2 = link2->NextFace( this );
3843
3844       isBndLink1 = ( theLink->MediumPos() > (*link1)->MediumPos() );
3845       isBndLink2 = ( theLink->MediumPos() > (*link2)->MediumPos() );
3846       if ( theStep == theFirstStep ) // (issue 22541) quad-dominant mesh
3847       {
3848         if ( !isBndLink1 && !f1 )
3849           f1 = (*link1)->GetContinuesFace( this ); // get a quadrangle face
3850         if ( !isBndLink2 && !f2 )
3851           f2 = (*link2)->GetContinuesFace( this );
3852       }
3853     }
3854     else if ( _sides.size() < 4 )
3855       return thePrevLen;      
3856
3857     // propagate to adjacent faces till limit step or boundary
3858     double len1 = thePrevLen + (theLink->MiddlePnt() - _sides[iL1]->MiddlePnt()).Modulus();
3859     double len2 = thePrevLen + (theLink->MiddlePnt() - _sides[iL2]->MiddlePnt()).Modulus();
3860     gp_Vec linkDir1(0,0,0); // initialize to avoid valgrind error ("Conditional jump...")
3861     gp_Vec linkDir2(0,0,0);
3862     try {
3863       OCC_CATCH_SIGNALS;
3864       if ( f1 && !isBndLink1 )
3865         len1 = f1->MoveByBoundary
3866           ( *link1, theRefVec, theLinks, theFaceHelper, len1, theStep-1, &linkDir1, theSign);
3867       else
3868         linkDir1 = LinkNorm( iL1/*, theFaceHelper*/ );
3869     } catch (...) {
3870       MSG( " --------------- EXCEPTION");
3871       return thePrevLen;
3872     }
3873     try {
3874       OCC_CATCH_SIGNALS;
3875       if ( f2 && !isBndLink2 )
3876         len2 = f2->MoveByBoundary
3877           ( *link2, theRefVec, theLinks, theFaceHelper, len2, theStep-1, &linkDir2, theSign);
3878       else
3879         linkDir2 = LinkNorm( iL2/*, theFaceHelper*/ );
3880     } catch (...) {
3881       MSG( " --------------- EXCEPTION");
3882       return thePrevLen;
3883     }
3884
3885     double fullLen = 0;
3886     if ( theStep != theFirstStep )
3887     {
3888       // choose chain length by direction of propagation most codirected with theRefVec
3889       bool choose1 = ( theRefVec * linkDir1 * theSign > theRefVec * linkDir2 * theSign );
3890       fullLen = choose1 ? len1 : len2;
3891       double r = thePrevLen / fullLen;
3892
3893       gp_Vec move = linkNorm * refProj * ( 1 - r );
3894       theLink->Move( move, /*sum=*/true );
3895
3896       MSG(string(theStep,'.')<<" Move "<< theLink->_mediumNode->GetID()<<
3897           " by " << refProj * ( 1 - r ) << " following " <<
3898           (choose1 ? *link1->_qlink : *link2->_qlink)); // warning: link1 can be invalid
3899
3900       if ( theLinkNorm ) *theLinkNorm = linkNorm;
3901     }
3902     return fullLen;
3903   }
3904
3905   //================================================================================
3906   /*!
3907    * \brief Checks if the face is distorted due to bentLink
3908    */
3909   //================================================================================
3910
3911   bool QFace::IsSpoiled(const QLink* bentLink ) const
3912   {
3913     // code is valid for convex faces only
3914     gp_XYZ gc(0,0,0);
3915     for ( TIDSortedNodeSet::const_iterator n = begin(); n!=end(); ++n)
3916       gc += XYZ( *n ) / size();
3917     for (unsigned i = 0; i < _sides.size(); ++i )
3918     {
3919       if ( _sides[i] == bentLink ) continue;
3920       gp_Vec linkNorm = _normal ^ gp_Vec( XYZ(_sides[i]->node1()), XYZ(_sides[i]->node2()));
3921       gp_Vec vecOut( gc, _sides[i]->MiddlePnt() );
3922       if ( linkNorm * vecOut < 0 )
3923         linkNorm.Reverse();
3924       double mag2 = linkNorm.SquareMagnitude();
3925       if ( mag2 > numeric_limits<double>::min() )
3926         linkNorm /= sqrt( mag2 );
3927       gp_Vec vecBent    ( _sides[i]->MiddlePnt(), bentLink->MediumPnt());
3928       gp_Vec vecStraight( _sides[i]->MiddlePnt(), bentLink->MiddlePnt());
3929       if ( vecBent * linkNorm > -0.1*vecStraight.Magnitude() )
3930         return true;
3931     }
3932     return false;
3933     
3934   }
3935
3936   //================================================================================
3937   /*!
3938    * \brief Find pairs of continues faces 
3939    */
3940   //================================================================================
3941
3942   void QLink::SetContinuesFaces() const
3943   {
3944     //       x0         x - QLink, [-|] - QFace, v - volume
3945     //   v0  |   v1   
3946     //       |          Between _faces of link x2 two vertical faces are continues
3947     // x1----x2-----x3  and two horizontal faces are continues. We set vertical faces
3948     //       |          to _faces[0] and _faces[1] and horizontal faces to
3949     //   v2  |   v3     _faces[2] and _faces[3] (or vise versa).
3950     //       x4
3951
3952     if ( _faces.empty() )
3953       return;
3954     int iFaceCont = -1, nbBoundary = 0, iBoundary[2]={-1,-1};
3955     if ( _faces[0]->IsBoundary() )
3956       iBoundary[ nbBoundary++ ] = 0;
3957     for ( int iF = 1; iFaceCont < 0 && iF < _faces.size(); ++iF )
3958     {
3959       // look for a face bounding none of volumes bound by _faces[0]
3960       bool sameVol = false;
3961       int nbVol = _faces[iF]->NbVolumes();
3962       for ( int iV = 0; !sameVol && iV < nbVol; ++iV )
3963         sameVol = ( _faces[iF]->_volumes[iV] == _faces[0]->_volumes[0] ||
3964                     _faces[iF]->_volumes[iV] == _faces[0]->_volumes[1]);
3965       if ( !sameVol )
3966         iFaceCont = iF;
3967       if ( _faces[iF]->IsBoundary() )
3968         iBoundary[ nbBoundary++ ] = iF;
3969     }
3970     // Set continues faces: arrange _faces to have
3971     // _faces[0] continues to _faces[1]
3972     // _faces[2] continues to _faces[3]
3973     if ( nbBoundary == 2 ) // bnd faces are continues
3974     {
3975       if (( iBoundary[0] < 2 ) != ( iBoundary[1] < 2 ))
3976       {
3977         int iNear0 = iBoundary[0] < 2 ? 1-iBoundary[0] : 5-iBoundary[0];
3978         std::swap( _faces[ iBoundary[1] ], _faces[iNear0] );
3979       }
3980     }
3981     else if ( iFaceCont > 0 ) // continues faces found
3982     {
3983       if ( iFaceCont != 1 )
3984         std::swap( _faces[1], _faces[iFaceCont] );
3985     }
3986     else if ( _faces.size() > 1 ) // not found, set NULL by the first face
3987     {
3988       _faces.insert( ++_faces.begin(), (QFace*) 0 );
3989     }
3990   }
3991   //================================================================================
3992   /*!
3993    * \brief Return a face continues to the given one
3994    */
3995   //================================================================================
3996
3997   const QFace* QLink::GetContinuesFace( const QFace* face ) const
3998   {
3999     for ( int i = 0; i < _faces.size(); ++i ) {
4000       if ( _faces[i] == face ) {
4001         int iF = i < 2 ? 1-i : 5-i;
4002         return iF < _faces.size() ? _faces[iF] : 0;
4003       }
4004     }
4005     return 0;
4006   }
4007   //================================================================================
4008   /*!
4009    * \brief True if link is on mesh boundary
4010    */
4011   //================================================================================
4012
4013   bool QLink::OnBoundary() const
4014   {
4015     for ( int i = 0; i < _faces.size(); ++i )
4016       if (_faces[i] && _faces[i]->IsBoundary()) return true;
4017     return false;
4018   }
4019   //================================================================================
4020   /*!
4021    * \brief Return normal of link of the chain
4022    */
4023   //================================================================================
4024
4025   gp_Vec TChainLink::Normal() const {
4026     gp_Vec norm;
4027     if (_qfaces[0]) norm  = _qfaces[0]->_normal;
4028     if (_qfaces[1]) norm += _qfaces[1]->_normal;
4029     return norm;
4030   }
4031   //================================================================================
4032   /*!
4033    * \brief Test link curvature taking into account size of faces
4034    */
4035   //================================================================================
4036
4037   bool TChainLink::IsStraight() const
4038   {
4039     bool isStraight = _qlink->IsStraight();
4040     if ( isStraight && _qfaces[0] && !_qfaces[1] )
4041     {
4042       int i = _qfaces[0]->LinkIndex( _qlink );
4043       int iOpp = ( i + 2 ) % _qfaces[0]->_sides.size();
4044       gp_XYZ mid1 = _qlink->MiddlePnt();
4045       gp_XYZ mid2 = _qfaces[0]->_sides[ iOpp ]->MiddlePnt();
4046       double faceSize2 = (mid1-mid2).SquareModulus();
4047       isStraight = _qlink->_nodeMove.SquareMagnitude() < 1/10./10. * faceSize2;
4048     }
4049     return isStraight;
4050   }
4051   
4052   //================================================================================
4053   /*!
4054    * \brief Move medium nodes of vertical links of pentahedrons adjacent by side faces
4055    */
4056   //================================================================================
4057
4058   void fixPrism( TChain& allLinks )
4059   {
4060     // separate boundary links from internal ones
4061     typedef set<const QLink*/*, QLink::PtrComparator*/> QLinkSet;
4062     QLinkSet interLinks, bndLinks1, bndLink2;
4063
4064     bool isCurved = false;
4065     for ( TChain::iterator lnk = allLinks.begin(); lnk != allLinks.end(); ++lnk ) {
4066       if ( (*lnk)->OnBoundary() )
4067         bndLinks1.insert( lnk->_qlink );
4068       else
4069         interLinks.insert( lnk->_qlink );
4070       isCurved = isCurved || !lnk->IsStraight();
4071     }
4072     if ( !isCurved )
4073       return; // no need to move
4074
4075     QLinkSet *curBndLinks = &bndLinks1, *newBndLinks = &bndLink2;
4076
4077     while ( !interLinks.empty() && !curBndLinks->empty() )
4078     {
4079       // propagate movement from boundary links to connected internal links
4080       QLinkSet::iterator bnd = curBndLinks->begin(), bndEnd = curBndLinks->end();
4081       for ( ; bnd != bndEnd; ++bnd )
4082       {
4083         const QLink* bndLink = *bnd;
4084         for ( int i = 0; i < bndLink->_faces.size(); ++i ) // loop on faces of bndLink
4085         {
4086           const QFace* face = bndLink->_faces[i]; // quadrange lateral face of a prism
4087           if ( !face ) continue;
4088           // find and move internal link opposite to bndLink within the face
4089           int interInd = ( face->LinkIndex( bndLink ) + 2 ) % face->_sides.size();
4090           const QLink* interLink = face->_sides[ interInd ];
4091           QLinkSet::iterator pInterLink = interLinks.find( interLink );
4092           if ( pInterLink == interLinks.end() ) continue; // not internal link
4093           interLink->Move( bndLink->_nodeMove );
4094           // treated internal links become new boundary ones
4095           interLinks.erase( pInterLink );
4096           newBndLinks->insert( interLink );
4097         }
4098       }
4099       curBndLinks->clear();
4100       std::swap( curBndLinks, newBndLinks );
4101     }
4102   }
4103
4104   //================================================================================
4105   /*!
4106    * \brief Fix links of continues triangles near curved boundary
4107    */
4108   //================================================================================
4109
4110   void fixTriaNearBoundary( TChain & allLinks, SMESH_MesherHelper& /*helper*/)
4111   {
4112     if ( allLinks.empty() ) return;
4113
4114     TLinkSet linkSet( allLinks.begin(), allLinks.end());
4115     TLinkInSet linkIt = linkSet.begin(), linksEnd = linkSet.end();
4116
4117     for ( linkIt = linkSet.begin(); linkIt != linksEnd; ++linkIt)
4118     {
4119       if ( linkIt->IsBoundary() && !linkIt->IsStraight() && linkIt->_qfaces[0])
4120       {
4121         // move iff a boundary link is bent towards inside of a face (issue 0021084)
4122         const QFace* face = linkIt->_qfaces[0];
4123         gp_XYZ pIn = ( face->_sides[0]->MiddlePnt() +
4124                        face->_sides[1]->MiddlePnt() +
4125                        face->_sides[2]->MiddlePnt() ) / 3.;
4126         gp_XYZ insideDir( pIn - (*linkIt)->MiddlePnt());
4127         bool linkBentInside = ((*linkIt)->_nodeMove.Dot( insideDir ) > 0 );
4128         //if ( face->IsSpoiled( linkIt->_qlink ))
4129         if ( linkBentInside )
4130           face->MoveByBoundary( *linkIt, (*linkIt)->_nodeMove, linkSet );
4131       }
4132     }
4133   }
4134
4135   //================================================================================
4136   /*!
4137    * \brief Detect rectangular structure of links and build chains from them
4138    */
4139   //================================================================================
4140
4141   enum TSplitTriaResult {
4142     _OK, _NO_CORNERS, _FEW_ROWS, _MANY_ROWS, _NO_SIDELINK, _BAD_MIDQUAD, _NOT_RECT,
4143     _NO_MIDQUAD, _NO_UPTRIA, _BAD_SET_SIZE, _BAD_CORNER, _BAD_START, _NO_BOTLINK, _TWISTED_CHAIN };
4144
4145   TSplitTriaResult splitTrianglesIntoChains( TChain &            allLinks,
4146                                              vector< TChain> &   resultChains,
4147                                              SMDS_TypeOfPosition pos )
4148   {
4149     // put links in the set and evalute number of result chains by number of boundary links
4150     TLinkSet linkSet;
4151     int nbBndLinks = 0;
4152     for ( TChain::iterator lnk = allLinks.begin(); lnk != allLinks.end(); ++lnk ) {
4153       linkSet.insert( *lnk );
4154       nbBndLinks += lnk->IsBoundary();
4155     }
4156     resultChains.clear();
4157     resultChains.reserve( nbBndLinks / 2 );
4158
4159     TLinkInSet linkIt, linksEnd = linkSet.end();
4160
4161     // find a boundary link with corner node; corner node has position pos-2
4162     // i.e. SMDS_TOP_VERTEX for links on faces and SMDS_TOP_EDGE for
4163     // links in volume
4164     SMDS_TypeOfPosition cornerPos = SMDS_TypeOfPosition(pos-2);
4165     const SMDS_MeshNode* corner = 0;
4166     for ( linkIt = linkSet.begin(); linkIt != linksEnd; ++linkIt )
4167       if ( linkIt->IsBoundary() && (corner = (*linkIt)->EndPosNode(cornerPos)))
4168         break;
4169     if ( !corner)
4170       return _NO_CORNERS;
4171
4172     TLinkInSet           startLink = linkIt;
4173     const SMDS_MeshNode* startCorner = corner;
4174     vector< TChain* >    rowChains;
4175     int iCol = 0;
4176
4177     while ( startLink != linksEnd) // loop on columns
4178     {
4179       // We suppose we have a rectangular structure like shown here. We have found a
4180       //               corner of the rectangle (startCorner) and a boundary link sharing  
4181       //    |/  |/  |  the startCorner (startLink). We are going to loop on rows of the   
4182       //  --o---o---o  structure making several chains at once. One chain (columnChain)   
4183       //    |\  |  /|  starts at startLink and continues upward (we look at the structure 
4184       //  \ | \ | / |  from such point that startLink is on the bottom of the structure). 
4185       //   \|  \|/  |  While going upward we also fill horizontal chains (rowChains) we   
4186       //  --o---o---o  encounter.                                                         
4187       //   /|\  |\  |
4188       //  / | \ | \ |  startCorner
4189       //    |  \|  \|,'
4190       //  --o---o---o
4191       //          `.startLink
4192
4193       if ( resultChains.size() == nbBndLinks / 2 )
4194         return _NOT_RECT;
4195       resultChains.push_back( TChain() );
4196       TChain& columnChain = resultChains.back();
4197
4198       TLinkInSet botLink = startLink; // current horizontal link to go up from
4199       corner = startCorner; // current corner the botLink ends at
4200       int iRow = 0;
4201       while ( botLink != linksEnd ) // loop on rows
4202       {
4203         // add botLink to the columnChain
4204         columnChain.push_back( *botLink );
4205
4206         const QFace* botTria = botLink->_qfaces[0]; // bottom triangle bound by botLink
4207         if ( !botTria )
4208         { // the column ends
4209           if ( botLink == startLink )
4210             return _TWISTED_CHAIN; // issue 0020951
4211           linkSet.erase( botLink );
4212           if ( iRow != rowChains.size() )
4213             return _FEW_ROWS; // different nb of rows in columns
4214           break;
4215         }
4216         // find the link dividing the quadrangle (midQuadLink) and vertical boundary
4217         // link ending at <corner> (sideLink); there are two cases:
4218         // 1) midQuadLink does not end at <corner>, then we easily find it by botTria,
4219         //   since midQuadLink is not at boundary while sideLink is.
4220         // 2) midQuadLink ends at <corner>
4221         bool isCase2;
4222         TLinkInSet midQuadLink = linksEnd;
4223         TLinkInSet sideLink = botTria->GetBoundaryLink( linkSet, *botLink, &midQuadLink,
4224                                                         corner, &isCase2 );
4225         if ( isCase2 ) { // find midQuadLink among links of botTria
4226           midQuadLink = botTria->GetLinkByNode( linkSet, *botLink, corner );
4227           if ( midQuadLink->IsBoundary() )
4228             return _BAD_MIDQUAD;
4229         }
4230         if ( sideLink == linksEnd || midQuadLink == linksEnd || sideLink == midQuadLink )
4231           return sideLink == linksEnd ? _NO_SIDELINK : _NO_MIDQUAD;
4232
4233         // fill chains
4234         columnChain.push_back( *midQuadLink );
4235         if ( iRow >= rowChains.size() ) {
4236           if ( iCol > 0 )
4237             return _MANY_ROWS; // different nb of rows in columns
4238           if ( resultChains.size() == nbBndLinks / 2 )
4239             return _NOT_RECT;
4240           resultChains.push_back( TChain() );
4241           rowChains.push_back( & resultChains.back() );
4242         }
4243         rowChains[iRow]->push_back( *sideLink );
4244         rowChains[iRow]->push_back( *midQuadLink );
4245
4246         const QFace* upTria = midQuadLink->NextFace( botTria ); // upper tria of the rectangle
4247         if ( !upTria)
4248           return _NO_UPTRIA;
4249         if ( iRow == 0 ) {
4250           // prepare startCorner and startLink for the next column
4251           startCorner = startLink->NextNode( startCorner );
4252           if (isCase2)
4253             startLink = botTria->GetBoundaryLink( linkSet, *botLink, 0, startCorner );
4254           else
4255             startLink = upTria->GetBoundaryLink( linkSet, *midQuadLink, 0, startCorner );
4256           // check if no more columns remains
4257           if ( startLink != linksEnd ) {
4258             const SMDS_MeshNode* botNode = startLink->NextNode( startCorner );
4259             if ( (isCase2 ? botTria : upTria)->Contains( botNode ))
4260               startLink = linksEnd; // startLink bounds upTria or botTria
4261             else if ( startLink == botLink || startLink == midQuadLink || startLink == sideLink )
4262               return _BAD_START;
4263           }
4264         }
4265         // find bottom link and corner for the next row
4266         corner = sideLink->NextNode( corner );
4267         // next bottom link ends at the new corner
4268         linkSet.erase( botLink );
4269         botLink = upTria->GetLinkByNode( linkSet, (isCase2 ? *sideLink : *midQuadLink), corner );
4270         if ( botLink == linksEnd || botLink == midQuadLink || botLink == sideLink)
4271           return _NO_BOTLINK;
4272         if ( midQuadLink == startLink || sideLink == startLink )
4273           return _TWISTED_CHAIN; // issue 0020951
4274         linkSet.erase( midQuadLink );
4275         linkSet.erase( sideLink );
4276
4277         // make faces neighboring the found ones be boundary
4278         if ( startLink != linksEnd ) {
4279           const QFace* tria = isCase2 ? botTria : upTria;
4280           for ( int iL = 0; iL < 3; ++iL ) {
4281             linkIt = linkSet.find( tria->_sides[iL] );
4282             if ( linkIt != linksEnd )
4283               linkIt->RemoveFace( tria );
4284           }
4285         }
4286         if ( botLink->_qfaces[0] == upTria || botLink->_qfaces[1] == upTria )
4287           botLink->RemoveFace( upTria ); // make next botTria first in vector
4288
4289         iRow++;
4290       } // loop on rows
4291
4292       iCol++;
4293     }
4294     // In the linkSet, there must remain the last links of rowChains; add them
4295     if ( linkSet.size() != rowChains.size() )
4296       return _BAD_SET_SIZE;
4297     for ( int iRow = 0; iRow < rowChains.size(); ++iRow ) {
4298       // find the link (startLink) ending at startCorner
4299       corner = 0;
4300       for ( startLink = linkSet.begin(); startLink != linksEnd; ++startLink ) {
4301         if ( (*startLink)->node1() == startCorner ) {
4302           corner = (*startLink)->node2(); break;
4303         }
4304         else if ( (*startLink)->node2() == startCorner) {
4305           corner = (*startLink)->node1(); break;
4306         }
4307       }
4308       if ( startLink == linksEnd )
4309         return _BAD_CORNER;
4310       rowChains[ iRow ]->push_back( *startLink );
4311       linkSet.erase( startLink );
4312       startCorner = corner;
4313     }
4314
4315     return _OK;
4316   }
4317
4318   //================================================================================
4319   /*!
4320    * \brief Place medium nodes at the link middle for elements whose corner nodes
4321    *        are out of geometrical boundary to prevent distorting elements.
4322    *        Issue 0020982, note 0013990
4323    */
4324   //================================================================================
4325
4326   void force3DOutOfBoundary( SMESH_MesherHelper&    theHelper,
4327                              SMESH_ComputeErrorPtr& theError)
4328   {
4329     SMESHDS_Mesh* meshDS = theHelper.GetMeshDS();
4330     TopoDS_Shape  shape = theHelper.GetSubShape().Oriented( TopAbs_FORWARD );
4331     if ( shape.IsNull() ) return;
4332
4333     if ( !theError ) theError = SMESH_ComputeError::New();
4334
4335     gp_XYZ faceNorm;
4336
4337     if ( shape.ShapeType() == TopAbs_FACE ) // 2D
4338     {
4339       if ( theHelper.GetMesh()->NbTriangles( ORDER_QUADRATIC ) < 1 ) return;
4340
4341       SMESHDS_SubMesh* faceSM = meshDS->MeshElements( shape );
4342       if ( !faceSM ) return;
4343
4344       const TopoDS_Face&      face = TopoDS::Face( shape );
4345       Handle(Geom_Surface) surface = BRep_Tool::Surface( face );
4346
4347       TopExp_Explorer edgeIt( face, TopAbs_EDGE );
4348       for ( ; edgeIt.More(); edgeIt.Next() ) // loop on EDGEs of a FACE
4349       {
4350         // check if the EDGE needs checking
4351         const TopoDS_Edge& edge = TopoDS::Edge( edgeIt.Current() );
4352         if ( SMESH_Algo::isDegenerated( edge ) )
4353           continue;
4354         if ( theHelper.IsRealSeam( edge ) &&
4355              edge.Orientation() == TopAbs_REVERSED )
4356           continue;
4357
4358         SMESHDS_SubMesh* edgeSM = meshDS->MeshElements( edge );
4359         if ( !edgeSM ) continue;
4360
4361         double f,l;
4362         Handle(Geom2d_Curve) pcurve  = BRep_Tool::CurveOnSurface( edge, face, f, l );
4363         BRepAdaptor_Curve    curve3D( edge );
4364         switch ( curve3D.GetType() ) {
4365         case GeomAbs_Line: continue;
4366         case GeomAbs_Circle:
4367         case GeomAbs_Ellipse:
4368         case GeomAbs_Hyperbola:
4369         case GeomAbs_Parabola:
4370           try
4371           {
4372             gp_Vec D1, D2, Du1, Dv1; gp_Pnt p;
4373             curve3D.D2( 0.5 * ( f + l ), p, D1, D2 );
4374             gp_Pnt2d uv = pcurve->Value( 0.5 * ( f + l ) );
4375             surface->D1( uv.X(), uv.Y(), p, Du1, Dv1 );
4376             gp_Vec fNorm = Du1 ^ Dv1;
4377             if ( fNorm.IsParallel( D2, M_PI * 25./180. ))
4378               continue; // face is normal to the curve3D
4379
4380             gp_Vec curvNorm = fNorm ^ D1;
4381             if ( edge.Orientation() == TopAbs_REVERSED ) curvNorm.Reverse();
4382             if ( curvNorm * D2 > 0 )
4383               continue; // convex edge
4384           }
4385           catch ( Standard_Failure )
4386           {
4387             continue;
4388           }
4389         }
4390         // get nodes shared by faces that may be distorted
4391         SMDS_NodeIteratorPtr nodeIt;
4392         if ( edgeSM->NbNodes() > 0 ) {
4393           nodeIt = edgeSM->GetNodes();
4394         }
4395         else {
4396           SMESHDS_SubMesh* vertexSM = meshDS->MeshElements( theHelper.IthVertex( 0, edge ));
4397           if ( !vertexSM )
4398             vertexSM = meshDS->MeshElements( theHelper.IthVertex( 1, edge ));
4399           if ( !vertexSM ) continue;
4400           nodeIt = vertexSM->GetNodes();
4401         }
4402
4403         // find suspicious faces
4404         TIDSortedElemSet checkedFaces;
4405         vector< const SMDS_MeshNode* > nOnEdge( 2 );
4406         const SMDS_MeshNode*           nOnFace;
4407         while ( nodeIt->more() )
4408         {
4409           const SMDS_MeshNode* n      = nodeIt->next();
4410           SMDS_ElemIteratorPtr faceIt = n->GetInverseElementIterator( SMDSAbs_Face );
4411           while ( faceIt->more() )
4412           {
4413             const SMDS_MeshElement* f = faceIt->next();
4414             if ( !faceSM->Contains( f ) ||
4415                  f->NbNodes() < 6       || // check quadratic triangles only
4416                  !checkedFaces.insert( f ).second )
4417               continue;
4418
4419             // get nodes on EDGE and on FACE of a suspicious face
4420             nOnEdge.clear(); nOnFace = 0;
4421             SMDS_MeshElement::iterator triNode = f->begin_nodes();
4422             for ( int nbN = 0; nbN < 3; ++triNode, ++nbN )
4423             {
4424               n = *triNode;
4425               if ( n->GetPosition()->GetDim() == 2 )
4426                 nOnFace = n;
4427               else
4428                 nOnEdge.push_back( n );
4429             }
4430
4431             // check if nOnFace is inside the FACE
4432             if ( nOnFace && nOnEdge.size() == 2 )
4433             {
4434               theHelper.AddTLinks( static_cast< const SMDS_MeshFace* > ( f ));
4435               if ( !SMESH_MeshAlgos::FaceNormal( f, faceNorm, /*normalized=*/false ))
4436                 continue;
4437               gp_XYZ edgeDir  = SMESH_TNodeXYZ( nOnEdge[0] ) - SMESH_TNodeXYZ( nOnEdge[1] );
4438               gp_XYZ edgeNorm = faceNorm ^ edgeDir;
4439               n = theHelper.GetMediumNode( nOnEdge[0], nOnEdge[1], true ); // find n, not create 
4440               gp_XYZ pN0     = SMESH_TNodeXYZ( nOnEdge[0] );
4441               gp_XYZ pMedium = SMESH_TNodeXYZ( n );                   // on-edge node location
4442               gp_XYZ pFaceN  = SMESH_TNodeXYZ( nOnFace );             // on-face node location
4443               double hMedium = edgeNorm * gp_Vec( pN0, pMedium ).XYZ();
4444               double hFace   = edgeNorm * gp_Vec( pN0, pFaceN ).XYZ();
4445               if ( Abs( hMedium ) > Abs( hFace * 0.6 ))
4446               {
4447                 // nOnFace is out of FACE, move a medium on-edge node to the middle
4448                 gp_XYZ pMid3D = 0.5 * ( pN0 + SMESH_TNodeXYZ( nOnEdge[1] ));
4449                 meshDS->MoveNode( n, pMid3D.X(), pMid3D.Y(), pMid3D.Z() );
4450                 MSG( "move OUT of face " << n );
4451                 theError->myBadElements.push_back( f );
4452               }
4453             }
4454           }
4455         }
4456       }
4457       if ( !theError->myBadElements.empty() )
4458         theError->myName = EDITERR_NO_MEDIUM_ON_GEOM;
4459       return;
4460
4461     } // 2D ==============================================================================
4462
4463     if ( shape.ShapeType() == TopAbs_SOLID ) // 3D
4464     {
4465       if ( theHelper.GetMesh()->NbTetras  ( ORDER_QUADRATIC ) < 1 &&
4466            theHelper.GetMesh()->NbPyramids( ORDER_QUADRATIC ) < 1 ) return;
4467
4468       SMESHDS_SubMesh* solidSM = meshDS->MeshElements( shape );
4469       if ( !solidSM ) return;
4470
4471       // check if the SOLID is bound by concave FACEs
4472       vector< TopoDS_Face > concaveFaces;
4473       TopExp_Explorer faceIt( shape, TopAbs_FACE );
4474       for ( ; faceIt.More(); faceIt.Next() ) // loop on FACEs of a SOLID
4475       {
4476         const TopoDS_Face&  face = TopoDS::Face( faceIt.Current() );
4477         if ( !meshDS->MeshElements( face )) continue;
4478
4479         BRepAdaptor_Surface surface( face );
4480         switch ( surface.GetType() ) {
4481         case GeomAbs_Plane: continue;
4482         case GeomAbs_Cylinder:
4483         case GeomAbs_Cone:
4484         case GeomAbs_Sphere:
4485           try
4486           {
4487             double u = 0.5 * ( surface.FirstUParameter() + surface.LastUParameter() );
4488             double v = 0.5 * ( surface.FirstVParameter() + surface.LastVParameter() );
4489             gp_Vec Du1, Dv1, Du2, Dv2, Duv2; gp_Pnt p;
4490             surface.D2( u,v, p, Du1, Dv1, Du2, Dv2, Duv2 );
4491             gp_Vec fNorm = Du1 ^ Dv1;
4492             if ( face.Orientation() == TopAbs_REVERSED ) fNorm.Reverse();
4493             bool concaveU = ( fNorm * Du2 > 1e-100 );
4494             bool concaveV = ( fNorm * Dv2 > 1e-100 );
4495             if ( concaveU || concaveV )
4496               concaveFaces.push_back( face );
4497           }
4498           catch ( Standard_Failure )
4499           {
4500             concaveFaces.push_back( face );
4501           }
4502         }
4503       }
4504       if ( concaveFaces.empty() )
4505         return;
4506
4507       // fix 2D mesh on the SOLID
4508       for ( faceIt.ReInit(); faceIt.More(); faceIt.Next() ) // loop on FACEs of a SOLID
4509       {
4510         SMESH_MesherHelper faceHelper( *theHelper.GetMesh() );
4511         faceHelper.SetSubShape( faceIt.Current() );
4512         force3DOutOfBoundary( faceHelper, theError );
4513       }
4514
4515       // get an iterator over faces on concaveFaces
4516       vector< SMDS_ElemIteratorPtr > faceIterVec( concaveFaces.size() );
4517       for ( size_t i = 0; i < concaveFaces.size(); ++i )
4518         faceIterVec[i] = meshDS->MeshElements( concaveFaces[i] )->GetElements();
4519       typedef SMDS_IteratorOnIterators
4520         < const SMDS_MeshElement*, vector< SMDS_ElemIteratorPtr > > TIterOnIter;
4521       SMDS_ElemIteratorPtr faceIter( new TIterOnIter( faceIterVec ));
4522
4523       // a seacher to check if a volume is close to a concave face
4524       std::auto_ptr< SMESH_ElementSearcher > faceSearcher
4525         ( SMESH_MeshAlgos::GetElementSearcher( *theHelper.GetMeshDS(), faceIter ));
4526
4527       // classifier
4528       //BRepClass3d_SolidClassifier solidClassifier( shape );
4529
4530       TIDSortedElemSet checkedVols, movedNodes;
4531       //for ( faceIt.ReInit(); faceIt.More(); faceIt.Next() ) // loop on FACEs of a SOLID
4532       for ( size_t iF = 0; iF < concaveFaces.size(); ++iF ) // loop on concave FACEs
4533       {
4534         //const TopoDS_Shape& face = faceIt.Current();
4535         const TopoDS_Shape& face = concaveFaces[ iF ];
4536         SMESHDS_SubMesh*  faceSM = meshDS->MeshElements( face );
4537         if ( !faceSM ) continue;
4538
4539         // get nodes shared by volumes (tet and pyra) on the FACE that may be distorted
4540         SMDS_NodeIteratorPtr nodeIt;
4541         if ( faceSM->NbNodes() > 0 ) {
4542           nodeIt = faceSM->GetNodes();
4543         }
4544         else {
4545           TopExp_Explorer vertex( face, TopAbs_VERTEX );
4546           SMESHDS_SubMesh* vertexSM = meshDS->MeshElements( vertex.Current() );
4547           if ( !vertexSM ) continue;
4548           nodeIt = vertexSM->GetNodes();
4549         }
4550         // get ids of sub-shapes of the FACE
4551         set< int > subIDs;
4552         SMESH_subMeshIteratorPtr smIt =
4553           theHelper.GetMesh()->GetSubMesh( face )->getDependsOnIterator(/*includeSelf=*/true);
4554         while ( smIt->more() )
4555           subIDs.insert( smIt->next()->GetId() );
4556
4557         // find suspicious volumes adjacent to the FACE
4558         vector< const SMDS_MeshNode* >    nOnFace( 4 );
4559         const SMDS_MeshNode*              nInSolid;
4560         while ( nodeIt->more() )
4561         {
4562           const SMDS_MeshNode* n     = nodeIt->next();
4563           SMDS_ElemIteratorPtr volIt = n->GetInverseElementIterator( SMDSAbs_Volume );
4564           while ( volIt->more() )
4565           {
4566             const SMDS_MeshElement* vol = volIt->next();
4567             int nbN = vol->NbCornerNodes();
4568             if ( ( nbN != 4 && nbN != 5 )  ||
4569                  !solidSM->Contains( vol ) ||
4570                  !checkedVols.insert( vol ).second )
4571               continue;
4572
4573             // get nodes on FACE and in SOLID of a suspicious volume
4574             nOnFace.clear(); nInSolid = 0;
4575             SMDS_MeshElement::iterator volNode = vol->begin_nodes();
4576             for ( int nb = nbN; nb > 0; ++volNode, --nb )
4577             {
4578               n = *volNode;
4579               if ( n->GetPosition()->GetDim() == 3 )
4580                 nInSolid = n;
4581               else if ( subIDs.count( n->getshapeId() ))
4582                 nOnFace.push_back( n );
4583               else
4584                 nInSolid = n;
4585             }
4586             if ( !nInSolid || nOnFace.size() != nbN - 1 )
4587               continue;
4588
4589             // get size of the vol
4590             SMESH_TNodeXYZ pInSolid( nInSolid ), pOnFace0( nOnFace[0] );
4591             double volLength = pInSolid.SquareDistance( nOnFace[0] );
4592             for ( size_t i = 1; i < nOnFace.size(); ++i )
4593             {
4594               volLength = Max( volLength, pOnFace0.SquareDistance( nOnFace[i] ));
4595             }
4596
4597             // check if vol is close to concaveFaces
4598             const SMDS_MeshElement* closeFace =
4599               faceSearcher->FindClosestTo( pInSolid, SMDSAbs_Face );
4600             if ( !closeFace ||
4601                  pInSolid.SquareDistance( closeFace->GetNode(0) ) > 4 * volLength )
4602               continue;
4603
4604             // check if vol is distorted, i.e. a medium node is much closer
4605             // to nInSolid than the link middle
4606             bool isDistorted = false;
4607             SMDS_FaceOfNodes onFaceTria( nOnFace[0], nOnFace[1], nOnFace[2] );
4608             if ( !SMESH_MeshAlgos::FaceNormal( &onFaceTria, faceNorm, /*normalized=*/false ))
4609               continue;
4610             theHelper.AddTLinks( static_cast< const SMDS_MeshVolume* > ( vol ));
4611             vector< pair< SMESH_TLink, const SMDS_MeshNode* > > links;
4612             for ( size_t i = 0; i < nOnFace.size(); ++i ) // loop on links between nOnFace
4613               for ( size_t j = i+1; j < nOnFace.size(); ++j )
4614               {
4615                 SMESH_TLink link( nOnFace[i], nOnFace[j] );
4616                 TLinkNodeMap::const_iterator linkIt =
4617                   theHelper.GetTLinkNodeMap().find( link );
4618                 if ( linkIt != theHelper.GetTLinkNodeMap().end() )
4619                 {
4620                   links.push_back( make_pair( linkIt->first, linkIt->second  ));
4621                   if ( !isDistorted ) {
4622                     // compare projections of nInSolid and nMedium to face normal
4623                     gp_Pnt pMedium = SMESH_TNodeXYZ( linkIt->second );
4624                     double hMedium = faceNorm * gp_Vec( pOnFace0, pMedium ).XYZ();
4625                     double hVol    = faceNorm * gp_Vec( pOnFace0, pInSolid ).XYZ();
4626                     isDistorted = ( Abs( hMedium ) > Abs( hVol * 0.5 ));
4627                   }
4628                 }
4629               }
4630             // move medium nodes to link middle
4631             if ( isDistorted )
4632             {
4633               for ( size_t i = 0; i < links.size(); ++i )
4634               {
4635                 const SMDS_MeshNode* nMedium = links[i].second;
4636                 if ( movedNodes.insert( nMedium ).second )
4637                 {
4638                   gp_Pnt pMid3D = 0.5 * ( SMESH_TNodeXYZ( links[i].first.node1() ) +
4639                                           SMESH_TNodeXYZ( links[i].first.node2() ));
4640                   meshDS->MoveNode( nMedium, pMid3D.X(), pMid3D.Y(), pMid3D.Z() );
4641                   MSG( "move OUT of solid " << nMedium );
4642                 }
4643               }
4644               theError->myBadElements.push_back( vol );
4645             }
4646           } // loop on volumes sharing a node on FACE
4647         } // loop on nodes on FACE
4648       }  // loop on FACEs of a SOLID
4649
4650       if ( !theError->myBadElements.empty() )
4651         theError->myName = EDITERR_NO_MEDIUM_ON_GEOM;
4652     } // 3D case
4653   }
4654
4655 } //namespace
4656
4657 //=======================================================================
4658 /*!
4659  * \brief Move medium nodes of faces and volumes to fix distorted elements
4660  * \param error - container of fixed distorted elements
4661  * \param volumeOnly - to fix nodes on faces or not, if the shape is solid
4662  * 
4663  * Issue 0020307: EDF 992 SMESH : Linea/Quadratic with Medium Node on Geometry
4664  */
4665 //=======================================================================
4666
4667 void SMESH_MesherHelper::FixQuadraticElements(SMESH_ComputeErrorPtr& compError,
4668                                               bool                   volumeOnly)
4669 {
4670   // setenv NO_FixQuadraticElements to know if FixQuadraticElements() is guilty of bad conversion
4671   if ( getenv("NO_FixQuadraticElements") )
4672     return;
4673
4674   // 0. Apply algorithm to SOLIDs or FACEs
4675   // ----------------------------------------------
4676   if ( myShape.IsNull() ) {
4677     if ( !myMesh->HasShapeToMesh() ) return;
4678     SetSubShape( myMesh->GetShapeToMesh() );
4679
4680 #ifdef _DEBUG_
4681     int nbSolids = 0;
4682     TopTools_IndexedMapOfShape solids;
4683     TopExp::MapShapes(myShape,TopAbs_SOLID,solids);
4684     nbSolids = solids.Extent();
4685 #endif
4686     TopTools_MapOfShape faces; // faces not in solid or in not meshed solid
4687     for ( TopExp_Explorer f(myShape,TopAbs_FACE,TopAbs_SOLID); f.More(); f.Next() ) {
4688       faces.Add( f.Current() ); // not in solid
4689     }
4690     for ( TopExp_Explorer s(myShape,TopAbs_SOLID); s.More(); s.Next() ) {
4691       if ( myMesh->GetSubMesh( s.Current() )->IsEmpty() ) { // get faces of solid
4692         for ( TopExp_Explorer f( s.Current(), TopAbs_FACE); f.More(); f.Next() )
4693           faces.Add( f.Current() ); // in not meshed solid
4694       }
4695       else { // fix nodes in the solid and its faces
4696 #ifdef _DEBUG_
4697         MSG("FIX SOLID " << nbSolids-- << " #" << GetMeshDS()->ShapeToIndex(s.Current()));
4698 #endif
4699         SMESH_MesherHelper h(*myMesh);
4700         h.SetSubShape( s.Current() );
4701         h.ToFixNodeParameters(true);
4702         h.FixQuadraticElements( compError, false );
4703       }
4704     }
4705     // fix nodes on geom faces
4706 #ifdef _DEBUG_
4707     int nbfaces = faces.Extent(); /*avoid "unused varianbles": */ nbfaces++, nbfaces--; 
4708 #endif
4709     for ( TopTools_MapIteratorOfMapOfShape fIt( faces ); fIt.More(); fIt.Next() ) {
4710       MSG("FIX FACE " << nbfaces-- << " #" << GetMeshDS()->ShapeToIndex(fIt.Key()));
4711       SMESH_MesherHelper h(*myMesh);
4712       h.SetSubShape( fIt.Key() );
4713       h.ToFixNodeParameters(true);
4714       h.FixQuadraticElements( compError, true);
4715     }
4716     //perf_print_all_meters(1);
4717     if ( compError && compError->myName == EDITERR_NO_MEDIUM_ON_GEOM )
4718       compError->myComment = "during conversion to quadratic, "
4719         "some medium nodes were not placed on geometry to avoid distorting elements";
4720     return;
4721   }
4722
4723   // 1. Find out type of elements and get iterator on them
4724   // ---------------------------------------------------
4725
4726   SMDS_ElemIteratorPtr elemIt;
4727   SMDSAbs_ElementType elemType = SMDSAbs_All;
4728
4729   SMESH_subMesh* submesh = myMesh->GetSubMeshContaining( myShapeID );
4730   if ( !submesh )
4731     return;
4732   if ( SMESHDS_SubMesh* smDS = submesh->GetSubMeshDS() ) {
4733     elemIt = smDS->GetElements();
4734     if ( elemIt->more() ) {
4735       elemType = elemIt->next()->GetType();
4736       elemIt = smDS->GetElements();
4737     }
4738   }
4739   if ( !elemIt || !elemIt->more() || elemType < SMDSAbs_Face )
4740     return;
4741
4742   // 2. Fill in auxiliary data structures
4743   // ----------------------------------
4744
4745   set< QLink > links;
4746   set< QFace > faces;
4747   set< QLink >::iterator pLink;
4748   set< QFace >::iterator pFace;
4749
4750   bool isCurved = false;
4751   //bool hasRectFaces = false;
4752   //set<int> nbElemNodeSet;
4753   SMDS_VolumeTool volTool;
4754
4755   TIDSortedNodeSet apexOfPyramid;
4756   const int apexIndex = 4;
4757
4758   // Issue 0020982
4759   // Move medium nodes to the link middle for elements whose corner nodes
4760   // are out of geometrical boundary to fix distorted elements.
4761   force3DOutOfBoundary( *this, compError );
4762
4763   if ( elemType == SMDSAbs_Volume )
4764   {
4765     while ( elemIt->more() ) // loop on volumes
4766     {
4767       const SMDS_MeshElement* vol = elemIt->next();
4768       if ( !vol->IsQuadratic() || !volTool.Set( vol ))
4769         return;
4770       double volMinSize2 = -1.;
4771       for ( int iF = 0; iF < volTool.NbFaces(); ++iF ) // loop on faces of volume
4772       {
4773         int nbN = volTool.NbFaceNodes( iF );
4774         //nbElemNodeSet.insert( nbN );
4775         const SMDS_MeshNode** faceNodes = volTool.GetFaceNodes( iF );
4776         vector< const QLink* > faceLinks( nbN/2 );
4777         for ( int iN = 0; iN < nbN; iN += 2 ) // loop on links of a face
4778         {
4779           // store QLink
4780           QLink link( faceNodes[iN], faceNodes[iN+2], faceNodes[iN+1] );
4781           pLink = links.insert( link ).first;
4782           faceLinks[ iN/2 ] = & *pLink;
4783
4784           if ( link.MediumPos() == SMDS_TOP_3DSPACE )
4785           {
4786             if ( !link.IsStraight() )
4787               return; // already fixed
4788           }
4789           else if ( !isCurved )
4790           {
4791             if ( volMinSize2 < 0 ) volMinSize2 = volTool.MinLinearSize2();
4792             isCurved = !isStraightLink( volMinSize2, link._nodeMove.SquareMagnitude() );
4793           }
4794         }
4795         // store QFace
4796         pFace = faces.insert( QFace( faceLinks )).first;
4797         if ( pFace->NbVolumes() == 0 )
4798           pFace->AddSelfToLinks();
4799         pFace->SetVolume( vol );
4800 //         hasRectFaces = hasRectFaces ||
4801 //           ( volTool.GetVolumeType() == SMDS_VolumeTool::QUAD_HEXA ||
4802 //             volTool.GetVolumeType() == SMDS_VolumeTool::QUAD_PENTA );
4803 #ifdef _DEBUG_
4804         if ( nbN == 6 )
4805           pFace->_face = GetMeshDS()->FindFace(faceNodes[0],faceNodes[2],faceNodes[4]);
4806         else
4807           pFace->_face = GetMeshDS()->FindFace(faceNodes[0],faceNodes[2],
4808                                                faceNodes[4],faceNodes[6] );
4809 #endif
4810       }
4811       // collect pyramid apexes for further correction
4812       if ( vol->NbCornerNodes() == 5 )
4813         apexOfPyramid.insert( vol->GetNode( apexIndex ));
4814     }
4815     set< QLink >::iterator pLink = links.begin();
4816     for ( ; pLink != links.end(); ++pLink )
4817       pLink->SetContinuesFaces();
4818   }
4819   else
4820   {
4821     while ( elemIt->more() ) // loop on faces
4822     {
4823       const SMDS_MeshElement* face = elemIt->next();
4824       if ( !face->IsQuadratic() )
4825         continue;
4826       //nbElemNodeSet.insert( face->NbNodes() );
4827       int nbN = face->NbNodes()/2;
4828       vector< const QLink* > faceLinks( nbN );
4829       for ( int iN = 0; iN < nbN; ++iN ) // loop on links of a face
4830       {
4831         // store QLink
4832         QLink link( face->GetNode(iN), face->GetNode((iN+1)%nbN), face->GetNode(iN+nbN) );
4833         pLink = links.insert( link ).first;
4834         faceLinks[ iN ] = & *pLink;
4835         if ( !isCurved &&
4836              link.node1()->GetPosition()->GetTypeOfPosition() < 2 &&
4837              link.node2()->GetPosition()->GetTypeOfPosition() < 2 )
4838           isCurved = !link.IsStraight();
4839       }
4840       // store QFace
4841       pFace = faces.insert( QFace( faceLinks )).first;
4842       pFace->AddSelfToLinks();
4843       //hasRectFaces = ( hasRectFaces || nbN == 4 );
4844     }
4845   }
4846   if ( !isCurved )
4847     return; // no curved edges of faces
4848
4849   // 3. Compute displacement of medium nodes
4850   // ---------------------------------------
4851
4852   SMESH_MesherHelper faceHlp(*myMesh);
4853
4854   // two loops on QFaces: the first is to treat boundary links, the second is for internal ones.
4855   TopLoc_Location loc;
4856   bool checkUV;
4857   // not to treat boundary of volumic sub-mesh.
4858   int isInside = ( elemType == SMDSAbs_Volume && volumeOnly ) ? 1 : 0;
4859   for ( ; isInside < 2; ++isInside )
4860   {
4861     MSG( "--------------- LOOP (inside=" << isInside << ") ------------------");
4862     SMDS_TypeOfPosition pos = isInside ? SMDS_TOP_3DSPACE : SMDS_TOP_FACE;
4863     SMDS_TypeOfPosition bndPos = isInside ? SMDS_TOP_FACE : SMDS_TOP_EDGE;
4864
4865     for ( pFace = faces.begin(); pFace != faces.end(); ++pFace ) {
4866       if ( bool(isInside) == pFace->IsBoundary() )
4867         continue;
4868       for ( int dir = 0; dir < 2; ++dir ) // 2 directions of propagation from the quadrangle
4869       {
4870         MSG( "CHAIN");
4871         // make chain of links connected via continues faces
4872         int error = ERR_OK;
4873         TChain rawChain;
4874         if ( !pFace->GetLinkChain( dir, rawChain, pos, error) && error ==ERR_UNKNOWN ) continue;
4875         rawChain.reverse();
4876         if ( !pFace->GetLinkChain( dir+2, rawChain, pos, error ) && error ==ERR_UNKNOWN ) continue;
4877
4878         vector< TChain > chains;
4879         if ( error == ERR_OK ) { // chain contains continues rectangles
4880           chains.resize(1);
4881           chains[0].splice( chains[0].begin(), rawChain );
4882         }
4883         else if ( error == ERR_TRI ) {  // chain contains continues triangles
4884           TSplitTriaResult res = splitTrianglesIntoChains( rawChain, chains, pos );
4885           if ( res != _OK ) { // not 'quadrangles split into triangles' in chain
4886             fixTriaNearBoundary( rawChain, *this );
4887             break;
4888           }
4889         }
4890         else if ( error == ERR_PRISM ) { // quadrangle side faces of prisms
4891           fixPrism( rawChain );
4892           break;
4893         }
4894         else {
4895           continue;
4896         }
4897         for ( int iC = 0; iC < chains.size(); ++iC )
4898         {
4899           TChain& chain = chains[iC];
4900           if ( chain.empty() ) continue;
4901           if ( chain.front().IsStraight() && chain.back().IsStraight() ) {
4902             MSG("3D straight - ignore");
4903             continue;
4904           }
4905           if ( chain.front()->MediumPos() > bndPos ||
4906                chain.back() ->MediumPos() > bndPos ) {
4907             MSG("Internal chain - ignore");
4908             continue;
4909           }
4910           // mesure chain length and compute link position along the chain
4911           double chainLen = 0;
4912           vector< double > linkPos;
4913           TChain savedChain; // backup
4914           MSGBEG( "Link medium nodes: ");
4915           TChain::iterator link0 = chain.begin(), link1 = chain.begin(), link2;
4916           for ( ++link1; link1 != chain.end(); ++link1, ++link0 ) {
4917             MSGBEG( (*link0)->_mediumNode->GetID() << "-" <<(*link1)->_mediumNode->GetID()<<" ");
4918             double len = ((*link0)->MiddlePnt() - (*link1)->MiddlePnt()).Modulus();
4919             while ( len < numeric_limits<double>::min() ) { // remove degenerated link
4920               if ( savedChain.empty() ) savedChain = chain;
4921               link1 = chain.erase( link1 );
4922               if ( link1 == chain.end() )
4923                 break;
4924               len = ((*link0)->MiddlePnt() - (*link1)->MiddlePnt()).Modulus();
4925             }
4926             chainLen += len;
4927             linkPos.push_back( chainLen );
4928           }
4929           MSG("");
4930           if ( linkPos.size() <= 2 && savedChain.size() > 2 ) {
4931             //continue;
4932             linkPos.clear();
4933             chainLen = 0;
4934             chain = savedChain;
4935             for ( link1 = chain.begin(); link1 != chain.end(); ++link1 ) {
4936               chainLen += 1;
4937               linkPos.push_back( chainLen );
4938             }
4939           }
4940           gp_Vec move0 = chain.front()->_nodeMove;
4941           gp_Vec move1 = chain.back ()->_nodeMove;
4942
4943           TopoDS_Face face;
4944           if ( !isInside )
4945           {
4946             // compute node displacement of end links of chain in parametric space of FACE
4947             TChainLink& linkOnFace = *(++chain.begin());
4948             const SMDS_MeshNode* nodeOnFace = linkOnFace->_mediumNode;
4949             TopoDS_Shape f = GetSubShapeByNode( nodeOnFace, GetMeshDS() );
4950             if ( !f.IsNull() && f.ShapeType() == TopAbs_FACE )
4951             {
4952               face = TopoDS::Face( f );
4953               faceHlp.SetSubShape( face );
4954               Handle(Geom_Surface) surf = BRep_Tool::Surface(face,loc);
4955               //bool isStraight[2]; // commented for issue 0023118
4956               for ( int is1 = 0; is1 < 2; ++is1 ) // move0 or move1
4957               {
4958                 TChainLink& link = is1 ? chain.back() : chain.front();
4959                 gp_XY uvm  = faceHlp.GetNodeUV( face, link->_mediumNode, nodeOnFace, &checkUV );
4960                 gp_XY uv1  = faceHlp.GetNodeUV( face, link->node1(),     nodeOnFace, &checkUV );
4961                 gp_XY uv2  = faceHlp.GetNodeUV( face, link->node2(),     nodeOnFace, &checkUV );
4962                 gp_XY uv12 = faceHlp.GetMiddleUV( surf, uv1, uv2 );
4963                 // uvMove = uvm - uv12
4964                 gp_XY uvMove = ApplyIn2D(surf, uvm, uv12, gp_XY_Subtracted, /*inPeriod=*/false);
4965                 ( is1 ? move1 : move0 ).SetCoord( uvMove.X(), uvMove.Y(), 0 );
4966                 if ( !is1 ) // correct nodeOnFace for move1 (issue 0020919)
4967                   nodeOnFace = (*(++chain.rbegin()))->_mediumNode;
4968                 // isStraight[is1] = isStraightLink( (uv2-uv1).SquareModulus(),
4969                 //                                   10 * uvMove.SquareModulus());
4970               }
4971               // if ( isStraight[0] && isStraight[1] ) {
4972               //   MSG("2D straight - ignore");
4973               //   continue; // straight - no need to move nodes of internal links
4974               // }
4975
4976               // check if a chain is already fixed
4977               gp_XY uvm  = faceHlp.GetNodeUV( face, linkOnFace->_mediumNode, 0, &checkUV );
4978               gp_XY uv1  = faceHlp.GetNodeUV( face, linkOnFace->node1(), nodeOnFace, &checkUV );
4979               gp_XY uv2  = faceHlp.GetNodeUV( face, linkOnFace->node2(), nodeOnFace, &checkUV );
4980               gp_XY uv12 = faceHlp.GetMiddleUV( surf, uv1, uv2 );
4981               if (( uvm - uv12 ).SquareModulus() > 1e-10 )
4982               {
4983                 MSG("Already fixed - ignore");
4984                 continue;
4985               }
4986             }
4987           }
4988           gp_Trsf trsf;
4989           if ( isInside || face.IsNull() )
4990           {
4991             // compute node displacement of end links in their local coord systems
4992             {
4993               TChainLink& ln0 = chain.front(), ln1 = *(++chain.begin());
4994               trsf.SetTransformation( gp_Ax3( gp::Origin(), ln0.Normal(),
4995                                               gp_Vec( ln0->MiddlePnt(), ln1->MiddlePnt() )));
4996               move0.Transform(trsf);
4997             }
4998             {
4999               TChainLink& ln0 = *(++chain.rbegin()), ln1 = chain.back();
5000               trsf.SetTransformation( gp_Ax3( gp::Origin(), ln1.Normal(),
5001                                               gp_Vec( ln0->MiddlePnt(), ln1->MiddlePnt() )));
5002               move1.Transform(trsf);
5003             }
5004           }
5005           // compute displacement of medium nodes
5006           link2 = chain.begin();
5007           link0 = link2++;
5008           link1 = link2++;
5009           for ( int i = 0; link2 != chain.end(); ++link0, ++link1, ++link2, ++i )
5010           {
5011             double r = linkPos[i] / chainLen;
5012             // displacement in local coord system
5013             gp_Vec move = (1. - r) * move0 + r * move1;
5014             if ( isInside || face.IsNull()) {
5015               // transform to global
5016               gp_Vec x01( (*link0)->MiddlePnt(), (*link1)->MiddlePnt() );
5017               gp_Vec x12( (*link1)->MiddlePnt(), (*link2)->MiddlePnt() );
5018               try {
5019                 gp_Vec x = x01.Normalized() + x12.Normalized();
5020                 trsf.SetTransformation( gp_Ax3( gp::Origin(), link1->Normal(), x), gp_Ax3() );
5021               } catch ( Standard_Failure ) {
5022                 trsf.Invert();
5023               }
5024               move.Transform(trsf);
5025               (*link1)->Move( move, /*sum=*/false, /*is2dFixed=*/false );
5026             }
5027             else {
5028               // compute 3D displacement by 2D one
5029               Handle(Geom_Surface) s = BRep_Tool::Surface(face,loc);
5030               gp_XY oldUV   = faceHlp.GetNodeUV( face, (*link1)->_mediumNode, 0, &checkUV );
5031               gp_XY newUV   = ApplyIn2D( s, oldUV, gp_XY( move.X(),move.Y()), gp_XY_Added );
5032               gp_Pnt newPnt = s->Value( newUV.X(), newUV.Y());
5033               move = gp_Vec( XYZ((*link1)->_mediumNode), newPnt.Transformed(loc) );
5034               if ( SMDS_FacePosition* nPos =
5035                    dynamic_cast< SMDS_FacePosition* >((*link1)->_mediumNode->GetPosition()))
5036                 nPos->SetParameters( newUV.X(), newUV.Y() );
5037 #ifdef _DEBUG_
5038               if ( (XYZ((*link1)->node1()) - XYZ((*link1)->node2())).SquareModulus() <
5039                    move.SquareMagnitude())
5040               {
5041                 gp_XY uv0 = faceHlp.GetNodeUV( face, (*link0)->_mediumNode, 0, &checkUV );
5042                 gp_XY uv2 = faceHlp.GetNodeUV( face, (*link2)->_mediumNode, 0, &checkUV );
5043                 MSG( "TOO LONG MOVE \t" <<
5044                      "uv0: "<<uv0.X()<<", "<<uv0.Y()<<" \t" <<
5045                      "uv2: "<<uv2.X()<<", "<<uv2.Y()<<" \t" <<
5046                      "uvOld: "<<oldUV.X()<<", "<<oldUV.Y()<<" \t" <<
5047                      "newUV: "<<newUV.X()<<", "<<newUV.Y()<<" \t");
5048               }
5049 #endif
5050               (*link1)->Move( move, /*sum=*/false, /*is2dFixed=*/true );
5051             }
5052             MSG( "Move " << (*link1)->_mediumNode->GetID() << " following "
5053                  << chain.front()->_mediumNode->GetID() <<"-"
5054                  << chain.back ()->_mediumNode->GetID() <<
5055                  " by " << move.Magnitude());
5056           }
5057         } // loop on chains of links
5058       } // loop on 2 directions of propagation from quadrangle
5059     } // loop on faces
5060   } // fix faces and/or volumes
5061
5062   // 4. Move nodes
5063   // -------------
5064
5065   TIDSortedElemSet biQuadQuas, biQuadTris, triQuadHexa;
5066   const SMDS_MeshElement *biQuadQua, *triQuadHex;
5067   const bool toFixCentralNodes = ( myMesh->NbBiQuadQuadrangles() +
5068                                    myMesh->NbBiQuadTriangles() +
5069                                    myMesh->NbTriQuadraticHexas() );
5070   double distXYZ[4];
5071   faceHlp.ToFixNodeParameters( true );
5072
5073   for ( pLink = links.begin(); pLink != links.end(); ++pLink ) {
5074     if ( pLink->IsMoved() )
5075     {
5076       gp_Pnt p = pLink->MiddlePnt() + pLink->Move();
5077
5078       // put on surface nodes on FACE but moved in 3D (23050)
5079       if ( !pLink->IsFixedOnSurface() )
5080       {
5081         faceHlp.SetSubShape( pLink->_mediumNode->getshapeId() );
5082         if ( faceHlp.GetSubShape().ShapeType() == TopAbs_FACE )
5083         {
5084           const_cast<SMDS_MeshNode*>( pLink->_mediumNode )->setXYZ( p.X(), p.Y(), p.Z());
5085           p.Coord( distXYZ[1], distXYZ[2], distXYZ[3] );
5086           gp_XY uv( Precision::Infinite(), 0 );
5087           if ( faceHlp.CheckNodeUV( TopoDS::Face( faceHlp.GetSubShape() ), pLink->_mediumNode,
5088                                     uv, /*tol=*/pLink->Move().Modulus(), /*force=*/true, distXYZ ))
5089             p.SetCoord( distXYZ[1], distXYZ[2], distXYZ[3] );
5090         }
5091       }
5092       GetMeshDS()->MoveNode( pLink->_mediumNode, p.X(), p.Y(), p.Z());
5093
5094       // collect bi-quadratic elements
5095       if ( toFixCentralNodes )
5096       {
5097         biQuadQua = triQuadHex = 0;
5098         SMDS_ElemIteratorPtr eIt = pLink->_mediumNode->GetInverseElementIterator();
5099         while ( eIt->more() )
5100         {
5101           const SMDS_MeshElement* e = eIt->next();
5102           switch( e->GetEntityType() ) {
5103           case SMDSEntity_BiQuad_Quadrangle: biQuadQuas.insert( e ); break;
5104           case SMDSEntity_BiQuad_Triangle:   biQuadTris.insert( e ); break;
5105           case SMDSEntity_TriQuad_Hexa:      triQuadHexa.insert( e ); break;
5106           default:;
5107           }
5108         }
5109       }
5110     }
5111   }
5112   // Fix positions of central nodes of bi-tri-quadratic elements
5113
5114   // treat bi-quad quadrangles
5115   {
5116     vector< const SMDS_MeshNode* > nodes( 9 );
5117     gp_XY uv[ 9 ];
5118     TIDSortedElemSet::iterator quadIt = biQuadQuas.begin();
5119     for ( ; quadIt != biQuadQuas.end(); ++quadIt )
5120     {
5121       const SMDS_MeshElement* quad = *quadIt;
5122       // nodes
5123       nodes.clear();
5124       nodes.assign( quad->begin_nodes(), quad->end_nodes() );
5125       // FACE
5126       TopoDS_Shape S = GetSubShapeByNode( nodes.back(), GetMeshDS() );
5127       if ( S.IsNull() || S.ShapeType() != TopAbs_FACE ) continue;
5128       const TopoDS_Face& F = TopoDS::Face( S );
5129       Handle( Geom_Surface ) surf = BRep_Tool::Surface( F, loc );
5130       const double tol = BRep_Tool::Tolerance( F );
5131       // UV
5132       for ( int i = 0; i < 8; ++i )
5133       {
5134         uv[ i ] = GetNodeUV( F, nodes[i], nodes[8], &checkUV );
5135         // as this method is used after mesh generation, UV of nodes is not
5136         // updated according to bending links, so we update 
5137         if ( i > 3 && nodes[i]->GetPosition()->GetTypeOfPosition() == SMDS_TOP_FACE )
5138           CheckNodeUV( F, nodes[i], uv[ i ], 2*tol, /*force=*/true );
5139       }
5140       AdjustByPeriod( F, uv, 8 ); // put uv[] within a period (IPAL52698)
5141       // move the central node
5142       gp_XY uvCent = calcTFI (0.5, 0.5, uv[0],uv[1],uv[2],uv[3],uv[4],uv[5],uv[6],uv[7] );
5143       gp_Pnt p = surf->Value( uvCent.X(), uvCent.Y() ).Transformed( loc );
5144       GetMeshDS()->MoveNode( nodes[8], p.X(), p.Y(), p.Z());
5145     }
5146   }
5147
5148   // treat bi-quad triangles
5149   {
5150     vector< const SMDS_MeshNode* > nodes;
5151     gp_XY uv[ 6 ];
5152     TIDSortedElemSet::iterator triIt = biQuadTris.begin();
5153     for ( ; triIt != biQuadTris.end(); ++triIt )
5154     {
5155       const SMDS_MeshElement* tria = *triIt;
5156       // FACE
5157       const TopoDS_Shape& S = GetMeshDS()->IndexToShape( tria->getshapeId() );
5158       if ( S.IsNull() || S.ShapeType() != TopAbs_FACE ) continue;
5159       const TopoDS_Face& F = TopoDS::Face( S );
5160       Handle( Geom_Surface ) surf = BRep_Tool::Surface( F, loc );
5161       const double tol = BRep_Tool::Tolerance( F );
5162
5163       // nodes
5164       nodes.assign( tria->begin_nodes(), tria->end_nodes() );
5165       // UV
5166       bool uvOK = true, badTria = false;
5167       for ( int i = 0; i < 6; ++i )
5168       {
5169         uv[ i ] = GetNodeUV( F, nodes[i], nodes[(i+1)%3], &uvOK );
5170         // as this method is used after mesh generation, UV of nodes is not
5171         // updated according to bending links, so we update 
5172         if ( nodes[i]->GetPosition()->GetTypeOfPosition() == SMDS_TOP_FACE )
5173           CheckNodeUV( F, nodes[i], uv[ i ], 2*tol, /*force=*/true );
5174       }
5175
5176       // move the central node
5177       gp_Pnt p;
5178       if ( !uvOK || badTria )
5179       {
5180         p = ( SMESH_TNodeXYZ( nodes[3] ) +
5181               SMESH_TNodeXYZ( nodes[4] ) +
5182               SMESH_TNodeXYZ( nodes[5] )) / 3;
5183       }
5184       else
5185       {
5186         AdjustByPeriod( F, uv, 6 ); // put uv[] within a period (IPAL52698)
5187         gp_XY uvCent = GetCenterUV( uv[0], uv[1], uv[2], uv[3], uv[4], uv[5], &badTria );
5188         p = surf->Value( uvCent.X(), uvCent.Y() ).Transformed( loc );
5189       }
5190       GetMeshDS()->MoveNode( tria->GetNode(6), p.X(), p.Y(), p.Z() );
5191     }
5192   }
5193
5194   // treat tri-quadratic hexahedra
5195   {
5196     SMDS_VolumeTool volExp;
5197     TIDSortedElemSet::iterator hexIt = triQuadHexa.begin();
5198     for ( ; hexIt != triQuadHexa.end(); ++hexIt )
5199     {
5200       volExp.Set( *hexIt, /*ignoreCentralNodes=*/false );
5201
5202       // fix nodes central in sides
5203       for ( int iQuad = 0; iQuad < volExp.NbFaces(); ++iQuad )
5204       {
5205         const SMDS_MeshNode** quadNodes = volExp.GetFaceNodes( iQuad );
5206         if ( quadNodes[8]->GetPosition()->GetTypeOfPosition() == SMDS_TOP_3DSPACE )
5207         {
5208           gp_XYZ p = calcTFI( 0.5, 0.5,
5209                               SMESH_TNodeXYZ( quadNodes[0] ), SMESH_TNodeXYZ( quadNodes[2] ),
5210                               SMESH_TNodeXYZ( quadNodes[4] ), SMESH_TNodeXYZ( quadNodes[6] ),
5211                               SMESH_TNodeXYZ( quadNodes[1] ), SMESH_TNodeXYZ( quadNodes[3] ),
5212                               SMESH_TNodeXYZ( quadNodes[5] ), SMESH_TNodeXYZ( quadNodes[7] ));
5213           GetMeshDS()->MoveNode( quadNodes[8], p.X(), p.Y(), p.Z());
5214         }
5215       }
5216
5217       // fix the volume central node
5218       vector<gp_XYZ> pointsOnShapes( SMESH_Block::ID_Shell );
5219       const SMDS_MeshNode** hexNodes = volExp.GetNodes();
5220
5221       pointsOnShapes[ SMESH_Block::ID_V000 ] = SMESH_TNodeXYZ( hexNodes[ 0 ] );
5222       pointsOnShapes[ SMESH_Block::ID_V100 ] = SMESH_TNodeXYZ( hexNodes[ 3 ] );
5223       pointsOnShapes[ SMESH_Block::ID_V010 ] = SMESH_TNodeXYZ( hexNodes[ 1 ] );
5224       pointsOnShapes[ SMESH_Block::ID_V110 ] = SMESH_TNodeXYZ( hexNodes[ 2 ] );
5225       pointsOnShapes[ SMESH_Block::ID_V001 ] = SMESH_TNodeXYZ( hexNodes[ 4 ] );
5226       pointsOnShapes[ SMESH_Block::ID_V101 ] = SMESH_TNodeXYZ( hexNodes[ 7 ] );
5227       pointsOnShapes[ SMESH_Block::ID_V011 ] = SMESH_TNodeXYZ( hexNodes[ 5 ] );
5228       pointsOnShapes[ SMESH_Block::ID_V111 ] = SMESH_TNodeXYZ( hexNodes[ 6 ] );
5229
5230       pointsOnShapes[ SMESH_Block::ID_Ex00 ] = SMESH_TNodeXYZ( hexNodes[ 11 ] );
5231       pointsOnShapes[ SMESH_Block::ID_Ex10 ] = SMESH_TNodeXYZ( hexNodes[  9 ] );
5232       pointsOnShapes[ SMESH_Block::ID_E0y0 ] = SMESH_TNodeXYZ( hexNodes[  8 ] );
5233       pointsOnShapes[ SMESH_Block::ID_E1y0 ] = SMESH_TNodeXYZ( hexNodes[ 10 ] );
5234       pointsOnShapes[ SMESH_Block::ID_Ex01 ] = SMESH_TNodeXYZ( hexNodes[ 15 ] );
5235       pointsOnShapes[ SMESH_Block::ID_Ex11 ] = SMESH_TNodeXYZ( hexNodes[ 13 ] );
5236       pointsOnShapes[ SMESH_Block::ID_E0y1 ] = SMESH_TNodeXYZ( hexNodes[ 12 ] );
5237       pointsOnShapes[ SMESH_Block::ID_E1y1 ] = SMESH_TNodeXYZ( hexNodes[ 14 ] );
5238       pointsOnShapes[ SMESH_Block::ID_E00z ] = SMESH_TNodeXYZ( hexNodes[ 16 ] );    
5239       pointsOnShapes[ SMESH_Block::ID_E10z ] = SMESH_TNodeXYZ( hexNodes[ 19 ] );    
5240       pointsOnShapes[ SMESH_Block::ID_E01z ] = SMESH_TNodeXYZ( hexNodes[ 17 ] );    
5241       pointsOnShapes[ SMESH_Block::ID_E11z ] = SMESH_TNodeXYZ( hexNodes[ 18 ] );
5242
5243       pointsOnShapes[ SMESH_Block::ID_Fxy0 ] = SMESH_TNodeXYZ( hexNodes[ 20 ] );
5244       pointsOnShapes[ SMESH_Block::ID_Fxy1 ] = SMESH_TNodeXYZ( hexNodes[ 25 ] );
5245       pointsOnShapes[ SMESH_Block::ID_Fx0z ] = SMESH_TNodeXYZ( hexNodes[ 21 ] );   
5246       pointsOnShapes[ SMESH_Block::ID_Fx1z ] = SMESH_TNodeXYZ( hexNodes[ 23 ] );   
5247       pointsOnShapes[ SMESH_Block::ID_F0yz ] = SMESH_TNodeXYZ( hexNodes[ 24 ] );    
5248       pointsOnShapes[ SMESH_Block::ID_F1yz ] = SMESH_TNodeXYZ( hexNodes[ 22 ] );
5249
5250       gp_XYZ nCenterParams(0.5, 0.5, 0.5), nCenterCoords;
5251       SMESH_Block::ShellPoint( nCenterParams, pointsOnShapes, nCenterCoords );
5252       GetMeshDS()->MoveNode( hexNodes[26],
5253                              nCenterCoords.X(), nCenterCoords.Y(), nCenterCoords.Z());
5254     }
5255   }
5256 }