Salome HOME
23627: [IMACS] ASERIS: project point to the mesh and create a slot
[modules/smesh.git] / src / SMESHUtils / SMESH_MeshAlgos.cxx
1 // Copyright (C) 2007-2016  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 // File      : SMESH_MeshAlgos.hxx
23 // Created   : Tue Apr 30 18:00:36 2013
24 // Author    : Edward AGAPOV (eap)
25
26 // Initially this file held some low level algorithms extracted from SMESH_MeshEditor
27 // to make them accessible from Controls package
28
29 #include "SMESH_MeshAlgos.hxx"
30
31 #include "ObjectPool.hxx"
32 #include "SMDS_FaceOfNodes.hxx"
33 #include "SMDS_LinearEdge.hxx"
34 #include "SMDS_Mesh.hxx"
35 #include "SMDS_PolygonalFaceOfNodes.hxx"
36 #include "SMDS_VolumeTool.hxx"
37 #include "SMESH_OctreeNode.hxx"
38
39 #include <Utils_SALOME_Exception.hxx>
40
41 #include <GC_MakeSegment.hxx>
42 #include <GeomAPI_ExtremaCurveCurve.hxx>
43 #include <Geom_Line.hxx>
44 #include <IntAna_IntConicQuad.hxx>
45 #include <IntAna_Quadric.hxx>
46 #include <gp_Lin.hxx>
47 #include <gp_Pln.hxx>
48 #include <NCollection_DataMap.hxx>
49
50 #include <limits>
51 #include <numeric>
52
53 #include <boost/container/flat_set.hpp>
54
55 //=======================================================================
56 /*!
57  * \brief Implementation of search for the node closest to point
58  */
59 //=======================================================================
60
61 struct SMESH_NodeSearcherImpl: public SMESH_NodeSearcher
62 {
63   //---------------------------------------------------------------------
64   /*!
65    * \brief Constructor
66    */
67   SMESH_NodeSearcherImpl( const SMDS_Mesh*     theMesh   = 0,
68                           SMDS_ElemIteratorPtr theElemIt = SMDS_ElemIteratorPtr() )
69   {
70     myMesh = ( SMDS_Mesh* ) theMesh;
71
72     TIDSortedNodeSet nodes;
73     if ( theMesh ) {
74       SMDS_NodeIteratorPtr nIt = theMesh->nodesIterator();
75       while ( nIt->more() )
76         nodes.insert( nodes.end(), nIt->next() );
77     }
78     else if ( theElemIt )
79     {
80       while ( theElemIt->more() )
81       {
82         const SMDS_MeshElement* e = theElemIt->next();
83         nodes.insert( e->begin_nodes(), e->end_nodes() );
84       }
85     }
86     myOctreeNode = new SMESH_OctreeNode(nodes) ;
87
88     // get max size of a leaf box
89     SMESH_OctreeNode* tree = myOctreeNode;
90     while ( !tree->isLeaf() )
91     {
92       SMESH_OctreeNodeIteratorPtr cIt = tree->GetChildrenIterator();
93       if ( cIt->more() )
94         tree = cIt->next();
95     }
96     myHalfLeafSize = tree->maxSize() / 2.;
97   }
98
99   //---------------------------------------------------------------------
100   /*!
101    * \brief Move node and update myOctreeNode accordingly
102    */
103   void MoveNode( const SMDS_MeshNode* node, const gp_Pnt& toPnt )
104   {
105     myOctreeNode->UpdateByMoveNode( node, toPnt );
106     myMesh->MoveNode( node, toPnt.X(), toPnt.Y(), toPnt.Z() );
107   }
108
109   //---------------------------------------------------------------------
110   /*!
111    * \brief Do it's job
112    */
113   const SMDS_MeshNode* FindClosestTo( const gp_Pnt& thePnt )
114   {
115     std::map<double, const SMDS_MeshNode*> dist2Nodes;
116     myOctreeNode->NodesAround( thePnt.Coord(), dist2Nodes, myHalfLeafSize );
117     if ( !dist2Nodes.empty() )
118       return dist2Nodes.begin()->second;
119
120     std::vector<const SMDS_MeshNode*> nodes;
121     //myOctreeNode->NodesAround( &tgtNode, &nodes, myHalfLeafSize );
122
123     double minSqDist = DBL_MAX;
124     if ( nodes.empty() )  // get all nodes of OctreeNode's closest to thePnt
125     {
126       // sort leafs by their distance from thePnt
127       typedef std::multimap< double, SMESH_OctreeNode* > TDistTreeMap;
128       TDistTreeMap treeMap;
129       std::list< SMESH_OctreeNode* > treeList;
130       std::list< SMESH_OctreeNode* >::iterator trIt;
131       treeList.push_back( myOctreeNode );
132
133       gp_XYZ pointNode( thePnt.X(), thePnt.Y(), thePnt.Z() );
134       bool pointInside = myOctreeNode->isInside( pointNode, myHalfLeafSize );
135       for ( trIt = treeList.begin(); trIt != treeList.end(); ++trIt)
136       {
137         SMESH_OctreeNode* tree = *trIt;
138         if ( !tree->isLeaf() ) // put children to the queue
139         {
140           if ( pointInside && !tree->isInside( pointNode, myHalfLeafSize )) continue;
141           SMESH_OctreeNodeIteratorPtr cIt = tree->GetChildrenIterator();
142           while ( cIt->more() )
143             treeList.push_back( cIt->next() );
144         }
145         else if ( tree->NbNodes() ) // put a tree to the treeMap
146         {
147           const Bnd_B3d& box = *tree->getBox();
148           double sqDist = thePnt.SquareDistance( 0.5 * ( box.CornerMin() + box.CornerMax() ));
149           treeMap.insert( std::make_pair( sqDist, tree ));
150         }
151       }
152       // find distance after which there is no sense to check tree's
153       double sqLimit = DBL_MAX;
154       TDistTreeMap::iterator sqDist_tree = treeMap.begin();
155       if ( treeMap.size() > 5 ) {
156         SMESH_OctreeNode* closestTree = sqDist_tree->second;
157         const Bnd_B3d& box = *closestTree->getBox();
158         double limit = sqrt( sqDist_tree->first ) + sqrt ( box.SquareExtent() );
159         sqLimit = limit * limit;
160       }
161       // get all nodes from trees
162       for ( ; sqDist_tree != treeMap.end(); ++sqDist_tree) {
163         if ( sqDist_tree->first > sqLimit )
164           break;
165         SMESH_OctreeNode* tree = sqDist_tree->second;
166         tree->AllNodesAround( tree->GetNodeIterator()->next(), &nodes );
167       }
168     }
169     // find closest among nodes
170     minSqDist = DBL_MAX;
171     const SMDS_MeshNode* closestNode = 0;
172     for ( size_t i = 0; i < nodes.size(); ++i )
173     {
174       double sqDist = thePnt.SquareDistance( SMESH_NodeXYZ( nodes[ i ]));
175       if ( minSqDist > sqDist ) {
176         closestNode = nodes[ i ];
177         minSqDist = sqDist;
178       }
179     }
180     return closestNode;
181   }
182
183   //---------------------------------------------------------------------
184   /*!
185    * \brief Finds nodes located within a tolerance near a point
186    */
187   int FindNearPoint(const gp_Pnt&                        point,
188                     const double                         tolerance,
189                     std::vector< const SMDS_MeshNode* >& foundNodes)
190   {
191     myOctreeNode->NodesAround( point.Coord(), foundNodes, tolerance );
192     return foundNodes.size();
193   }
194
195   //---------------------------------------------------------------------
196   /*!
197    * \brief Destructor
198    */
199   ~SMESH_NodeSearcherImpl() { delete myOctreeNode; }
200
201   //---------------------------------------------------------------------
202   /*!
203    * \brief Return the node tree
204    */
205   const SMESH_OctreeNode* getTree() const { return myOctreeNode; }
206
207 private:
208   SMESH_OctreeNode* myOctreeNode;
209   SMDS_Mesh*        myMesh;
210   double            myHalfLeafSize; // max size of a leaf box
211 };
212
213 // ========================================================================
214 namespace // Utils used in SMESH_ElementSearcherImpl::FindElementsByPoint()
215 {
216   const int MaxNbElemsInLeaf = 10; // maximal number of elements in a leaf of tree
217   const int MaxLevel         = 7;  // maximal tree height -> nb terminal boxes: 8^7 = 2097152
218   const double NodeRadius = 1e-9;  // to enlarge bnd box of element
219
220   //=======================================================================
221   /*!
222    * \brief Octal tree of bounding boxes of elements
223    */
224   //=======================================================================
225
226   class ElementBndBoxTree : public SMESH_Octree
227   {
228   public:
229
230     typedef boost::container::flat_set< const SMDS_MeshElement*, TIDCompare > TElemSeq;
231
232     ElementBndBoxTree(const SMDS_Mesh&     mesh,
233                       SMDSAbs_ElementType  elemType,
234                       SMDS_ElemIteratorPtr theElemIt = SMDS_ElemIteratorPtr(),
235                       double               tolerance = NodeRadius );
236     void getElementsNearPoint( const gp_Pnt& point, TElemSeq& foundElems );
237     void getElementsNearLine ( const gp_Ax1& line,  TElemSeq& foundElems );
238     void getElementsInBox    ( const Bnd_B3d& box,  TElemSeq& foundElems );
239     void getElementsInSphere ( const gp_XYZ& center, const double radius, TElemSeq& foundElems );
240     ElementBndBoxTree* getLeafAtPoint( const gp_XYZ& point );
241
242   protected:
243     ElementBndBoxTree() {}
244     SMESH_Octree* newChild() const { return new ElementBndBoxTree; }
245     void          buildChildrenData();
246     Bnd_B3d*      buildRootBox();
247   private:
248     //!< Bounding box of element
249     struct ElementBox : public Bnd_B3d
250     {
251       const SMDS_MeshElement* _element;
252       void init(const SMDS_MeshElement* elem, double tolerance);
253     };
254     std::vector< ElementBox* > _elements;
255
256     typedef ObjectPool< ElementBox > TElementBoxPool;
257
258     //!< allocator of ElementBox's and SMESH_TreeLimit
259     struct LimitAndPool : public SMESH_TreeLimit
260     {
261       TElementBoxPool _elBoPool;
262       LimitAndPool():SMESH_TreeLimit( MaxLevel, /*minSize=*/0. ) {}
263     };
264     LimitAndPool* getLimitAndPool() const
265     {
266       SMESH_TreeLimit* limitAndPool = const_cast< SMESH_TreeLimit* >( myLimit );
267       return static_cast< LimitAndPool* >( limitAndPool );
268     }
269   };
270
271   //================================================================================
272   /*!
273    * \brief ElementBndBoxTree creation
274    */
275   //================================================================================
276
277   ElementBndBoxTree::ElementBndBoxTree(const SMDS_Mesh&     mesh,
278                                        SMDSAbs_ElementType  elemType,
279                                        SMDS_ElemIteratorPtr theElemIt,
280                                        double               tolerance)
281     :SMESH_Octree( new LimitAndPool() )
282   {
283     int nbElems = mesh.GetMeshInfo().NbElements( elemType );
284     _elements.reserve( nbElems );
285
286     TElementBoxPool& elBoPool = getLimitAndPool()->_elBoPool;
287
288 #ifdef _DEBUG_
289     if ( theElemIt && !theElemIt->more() )
290       std::cout << "WARNING: ElementBndBoxTree constructed on empty iterator!" << std::endl;
291 #endif
292
293     SMDS_ElemIteratorPtr elemIt = theElemIt ? theElemIt : mesh.elementsIterator( elemType );
294     while ( elemIt->more() )
295     {
296       ElementBox* eb = elBoPool.getNew();
297       eb->init( elemIt->next(), tolerance );
298       _elements.push_back( eb );
299     }
300     compute();
301   }
302
303   //================================================================================
304   /*!
305    * \brief Return the maximal box
306    */
307   //================================================================================
308
309   Bnd_B3d* ElementBndBoxTree::buildRootBox()
310   {
311     Bnd_B3d* box = new Bnd_B3d;
312     for ( size_t i = 0; i < _elements.size(); ++i )
313       box->Add( *_elements[i] );
314     return box;
315   }
316
317   //================================================================================
318   /*!
319    * \brief Redistrubute element boxes among children
320    */
321   //================================================================================
322
323   void ElementBndBoxTree::buildChildrenData()
324   {
325     for ( size_t i = 0; i < _elements.size(); ++i )
326     {
327       for (int j = 0; j < 8; j++)
328       {
329         if ( !_elements[i]->IsOut( *myChildren[j]->getBox() ))
330           ((ElementBndBoxTree*)myChildren[j])->_elements.push_back( _elements[i]);
331       }
332     }
333     //_size = _elements.size();
334     SMESHUtils::FreeVector( _elements ); // = _elements.clear() + free memory
335
336     for (int j = 0; j < 8; j++)
337     {
338       ElementBndBoxTree* child = static_cast<ElementBndBoxTree*>( myChildren[j]);
339       if ((int) child->_elements.size() <= MaxNbElemsInLeaf )
340         child->myIsLeaf = true;
341
342       if ( child->isLeaf() && child->_elements.capacity() > child->_elements.size() )
343         SMESHUtils::CompactVector( child->_elements );
344     }
345   }
346
347   //================================================================================
348   /*!
349    * \brief Return elements which can include the point
350    */
351   //================================================================================
352
353   void ElementBndBoxTree::getElementsNearPoint( const gp_Pnt& point, TElemSeq& foundElems)
354   {
355     if ( getBox()->IsOut( point.XYZ() ))
356       return;
357
358     if ( isLeaf() )
359     {
360       for ( size_t i = 0; i < _elements.size(); ++i )
361         if ( !_elements[i]->IsOut( point.XYZ() ))
362           foundElems.insert( _elements[i]->_element );
363     }
364     else
365     {
366       for (int i = 0; i < 8; i++)
367         ((ElementBndBoxTree*) myChildren[i])->getElementsNearPoint( point, foundElems );
368     }
369   }
370
371   //================================================================================
372   /*!
373    * \brief Return elements which can be intersected by the line
374    */
375   //================================================================================
376
377   void ElementBndBoxTree::getElementsNearLine( const gp_Ax1& line, TElemSeq& foundElems )
378   {
379     if ( getBox()->IsOut( line ))
380       return;
381
382     if ( isLeaf() )
383     {
384       for ( size_t i = 0; i < _elements.size(); ++i )
385         if ( !_elements[i]->IsOut( line ) )
386           foundElems.insert( _elements[i]->_element );
387     }
388     else
389     {
390       for (int i = 0; i < 8; i++)
391         ((ElementBndBoxTree*) myChildren[i])->getElementsNearLine( line, foundElems );
392     }
393   }
394
395   //================================================================================
396   /*!
397    * \brief Return elements from leaves intersecting the sphere
398    */
399   //================================================================================
400
401   void ElementBndBoxTree::getElementsInSphere ( const gp_XYZ& center,
402                                                 const double  radius,
403                                                 TElemSeq&     foundElems)
404   {
405     if ( getBox()->IsOut( center, radius ))
406       return;
407
408     if ( isLeaf() )
409     {
410       for ( size_t i = 0; i < _elements.size(); ++i )
411         if ( !_elements[i]->IsOut( center, radius ))
412           foundElems.insert( _elements[i]->_element );
413     }
414     else
415     {
416       for (int i = 0; i < 8; i++)
417         ((ElementBndBoxTree*) myChildren[i])->getElementsInSphere( center, radius, foundElems );
418     }
419   }
420
421   //================================================================================
422   /*!
423    * \brief Return elements from leaves intersecting the box
424    */
425   //================================================================================
426
427   void ElementBndBoxTree::getElementsInBox( const Bnd_B3d& box,  TElemSeq& foundElems )
428   {
429     if ( getBox()->IsOut( box ))
430       return;
431
432     if ( isLeaf() )
433     {
434       for ( size_t i = 0; i < _elements.size(); ++i )
435         if ( !_elements[i]->IsOut( box ))
436           foundElems.insert( _elements[i]->_element );
437     }
438     else
439     {
440       for (int i = 0; i < 8; i++)
441         ((ElementBndBoxTree*) myChildren[i])->getElementsInBox( box, foundElems );
442     }
443   }
444
445   //================================================================================
446   /*!
447    * \brief Return a leaf including a point
448    */
449   //================================================================================
450
451   ElementBndBoxTree* ElementBndBoxTree::getLeafAtPoint( const gp_XYZ& point )
452   {
453     if ( getBox()->IsOut( point ))
454       return 0;
455
456     if ( isLeaf() )
457     {
458       return this;
459     }
460     else
461     {
462       for (int i = 0; i < 8; i++)
463         if ( ElementBndBoxTree* l = ((ElementBndBoxTree*) myChildren[i])->getLeafAtPoint( point ))
464           return l;
465     }
466     return 0;
467   }
468
469   //================================================================================
470   /*!
471    * \brief Construct the element box
472    */
473   //================================================================================
474
475   void ElementBndBoxTree::ElementBox::init(const SMDS_MeshElement* elem, double tolerance)
476   {
477     _element  = elem;
478     SMDS_ElemIteratorPtr nIt = elem->nodesIterator();
479     while ( nIt->more() )
480       Add( SMESH_NodeXYZ( nIt->next() ));
481     Enlarge( tolerance );
482   }
483
484 } // namespace
485
486 //=======================================================================
487 /*!
488  * \brief Implementation of search for the elements by point and
489  *        of classification of point in 2D mesh
490  */
491 //=======================================================================
492
493 SMESH_ElementSearcher::~SMESH_ElementSearcher()
494 {
495 }
496
497 struct SMESH_ElementSearcherImpl: public SMESH_ElementSearcher
498 {
499   SMDS_Mesh*                        _mesh;
500   SMDS_ElemIteratorPtr              _meshPartIt;
501   ElementBndBoxTree*                _ebbTree      [SMDSAbs_NbElementTypes];
502   int                               _ebbTreeHeight[SMDSAbs_NbElementTypes];
503   SMESH_NodeSearcherImpl*           _nodeSearcher;
504   SMDSAbs_ElementType               _elementType;
505   double                            _tolerance;
506   bool                              _outerFacesFound;
507   std::set<const SMDS_MeshElement*> _outerFaces; // empty means "no internal faces at all"
508
509   SMESH_ElementSearcherImpl( SMDS_Mesh&           mesh,
510                              double               tol=-1,
511                              SMDS_ElemIteratorPtr elemIt=SMDS_ElemIteratorPtr())
512     : _mesh(&mesh),_meshPartIt(elemIt),_nodeSearcher(0),_tolerance(tol),_outerFacesFound(false)
513   {
514     for ( int i = 0; i < SMDSAbs_NbElementTypes; ++i )
515     {
516       _ebbTree[i] = NULL;
517       _ebbTreeHeight[i] = -1;
518     }
519     _elementType = SMDSAbs_All;
520   }
521   virtual ~SMESH_ElementSearcherImpl()
522   {
523     for ( int i = 0; i < SMDSAbs_NbElementTypes; ++i )
524     {
525       delete _ebbTree[i]; _ebbTree[i] = NULL;
526     }
527     if ( _nodeSearcher ) delete _nodeSearcher; _nodeSearcher = 0;
528   }
529   virtual int FindElementsByPoint(const gp_Pnt&                           point,
530                                   SMDSAbs_ElementType                     type,
531                                   std::vector< const SMDS_MeshElement* >& foundElements);
532   virtual TopAbs_State GetPointState(const gp_Pnt& point);
533   virtual const SMDS_MeshElement* FindClosestTo( const gp_Pnt&       point,
534                                                  SMDSAbs_ElementType type );
535
536   virtual void GetElementsNearLine( const gp_Ax1&                           line,
537                                     SMDSAbs_ElementType                     type,
538                                     std::vector< const SMDS_MeshElement* >& foundElems);
539   virtual void GetElementsInSphere( const gp_XYZ&                           center,
540                                     const double                            radius,
541                                     SMDSAbs_ElementType                     type,
542                                     std::vector< const SMDS_MeshElement* >& foundElems);
543   virtual void GetElementsInBox( const Bnd_B3d&                          box,
544                                  SMDSAbs_ElementType                     type,
545                                  std::vector< const SMDS_MeshElement* >& foundElems);
546   virtual gp_XYZ Project(const gp_Pnt&            point,
547                          SMDSAbs_ElementType      type,
548                          const SMDS_MeshElement** closestElem);
549   double getTolerance();
550   bool getIntersParamOnLine(const gp_Lin& line, const SMDS_MeshElement* face,
551                             const double tolerance, double & param);
552   void findOuterBoundary(const SMDS_MeshElement* anyOuterFace);
553   bool isOuterBoundary(const SMDS_MeshElement* face) const
554   {
555     return _outerFaces.empty() || _outerFaces.count(face);
556   }
557   int getTreeHeight()
558   {
559     if ( _ebbTreeHeight[ _elementType ] < 0 )
560       _ebbTreeHeight[ _elementType ] = _ebbTree[ _elementType ]->getHeight();
561     return _ebbTreeHeight[ _elementType ];
562   }
563
564   struct TInters //!< data of intersection of the line and the mesh face (used in GetPointState())
565   {
566     const SMDS_MeshElement* _face;
567     gp_Vec                  _faceNorm;
568     bool                    _coincides; //!< the line lays in face plane
569     TInters(const SMDS_MeshElement* face, const gp_Vec& faceNorm, bool coinc=false)
570       : _face(face), _faceNorm( faceNorm ), _coincides( coinc ) {}
571   };
572   struct TFaceLink //!< link and faces sharing it (used in findOuterBoundary())
573   {
574     SMESH_TLink      _link;
575     TIDSortedElemSet _faces;
576     TFaceLink( const SMDS_MeshNode* n1, const SMDS_MeshNode* n2, const SMDS_MeshElement* face)
577       : _link( n1, n2 ), _faces( &face, &face + 1) {}
578   };
579 };
580
581 ostream& operator<< (ostream& out, const SMESH_ElementSearcherImpl::TInters& i)
582 {
583   return out << "TInters(face=" << ( i._face ? i._face->GetID() : 0)
584              << ", _coincides="<<i._coincides << ")";
585 }
586
587 //=======================================================================
588 /*!
589  * \brief define tolerance for search
590  */
591 //=======================================================================
592
593 double SMESH_ElementSearcherImpl::getTolerance()
594 {
595   if ( _tolerance < 0 )
596   {
597     const SMDS_MeshInfo& meshInfo = _mesh->GetMeshInfo();
598
599     _tolerance = 0;
600     if ( _nodeSearcher && meshInfo.NbNodes() > 1 )
601     {
602       double boxSize = _nodeSearcher->getTree()->maxSize();
603       _tolerance = 1e-8 * boxSize/* / meshInfo.NbNodes()*/;
604     }
605     else if ( _ebbTree[_elementType] && meshInfo.NbElements() > 0 )
606     {
607       double boxSize = _ebbTree[_elementType]->maxSize();
608       _tolerance = 1e-8 * boxSize/* / meshInfo.NbElements()*/;
609     }
610     if ( _tolerance == 0 )
611     {
612       // define tolerance by size of a most complex element
613       int complexType = SMDSAbs_Volume;
614       while ( complexType > SMDSAbs_All &&
615               meshInfo.NbElements( SMDSAbs_ElementType( complexType )) < 1 )
616         --complexType;
617       if ( complexType == SMDSAbs_All ) return 0; // empty mesh
618       double elemSize;
619       if ( complexType == int( SMDSAbs_Node ))
620       {
621         SMDS_NodeIteratorPtr nodeIt = _mesh->nodesIterator();
622         elemSize = 1;
623         if ( meshInfo.NbNodes() > 2 )
624           elemSize = SMESH_TNodeXYZ( nodeIt->next() ).Distance( nodeIt->next() );
625       }
626       else
627       {
628         SMDS_ElemIteratorPtr  elemIt = _mesh->elementsIterator( SMDSAbs_ElementType( complexType ));
629         const SMDS_MeshElement* elem = elemIt->next();
630         SMDS_ElemIteratorPtr  nodeIt = elem->nodesIterator();
631         SMESH_TNodeXYZ n1( nodeIt->next() );
632         elemSize = 0;
633         while ( nodeIt->more() )
634         {
635           double dist = n1.Distance( static_cast<const SMDS_MeshNode*>( nodeIt->next() ));
636           elemSize = std::max( dist, elemSize );
637         }
638       }
639       _tolerance = 1e-4 * elemSize;
640     }
641   }
642   return _tolerance;
643 }
644
645 //================================================================================
646 /*!
647  * \brief Find intersection of the line and an edge of face and return parameter on line
648  */
649 //================================================================================
650
651 bool SMESH_ElementSearcherImpl::getIntersParamOnLine(const gp_Lin&           line,
652                                                      const SMDS_MeshElement* face,
653                                                      const double            tol,
654                                                      double &                param)
655 {
656   int nbInts = 0;
657   param = 0;
658
659   GeomAPI_ExtremaCurveCurve anExtCC;
660   Handle(Geom_Curve) lineCurve = new Geom_Line( line );
661
662   int nbNodes = face->IsQuadratic() ? face->NbNodes()/2 : face->NbNodes();
663   for ( int i = 0; i < nbNodes && nbInts < 2; ++i )
664   {
665     GC_MakeSegment edge( SMESH_TNodeXYZ( face->GetNode( i )),
666                          SMESH_TNodeXYZ( face->GetNode( (i+1)%nbNodes) ));
667     anExtCC.Init( lineCurve, edge.Value() );
668     if ( anExtCC.NbExtrema() > 0 && anExtCC.LowerDistance() <= tol)
669     {
670       Standard_Real pl, pe;
671       anExtCC.LowerDistanceParameters( pl, pe );
672       param += pl;
673       if ( ++nbInts == 2 )
674         break;
675     }
676   }
677   if ( nbInts > 0 ) param /= nbInts;
678   return nbInts > 0;
679 }
680 //================================================================================
681 /*!
682  * \brief Find all faces belonging to the outer boundary of mesh
683  */
684 //================================================================================
685
686 void SMESH_ElementSearcherImpl::findOuterBoundary(const SMDS_MeshElement* outerFace)
687 {
688   if ( _outerFacesFound ) return;
689
690   // Collect all outer faces by passing from one outer face to another via their links
691   // and BTW find out if there are internal faces at all.
692
693   // checked links and links where outer boundary meets internal one
694   std::set< SMESH_TLink > visitedLinks, seamLinks;
695
696   // links to treat with already visited faces sharing them
697   std::list < TFaceLink > startLinks;
698
699   // load startLinks with the first outerFace
700   startLinks.push_back( TFaceLink( outerFace->GetNode(0), outerFace->GetNode(1), outerFace));
701   _outerFaces.insert( outerFace );
702
703   TIDSortedElemSet emptySet;
704   while ( !startLinks.empty() )
705   {
706     const SMESH_TLink& link  = startLinks.front()._link;
707     TIDSortedElemSet&  faces = startLinks.front()._faces;
708
709     outerFace = *faces.begin();
710     // find other faces sharing the link
711     const SMDS_MeshElement* f;
712     while (( f = SMESH_MeshAlgos::FindFaceInSet(link.node1(), link.node2(), emptySet, faces )))
713       faces.insert( f );
714
715     // select another outer face among the found
716     const SMDS_MeshElement* outerFace2 = 0;
717     if ( faces.size() == 2 )
718     {
719       outerFace2 = (outerFace == *faces.begin() ? *faces.rbegin() : *faces.begin());
720     }
721     else if ( faces.size() > 2 )
722     {
723       seamLinks.insert( link );
724
725       // link direction within the outerFace
726       gp_Vec n1n2( SMESH_TNodeXYZ( link.node1()),
727                    SMESH_TNodeXYZ( link.node2()));
728       int i1 = outerFace->GetNodeIndex( link.node1() );
729       int i2 = outerFace->GetNodeIndex( link.node2() );
730       bool rev = ( abs(i2-i1) == 1 ? i1 > i2 : i2 > i1 );
731       if ( rev ) n1n2.Reverse();
732       // outerFace normal
733       gp_XYZ ofNorm, fNorm;
734       if ( SMESH_MeshAlgos::FaceNormal( outerFace, ofNorm, /*normalized=*/false ))
735       {
736         // direction from the link inside outerFace
737         gp_Vec dirInOF = gp_Vec( ofNorm ) ^ n1n2;
738         // sort all other faces by angle with the dirInOF
739         std::map< double, const SMDS_MeshElement* > angle2Face;
740         std::set< const SMDS_MeshElement*, TIDCompare >::const_iterator face = faces.begin();
741         for ( ; face != faces.end(); ++face )
742         {
743           if ( *face == outerFace ) continue;
744           if ( !SMESH_MeshAlgos::FaceNormal( *face, fNorm, /*normalized=*/false ))
745             continue;
746           gp_Vec dirInF = gp_Vec( fNorm ) ^ n1n2;
747           double angle = dirInOF.AngleWithRef( dirInF, n1n2 );
748           if ( angle < 0 ) angle += 2. * M_PI;
749           angle2Face.insert( std::make_pair( angle, *face ));
750         }
751         if ( !angle2Face.empty() )
752           outerFace2 = angle2Face.begin()->second;
753       }
754     }
755     // store the found outer face and add its links to continue searching from
756     if ( outerFace2 )
757     {
758       _outerFaces.insert( outerFace2 );
759       int nbNodes = outerFace2->NbCornerNodes();
760       for ( int i = 0; i < nbNodes; ++i )
761       {
762         SMESH_TLink link2( outerFace2->GetNode(i), outerFace2->GetNode((i+1)%nbNodes));
763         if ( visitedLinks.insert( link2 ).second )
764           startLinks.push_back( TFaceLink( link2.node1(), link2.node2(), outerFace2 ));
765       }
766     }
767     startLinks.pop_front();
768   }
769   _outerFacesFound = true;
770
771   if ( !seamLinks.empty() )
772   {
773     // There are internal boundaries touching the outher one,
774     // find all faces of internal boundaries in order to find
775     // faces of boundaries of holes, if any.
776
777   }
778   else
779   {
780     _outerFaces.clear();
781   }
782 }
783
784 //=======================================================================
785 /*!
786  * \brief Find elements of given type where the given point is IN or ON.
787  *        Returns nb of found elements and elements them-selves.
788  *
789  * 'ALL' type means elements of any type excluding nodes, balls and 0D elements
790  */
791 //=======================================================================
792
793 int SMESH_ElementSearcherImpl::
794 FindElementsByPoint(const gp_Pnt&                           point,
795                     SMDSAbs_ElementType                     type,
796                     std::vector< const SMDS_MeshElement* >& foundElements)
797 {
798   foundElements.clear();
799   _elementType = type;
800
801   double tolerance = getTolerance();
802
803   // =================================================================================
804   if ( type == SMDSAbs_Node || type == SMDSAbs_0DElement || type == SMDSAbs_Ball)
805   {
806     if ( !_nodeSearcher )
807     {
808       if ( _meshPartIt )
809         _nodeSearcher = new SMESH_NodeSearcherImpl( 0, _meshPartIt );
810       else
811         _nodeSearcher = new SMESH_NodeSearcherImpl( _mesh );
812     }
813     std::vector< const SMDS_MeshNode* > foundNodes;
814     _nodeSearcher->FindNearPoint( point, tolerance, foundNodes );
815
816     if ( type == SMDSAbs_Node )
817     {
818       foundElements.assign( foundNodes.begin(), foundNodes.end() );
819     }
820     else
821     {
822       for ( size_t i = 0; i < foundNodes.size(); ++i )
823       {
824         SMDS_ElemIteratorPtr elemIt = foundNodes[i]->GetInverseElementIterator( type );
825         while ( elemIt->more() )
826           foundElements.push_back( elemIt->next() );
827       }
828     }
829   }
830   // =================================================================================
831   else // elements more complex than 0D
832   {
833     if ( !_ebbTree[type] )
834     {
835       _ebbTree[_elementType] = new ElementBndBoxTree( *_mesh, type, _meshPartIt, tolerance );
836     }
837     ElementBndBoxTree::TElemSeq suspectElems;
838     _ebbTree[ type ]->getElementsNearPoint( point, suspectElems );
839     ElementBndBoxTree::TElemSeq::iterator elem = suspectElems.begin();
840     for ( ; elem != suspectElems.end(); ++elem )
841       if ( !SMESH_MeshAlgos::IsOut( *elem, point, tolerance ))
842         foundElements.push_back( *elem );
843   }
844   return foundElements.size();
845 }
846
847 //=======================================================================
848 /*!
849  * \brief Find an element of given type most close to the given point
850  *
851  * WARNING: Only face search is implemeneted so far
852  */
853 //=======================================================================
854
855 const SMDS_MeshElement*
856 SMESH_ElementSearcherImpl::FindClosestTo( const gp_Pnt&       point,
857                                           SMDSAbs_ElementType type )
858 {
859   const SMDS_MeshElement* closestElem = 0;
860   _elementType = type;
861
862   if ( type == SMDSAbs_Face ||
863        type == SMDSAbs_Volume ||
864        type == SMDSAbs_Edge )
865   {
866     ElementBndBoxTree*& ebbTree = _ebbTree[ type ];
867     if ( !ebbTree )
868       ebbTree = new ElementBndBoxTree( *_mesh, type, _meshPartIt );
869
870     ElementBndBoxTree::TElemSeq suspectElems;
871     ebbTree->getElementsNearPoint( point, suspectElems );
872
873     if ( suspectElems.empty() && ebbTree->maxSize() > 0 )
874     {
875       gp_Pnt boxCenter = 0.5 * ( ebbTree->getBox()->CornerMin() +
876                                  ebbTree->getBox()->CornerMax() );
877       double radius = -1;
878       if ( ebbTree->getBox()->IsOut( point.XYZ() ))
879         radius = point.Distance( boxCenter ) - 0.5 * ebbTree->maxSize();
880       if ( radius < 0 )
881         radius = ebbTree->maxSize() / pow( 2., getTreeHeight()) / 2;
882       while ( suspectElems.empty() && radius < 1e100 )
883       {
884         ebbTree->getElementsInSphere( point.XYZ(), radius, suspectElems );
885         radius *= 1.1;
886       }
887     }
888     double minDist = std::numeric_limits<double>::max();
889     std::multimap< double, const SMDS_MeshElement* > dist2face;
890     ElementBndBoxTree::TElemSeq::iterator elem = suspectElems.begin();
891     for ( ; elem != suspectElems.end(); ++elem )
892     {
893       double dist = SMESH_MeshAlgos::GetDistance( *elem, point );
894       if ( dist < minDist + 1e-10)
895       {
896         minDist = dist;
897         dist2face.insert( dist2face.begin(), std::make_pair( dist, *elem ));
898       }
899     }
900     if ( !dist2face.empty() )
901     {
902       std::multimap< double, const SMDS_MeshElement* >::iterator d2f = dist2face.begin();
903       closestElem = d2f->second;
904       // if there are several elements at the same distance, select one
905       // with GC closest to the point
906       typedef SMDS_StdIterator< SMESH_TNodeXYZ, SMDS_ElemIteratorPtr > TXyzIterator;
907       double minDistToGC = 0;
908       for ( ++d2f; d2f != dist2face.end() && fabs( d2f->first - minDist ) < 1e-10; ++d2f )
909       {
910         if ( minDistToGC == 0 )
911         {
912           gp_XYZ gc(0,0,0);
913           gc = accumulate( TXyzIterator(closestElem->nodesIterator()),
914                            TXyzIterator(), gc ) / closestElem->NbNodes();
915           minDistToGC = point.SquareDistance( gc );
916         }
917         gp_XYZ gc(0,0,0);
918         gc = accumulate( TXyzIterator( d2f->second->nodesIterator()),
919                          TXyzIterator(), gc ) / d2f->second->NbNodes();
920         double d = point.SquareDistance( gc );
921         if ( d < minDistToGC )
922         {
923           minDistToGC = d;
924           closestElem = d2f->second;
925         }
926       }
927       // cout << "FindClosestTo( " <<point.X()<<", "<<point.Y()<<", "<<point.Z()<<" ) FACE "
928       //      <<closestElem->GetID() << " DIST " << minDist << endl;
929     }
930   }
931   else
932   {
933     // NOT IMPLEMENTED SO FAR
934   }
935   return closestElem;
936 }
937
938
939 //================================================================================
940 /*!
941  * \brief Classify the given point in the closed 2D mesh
942  */
943 //================================================================================
944
945 TopAbs_State SMESH_ElementSearcherImpl::GetPointState(const gp_Pnt& point)
946 {
947   _elementType = SMDSAbs_Face;
948
949   double tolerance = getTolerance();
950
951   ElementBndBoxTree*& ebbTree = _ebbTree[ SMDSAbs_Face ];
952   if ( !ebbTree )
953     ebbTree = new ElementBndBoxTree( *_mesh, _elementType, _meshPartIt );
954
955   // Algo: analyse transition of a line starting at the point through mesh boundary;
956   // try three lines parallel to axis of the coordinate system and perform rough
957   // analysis. If solution is not clear perform thorough analysis.
958
959   const int nbAxes = 3;
960   gp_Dir axisDir[ nbAxes ] = { gp::DX(), gp::DY(), gp::DZ() };
961   std::map< double, TInters >   paramOnLine2TInters[ nbAxes ];
962   std::list< TInters > tangentInters[ nbAxes ]; // of faces whose plane includes the line
963   std::multimap< int, int > nbInt2Axis; // to find the simplest case
964   for ( int axis = 0; axis < nbAxes; ++axis )
965   {
966     gp_Ax1 lineAxis( point, axisDir[axis]);
967     gp_Lin line    ( lineAxis );
968
969     ElementBndBoxTree::TElemSeq suspectFaces; // faces possibly intersecting the line
970     ebbTree->getElementsNearLine( lineAxis, suspectFaces );
971
972     // Intersect faces with the line
973
974     std::map< double, TInters > & u2inters = paramOnLine2TInters[ axis ];
975     ElementBndBoxTree::TElemSeq::iterator face = suspectFaces.begin();
976     for ( ; face != suspectFaces.end(); ++face )
977     {
978       // get face plane
979       gp_XYZ fNorm;
980       if ( !SMESH_MeshAlgos::FaceNormal( *face, fNorm, /*normalized=*/false)) continue;
981       gp_Pln facePlane( SMESH_TNodeXYZ( (*face)->GetNode(0)), fNorm );
982
983       // perform intersection
984       IntAna_IntConicQuad intersection( line, IntAna_Quadric( facePlane ));
985       if ( !intersection.IsDone() )
986         continue;
987       if ( intersection.IsInQuadric() )
988       {
989         tangentInters[ axis ].push_back( TInters( *face, fNorm, true ));
990       }
991       else if ( ! intersection.IsParallel() && intersection.NbPoints() > 0 )
992       {
993         double tol = 1e-4 * Sqrt( fNorm.Modulus() );
994         gp_Pnt intersectionPoint = intersection.Point(1);
995         if ( !SMESH_MeshAlgos::IsOut( *face, intersectionPoint, tol ))
996           u2inters.insert( std::make_pair( intersection.ParamOnConic(1), TInters( *face, fNorm )));
997       }
998     }
999     // Analyse intersections roughly
1000
1001     int nbInter = u2inters.size();
1002     if ( nbInter == 0 )
1003       return TopAbs_OUT;
1004
1005     double f = u2inters.begin()->first, l = u2inters.rbegin()->first;
1006     if ( nbInter == 1 ) // not closed mesh
1007       return fabs( f ) < tolerance ? TopAbs_ON : TopAbs_UNKNOWN;
1008
1009     if ( fabs( f ) < tolerance || fabs( l ) < tolerance )
1010       return TopAbs_ON;
1011
1012     if ( (f<0) == (l<0) )
1013       return TopAbs_OUT;
1014
1015     int nbIntBeforePoint = std::distance( u2inters.begin(), u2inters.lower_bound(0));
1016     int nbIntAfterPoint  = nbInter - nbIntBeforePoint;
1017     if ( nbIntBeforePoint == 1 || nbIntAfterPoint == 1 )
1018       return TopAbs_IN;
1019
1020     nbInt2Axis.insert( std::make_pair( std::min( nbIntBeforePoint, nbIntAfterPoint ), axis ));
1021
1022     if ( _outerFacesFound ) break; // pass to thorough analysis
1023
1024   } // three attempts - loop on CS axes
1025
1026   // Analyse intersections thoroughly.
1027   // We make two loops maximum, on the first one we only exclude touching intersections,
1028   // on the second, if situation is still unclear, we gather and use information on
1029   // position of faces (internal or outer). If faces position is already gathered,
1030   // we make the second loop right away.
1031
1032   for ( int hasPositionInfo = _outerFacesFound; hasPositionInfo < 2; ++hasPositionInfo )
1033   {
1034     std::multimap< int, int >::const_iterator nb_axis = nbInt2Axis.begin();
1035     for ( ; nb_axis != nbInt2Axis.end(); ++nb_axis )
1036     {
1037       int axis = nb_axis->second;
1038       std::map< double, TInters > & u2inters = paramOnLine2TInters[ axis ];
1039
1040       gp_Ax1 lineAxis( point, axisDir[axis]);
1041       gp_Lin line    ( lineAxis );
1042
1043       // add tangent intersections to u2inters
1044       double param;
1045       std::list< TInters >::const_iterator tgtInt = tangentInters[ axis ].begin();
1046       for ( ; tgtInt != tangentInters[ axis ].end(); ++tgtInt )
1047         if ( getIntersParamOnLine( line, tgtInt->_face, tolerance, param ))
1048           u2inters.insert( std::make_pair( param, *tgtInt ));
1049       tangentInters[ axis ].clear();
1050
1051       // Count intersections before and after the point excluding touching ones.
1052       // If hasPositionInfo we count intersections of outer boundary only
1053
1054       int nbIntBeforePoint = 0, nbIntAfterPoint = 0;
1055       double f = std::numeric_limits<double>::max(), l = -std::numeric_limits<double>::max();
1056       std::map< double, TInters >::iterator u_int1 = u2inters.begin(), u_int2 = u_int1;
1057       bool ok = ! u_int1->second._coincides;
1058       while ( ok && u_int1 != u2inters.end() )
1059       {
1060         double u = u_int1->first;
1061         bool touchingInt = false;
1062         if ( ++u_int2 != u2inters.end() )
1063         {
1064           // skip intersections at the same point (if the line passes through edge or node)
1065           int nbSamePnt = 0;
1066           while ( u_int2 != u2inters.end() && fabs( u_int2->first - u ) < tolerance )
1067           {
1068             ++nbSamePnt;
1069             ++u_int2;
1070           }
1071
1072           // skip tangent intersections
1073           int nbTgt = 0;
1074           if ( u_int2 != u2inters.end() )
1075           {
1076             const SMDS_MeshElement* prevFace = u_int1->second._face;
1077             while ( ok && u_int2->second._coincides )
1078             {
1079               if ( SMESH_MeshAlgos::GetCommonNodes(prevFace , u_int2->second._face).empty() )
1080                 ok = false;
1081               else
1082               {
1083                 nbTgt++;
1084                 u_int2++;
1085                 ok = ( u_int2 != u2inters.end() );
1086               }
1087             }
1088           }
1089           if ( !ok ) break;
1090
1091           // skip intersections at the same point after tangent intersections
1092           if ( nbTgt > 0 )
1093           {
1094             double u2 = u_int2->first;
1095             ++u_int2;
1096             while ( u_int2 != u2inters.end() && fabs( u_int2->first - u2 ) < tolerance )
1097             {
1098               ++nbSamePnt;
1099               ++u_int2;
1100             }
1101           }
1102           // decide if we skipped a touching intersection
1103           if ( nbSamePnt + nbTgt > 0 )
1104           {
1105             double minDot = std::numeric_limits<double>::max(), maxDot = -minDot;
1106             std::map< double, TInters >::iterator u_int = u_int1;
1107             for ( ; u_int != u_int2; ++u_int )
1108             {
1109               if ( u_int->second._coincides ) continue;
1110               double dot = u_int->second._faceNorm * line.Direction();
1111               if ( dot > maxDot ) maxDot = dot;
1112               if ( dot < minDot ) minDot = dot;
1113             }
1114             touchingInt = ( minDot*maxDot < 0 );
1115           }
1116         }
1117         if ( !touchingInt )
1118         {
1119           if ( !hasPositionInfo || isOuterBoundary( u_int1->second._face ))
1120           {
1121             if ( u < 0 )
1122               ++nbIntBeforePoint;
1123             else
1124               ++nbIntAfterPoint;
1125           }
1126           if ( u < f ) f = u;
1127           if ( u > l ) l = u;
1128         }
1129
1130         u_int1 = u_int2; // to next intersection
1131
1132       } // loop on intersections with one line
1133
1134       if ( ok )
1135       {
1136         if ( fabs( f ) < tolerance || fabs( l ) < tolerance )
1137           return TopAbs_ON;
1138
1139         if ( nbIntBeforePoint == 0  || nbIntAfterPoint == 0)
1140           return TopAbs_OUT;
1141
1142         if ( nbIntBeforePoint + nbIntAfterPoint == 1 ) // not closed mesh
1143           return fabs( f ) < tolerance ? TopAbs_ON : TopAbs_UNKNOWN;
1144
1145         if ( nbIntBeforePoint == 1 || nbIntAfterPoint == 1 )
1146           return TopAbs_IN;
1147
1148         if ( (f<0) == (l<0) )
1149           return TopAbs_OUT;
1150
1151         if ( hasPositionInfo )
1152           return nbIntBeforePoint % 2 ? TopAbs_IN : TopAbs_OUT;
1153       }
1154     } // loop on intersections of the tree lines - thorough analysis
1155
1156     if ( !hasPositionInfo )
1157     {
1158       // gather info on faces position - is face in the outer boundary or not
1159       std::map< double, TInters > & u2inters = paramOnLine2TInters[ 0 ];
1160       findOuterBoundary( u2inters.begin()->second._face );
1161     }
1162
1163   } // two attempts - with and w/o faces position info in the mesh
1164
1165   return TopAbs_UNKNOWN;
1166 }
1167
1168 //=======================================================================
1169 /*!
1170  * \brief Return elements possibly intersecting the line
1171  */
1172 //=======================================================================
1173
1174 void SMESH_ElementSearcherImpl::
1175 GetElementsNearLine( const gp_Ax1&                           line,
1176                      SMDSAbs_ElementType                     type,
1177                      std::vector< const SMDS_MeshElement* >& foundElems)
1178 {
1179   _elementType = type;
1180   ElementBndBoxTree*& ebbTree = _ebbTree[ type ];
1181   if ( !ebbTree )
1182     ebbTree = new ElementBndBoxTree( *_mesh, _elementType, _meshPartIt );
1183
1184   ElementBndBoxTree::TElemSeq elems;
1185   ebbTree->getElementsNearLine( line, elems );
1186
1187   foundElems.insert( foundElems.end(), elems.begin(), elems.end() );
1188 }
1189
1190 //=======================================================================
1191 /*
1192  * Return elements whose bounding box intersects a sphere
1193  */
1194 //=======================================================================
1195
1196 void SMESH_ElementSearcherImpl::
1197 GetElementsInSphere( const gp_XYZ&                           center,
1198                      const double                            radius,
1199                      SMDSAbs_ElementType                     type,
1200                      std::vector< const SMDS_MeshElement* >& foundElems)
1201 {
1202   _elementType = type;
1203   ElementBndBoxTree*& ebbTree = _ebbTree[ type ];
1204   if ( !ebbTree )
1205     ebbTree = new ElementBndBoxTree( *_mesh, _elementType, _meshPartIt );
1206
1207   ElementBndBoxTree::TElemSeq elems;
1208   ebbTree->getElementsInSphere( center, radius, elems );
1209
1210   foundElems.insert( foundElems.end(), elems.begin(), elems.end() );
1211 }
1212
1213 //=======================================================================
1214 /*
1215  * Return elements whose bounding box intersects a given bounding box
1216  */
1217 //=======================================================================
1218
1219 void SMESH_ElementSearcherImpl::
1220 GetElementsInBox( const Bnd_B3d&                          box,
1221                   SMDSAbs_ElementType                     type,
1222                   std::vector< const SMDS_MeshElement* >& foundElems)
1223 {
1224   _elementType = type;
1225   ElementBndBoxTree*& ebbTree = _ebbTree[ type ];
1226   if ( !ebbTree )
1227     ebbTree = new ElementBndBoxTree( *_mesh, _elementType, _meshPartIt, getTolerance() );
1228
1229   ElementBndBoxTree::TElemSeq elems;
1230   ebbTree->getElementsInBox( box, elems );
1231
1232   foundElems.insert( foundElems.end(), elems.begin(), elems.end() );
1233 }
1234
1235 //=======================================================================
1236 /*
1237  * \brief Return a projection of a given point to a mesh.
1238  *        Optionally return the closest element
1239  */
1240 //=======================================================================
1241
1242 gp_XYZ SMESH_ElementSearcherImpl::Project(const gp_Pnt&            point,
1243                                           SMDSAbs_ElementType      type,
1244                                           const SMDS_MeshElement** closestElem)
1245 {
1246   _elementType = type;
1247   if ( _mesh->GetMeshInfo().NbElements( _elementType ) == 0 )
1248     throw SALOME_Exception( LOCALIZED( "No elements of given type in the mesh" ));
1249
1250   ElementBndBoxTree*& ebbTree = _ebbTree[ _elementType ];
1251   if ( !ebbTree )
1252     ebbTree = new ElementBndBoxTree( *_mesh, _elementType, _meshPartIt );
1253
1254   gp_XYZ p = point.XYZ();
1255   ElementBndBoxTree* ebbLeaf = ebbTree->getLeafAtPoint( p );
1256   const Bnd_B3d* box = ebbLeaf ? ebbLeaf->getBox() : ebbTree->getBox();
1257   double radius = ( box->CornerMax() - box->CornerMin() ).Modulus();
1258
1259   ElementBndBoxTree::TElemSeq elems;
1260   ebbTree->getElementsInSphere( p, radius, elems );
1261   while ( elems.empty() && radius < 1e100 )
1262   {
1263     radius *= 1.5;
1264     ebbTree->getElementsInSphere( p, radius, elems );
1265   }
1266   gp_XYZ proj, bestProj;
1267   const SMDS_MeshElement* elem = 0;
1268   double minDist = 2 * radius;
1269   ElementBndBoxTree::TElemSeq::iterator e = elems.begin();
1270   for ( ; e != elems.end(); ++e )
1271   {
1272     double d = SMESH_MeshAlgos::GetDistance( *e, point, &proj );
1273     if ( d < minDist )
1274     {
1275       bestProj = proj;
1276       elem = *e;
1277       minDist = d;
1278     }
1279   }
1280   if ( closestElem ) *closestElem = elem;
1281
1282   return bestProj;
1283 }
1284
1285 //=======================================================================
1286 /*!
1287  * \brief Return true if the point is IN or ON of the element
1288  */
1289 //=======================================================================
1290
1291 bool SMESH_MeshAlgos::IsOut( const SMDS_MeshElement* element, const gp_Pnt& point, double tol )
1292 {
1293   if ( element->GetType() == SMDSAbs_Volume)
1294   {
1295     return SMDS_VolumeTool( element ).IsOut( point.X(), point.Y(), point.Z(), tol );
1296   }
1297
1298   // get ordered nodes
1299
1300   std::vector< SMESH_TNodeXYZ > xyz; xyz.reserve( element->NbNodes()+1 );
1301
1302   SMDS_NodeIteratorPtr nodeIt = element->interlacedNodesIterator();
1303   for ( int i = 0; nodeIt->more(); ++i )
1304     xyz.push_back( SMESH_TNodeXYZ( nodeIt->next() ));
1305
1306   int i, nbNodes = (int) xyz.size(); // central node of biquadratic is missing
1307
1308   if ( element->GetType() == SMDSAbs_Face ) // --------------------------------------------------
1309   {
1310     // compute face normal
1311     gp_Vec faceNorm(0,0,0);
1312     xyz.push_back( xyz.front() );
1313     for ( i = 0; i < nbNodes; ++i )
1314     {
1315       gp_Vec edge1( xyz[i+1], xyz[i]);
1316       gp_Vec edge2( xyz[i+1], xyz[(i+2)%nbNodes] );
1317       faceNorm += edge1 ^ edge2;
1318     }
1319     double fNormSize = faceNorm.Magnitude();
1320     if ( fNormSize <= tol )
1321     {
1322       // degenerated face: point is out if it is out of all face edges
1323       for ( i = 0; i < nbNodes; ++i )
1324       {
1325         SMDS_LinearEdge edge( xyz[i]._node, xyz[i+1]._node );
1326         if ( !IsOut( &edge, point, tol ))
1327           return false;
1328       }
1329       return true;
1330     }
1331     faceNorm /= fNormSize;
1332
1333     // check if the point lays on face plane
1334     gp_Vec n2p( xyz[0], point );
1335     double dot = n2p * faceNorm;
1336     if ( Abs( dot ) > tol ) // not on face plane
1337     {
1338       bool isOut = true;
1339       if ( nbNodes > 3 ) // maybe the face is not planar
1340       {
1341         double elemThick = 0;
1342         for ( i = 1; i < nbNodes; ++i )
1343         {
1344           gp_Vec n2n( xyz[0], xyz[i] );
1345           elemThick = Max( elemThick, Abs( n2n * faceNorm ));
1346         }
1347         isOut = Abs( dot ) > elemThick + tol;
1348       }
1349       if ( isOut )
1350         return isOut;
1351     }
1352
1353     // check if point is out of face boundary:
1354     // define it by closest transition of a ray point->infinity through face boundary
1355     // on the face plane.
1356     // First, find normal of a plane perpendicular to face plane, to be used as a cutting tool
1357     // to find intersections of the ray with the boundary.
1358     gp_Vec ray = n2p;
1359     gp_Vec plnNorm = ray ^ faceNorm;
1360     double n2pSize = plnNorm.Magnitude();
1361     if ( n2pSize <= tol ) return false; // point coincides with the first node
1362     if ( n2pSize * n2pSize > fNormSize * 100 ) return true; // point is very far
1363     plnNorm /= n2pSize;
1364     // for each node of the face, compute its signed distance to the cutting plane
1365     std::vector<double> dist( nbNodes + 1);
1366     for ( i = 0; i < nbNodes; ++i )
1367     {
1368       gp_Vec n2p( xyz[i], point );
1369       dist[i] = n2p * plnNorm;
1370     }
1371     dist.back() = dist.front();
1372     // find the closest intersection
1373     int    iClosest = -1;
1374     double rClosest = 0, distClosest = 1e100;
1375     gp_Pnt pClosest;
1376     for ( i = 0; i < nbNodes; ++i )
1377     {
1378       double r;
1379       if ( fabs( dist[i] ) < tol )
1380         r = 0.;
1381       else if ( fabs( dist[i+1]) < tol )
1382         r = 1.;
1383       else if ( dist[i] * dist[i+1] < 0 )
1384         r = dist[i] / ( dist[i] - dist[i+1] );
1385       else
1386         continue; // no intersection
1387       gp_Pnt pInt = xyz[i] * (1.-r) + xyz[i+1] * r;
1388       gp_Vec p2int( point, pInt);
1389       double intDist = p2int.SquareMagnitude();
1390       if ( intDist < distClosest )
1391       {
1392         iClosest = i;
1393         rClosest = r;
1394         pClosest = pInt;
1395         distClosest = intDist;
1396       }
1397     }
1398     if ( iClosest < 0 )
1399       return true; // no intesections - out
1400
1401     // analyse transition
1402     gp_Vec edge( xyz[iClosest], xyz[iClosest+1] );
1403     gp_Vec edgeNorm = -( edge ^ faceNorm ); // normal to intersected edge pointing out of face
1404     gp_Vec p2int ( point, pClosest );
1405     bool out = (edgeNorm * p2int) < -tol;
1406     if ( rClosest > 0. && rClosest < 1. ) // not node intersection
1407       return out;
1408
1409     // the ray passes through a face node; analyze transition through an adjacent edge
1410     gp_Pnt p1 = xyz[ (rClosest == 0.) ? ((iClosest+nbNodes-1) % nbNodes) : (iClosest+1) ];
1411     gp_Pnt p2 = xyz[ (rClosest == 0.) ? iClosest : ((iClosest+2) % nbNodes) ];
1412     gp_Vec edgeAdjacent( p1, p2 );
1413     gp_Vec edgeNorm2 = -( edgeAdjacent ^ faceNorm );
1414     bool out2 = (edgeNorm2 * p2int) < -tol;
1415
1416     bool covexCorner = ( edgeNorm * edgeAdjacent * (rClosest==1. ? 1. : -1.)) < 0;
1417     return covexCorner ? (out || out2) : (out && out2);
1418   }
1419
1420   if ( element->GetType() == SMDSAbs_Edge ) // --------------------------------------------------
1421   {
1422     // point is out of edge if it is NOT ON any straight part of edge
1423     // (we consider quadratic edge as being composed of two straight parts)
1424     for ( i = 1; i < nbNodes; ++i )
1425     {
1426       gp_Vec edge( xyz[i-1], xyz[i] );
1427       gp_Vec n1p ( xyz[i-1], point  );
1428       double u = ( edge * n1p ) / edge.SquareMagnitude(); // param [0,1] on the edge
1429       if ( u <= 0. ) {
1430         if ( n1p.SquareMagnitude() < tol * tol )
1431           return false;
1432         continue;
1433       }
1434       if ( u >= 1. ) {
1435         if ( point.SquareDistance( xyz[i] ) < tol * tol )
1436           return false;
1437         continue;
1438       }
1439       gp_XYZ proj = ( 1. - u ) * xyz[i-1] + u * xyz[i]; // projection of the point on the edge
1440       double dist2 = point.SquareDistance( proj );
1441       if ( dist2 > tol * tol )
1442         continue;
1443       return false; // point is ON this part
1444     }
1445     return true;
1446   }
1447
1448   // Node or 0D element -------------------------------------------------------------------------
1449   {
1450     gp_Vec n2p ( xyz[0], point );
1451     return n2p.SquareMagnitude() > tol * tol;
1452   }
1453   return true;
1454 }
1455
1456 //=======================================================================
1457 namespace
1458 {
1459   // Position of a point relative to a segment
1460   //            .           .
1461   //            .  LEFT     .
1462   //            .           .
1463   //  VERTEX 1  o----ON----->  VERTEX 2
1464   //            .           .
1465   //            .  RIGHT    .
1466   //            .           .
1467   enum PositionName { POS_LEFT = 1, POS_VERTEX = 2, POS_RIGHT = 4, //POS_ON = 8,
1468                       POS_ALL = POS_LEFT | POS_RIGHT | POS_VERTEX,
1469                       POS_MAX = POS_RIGHT };
1470   struct PointPos
1471   {
1472     PositionName _name;
1473     int          _index; // index of vertex or segment
1474
1475     PointPos( PositionName n, int i=-1 ): _name(n), _index(i) {}
1476     bool operator < (const PointPos& other ) const
1477     {
1478       if ( _name == other._name )
1479         return  ( _index < 0 || other._index < 0 ) ? false : _index < other._index;
1480       return _name < other._name;
1481     }
1482   };
1483
1484   //================================================================================
1485   /*!
1486    * \brief Return position of a point relative to a segment
1487    *  \param point2D      - the point to analyze position of
1488    *  \param segEnds      - end points of segments
1489    *  \param index0       - 0-based index of the first point of segment
1490    *  \param posToFindOut - flags of positions to detect
1491    *  \retval PointPos - point position
1492    */
1493   //================================================================================
1494
1495   PointPos getPointPosition( const gp_XY& point2D,
1496                              const gp_XY* segEnds,
1497                              const int    index0 = 0,
1498                              const int    posToFindOut = POS_ALL)
1499   {
1500     const gp_XY& p1 = segEnds[ index0   ];
1501     const gp_XY& p2 = segEnds[ index0+1 ];
1502     const gp_XY grad = p2 - p1;
1503
1504     if ( posToFindOut & POS_VERTEX )
1505     {
1506       // check if the point2D is at "vertex 1" zone
1507       gp_XY pp1[2] = { p1, gp_XY( p1.X() - grad.Y(),
1508                                   p1.Y() + grad.X() ) };
1509       if ( getPointPosition( point2D, pp1, 0, POS_LEFT|POS_RIGHT )._name == POS_LEFT )
1510         return PointPos( POS_VERTEX, index0 );
1511
1512       // check if the point2D is at "vertex 2" zone
1513       gp_XY pp2[2] = { p2, gp_XY( p2.X() - grad.Y(),
1514                                   p2.Y() + grad.X() ) };
1515       if ( getPointPosition( point2D, pp2, 0, POS_LEFT|POS_RIGHT )._name == POS_RIGHT )
1516         return PointPos( POS_VERTEX, index0 + 1);
1517     }
1518     double edgeEquation =
1519       ( point2D.X() - p1.X() ) * grad.Y() - ( point2D.Y() - p1.Y() ) * grad.X();
1520     return PointPos( edgeEquation < 0 ? POS_LEFT : POS_RIGHT, index0 );
1521   }
1522 }
1523
1524 //=======================================================================
1525 /*!
1526  * \brief Return minimal distance from a point to an element
1527  *
1528  * Currently we ignore non-planarity and 2nd order of face
1529  */
1530 //=======================================================================
1531
1532 double SMESH_MeshAlgos::GetDistance( const SMDS_MeshElement* elem,
1533                                      const gp_Pnt&           point,
1534                                      gp_XYZ*                 closestPnt )
1535 {
1536   switch ( elem->GetType() )
1537   {
1538   case SMDSAbs_Volume:
1539     return GetDistance( static_cast<const SMDS_MeshVolume*>( elem ), point, closestPnt );
1540   case SMDSAbs_Face:
1541     return GetDistance( static_cast<const SMDS_MeshFace*>( elem ), point, closestPnt );
1542   case SMDSAbs_Edge:
1543     return GetDistance( static_cast<const SMDS_MeshEdge*>( elem ), point, closestPnt );
1544   case SMDSAbs_Node:
1545     if ( closestPnt ) *closestPnt = SMESH_TNodeXYZ( elem );
1546     return point.Distance( SMESH_TNodeXYZ( elem ));
1547   default:;
1548   }
1549   return -1;
1550 }
1551
1552 //=======================================================================
1553 /*!
1554  * \brief Return minimal distance from a point to a face
1555  *
1556  * Currently we ignore non-planarity and 2nd order of face
1557  */
1558 //=======================================================================
1559
1560 double SMESH_MeshAlgos::GetDistance( const SMDS_MeshFace* face,
1561                                      const gp_Pnt&        point,
1562                                      gp_XYZ*              closestPnt )
1563 {
1564   const double badDistance = -1;
1565   if ( !face ) return badDistance;
1566
1567   int nbCorners = face->NbCornerNodes();
1568   if ( nbCorners > 3 )
1569   {
1570     std::vector< const SMDS_MeshNode* > nodes;
1571     int nbTria = SMESH_MeshAlgos::Triangulate().GetTriangles( face, nodes );
1572
1573     double minDist = Precision::Infinite();
1574     gp_XYZ cp;
1575     for ( int i = 0; i < 3 * nbTria; i += 3 )
1576     {
1577       SMDS_FaceOfNodes triangle( nodes[i], nodes[i+1], nodes[i+2] );
1578       double dist = GetDistance( &triangle, point, closestPnt );
1579       if ( dist < minDist )
1580       {
1581         minDist = dist;
1582         if ( closestPnt )
1583           cp = *closestPnt;
1584       }
1585     }
1586
1587     if ( closestPnt )
1588       *closestPnt = cp;
1589     return minDist;
1590   }
1591
1592   // coordinates of nodes (medium nodes, if any, ignored)
1593   typedef SMDS_StdIterator< SMESH_TNodeXYZ, SMDS_ElemIteratorPtr > TXyzIterator;
1594   std::vector<gp_XYZ> xyz( TXyzIterator( face->nodesIterator()), TXyzIterator() );
1595   xyz.resize( 4 );
1596
1597   // transformation to get xyz[0] lies on the origin, xyz[1] lies on the Z axis,
1598   // and xyz[2] lies in the XZ plane. This is to pass to 2D space on XZ plane.
1599   gp_Trsf trsf;
1600   gp_Vec OZ ( xyz[0], xyz[1] );
1601   gp_Vec OX ( xyz[0], xyz[2] );
1602   if ( OZ.Magnitude() < std::numeric_limits<double>::min() )
1603   {
1604     if ( xyz.size() < 4 ) return badDistance;
1605     OZ = gp_Vec ( xyz[0], xyz[2] );
1606     OX = gp_Vec ( xyz[0], xyz[3] );
1607   }
1608   gp_Ax3 tgtCS;
1609   try {
1610     tgtCS = gp_Ax3( xyz[0], OZ, OX );
1611   }
1612   catch ( Standard_Failure ) {
1613     return badDistance;
1614   }
1615   trsf.SetTransformation( tgtCS );
1616
1617   // move all the nodes to 2D
1618   std::vector<gp_XY> xy( xyz.size() );
1619   for ( size_t i = 0; i < 3; ++i )
1620   {
1621     gp_XYZ p3d = xyz[i];
1622     trsf.Transforms( p3d );
1623     xy[i].SetCoord( p3d.X(), p3d.Z() );
1624   }
1625   xyz.back() = xyz.front();
1626   xy.back() = xy.front();
1627
1628   // // move the point in 2D
1629   gp_XYZ tmpPnt = point.XYZ();
1630   trsf.Transforms( tmpPnt );
1631   gp_XY point2D( tmpPnt.X(), tmpPnt.Z() );
1632
1633   // loop on edges of the face to analyze point position ralative to the face
1634   std::vector< PointPos > pntPosByType[ POS_MAX + 1 ];
1635   for ( size_t i = 1; i < xy.size(); ++i )
1636   {
1637     PointPos pos = getPointPosition( point2D, &xy[0], i-1 );
1638     pntPosByType[ pos._name ].push_back( pos );
1639   }
1640
1641   // compute distance
1642
1643   double dist = badDistance;
1644
1645   if ( pntPosByType[ POS_LEFT ].size() > 0 ) // point is most close to an edge
1646   {
1647     PointPos& pos = pntPosByType[ POS_LEFT ][0];
1648
1649     gp_Vec edge( xyz[ pos._index ], xyz[ pos._index+1 ]);
1650     gp_Vec n1p ( xyz[ pos._index ], point  );
1651     double u = ( edge * n1p ) / edge.SquareMagnitude(); // param [0,1] on the edge
1652     gp_XYZ proj = xyz[ pos._index ] + u * edge.XYZ(); // projection on the edge
1653     dist = point.Distance( proj );
1654     if ( closestPnt ) *closestPnt = proj;
1655   }
1656
1657   else if ( pntPosByType[ POS_RIGHT ].size() >= 2 ) // point is inside the face
1658   {
1659     dist = Abs( tmpPnt.Y() );
1660     if ( closestPnt )
1661     {
1662       if ( dist < std::numeric_limits<double>::min() ) {
1663         *closestPnt = point.XYZ();
1664       }
1665       else {
1666         tmpPnt.SetY( 0 );
1667         trsf.Inverted().Transforms( tmpPnt );
1668         *closestPnt = tmpPnt;
1669       }
1670     }
1671   }
1672
1673   else if ( pntPosByType[ POS_VERTEX ].size() > 0 ) // point is most close to a node
1674   {
1675     double minDist2 = Precision::Infinite();
1676     for ( size_t i = 0; i < pntPosByType[ POS_VERTEX ].size(); ++i )
1677     {
1678       PointPos& pos = pntPosByType[ POS_VERTEX ][i];
1679
1680       double d2 = point.SquareDistance( xyz[ pos._index ]);
1681       if ( minDist2 > d2 )
1682       {
1683         if ( closestPnt ) *closestPnt = xyz[ pos._index ];
1684         minDist2 = d2;
1685       }
1686     }
1687     dist = Sqrt( minDist2 );
1688   }
1689
1690   return dist;
1691 }
1692
1693 //=======================================================================
1694 /*!
1695  * \brief Return minimal distance from a point to an edge
1696  */
1697 //=======================================================================
1698
1699 double SMESH_MeshAlgos::GetDistance( const SMDS_MeshEdge* seg,
1700                                      const gp_Pnt&        point,
1701                                      gp_XYZ*              closestPnt )
1702 {
1703   double dist = Precision::Infinite();
1704   if ( !seg ) return dist;
1705
1706   int i = 0, nbNodes = seg->NbNodes();
1707
1708   std::vector< SMESH_TNodeXYZ > xyz( nbNodes );
1709   for ( SMDS_NodeIteratorPtr nodeIt = seg->interlacedNodesIterator(); nodeIt->more(); i++ )
1710     xyz[ i ].Set( nodeIt->next() );
1711
1712   for ( i = 1; i < nbNodes; ++i )
1713   {
1714     gp_Vec edge( xyz[i-1], xyz[i] );
1715     gp_Vec n1p ( xyz[i-1], point  );
1716     double d, u = ( edge * n1p ) / edge.SquareMagnitude(); // param [0,1] on the edge
1717     if ( u <= 0. ) {
1718       if (( d = n1p.SquareMagnitude() ) < dist ) {
1719         dist = d;
1720         if ( closestPnt ) *closestPnt = xyz[i-1];
1721       }
1722     }
1723     else if ( u >= 1. ) {
1724       if (( d = point.SquareDistance( xyz[i] )) < dist ) {
1725         dist = d;
1726         if ( closestPnt ) *closestPnt = xyz[i];
1727       }
1728     }
1729     else {
1730       gp_XYZ proj = xyz[i-1] + u * edge.XYZ(); // projection of the point on the edge
1731       if (( d = point.SquareDistance( proj )) < dist ) {
1732         dist = d;
1733         if ( closestPnt ) *closestPnt = proj;
1734       }
1735     }
1736   }
1737   return Sqrt( dist );
1738 }
1739
1740 //=======================================================================
1741 /*!
1742  * \brief Return minimal distance from a point to a volume
1743  *
1744  * Currently we ignore non-planarity and 2nd order
1745  */
1746 //=======================================================================
1747
1748 double SMESH_MeshAlgos::GetDistance( const SMDS_MeshVolume* volume,
1749                                      const gp_Pnt&          point,
1750                                      gp_XYZ*                closestPnt )
1751 {
1752   SMDS_VolumeTool vTool( volume );
1753   vTool.SetExternalNormal();
1754   const int iQ = volume->IsQuadratic() ? 2 : 1;
1755
1756   double n[3], bc[3];
1757   double minDist = 1e100, dist;
1758   gp_XYZ closeP = point.XYZ();
1759   bool isOut = false;
1760   for ( int iF = 0; iF < vTool.NbFaces(); ++iF )
1761   {
1762     // skip a facet with normal not "looking at" the point
1763     if ( !vTool.GetFaceNormal( iF, n[0], n[1], n[2] ) ||
1764          !vTool.GetFaceBaryCenter( iF, bc[0], bc[1], bc[2] ))
1765       continue;
1766     gp_XYZ bcp = point.XYZ() - gp_XYZ( bc[0], bc[1], bc[2] );
1767     if ( gp_XYZ( n[0], n[1], n[2] ) * bcp < 1e-6 )
1768       continue;
1769
1770     // find distance to a facet
1771     const SMDS_MeshNode** nodes = vTool.GetFaceNodes( iF );
1772     switch ( vTool.NbFaceNodes( iF ) / iQ ) {
1773     case 3:
1774     {
1775       SMDS_FaceOfNodes tmpFace( nodes[0], nodes[ 1*iQ ], nodes[ 2*iQ ] );
1776       dist = GetDistance( &tmpFace, point, closestPnt );
1777       break;
1778     }
1779     case 4:
1780     {
1781       SMDS_FaceOfNodes tmpFace( nodes[0], nodes[ 1*iQ ], nodes[ 2*iQ ], nodes[ 3*iQ ]);
1782       dist = GetDistance( &tmpFace, point, closestPnt );
1783       break;
1784     }
1785     default:
1786       std::vector<const SMDS_MeshNode *> nvec( nodes, nodes + vTool.NbFaceNodes( iF ));
1787       SMDS_PolygonalFaceOfNodes tmpFace( nvec );
1788       dist = GetDistance( &tmpFace, point, closestPnt );
1789     }
1790     if ( dist < minDist )
1791     {
1792       minDist = dist;
1793       isOut = true;
1794       if ( closestPnt ) closeP = *closestPnt;
1795     }
1796   }
1797   if ( isOut )
1798   {
1799     if ( closestPnt ) *closestPnt = closeP;
1800     return minDist;
1801   }
1802
1803   return 0; // point is inside the volume
1804 }
1805
1806 //================================================================================
1807 /*!
1808  * \brief Returns barycentric coordinates of a point within a triangle.
1809  *        A not returned bc2 = 1. - bc0 - bc1.
1810  *        The point lies within the triangle if ( bc0 >= 0 && bc1 >= 0 && bc0+bc1 <= 1 )
1811  */
1812 //================================================================================
1813
1814 void SMESH_MeshAlgos::GetBarycentricCoords( const gp_XY& p,
1815                                             const gp_XY& t0,
1816                                             const gp_XY& t1,
1817                                             const gp_XY& t2,
1818                                             double &     bc0,
1819                                             double &     bc1)
1820 {
1821   const double // matrix 2x2
1822     T11 = t0.X()-t2.X(), T12 = t1.X()-t2.X(),
1823     T21 = t0.Y()-t2.Y(), T22 = t1.Y()-t2.Y();
1824   const double Tdet = T11*T22 - T12*T21; // matrix determinant
1825   if ( Abs( Tdet ) < std::numeric_limits<double>::min() )
1826   {
1827     bc0 = bc1 = 2.;
1828     return;
1829   }
1830   // matrix inverse
1831   const double t11 = T22, t12 = -T12, t21 = -T21, t22 = T11;
1832   // vector
1833   const double r11 = p.X()-t2.X(), r12 = p.Y()-t2.Y();
1834   // barycentric coordinates: multiply matrix by vector
1835   bc0 = (t11 * r11 + t12 * r12)/Tdet;
1836   bc1 = (t21 * r11 + t22 * r12)/Tdet;
1837 }
1838
1839 //=======================================================================
1840 //function : FindFaceInSet
1841 //purpose  : Return a face having linked nodes n1 and n2 and which is
1842 //           - not in avoidSet,
1843 //           - in elemSet provided that !elemSet.empty()
1844 //           i1 and i2 optionally returns indices of n1 and n2
1845 //=======================================================================
1846
1847 const SMDS_MeshElement*
1848 SMESH_MeshAlgos::FindFaceInSet(const SMDS_MeshNode*    n1,
1849                                const SMDS_MeshNode*    n2,
1850                                const TIDSortedElemSet& elemSet,
1851                                const TIDSortedElemSet& avoidSet,
1852                                int*                    n1ind,
1853                                int*                    n2ind)
1854
1855 {
1856   int i1 = 0, i2 = 0;
1857   const SMDS_MeshElement* face = 0;
1858
1859   SMDS_ElemIteratorPtr invElemIt = n1->GetInverseElementIterator(SMDSAbs_Face);
1860   while ( invElemIt->more() && !face ) // loop on inverse faces of n1
1861   {
1862     const SMDS_MeshElement* elem = invElemIt->next();
1863     if (avoidSet.count( elem ))
1864       continue;
1865     if ( !elemSet.empty() && !elemSet.count( elem ))
1866       continue;
1867     // index of n1
1868     i1 = elem->GetNodeIndex( n1 );
1869     // find a n2 linked to n1
1870     int nbN = elem->IsQuadratic() ? elem->NbNodes()/2 : elem->NbNodes();
1871     for ( int di = -1; di < 2 && !face; di += 2 )
1872     {
1873       i2 = (i1+di+nbN) % nbN;
1874       if ( elem->GetNode( i2 ) == n2 )
1875         face = elem;
1876     }
1877     if ( !face && elem->IsQuadratic())
1878     {
1879       // analysis for quadratic elements using all nodes
1880       SMDS_NodeIteratorPtr anIter = elem->interlacedNodesIterator();
1881       const SMDS_MeshNode* prevN = static_cast<const SMDS_MeshNode*>( anIter->next() );
1882       for ( i1 = -1, i2 = 0; anIter->more() && !face; i1++, i2++ )
1883       {
1884         const SMDS_MeshNode* n = static_cast<const SMDS_MeshNode*>( anIter->next() );
1885         if ( n1 == prevN && n2 == n )
1886         {
1887           face = elem;
1888         }
1889         else if ( n2 == prevN && n1 == n )
1890         {
1891           face = elem; std::swap( i1, i2 );
1892         }
1893         prevN = n;
1894       }
1895     }
1896   }
1897   if ( n1ind ) *n1ind = i1;
1898   if ( n2ind ) *n2ind = i2;
1899   return face;
1900 }
1901
1902 //================================================================================
1903 /*!
1904  * Return sharp edges of faces and non-manifold ones. Optionally adds existing edges.
1905  */
1906 //================================================================================
1907
1908 std::vector< SMESH_MeshAlgos::Edge >
1909 SMESH_MeshAlgos::FindSharpEdges( SMDS_Mesh* theMesh,
1910                                  double     theAngle,
1911                                  bool       theAddExisting )
1912 {
1913   std::vector< Edge > resultEdges;
1914   if ( !theMesh ) return resultEdges;
1915
1916   typedef std::pair< bool, const SMDS_MeshNode* >                            TIsSharpAndMedium;
1917   typedef NCollection_DataMap< SMESH_TLink, TIsSharpAndMedium, SMESH_TLink > TLinkSharpMap;
1918
1919   TLinkSharpMap linkIsSharp( theMesh->NbFaces() );
1920   TIsSharpAndMedium sharpMedium( true, 0 );
1921   bool                 & isSharp = sharpMedium.first;
1922   const SMDS_MeshNode* & nMedium = sharpMedium.second;
1923
1924   if ( theAddExisting )
1925   {
1926     for ( SMDS_EdgeIteratorPtr edgeIt = theMesh->edgesIterator(); edgeIt->more(); )
1927     {
1928       const SMDS_MeshElement* edge = edgeIt->next();
1929       nMedium = ( edge->IsQuadratic() ) ? edge->GetNode(2) : 0;
1930       linkIsSharp.Bind( SMESH_TLink( edge->GetNode(0), edge->GetNode(1)), sharpMedium );
1931     }
1932   }
1933
1934   // check angles between face normals
1935
1936   const double angleCos = Cos( theAngle * M_PI / 180. ), angleCos2 = angleCos * angleCos;
1937   gp_XYZ norm1, norm2;
1938   std::vector< const SMDS_MeshNode* > faceNodes, linkNodes(2);
1939   std::vector<const SMDS_MeshElement *> linkFaces;
1940
1941   int nbSharp = linkIsSharp.Extent();
1942   for ( SMDS_FaceIteratorPtr faceIt = theMesh->facesIterator(); faceIt->more(); )
1943   {
1944     const SMDS_MeshElement* face = faceIt->next();
1945     size_t             nbCorners = face->NbCornerNodes();
1946
1947     faceNodes.assign( face->begin_nodes(), face->end_nodes() );
1948     if ( faceNodes.size() == nbCorners )
1949       faceNodes.resize( nbCorners * 2, 0 );
1950
1951     const SMDS_MeshNode* nPrev = faceNodes[ nbCorners-1 ];
1952     for ( size_t i = 0; i < nbCorners; ++i )
1953     {
1954       SMESH_TLink link( nPrev, faceNodes[i] );
1955       if ( !linkIsSharp.IsBound( link ))
1956       {
1957         linkNodes[0] = link.node1();
1958         linkNodes[1] = link.node2();
1959         linkFaces.clear();
1960         theMesh->GetElementsByNodes( linkNodes, linkFaces, SMDSAbs_Face );
1961
1962         isSharp = false;
1963         if ( linkFaces.size() > 2 )
1964         {
1965           isSharp = true;
1966         }
1967         else if ( linkFaces.size() == 2 &&
1968                   FaceNormal( linkFaces[0], norm1, /*normalize=*/false ) &&
1969                   FaceNormal( linkFaces[1], norm2, /*normalize=*/false ))
1970         {
1971           double dot = norm1 * norm2; // == cos * |norm1| * |norm2|
1972           if (( dot < 0 ) == ( angleCos < 0 ))
1973           {
1974             double cos2 = dot * dot / norm1.SquareModulus() / norm2.SquareModulus();
1975             isSharp = ( angleCos < 0 ) ? ( cos2 > angleCos2 ) : ( cos2 < angleCos2 );
1976           }
1977           else
1978           {
1979             isSharp = ( angleCos > 0 );
1980           }
1981         }
1982         nMedium = faceNodes[( i-1+nbCorners ) % nbCorners + nbCorners ];
1983
1984         linkIsSharp.Bind( link, sharpMedium );
1985         nbSharp += isSharp;
1986       }
1987
1988       nPrev = faceNodes[i];
1989     }
1990   }
1991
1992   resultEdges.resize( nbSharp );
1993   TLinkSharpMap::Iterator linkIsSharpIter( linkIsSharp );
1994   for ( int i = 0; linkIsSharpIter.More() && i < nbSharp; linkIsSharpIter.Next() )
1995   {
1996     const SMESH_TLink&                link = linkIsSharpIter.Key();
1997     const TIsSharpAndMedium& isSharpMedium = linkIsSharpIter.Value();
1998     if ( isSharpMedium.first )
1999     {
2000       Edge & edge  = resultEdges[ i++ ];
2001       edge._node1  = link.node1();
2002       edge._node2  = link.node2();
2003       edge._medium = isSharpMedium.second;
2004     }
2005   }
2006
2007   return resultEdges;
2008 }
2009
2010 //================================================================================
2011 /*!
2012  * Distribute all faces of the mesh between groups using given edges as group boundaries
2013  */
2014 //================================================================================
2015
2016 std::vector< std::vector< const SMDS_MeshElement* > >
2017 SMESH_MeshAlgos::SeparateFacesByEdges( SMDS_Mesh* theMesh, const std::vector< Edge >& theEdges )
2018 {
2019   std::vector< std::vector< const SMDS_MeshElement* > > groups;
2020   if ( !theMesh ) return groups;
2021
2022   // build map of face edges (SMESH_TLink) and their faces
2023
2024   typedef std::vector< const SMDS_MeshElement* >                    TFaceVec;
2025   typedef NCollection_DataMap< SMESH_TLink, TFaceVec, SMESH_TLink > TFacesByLinks;
2026   TFacesByLinks facesByLink( theMesh->NbFaces() );
2027
2028   std::vector< const SMDS_MeshNode* > faceNodes;
2029   for ( SMDS_FaceIteratorPtr faceIt = theMesh->facesIterator(); faceIt->more(); )
2030   {
2031     const SMDS_MeshElement* face = faceIt->next();
2032     size_t             nbCorners = face->NbCornerNodes();
2033
2034     faceNodes.assign( face->begin_nodes(), face->end_nodes() );
2035     faceNodes.resize( nbCorners + 1 );
2036     faceNodes[ nbCorners ] = faceNodes[0];
2037
2038     face->setIsMarked( false );
2039
2040     for ( size_t i = 0; i < nbCorners; ++i )
2041     {
2042       SMESH_TLink link( faceNodes[i], faceNodes[i+1] );
2043       TFaceVec* linkFaces = facesByLink.ChangeSeek( link );
2044       if ( !linkFaces )
2045       {
2046         linkFaces = facesByLink.Bound( link, TFaceVec() );
2047         linkFaces->reserve(2);
2048       }
2049       linkFaces->push_back( face );
2050     }
2051   }
2052
2053   // remove the given edges from facesByLink map
2054
2055   for ( size_t i = 0; i < theEdges.size(); ++i )
2056   {
2057     SMESH_TLink link( theEdges[i]._node1, theEdges[i]._node2 );
2058     facesByLink.UnBind( link );
2059   }
2060
2061   // faces connected via links of facesByLink map form a group
2062
2063   while ( !facesByLink.IsEmpty() )
2064   {
2065     groups.push_back( TFaceVec() );
2066     TFaceVec & group = groups.back();
2067
2068     group.push_back( TFacesByLinks::Iterator( facesByLink ).Value()[0] );
2069     group.back()->setIsMarked( true );
2070
2071     for ( size_t iF = 0; iF < group.size(); ++iF )
2072     {
2073       const SMDS_MeshElement* face = group[iF];
2074       size_t             nbCorners = face->NbCornerNodes();
2075       faceNodes.assign( face->begin_nodes(), face->end_nodes() );
2076       faceNodes.resize( nbCorners + 1 );
2077       faceNodes[ nbCorners ] = faceNodes[0];
2078
2079       for ( size_t iN = 0; iN < nbCorners; ++iN )
2080       {
2081         SMESH_TLink link( faceNodes[iN], faceNodes[iN+1] );
2082         if ( const TFaceVec* faces = facesByLink.Seek( link ))
2083         {
2084           const TFaceVec& faceNeighbors = *faces;
2085           for ( size_t i = 0; i < faceNeighbors.size(); ++i )
2086             if ( !faceNeighbors[i]->isMarked() )
2087             {
2088               group.push_back( faceNeighbors[i] );
2089               faceNeighbors[i]->setIsMarked( true );
2090             }
2091           facesByLink.UnBind( link );
2092         }
2093       }
2094     }
2095   }
2096
2097   // find faces that are alone in its group; they were not in facesByLink
2098
2099   int nbInGroups = 0;
2100   for ( size_t i = 0; i < groups.size(); ++i )
2101     nbInGroups += groups[i].size();
2102   if ( nbInGroups < theMesh->NbFaces() )
2103   {
2104     for ( SMDS_FaceIteratorPtr faceIt = theMesh->facesIterator(); faceIt->more(); )
2105     {
2106       const SMDS_MeshElement* face = faceIt->next();
2107       if ( !face->isMarked() )
2108       {
2109         groups.push_back( TFaceVec() );
2110         groups.back().push_back( face );
2111       }
2112     }
2113   }
2114
2115   return groups;
2116 }
2117
2118 //================================================================================
2119 /*!
2120  * \brief Calculate normal of a mesh face
2121  */
2122 //================================================================================
2123
2124 bool SMESH_MeshAlgos::FaceNormal(const SMDS_MeshElement* F, gp_XYZ& normal, bool normalized)
2125 {
2126   if ( !F || F->GetType() != SMDSAbs_Face )
2127     return false;
2128
2129   normal.SetCoord(0,0,0);
2130   int nbNodes = F->NbCornerNodes();
2131   for ( int i = 0; i < nbNodes-2; ++i )
2132   {
2133     gp_XYZ p[3];
2134     for ( int n = 0; n < 3; ++n )
2135     {
2136       const SMDS_MeshNode* node = F->GetNode( i + n );
2137       p[n].SetCoord( node->X(), node->Y(), node->Z() );
2138     }
2139     normal += ( p[2] - p[1] ) ^ ( p[0] - p[1] );
2140   }
2141   double size2 = normal.SquareModulus();
2142   bool ok = ( size2 > std::numeric_limits<double>::min() * std::numeric_limits<double>::min());
2143   if ( normalized && ok )
2144     normal /= sqrt( size2 );
2145
2146   return ok;
2147 }
2148
2149 //=======================================================================
2150 //function : GetCommonNodes
2151 //purpose  : Return nodes common to two elements
2152 //=======================================================================
2153
2154 std::vector< const SMDS_MeshNode*> SMESH_MeshAlgos::GetCommonNodes(const SMDS_MeshElement* e1,
2155                                                                    const SMDS_MeshElement* e2)
2156 {
2157   std::vector< const SMDS_MeshNode*> common;
2158   for ( int i = 0 ; i < e1->NbNodes(); ++i )
2159     if ( e2->GetNodeIndex( e1->GetNode( i )) >= 0 )
2160       common.push_back( e1->GetNode( i ));
2161   return common;
2162 }
2163 //================================================================================
2164 /*!
2165  * \brief Return true if node1 encounters first in the face and node2, after
2166  */
2167 //================================================================================
2168
2169 bool SMESH_MeshAlgos::IsRightOrder( const SMDS_MeshElement* face,
2170                                     const SMDS_MeshNode*    node0,
2171                                     const SMDS_MeshNode*    node1 )
2172 {
2173   int i0 = face->GetNodeIndex( node0 );
2174   int i1 = face->GetNodeIndex( node1 );
2175   if ( face->IsQuadratic() )
2176   {
2177     if ( face->IsMediumNode( node0 ))
2178     {
2179       i0 -= ( face->NbNodes()/2 - 1 );
2180       i1 *= 2;
2181     }
2182     else
2183     {
2184       i1 -= ( face->NbNodes()/2 - 1 );
2185       i0 *= 2;
2186     }
2187   }
2188   int diff = i1 - i0;
2189   return ( diff == 1 ) || ( diff == -face->NbNodes()+1 );
2190 }
2191
2192 //=======================================================================
2193 /*!
2194  * \brief Partition given 1D elements into groups of contiguous edges.
2195  *        A node where number of meeting edges != 2 is a group end.
2196  *        An optional startNode is used to orient groups it belongs to.
2197  * \return a list of edge groups and a list of corresponding node groups.
2198  *         If a group is closed, the first and last nodes of the group are same.
2199  */
2200 //=======================================================================
2201
2202 void SMESH_MeshAlgos::Get1DBranches( SMDS_ElemIteratorPtr theEdgeIt,
2203                                      TElemGroupVector&    theEdgeGroups,
2204                                      TNodeGroupVector&    theNodeGroups,
2205                                      const SMDS_MeshNode* theStartNode )
2206 {
2207   if ( !theEdgeIt )
2208     return;
2209
2210   // build map of nodes and their adjacent edges
2211
2212   typedef std::vector< const SMDS_MeshNode* >                                 TNodeVec;
2213   typedef std::vector< const SMDS_MeshElement* >                              TEdgeVec;
2214   typedef NCollection_DataMap< const SMDS_MeshNode*, TEdgeVec, SMESH_Hasher > TEdgesByNodeMap;
2215   TEdgesByNodeMap edgesByNode;
2216
2217   while ( theEdgeIt->more() )
2218   {
2219     const SMDS_MeshElement* edge = theEdgeIt->next();
2220     if ( edge->GetType() != SMDSAbs_Edge )
2221       continue;
2222
2223     const SMDS_MeshNode* nodes[2] = { edge->GetNode(0), edge->GetNode(1) };
2224     for ( int i = 0; i < 2; ++i )
2225     {
2226       TEdgeVec* nodeEdges = edgesByNode.ChangeSeek( nodes[i] );
2227       if ( !nodeEdges )
2228       {
2229         nodeEdges = edgesByNode.Bound( nodes[i], TEdgeVec() );
2230         nodeEdges->reserve(2);
2231       }
2232       nodeEdges->push_back( edge );
2233     }
2234   }
2235
2236   if ( edgesByNode.IsEmpty() )
2237     return;
2238
2239
2240   // build edge branches
2241
2242   TElemGroupVector branches(2);
2243   TNodeGroupVector nodeBranches(2);
2244
2245   while ( !edgesByNode.IsEmpty() )
2246   {
2247     if ( !theStartNode || !edgesByNode.IsBound( theStartNode ))
2248     {
2249       theStartNode = TEdgesByNodeMap::Iterator( edgesByNode ).Key();
2250     }
2251
2252     size_t nbBranches = 0;
2253     bool startIsBranchEnd = false;
2254
2255     while ( edgesByNode.IsBound( theStartNode ))
2256     {
2257       // initialize a new branch
2258
2259       ++nbBranches;
2260       if ( branches.size() < nbBranches )
2261       {
2262         branches.push_back   ( TEdgeVec() );
2263         nodeBranches.push_back( TNodeVec() );
2264       }
2265       TEdgeVec & branch     = branches    [ nbBranches - 1 ];
2266       TNodeVec & nodeBranch = nodeBranches[ nbBranches - 1 ];
2267       branch.clear();
2268       nodeBranch.clear();
2269       {
2270         TEdgeVec& edges = edgesByNode( theStartNode );
2271         startIsBranchEnd = ( edges.size() != 2 );
2272
2273         int nbEdges = 0;
2274         const SMDS_MeshElement* startEdge = 0;
2275         for ( size_t i = 0; i < edges.size(); ++i )
2276         {
2277           if ( !startEdge && edges[i] )
2278           {
2279             startEdge = edges[i];
2280             edges[i] = 0;
2281           }
2282           nbEdges += bool( edges[i] );
2283         }
2284         if ( nbEdges == 0 )
2285           edgesByNode.UnBind( theStartNode );
2286         if ( !startEdge )
2287           continue;
2288
2289         branch.push_back( startEdge );
2290
2291         nodeBranch.push_back( theStartNode );
2292         nodeBranch.push_back( branch.back()->GetNode(0) );
2293         if ( nodeBranch.back() == theStartNode )
2294           nodeBranch.back() = branch.back()->GetNode(1);
2295       }
2296
2297       // fill the branch
2298
2299       bool isBranchEnd = false;
2300       TEdgeVec* edgesPtr;
2301
2302       while (( !isBranchEnd ) && ( edgesPtr = edgesByNode.ChangeSeek( nodeBranch.back() )))
2303       {
2304         TEdgeVec& edges = *edgesPtr;
2305
2306         isBranchEnd = ( edges.size() != 2 );
2307
2308         const SMDS_MeshNode* lastNode = nodeBranch.back();
2309
2310         switch ( edges.size() )
2311         {
2312         case 1:
2313           edgesByNode.UnBind( lastNode );
2314           break;
2315
2316         case 2:
2317         {
2318           if ( const SMDS_MeshElement* nextEdge = edges[ edges[0] == branch.back() ])
2319           {
2320             branch.push_back( nextEdge );
2321
2322             const SMDS_MeshNode* nextNode = nextEdge->GetNode(0);
2323             if ( nodeBranch.back() == nextNode )
2324               nextNode = nextEdge->GetNode(1);
2325             nodeBranch.push_back( nextNode );
2326           }
2327           edgesByNode.UnBind( lastNode );
2328           break;
2329         }
2330
2331         default:
2332           int nbEdges = 0;
2333           for ( size_t i = 0; i < edges.size(); ++i )
2334           {
2335             if ( edges[i] == branch.back() )
2336               edges[i] = 0;
2337             nbEdges += bool( edges[i] );
2338           }
2339           if ( nbEdges == 0 )
2340             edgesByNode.UnBind( lastNode );
2341         }
2342       }
2343     } // while ( edgesByNode.IsBound( theStartNode ))
2344
2345
2346     // put the found branches to the result
2347
2348     if ( nbBranches == 2 && !startIsBranchEnd ) // join two branches starting at the same node
2349     {
2350       if ( nodeBranches[0].back() == nodeBranches[1].back() )
2351       {
2352         // it is a closed branch, keep theStartNode first
2353         nodeBranches[0].pop_back();
2354         nodeBranches[0].reserve( nodeBranches[0].size() + nodeBranches[1].size() );
2355         nodeBranches[0].insert( nodeBranches[0].end(),
2356                                 nodeBranches[1].rbegin(), nodeBranches[1].rend() );
2357         branches[0].reserve( branches[0].size() + branches[1].size() );
2358         branches[0].insert( branches[0].end(), branches[1].rbegin(), branches[1].rend() );
2359       }
2360       else
2361       {
2362         std::reverse( nodeBranches[0].begin(), nodeBranches[0].end() );
2363         nodeBranches[0].pop_back();
2364         nodeBranches[0].reserve( nodeBranches[0].size() + nodeBranches[1].size() );
2365         nodeBranches[0].insert( nodeBranches[0].end(),
2366                                 nodeBranches[1].begin(), nodeBranches[1].end() );
2367
2368         std::reverse( branches[0].begin(), branches[0].end() );
2369         branches[0].reserve( branches[0].size() + branches[1].size() );
2370         branches[0].insert( branches[0].end(), branches[1].begin(), branches[1].end() );
2371       }
2372       nodeBranches[1].clear();
2373       branches[1].clear();
2374     }
2375
2376     for ( size_t i = 0; i < nbBranches; ++i )
2377     {
2378       if ( branches[i].empty() )
2379         continue;
2380
2381       theEdgeGroups.push_back( TEdgeVec() );
2382       theEdgeGroups.back().swap( branches[i] );
2383
2384       theNodeGroups.push_back( TNodeVec() );
2385       theNodeGroups.back().swap( nodeBranches[i] );
2386     }
2387
2388   } // while ( !edgesByNode.IsEmpty() )
2389
2390   return;
2391 }
2392
2393 //=======================================================================
2394 /*!
2395  * \brief Return SMESH_NodeSearcher
2396  */
2397 //=======================================================================
2398
2399 SMESH_NodeSearcher* SMESH_MeshAlgos::GetNodeSearcher(SMDS_Mesh& mesh)
2400 {
2401   return new SMESH_NodeSearcherImpl( &mesh );
2402 }
2403
2404 //=======================================================================
2405 /*!
2406  * \brief Return SMESH_NodeSearcher
2407  */
2408 //=======================================================================
2409
2410 SMESH_NodeSearcher* SMESH_MeshAlgos::GetNodeSearcher(SMDS_ElemIteratorPtr elemIt)
2411 {
2412   return new SMESH_NodeSearcherImpl( 0, elemIt );
2413 }
2414
2415 //=======================================================================
2416 /*!
2417  * \brief Return SMESH_ElementSearcher
2418  */
2419 //=======================================================================
2420
2421 SMESH_ElementSearcher* SMESH_MeshAlgos::GetElementSearcher(SMDS_Mesh& mesh,
2422                                                            double     tolerance)
2423 {
2424   return new SMESH_ElementSearcherImpl( mesh, tolerance );
2425 }
2426
2427 //=======================================================================
2428 /*!
2429  * \brief Return SMESH_ElementSearcher acting on a sub-set of elements
2430  */
2431 //=======================================================================
2432
2433 SMESH_ElementSearcher* SMESH_MeshAlgos::GetElementSearcher(SMDS_Mesh&           mesh,
2434                                                            SMDS_ElemIteratorPtr elemIt,
2435                                                            double               tolerance)
2436 {
2437   return new SMESH_ElementSearcherImpl( mesh, tolerance, elemIt );
2438 }