Salome HOME
First draft for dense matrix
[tools/medcoupling.git] / src / MEDCoupling / MEDCouplingStructuredMesh.cxx
1 // Copyright (C) 2007-2014  CEA/DEN, EDF R&D
2 //
3 // This library is free software; you can redistribute it and/or
4 // modify it under the terms of the GNU Lesser General Public
5 // License as published by the Free Software Foundation; either
6 // version 2.1 of the License, or (at your option) any later version.
7 //
8 // This library is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11 // Lesser General Public License for more details.
12 //
13 // You should have received a copy of the GNU Lesser General Public
14 // License along with this library; if not, write to the Free Software
15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
16 //
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
18 //
19 // Author : Anthony Geay (CEA/DEN)
20
21 #include "MEDCouplingStructuredMesh.hxx"
22 #include "MEDCouplingFieldDouble.hxx"
23 #include "MEDCouplingMemArray.hxx"
24 #include "MEDCoupling1GTUMesh.hxx"
25 #include "MEDCouplingUMesh.hxx"
26
27 #include <numeric>
28
29 using namespace ParaMEDMEM;
30
31 MEDCouplingStructuredMesh::MEDCouplingStructuredMesh()
32 {
33 }
34
35 MEDCouplingStructuredMesh::MEDCouplingStructuredMesh(const MEDCouplingStructuredMesh& other, bool deepCopy):MEDCouplingMesh(other)
36 {
37 }
38
39 MEDCouplingStructuredMesh::~MEDCouplingStructuredMesh()
40 {
41 }
42
43 std::size_t MEDCouplingStructuredMesh::getHeapMemorySizeWithoutChildren() const
44 {
45   return MEDCouplingMesh::getHeapMemorySizeWithoutChildren();
46 }
47
48 void MEDCouplingStructuredMesh::copyTinyStringsFrom(const MEDCouplingMesh *other)
49 {
50   MEDCouplingMesh::copyTinyStringsFrom(other);
51 }
52
53 bool MEDCouplingStructuredMesh::isEqualIfNotWhy(const MEDCouplingMesh *other, double prec, std::string& reason) const
54 {
55   return MEDCouplingMesh::isEqualIfNotWhy(other,prec,reason);
56 }
57
58 INTERP_KERNEL::NormalizedCellType MEDCouplingStructuredMesh::getTypeOfCell(int cellId) const
59 {
60   return GetGeoTypeGivenMeshDimension(getMeshDimension());
61 }
62
63 INTERP_KERNEL::NormalizedCellType MEDCouplingStructuredMesh::GetGeoTypeGivenMeshDimension(int meshDim)
64 {
65   switch(meshDim)
66   {
67     case 3:
68       return INTERP_KERNEL::NORM_HEXA8;
69     case 2:
70       return INTERP_KERNEL::NORM_QUAD4;
71     case 1:
72       return INTERP_KERNEL::NORM_SEG2;
73     case 0:
74       return INTERP_KERNEL::NORM_POINT1;
75     default:
76       throw INTERP_KERNEL::Exception("Unexpected dimension for MEDCouplingStructuredMesh::GetGeoTypeGivenMeshDimension !");
77   }
78 }
79
80 std::set<INTERP_KERNEL::NormalizedCellType> MEDCouplingStructuredMesh::getAllGeoTypes() const
81 {
82   std::set<INTERP_KERNEL::NormalizedCellType> ret2;
83   ret2.insert(getTypeOfCell(0));
84   return ret2;
85 }
86
87 int MEDCouplingStructuredMesh::getNumberOfCellsWithType(INTERP_KERNEL::NormalizedCellType type) const
88 {
89   int ret=getNumberOfCells();
90   if(type==getTypeOfCell(0))
91     return ret;
92   const INTERP_KERNEL::CellModel& cm=INTERP_KERNEL::CellModel::GetCellModel(getTypeOfCell(0));
93   std::ostringstream oss; oss << "MEDCouplingStructuredMesh::getNumberOfCellsWithType : no specified type ! Type available is " << cm.getRepr() << " !";
94   throw INTERP_KERNEL::Exception(oss.str().c_str());
95 }
96
97 DataArrayInt *MEDCouplingStructuredMesh::giveCellsWithType(INTERP_KERNEL::NormalizedCellType type) const
98 {
99   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> ret=DataArrayInt::New();
100   if(getTypeOfCell(0)==type)
101     {
102       ret->alloc(getNumberOfCells(),1);
103       ret->iota(0);
104     }
105   else
106     ret->alloc(0,1);
107   return ret.retn();
108 }
109
110 DataArrayInt *MEDCouplingStructuredMesh::computeNbOfNodesPerCell() const
111 {
112   int nbCells=getNumberOfCells();
113   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> ret=DataArrayInt::New();
114   ret->alloc(nbCells,1);
115   const INTERP_KERNEL::CellModel& cm=INTERP_KERNEL::CellModel::GetCellModel(getTypeOfCell(0));
116   ret->fillWithValue((int)cm.getNumberOfNodes());
117   return ret.retn();
118 }
119
120 DataArrayInt *MEDCouplingStructuredMesh::computeNbOfFacesPerCell() const
121 {
122   int nbCells=getNumberOfCells();
123   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> ret=DataArrayInt::New();
124   ret->alloc(nbCells,1);
125   const INTERP_KERNEL::CellModel& cm=INTERP_KERNEL::CellModel::GetCellModel(getTypeOfCell(0));
126   ret->fillWithValue((int)cm.getNumberOfSons());
127   return ret.retn();
128 }
129
130 /*!
131  * This method computes effective number of nodes per cell. That is to say nodes appearing several times in nodal connectivity of a cell,
132  * will be counted only once here whereas it will be counted several times in MEDCouplingMesh::computeNbOfNodesPerCell method.
133  * Here for structured mesh it returns exactly as MEDCouplingStructuredMesh::computeNbOfNodesPerCell does.
134  *
135  * \return DataArrayInt * - new object to be deallocated by the caller.
136  */
137 DataArrayInt *MEDCouplingStructuredMesh::computeEffectiveNbOfNodesPerCell() const
138 {
139   return computeNbOfNodesPerCell();
140 }
141
142 void MEDCouplingStructuredMesh::getNodeIdsOfCell(int cellId, std::vector<int>& conn) const
143 {
144   int meshDim=getMeshDimension();
145   int tmpCell[3],tmpNode[3];
146   getSplitCellValues(tmpCell);
147   getSplitNodeValues(tmpNode);
148   int tmp2[3];
149   GetPosFromId(cellId,meshDim,tmpCell,tmp2);
150   switch(meshDim)
151   {
152     case 1:
153       conn.push_back(tmp2[0]); conn.push_back(tmp2[0]+1);
154       break;
155     case 2:
156       conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]); conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]+1);
157       conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]+1); conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]);
158       break;
159     case 3:
160       conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]+tmp2[2]*tmpNode[2]); conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]+1+tmp2[2]*tmpNode[2]);
161       conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]+1+tmp2[2]*tmpNode[2]); conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]+tmp2[2]*tmpNode[2]);
162       conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]+(tmp2[2]+1)*tmpNode[2]); conn.push_back(tmp2[1]*tmpNode[1]+tmp2[0]+1+(tmp2[2]+1)*tmpNode[2]);
163       conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]+1+(tmp2[2]+1)*tmpNode[2]); conn.push_back((tmp2[1]+1)*tmpNode[1]+tmp2[0]+(tmp2[2]+1)*tmpNode[2]);
164       break;
165     default:
166       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::getNodeIdsOfCell : big problem spacedim must be in 1,2 or 3 !");
167   };
168 }
169
170 /*!
171  * This method returns the mesh dimension of \a this. It can be different from space dimension in case of a not null dimension contains only one node.
172  */
173 int MEDCouplingStructuredMesh::getMeshDimension() const
174 {
175   std::vector<int> ngs(getNodeGridStructure());
176   int ret(0),pos(0);
177   for(std::vector<int>::const_iterator it=ngs.begin();it!=ngs.end();it++,pos++)
178     {
179       if(*it<=0)
180         {
181           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::getMeshDimension : At pos #" << pos << " number of nodes is " << *it << " ! Must be > 0 !";
182           throw INTERP_KERNEL::Exception(oss.str().c_str());
183         }
184       if(*it>1)
185         ret++;
186     }
187   return ret;
188 }
189
190 /*!
191  * This method returns the space dimension by only considering the node grid structure.
192  * For cartesian mesh the returned value is equal to those returned by getSpaceDimension.
193  * But for curvelinear is could be different !
194  */
195 int MEDCouplingStructuredMesh::getSpaceDimensionOnNodeStruct() const
196 {
197   std::vector<int> nodeStr(getNodeGridStructure());
198   int spd1(0),pos(0);
199   for(std::vector<int>::const_iterator it=nodeStr.begin();it!=nodeStr.end();it++,pos++)
200     {
201       int elt(*it);
202       if(elt<=0)
203         {
204           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::getSpaceDimensionOnNodeStruct : At pos #" << pos << " value of node grid structure is " << *it << " ! must be >=1 !";
205           throw INTERP_KERNEL::Exception(oss.str().c_str());
206         }
207       spd1++;
208     }
209   return spd1;
210 }
211
212 void MEDCouplingStructuredMesh::getSplitCellValues(int *res) const
213 {
214   std::vector<int> strct(getCellGridStructure());
215   std::vector<int> ret(MEDCouplingStructuredMesh::GetSplitVectFromStruct(strct));
216   std::copy(ret.begin(),ret.end(),res);
217 }
218
219 void MEDCouplingStructuredMesh::getSplitNodeValues(int *res) const
220 {
221   std::vector<int> strct(getNodeGridStructure());
222   std::vector<int> ret(MEDCouplingStructuredMesh::GetSplitVectFromStruct(strct));
223   std::copy(ret.begin(),ret.end(),res);
224 }
225
226 /*!
227  * This method returns the number of cells of unstructured sub level mesh, without building it.
228  */
229 int MEDCouplingStructuredMesh::getNumberOfCellsOfSubLevelMesh() const
230 {
231   std::vector<int> cgs(getCellGridStructure());
232   return GetNumberOfCellsOfSubLevelMesh(cgs,getMeshDimension());
233 }
234
235 /*!
236  * See MEDCouplingUMesh::getDistributionOfTypes for more information
237  */
238 std::vector<int> MEDCouplingStructuredMesh::getDistributionOfTypes() const
239 {
240   //only one type of cell
241   std::vector<int> ret(3);
242   ret[0]=getTypeOfCell(0);
243   ret[1]=getNumberOfCells();
244   ret[2]=-1; //ret[3*k+2]==-1 because it has no sense here
245   return ret;
246 }
247
248 /*!
249  * This method tries to minimize at most the number of deep copy.
250  * So if \a idsPerType is not empty it can be returned directly (without copy, but with ref count incremented) in return.
251  * 
252  * See MEDCouplingUMesh::checkTypeConsistencyAndContig for more information
253  */
254 DataArrayInt *MEDCouplingStructuredMesh::checkTypeConsistencyAndContig(const std::vector<int>& code, const std::vector<const DataArrayInt *>& idsPerType) const
255 {
256   int nbOfCells=getNumberOfCells();
257   if(code.size()!=3)
258     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : invalid input code should be exactly of size 3 !");
259   if(code[0]!=(int)getTypeOfCell(0))
260     {
261       std::ostringstream oss; oss << "MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : Mismatch of geometric type ! Asking for " << code[0] << " whereas the geometric type is \a this is " << getTypeOfCell(0) << " !";
262       throw INTERP_KERNEL::Exception(oss.str().c_str());
263     }
264   if(code[2]==-1)
265     {
266       if(code[1]==nbOfCells)
267         return 0;
268       else
269         {
270           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : mismatch between the number of cells in this (" << nbOfCells << ") and the number of non profile (" << code[1] << ") !";
271           throw INTERP_KERNEL::Exception(oss.str().c_str());
272         }
273     }
274   if(code[2]!=0)
275     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : single geo type mesh ! 0 or -1 is expected at pos #2 of input code !");
276   if(idsPerType.size()!=1)
277     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : input code points to DataArrayInt #0 whereas the size of idsPerType is not equal to 1 !");
278   const DataArrayInt *pfl=idsPerType[0];
279   if(!pfl)
280     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : the input code points to a NULL DataArrayInt at rank 0 !");
281   if(pfl->getNumberOfComponents()!=1)
282     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::checkTypeConsistencyAndContig : input profile should have exactly one component !");
283   pfl->checkAllIdsInRange(0,nbOfCells);
284   pfl->incrRef();
285   return const_cast<DataArrayInt *>(pfl);
286 }
287
288 /*!
289  * This method is the opposite of MEDCouplingUMesh::checkTypeConsistencyAndContig method. Given a list of cells in \a profile it returns a list of sub-profiles sorted by geo type.
290  * The result is put in the array \a idsPerType. In the returned parameter \a code, foreach i \a code[3*i+2] refers (if different from -1) to a location into the \a idsPerType.
291  * This method has 1 input \a profile and 3 outputs \a code \a idsInPflPerType and \a idsPerType.
292  * 
293  * \param [out] code is a vector of size 3*n where n is the number of different geometric type in \a this \b reduced to the profile \a profile. \a code has exactly the same semantic than in MEDCouplingUMesh::checkTypeConsistencyAndContig method.
294  * \param [out] idsInPflPerType is a vector of size of different geometric type in the subpart defined by \a profile of \a this ( equal to \a code.size()/3). For each i,
295  *              \a idsInPflPerType[i] stores the tuple ids in \a profile that correspond to the geometric type code[3*i+0]
296  * \param [out] idsPerType is a vector of size of different sub profiles needed to be defined to represent the profile \a profile for a given geometric type.
297  *              This vector can be empty in case of all geometric type cells are fully covered in ascending in the given input \a profile.
298  * 
299  * \warning for performance reasons no deep copy will be performed, if \a profile can been used as this in output parameters \a idsInPflPerType and \a idsPerType.
300  *
301  * \throw if \a profile has not exactly one component. It throws too, if \a profile contains some values not in [0,getNumberOfCells()) or if \a this is not fully defined
302  *
303  *  \b Example1: <br>
304  *          - Before \a this has 3 cells \a profile contains [0,1,2]
305  *          - After \a code contains [NORM_...,nbCells,-1], \a idsInPflPerType [[0,1,2]] and \a idsPerType is empty <br>
306  * 
307  *  \b Example2: <br>
308  *          - Before \a this has 3 cells \a profile contains [1,2]
309  *          - After \a code contains [NORM_...,nbCells,0], \a idsInPflPerType [[0,1]] and \a idsPerType is [[1,2]] <br>
310
311  */
312 void MEDCouplingStructuredMesh::splitProfilePerType(const DataArrayInt *profile, std::vector<int>& code, std::vector<DataArrayInt *>& idsInPflPerType, std::vector<DataArrayInt *>& idsPerType) const
313 {
314   if(!profile || !profile->isAllocated())
315     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::splitProfilePerType : input profile is NULL or not allocated !");
316   if(profile->getNumberOfComponents()!=1)
317     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::splitProfilePerType : input profile should have exactly one component !");
318   int nbTuples=profile->getNumberOfTuples();
319   int nbOfCells=getNumberOfCells();
320   code.resize(3); idsInPflPerType.resize(1);
321   code[0]=(int)getTypeOfCell(0); code[1]=nbOfCells;
322   idsInPflPerType.resize(1);
323   if(profile->isIdentity() && nbTuples==nbOfCells)
324     {
325       code[2]=-1;
326       idsInPflPerType[0]=0;
327       idsPerType.clear();
328       return ;
329     }
330   code[1]=profile->getNumberOfTuples();
331   code[2]=0;
332   profile->checkAllIdsInRange(0,nbOfCells);
333   idsPerType.resize(1);
334   idsPerType[0]=profile->deepCpy();
335   idsInPflPerType[0]=DataArrayInt::Range(0,nbTuples,1);
336 }
337
338 /*!
339  * Creates a new unstructured mesh (MEDCoupling1SGTUMesh) from \a this structured one.
340  *  \return MEDCouplingUMesh * - a new instance of MEDCouplingUMesh. The caller is to
341  * delete this array using decrRef() as it is no more needed. 
342  *  \throw If \a this->getMeshDimension() is not among [1,2,3].
343  */
344 MEDCoupling1SGTUMesh *MEDCouplingStructuredMesh::build1SGTUnstructured() const
345 {
346   int meshDim(getMeshDimension()),spaceDim(getSpaceDimensionOnNodeStruct());
347   if((meshDim<0 || meshDim>3) || (spaceDim<0 || spaceDim>3))
348     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::build1SGTUnstructured : meshdim and spacedim must be in [1,2,3] !");
349   MEDCouplingAutoRefCountObjectPtr<DataArrayDouble> coords(getCoordinatesAndOwner());
350   int ns[3];
351   getNodeGridStructure(ns);
352   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(Build1GTNodalConnectivity(ns,ns+spaceDim));
353   MEDCouplingAutoRefCountObjectPtr<MEDCoupling1SGTUMesh> ret(MEDCoupling1SGTUMesh::New(getName(),GetGeoTypeGivenMeshDimension(meshDim)));
354   ret->setNodalConnectivity(conn); ret->setCoords(coords);
355   try
356     { ret->copyTinyInfoFrom(this); }
357   catch(INTERP_KERNEL::Exception&) { }
358   return ret.retn();
359 }
360
361 /*!
362  * This method returns the unstructured mesh (having single geometric type) of the sub level mesh of \a this.
363  * This method is equivalent to computing MEDCouplingUMesh::buildDescendingConnectivity on the unstructurized \a this mesh.
364  * 
365  * The caller is to delete the returned mesh using decrRef() as it is no more needed. 
366  */
367 MEDCoupling1SGTUMesh *MEDCouplingStructuredMesh::build1SGTSubLevelMesh() const
368 {
369   int meshDim(getMeshDimension());
370   if(meshDim<1 || meshDim>3)
371     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::build1SGTSubLevelMesh : meshdim must be in [2,3] !");
372   MEDCouplingAutoRefCountObjectPtr<DataArrayDouble> coords(getCoordinatesAndOwner());
373   int ns[3];
374   getNodeGridStructure(ns);
375   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(Build1GTNodalConnectivityOfSubLevelMesh(ns,ns+meshDim));
376   MEDCouplingAutoRefCountObjectPtr<MEDCoupling1SGTUMesh> ret(MEDCoupling1SGTUMesh::New(getName(),GetGeoTypeGivenMeshDimension(meshDim-1)));
377   ret->setNodalConnectivity(conn); ret->setCoords(coords);
378   return ret.retn();
379 }
380
381 /*!
382  * Creates a new unstructured mesh (MEDCouplingUMesh) from \a this structured one.
383  *  \return MEDCouplingUMesh * - a new instance of MEDCouplingUMesh. The caller is to
384  * delete this array using decrRef() as it is no more needed. 
385  *  \throw If \a this->getMeshDimension() is not among [1,2,3].
386  */
387 MEDCouplingUMesh *MEDCouplingStructuredMesh::buildUnstructured() const
388 {
389   MEDCouplingAutoRefCountObjectPtr<MEDCoupling1SGTUMesh> ret0(build1SGTUnstructured());
390   return ret0->buildUnstructured();
391 }
392
393 /*!
394  * Creates a new MEDCouplingUMesh containing a part of cells of \a this mesh.
395  * The cells to include to the
396  * result mesh are specified by an array of cell ids.
397  *  \param [in] start - an array of cell ids to include to the result mesh.
398  *  \param [in] end - specifies the end of the array \a start, so that
399  *              the last value of \a start is \a end[ -1 ].
400  *  \return MEDCouplingMesh * - a new instance of MEDCouplingUMesh. The caller is to
401  *         delete this mesh using decrRef() as it is no more needed. 
402  */
403 MEDCouplingMesh *MEDCouplingStructuredMesh::buildPart(const int *start, const int *end) const
404 {
405   MEDCouplingUMesh *um=buildUnstructured();
406   MEDCouplingMesh *ret=um->buildPart(start,end);
407   um->decrRef();
408   return ret;
409 }
410
411 MEDCouplingMesh *MEDCouplingStructuredMesh::buildPartAndReduceNodes(const int *start, const int *end, DataArrayInt*& arr) const
412 {
413   std::vector<int> cgs(getCellGridStructure());
414   std::vector< std::pair<int,int> > cellPartFormat,nodePartFormat;
415   if(IsPartStructured(start,end,cgs,cellPartFormat))
416     {
417       MEDCouplingAutoRefCountObjectPtr<MEDCouplingStructuredMesh> ret(buildStructuredSubPart(cellPartFormat));
418       nodePartFormat=cellPartFormat;
419       for(std::vector< std::pair<int,int> >::iterator it=nodePartFormat.begin();it!=nodePartFormat.end();it++)
420         (*it).second++;
421       MEDCouplingAutoRefCountObjectPtr<DataArrayInt> tmp1(BuildExplicitIdsFrom(getNodeGridStructure(),nodePartFormat));
422       MEDCouplingAutoRefCountObjectPtr<DataArrayInt> tmp2(DataArrayInt::New()); tmp2->alloc(getNumberOfNodes(),1);
423       tmp2->fillWithValue(-1);
424       MEDCouplingAutoRefCountObjectPtr<DataArrayInt> tmp3(DataArrayInt::New()); tmp3->alloc(tmp1->getNumberOfTuples(),1); tmp3->iota(0);
425       tmp2->setPartOfValues3(tmp3,tmp1->begin(),tmp1->end(),0,1,1);
426       arr=tmp2.retn();
427       return ret.retn();
428     }
429   else
430     {
431       MEDCouplingUMesh *um=buildUnstructured();
432       MEDCouplingMesh *ret=um->buildPartAndReduceNodes(start,end,arr);
433       um->decrRef();
434       return ret;
435     }
436 }
437
438 DataArrayInt *MEDCouplingStructuredMesh::simplexize(int policy)
439 {
440   throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::simplexize : not available for Cartesian mesh !");
441 }
442
443 /*!
444  * Returns a new MEDCouplingFieldDouble holding normal vectors to cells of \a this
445  * 2D mesh. The computed vectors have 3 components and are normalized.
446  *  \return MEDCouplingFieldDouble * - a new instance of MEDCouplingFieldDouble on
447  *          cells and one time. The caller is to delete this field using decrRef() as
448  *          it is no more needed.
449  *  \throw If \a this->getMeshDimension() != 2.
450  */
451 MEDCouplingFieldDouble *MEDCouplingStructuredMesh::buildOrthogonalField() const
452 {
453   if(getMeshDimension()!=2)
454     throw INTERP_KERNEL::Exception("Expected a MEDCouplingStructuredMesh with meshDim == 2 !");
455   MEDCouplingFieldDouble *ret=MEDCouplingFieldDouble::New(ON_CELLS,NO_TIME);
456   DataArrayDouble *array=DataArrayDouble::New();
457   int nbOfCells=getNumberOfCells();
458   array->alloc(nbOfCells,3);
459   double *vals=array->getPointer();
460   for(int i=0;i<nbOfCells;i++)
461     { vals[3*i]=0.; vals[3*i+1]=0.; vals[3*i+2]=1.; }
462   ret->setArray(array);
463   array->decrRef();
464   ret->setMesh(this);
465   return ret;
466 }
467
468 void MEDCouplingStructuredMesh::getReverseNodalConnectivity(DataArrayInt *revNodal, DataArrayInt *revNodalIndx) const
469 {
470   std::vector<int> ngs(getNodeGridStructure());
471   int dim(getSpaceDimension());
472   switch(dim)
473   {
474     case 1:
475       return GetReverseNodalConnectivity1(ngs,revNodal,revNodalIndx);
476     case 2:
477       return GetReverseNodalConnectivity2(ngs,revNodal,revNodalIndx);
478     case 3:
479       return GetReverseNodalConnectivity3(ngs,revNodal,revNodalIndx);
480     default:
481       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::getReverseNodalConnectivity : only dimensions 1, 2 and 3 are supported !");
482   }
483 }
484
485 void MEDCouplingStructuredMesh::GetReverseNodalConnectivity1(const std::vector<int>& ngs, DataArrayInt *revNodal, DataArrayInt *revNodalIndx)
486 {
487   int nbNodes(ngs[0]);
488   revNodalIndx->alloc(nbNodes+1,1);
489   if(nbNodes==0)
490     { revNodal->alloc(0,1); revNodalIndx->setIJ(0,0,0); return ; }
491   if(nbNodes==1)
492     { revNodal->alloc(1,1); revNodal->setIJ(0,0,0); revNodalIndx->setIJ(0,0,0); revNodalIndx->setIJ(1,0,1); return ; }
493   revNodal->alloc(2*(nbNodes-1),1);
494   int *rn(revNodal->getPointer()),*rni(revNodalIndx->getPointer());
495   *rni++=0; *rni=1; *rn++=0;
496   for(int i=1;i<nbNodes-1;i++,rni++)
497     {
498       rn[0]=i-1; rn[1]=i;
499       rni[1]=rni[0]+2;
500       rn+=2;
501     }
502   rn[0]=nbNodes-2; rni[1]=rni[0]+1;
503 }
504
505 void MEDCouplingStructuredMesh::GetReverseNodalConnectivity2(const std::vector<int>& ngs, DataArrayInt *revNodal, DataArrayInt *revNodalIndx)
506 {
507   int nbNodesX(ngs[0]),nbNodesY(ngs[1]);
508   int nbNodes(nbNodesX*nbNodesY);
509   if(nbNodesX==0 || nbNodesY==0)
510     { revNodal->alloc(0,1); revNodalIndx->setIJ(0,0,0); return ; }
511   if(nbNodesX==1 || nbNodesY==1)
512     { std::vector<int> ngs2(1); ngs2[0]=std::max(nbNodesX,nbNodesY); return GetReverseNodalConnectivity1(ngs2,revNodal,revNodalIndx); }
513   revNodalIndx->alloc(nbNodes+1,1);
514   int nbCellsX(nbNodesX-1),nbCellsY(nbNodesY-1);
515   revNodal->alloc(4*(nbNodesX-2)*(nbNodesY-2)+2*2*(nbNodesX-2)+2*2*(nbNodesY-2)+4,1);
516   int *rn(revNodal->getPointer()),*rni(revNodalIndx->getPointer());
517   *rni++=0; *rni=1; *rn++=0;
518   for(int i=1;i<nbNodesX-1;i++,rni++,rn+=2)
519     {
520       rn[0]=i-1; rn[1]=i;
521       rni[1]=rni[0]+2;
522     }
523   rni[1]=rni[0]+1; *rn++=nbCellsX-1;
524   rni++;
525   for(int j=1;j<nbNodesY-1;j++)
526     {
527       int off(nbCellsX*(j-1)),off2(nbCellsX*j);
528       rni[1]=rni[0]+2; rn[0]=off; rn[1]=off2;
529       rni++; rn+=2;
530       for(int i=1;i<nbNodesX-1;i++,rni++,rn+=4)
531         {
532           rn[0]=i-1+off; rn[1]=i+off; rn[2]=i-1+off2; rn[3]=i+off2;
533           rni[1]=rni[0]+4;
534         }
535       rni[1]=rni[0]+2; rn[0]=off+nbCellsX-1; rn[1]=off2+nbCellsX-1;
536       rni++; rn+=2;
537     }
538   int off3(nbCellsX*(nbCellsY-1));
539   rni[1]=rni[0]+1;
540   rni++; *rn++=off3;
541   for(int i=1;i<nbNodesX-1;i++,rni++,rn+=2)
542     {
543       rn[0]=i-1+off3; rn[1]=i+off3;
544       rni[1]=rni[0]+2;
545     }
546   rni[1]=rni[0]+1; rn[0]=nbCellsX*nbCellsY-1;
547 }
548
549 void MEDCouplingStructuredMesh::GetReverseNodalConnectivity3(const std::vector<int>& ngs, DataArrayInt *revNodal, DataArrayInt *revNodalIndx)
550 {
551   int nbNodesX(ngs[0]),nbNodesY(ngs[1]),nbNodesZ(ngs[2]);
552   int nbNodes(nbNodesX*nbNodesY*nbNodesZ);
553   if(nbNodesX==0 || nbNodesY==0 || nbNodesZ==0)
554     { revNodal->alloc(0,1); revNodalIndx->setIJ(0,0,0); return ; }
555   if(nbNodesX==1 || nbNodesY==1 || nbNodesZ==1)
556     {
557       std::vector<int> ngs2(2);
558       int pos(0);
559       bool pass(false);
560       for(int i=0;i<3;i++)
561         {
562           if(pass)
563             { ngs2[pos++]=ngs[i]; }
564           else
565             {
566               pass=ngs[i]==1;
567               if(!pass)
568                 { ngs2[pos++]=ngs[i]; }
569             }
570         }
571       return GetReverseNodalConnectivity2(ngs2,revNodal,revNodalIndx);
572     }
573   revNodalIndx->alloc(nbNodes+1,1);
574   int nbCellsX(nbNodesX-1),nbCellsY(nbNodesY-1),nbCellsZ(nbNodesZ-1);
575   revNodal->alloc(8*(nbNodesX-2)*(nbNodesY-2)*(nbNodesZ-2)+4*(2*(nbNodesX-2)*(nbNodesY-2)+2*(nbNodesX-2)*(nbNodesZ-2)+2*(nbNodesY-2)*(nbNodesZ-2))+2*4*(nbNodesX-2)+2*4*(nbNodesY-2)+2*4*(nbNodesZ-2)+8,1);
576   int *rn(revNodal->getPointer()),*rni(revNodalIndx->getPointer());
577   *rni=0;
578   for(int k=0;k<nbNodesZ;k++)
579     {
580       bool factZ(k!=0 && k!=nbNodesZ-1);
581       int offZ0((k-1)*nbCellsX*nbCellsY),offZ1(k*nbCellsX*nbCellsY);
582       for(int j=0;j<nbNodesY;j++)
583         {
584           bool factYZ(factZ && (j!=0 && j!=nbNodesY-1));
585           int off00((j-1)*nbCellsX+offZ0),off01(j*nbCellsX+offZ0),off10((j-1)*nbCellsX+offZ1),off11(j*nbCellsX+offZ1);
586           for(int i=0;i<nbNodesX;i++,rni++)
587             {
588               int fact(factYZ && (i!=0 && i!=nbNodesX-1));
589               if(fact)
590                 {//most of points fall in this part of code
591                   rn[0]=off00+i-1; rn[1]=off00+i; rn[2]=off01+i-1; rn[3]=off01+i;
592                   rn[4]=off10+i-1; rn[5]=off10+i; rn[6]=off11+i-1; rn[7]=off11+i;
593                   rni[1]=rni[0]+8;
594                   rn+=8;
595                 }
596               else
597                 {
598                   int *rnRef(rn);
599                   if(k>=1 && j>=1 && i>=1)
600                     *rn++=off00+i-1;
601                   if(k>=1 && j>=1 && i<nbCellsX)
602                     *rn++=off00+i;
603                   if(k>=1 && j<nbCellsY && i>=1)
604                     *rn++=off01+i-1;
605                   if(k>=1 && j<nbCellsY && i<nbCellsX)
606                     *rn++=off01+i;
607                   //
608                   if(k<nbCellsZ && j>=1 && i>=1)
609                     *rn++=off10+i-1;
610                   if(k<nbCellsZ && j>=1 && i<nbCellsX)
611                     *rn++=off10+i;
612                   if(k<nbCellsZ && j<nbCellsY && i>=1)
613                     *rn++=off11+i-1;
614                   if(k<nbCellsZ && j<nbCellsY && i<nbCellsX)
615                     *rn++=off11+i;
616                   rni[1]=rni[0]+(int)(std::distance(rnRef,rn));
617                 }
618             }
619         }
620     }
621 }
622
623 /*!
624  * \return DataArrayInt * - newly allocated instance of nodal connectivity compatible for MEDCoupling1SGTMesh instance
625  */
626 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivity(const int *nodeStBg, const int *nodeStEnd)
627 {
628   int zippedNodeSt[3];
629   int dim(ZipNodeStructure(nodeStBg,nodeStEnd,zippedNodeSt));
630   switch(dim)
631   {
632     case 0:
633       {
634         MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
635         conn->alloc(1,1); conn->setIJ(0,0,0);
636         return conn.retn();
637       }
638     case 1:
639       return Build1GTNodalConnectivity1D(zippedNodeSt);
640     case 2:
641       return Build1GTNodalConnectivity2D(zippedNodeSt);
642     case 3:
643       return Build1GTNodalConnectivity3D(zippedNodeSt);
644     default:
645       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::Build1GTNodalConnectivity : only dimension in [0,1,2,3] supported !");
646   }
647 }
648
649 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivityOfSubLevelMesh(const int *nodeStBg, const int *nodeStEnd)
650 {
651   std::size_t dim(std::distance(nodeStBg,nodeStEnd));
652   switch(dim)
653   {
654     case 3:
655       return Build1GTNodalConnectivityOfSubLevelMesh3D(nodeStBg);
656     case 2:
657       return Build1GTNodalConnectivityOfSubLevelMesh2D(nodeStBg);
658     default:
659       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::Build1GTNodalConnectivityOfSubLevelMesh: only dimension in [2,3] supported !");
660   }
661 }
662
663 /*!
664  * This method retrieves the number of entities (it can be cells or nodes) given a range in compact standard format
665  * used in methods like BuildExplicitIdsFrom,IsPartStructured.
666  *
667  * \sa BuildExplicitIdsFrom,IsPartStructured
668  */
669 int MEDCouplingStructuredMesh::DeduceNumberOfGivenRangeInCompactFrmt(const std::vector< std::pair<int,int> >& partCompactFormat)
670 {
671   int ret(1);
672   bool isFetched(false);
673   std::size_t ii(0);
674   for(std::vector< std::pair<int,int> >::const_iterator it=partCompactFormat.begin();it!=partCompactFormat.end();it++,ii++)
675     {
676       int a((*it).first),b((*it).second);
677       if(a<0 || b<0 || b-a<0)
678         {
679           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::DeduceNumberOfGivenRangeInCompactFrmt : invalid input at dimension " << ii << " !";
680           throw INTERP_KERNEL::Exception(oss.str().c_str());
681         }
682       if(b-a>0)
683         {
684           isFetched=true;
685           ret*=(b-a);
686         }
687     }
688   return isFetched?ret:0;
689 }
690
691 int MEDCouplingStructuredMesh::DeduceNumberOfGivenStructure(const std::vector<int>& st)
692 {
693   int ret(1);
694   bool isFetched(false);
695   for(std::size_t i=0;i<st.size();i++)
696     {
697       if(st[i]<0)
698         throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::DeduceNumberOfGivenStructure : presence of a negative value in structure !");
699       ret*=st[i];
700       isFetched=true;
701     }
702   return isFetched?ret:0;
703 }
704
705 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivity1D(const int *nodeStBg)
706 {
707   int nbOfCells(*nodeStBg-1);
708   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
709   conn->alloc(2*nbOfCells,1);
710   int *cp=conn->getPointer();
711   for(int i=0;i<nbOfCells;i++)
712     {
713       cp[2*i+0]=i;
714       cp[2*i+1]=i+1;
715     }
716   return conn.retn();
717 }
718
719 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivity2D(const int *nodeStBg)
720 {
721   int n1=nodeStBg[0]-1;
722   int n2=nodeStBg[1]-1;
723   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
724   conn->alloc(4*n1*n2,1);
725   int *cp=conn->getPointer();
726   int pos=0;
727   for(int j=0;j<n2;j++)
728     for(int i=0;i<n1;i++,pos++)
729       {
730         cp[4*pos+0]=i+1+j*(n1+1);
731         cp[4*pos+1]=i+j*(n1+1);
732         cp[4*pos+2]=i+(j+1)*(n1+1);
733         cp[4*pos+3]=i+1+(j+1)*(n1+1);
734       }
735   return conn.retn();
736 }
737
738 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivity3D(const int *nodeStBg)
739 {
740   int n1=nodeStBg[0]-1;
741   int n2=nodeStBg[1]-1;
742   int n3=nodeStBg[2]-1;
743   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
744   conn->alloc(8*n1*n2*n3,1);
745   int *cp=conn->getPointer();
746   int pos=0;
747   for(int k=0;k<n3;k++)
748     for(int j=0;j<n2;j++)
749       for(int i=0;i<n1;i++,pos++)
750         {
751           int tmp=(n1+1)*(n2+1);
752           cp[8*pos+0]=i+1+j*(n1+1)+k*tmp;
753           cp[8*pos+1]=i+j*(n1+1)+k*tmp;
754           cp[8*pos+2]=i+(j+1)*(n1+1)+k*tmp;
755           cp[8*pos+3]=i+1+(j+1)*(n1+1)+k*tmp;
756           cp[8*pos+4]=i+1+j*(n1+1)+(k+1)*tmp;
757           cp[8*pos+5]=i+j*(n1+1)+(k+1)*tmp;
758           cp[8*pos+6]=i+(j+1)*(n1+1)+(k+1)*tmp;
759           cp[8*pos+7]=i+1+(j+1)*(n1+1)+(k+1)*tmp;
760         }
761   return conn.retn();
762 }
763
764 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivityOfSubLevelMesh3D(const int *nodeStBg)
765 {
766   std::vector<int> ngs(3);
767   int n0(nodeStBg[0]-1),n1(nodeStBg[1]-1),n2(nodeStBg[2]-1); ngs[0]=n0; ngs[1]=n1; ngs[2]=n2;
768   int off0(nodeStBg[0]),off1(nodeStBg[0]*nodeStBg[1]);
769   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
770   conn->alloc(4*GetNumberOfCellsOfSubLevelMesh(ngs,3));
771   int *cp(conn->getPointer());
772   //X
773   for(int i=0;i<nodeStBg[0];i++)
774     for(int j=0;j<n1;j++)
775       for(int k=0;k<n2;k++,cp+=4)
776         { cp[0]=k*off1+j*off0+i; cp[1]=(k+1)*off1+j*off0+i; cp[2]=(k+1)*off1+(j+1)*off0+i; cp[3]=k*off1+(j+1)*off0+i; }
777   //Y
778   for(int j=0;j<nodeStBg[1];j++)
779     for(int i=0;i<n0;i++)
780       for(int k=0;k<n2;k++,cp+=4)
781         { cp[0]=k*off1+j*off0+i; cp[1]=(k+1)*off1+j*off0+i; cp[2]=(k+1)*off1+j*off0+(i+1); cp[3]=k*off1+j*off0+(i+1); }
782   //Z
783   for(int k=0;k<nodeStBg[2];k++)
784     for(int i=0;i<n0;i++)
785       for(int j=0;j<n1;j++,cp+=4)
786         { cp[0]=k*off1+j*off0+i; cp[1]=k*off1+j*off0+(i+1); cp[2]=k*off1+(j+1)*off0+(i+1); cp[3]=k*off1+(j+1)*off0+i; }
787   return conn.retn();
788 }
789
790 /*!
791  * This method computes given the nodal structure defined by [ \a nodeStBg , \a nodeStEnd ) the zipped form.
792  * std::distance( \a nodeStBg, \a nodeStEnd ) is equal to the space dimension. The returned value is equal to
793  * the meshDimension (or the zipped spaceDimension).
794  *
795  * \param [out] zipNodeSt - The zipped node strucutre
796  * \return int - the
797  */
798 int MEDCouplingStructuredMesh::ZipNodeStructure(const int *nodeStBg, const int *nodeStEnd, int zipNodeSt[3])
799 {
800   int spaceDim((int)std::distance(nodeStBg,nodeStEnd));
801   if(spaceDim>3 || spaceDim<1)
802     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::ZipNodeStructure : spaceDim must in [1,2,3] !");
803   zipNodeSt[0]=0; zipNodeSt[1]=0; zipNodeSt[2]=0;
804   int zippedI(0);
805   for(int i=0;i<spaceDim;i++)
806     {
807       int elt(nodeStBg[i]);
808       if(elt<1)
809         {
810           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::ZipNodeStructure : the input nodal structure at pos#" << i << "(" << nodeStBg[i] << ") is invalid !";
811           throw INTERP_KERNEL::Exception(oss.str().c_str());
812         }
813       if(elt>=2)
814         zipNodeSt[zippedI++]=elt;
815     }
816   return zippedI;
817 }
818
819 DataArrayInt *MEDCouplingStructuredMesh::Build1GTNodalConnectivityOfSubLevelMesh2D(const int *nodeStBg)
820 {
821   std::vector<int> ngs(2);
822   int n0(nodeStBg[0]-1),n1(nodeStBg[1]-1); ngs[0]=n0; ngs[1]=n1;
823   int off0(nodeStBg[0]);
824   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> conn(DataArrayInt::New());
825   conn->alloc(2*GetNumberOfCellsOfSubLevelMesh(ngs,2));
826   int *cp(conn->getPointer());
827   //X
828   for(int i=0;i<nodeStBg[0];i++)
829     for(int j=0;j<n1;j++,cp+=2)
830       { cp[0]=j*off0+i; cp[1]=(j+1)*off0+i; }
831   //Y
832   for(int j=0;j<nodeStBg[1];j++)
833     for(int i=0;i<n0;i++,cp+=2)
834       { cp[0]=j*off0+i; cp[1]=j*off0+(i+1); }
835   return conn.retn();
836 }
837
838 /*!
839  * Returns a cell id by its (i,j,k) index. The cell is located between the i-th and
840  * ( i + 1 )-th nodes along X axis etc.
841  *  \param [in] i - a index of node coordinates array along X axis.
842  *  \param [in] j - a index of node coordinates array along Y axis.
843  *  \param [in] k - a index of node coordinates array along Z axis.
844  *  \return int - a cell id in \a this mesh.
845  */
846 int MEDCouplingStructuredMesh::getCellIdFromPos(int i, int j, int k) const
847 {
848   int tmp[3]={i,j,k};
849   int tmp2[3];
850   int meshDim(getMeshDimension());
851   getSplitCellValues(tmp2);
852   std::transform(tmp,tmp+meshDim,tmp2,tmp,std::multiplies<int>());
853   return std::accumulate(tmp,tmp+meshDim,0);
854 }
855
856 /*!
857  * Returns a node id by its (i,j,k) index.
858  *  \param [in] i - a index of node coordinates array along X axis.
859  *  \param [in] j - a index of node coordinates array along Y axis.
860  *  \param [in] k - a index of node coordinates array along Z axis.
861  *  \return int - a node id in \a this mesh.
862  */
863 int MEDCouplingStructuredMesh::getNodeIdFromPos(int i, int j, int k) const
864 {
865   int tmp[3]={i,j,k};
866   int tmp2[3];
867   int spaceDim(getSpaceDimension());
868   getSplitNodeValues(tmp2);
869   std::transform(tmp,tmp+spaceDim,tmp2,tmp,std::multiplies<int>());
870   return std::accumulate(tmp,tmp+spaceDim,0);
871 }
872
873
874 int MEDCouplingStructuredMesh::getNumberOfCells() const
875 {
876   std::vector<int> ngs(getNodeGridStructure());
877   int ret(1);
878   bool isCatched(false);
879   std::size_t ii(0);
880   for(std::vector<int>::const_iterator it=ngs.begin();it!=ngs.end();it++,ii++)
881     {
882       int elt(*it);
883       if(elt<=0)
884         {
885           std::ostringstream oss; oss << "MEDCouplingStructuredMesh::getNumberOfCells : at pos #" << ii << " the number of nodes in nodeStructure is " << *it << " ! Must be > 0 !";
886           throw INTERP_KERNEL::Exception(oss.str().c_str());
887         }
888       if(elt>1)
889         {
890           ret*=elt-1;
891           isCatched=true;
892         }
893     }
894   return isCatched?ret:0;
895 }
896
897 int MEDCouplingStructuredMesh::getNumberOfNodes() const
898 {
899   std::vector<int> ngs(getNodeGridStructure());
900   int ret(1);
901   for(std::vector<int>::const_iterator it=ngs.begin();it!=ngs.end();it++)
902     ret*=*it;
903   return ret;
904 }
905
906 void MEDCouplingStructuredMesh::GetPosFromId(int nodeId, int meshDim, const int *split, int *res)
907 {
908   int work=nodeId;
909   for(int i=meshDim-1;i>=0;i--)
910     {
911       int pos=work/split[i];
912       work=work%split[i];
913       res[i]=pos;
914     }
915 }
916
917 std::vector<int> MEDCouplingStructuredMesh::getCellGridStructure() const
918 {
919   std::vector<int> ret(getNodeGridStructure());
920   std::transform(ret.begin(),ret.end(),ret.begin(),std::bind2nd(std::plus<int>(),-1));
921   return ret;
922 }
923
924 /*!
925  * Given a struct \a strct it returns a split vector [1,strct[0],strct[0]*strct[1]...]
926  * This decomposition allows to quickly find i,j,k given a global id.
927  */
928 std::vector<int> MEDCouplingStructuredMesh::GetSplitVectFromStruct(const std::vector<int>& strct)
929 {
930   int spaceDim((int)strct.size());
931   std::vector<int> res(spaceDim);
932   for(int l=0;l<spaceDim;l++)
933     {
934       int val=1;
935       for(int p=0;p<spaceDim-l-1;p++)
936         val*=strct[p];
937       res[spaceDim-l-1]=val;
938     }
939   return res;
940 }
941
942 /*!
943  * This method states if given part ids [ \a startIds, \a stopIds) and a structure \a st returns if it can be considered as a structured dataset.
944  * If true is returned \a partCompactFormat will contain the information to build the corresponding part.
945  *
946  * \sa MEDCouplingStructuredMesh::BuildExplicitIdsFrom, MEDCouplingStructuredMesh::DeduceNumberOfGivenRangeInCompactFrmt
947  */
948 bool MEDCouplingStructuredMesh::IsPartStructured(const int *startIds, const int *stopIds, const std::vector<int>& st, std::vector< std::pair<int,int> >& partCompactFormat)
949 {
950   int dim((int)st.size());
951   partCompactFormat.resize(dim);
952   if(dim<1 || dim>3)
953     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::isPartStructured : input structure must be of dimension in [1,2,3] !");
954   std::vector<int> tmp2(dim),tmp(dim),tmp3(dim),tmp4(dim); tmp2[0]=1;
955   for(int i=1;i<dim;i++)
956     tmp2[i]=tmp2[i-1]*st[i-1];
957   std::size_t sz(std::distance(startIds,stopIds));
958   if(sz==0)
959     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::IsPartStructured : empty input !");
960   GetPosFromId(*startIds,dim,&tmp2[0],&tmp[0]);
961   partCompactFormat.resize(dim);
962   for(int i=0;i<dim;i++)
963     partCompactFormat[i].first=tmp[i];
964   if(tmp[dim-1]<0 || tmp[dim-1]>=st[dim-1])
965     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::IsPartStructured : first id in input is not in valid range !");
966   if(sz==1)
967     {
968       for(int i=0;i<dim;i++)
969         partCompactFormat[i].second=tmp[i]+1;
970       return true;
971     }
972   GetPosFromId(startIds[sz-1],dim,&tmp2[0],&tmp3[0]);
973   int szExp(1);
974   for(int i=0;i<dim;i++)
975     {
976       if(tmp3[i]<0 || tmp3[i]>=st[i])
977         throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::IsPartStructured : last id in input is not in valid range !");
978       partCompactFormat[i].second=tmp3[i]+1;
979       tmp4[i]=partCompactFormat[i].second-partCompactFormat[i].first;
980       if(tmp4[i]<=0)
981         return false;
982       szExp*=tmp4[i];
983     }
984   if(szExp!=(int)sz)
985     return false;
986   const int *w(startIds);
987   switch(dim)
988   {
989     case 3:
990       {
991         for(int i=0;i<tmp4[2];i++)
992           {
993             int a=tmp2[2]*(partCompactFormat[2].first+i);
994             for(int j=0;j<tmp4[1];j++)
995               {
996                 int b=tmp2[1]*(partCompactFormat[1].first+j);
997                 for(int k=0;k<tmp4[0];k++,w++)
998                   {
999                     if(partCompactFormat[0].first+k+b+a!=*w)
1000                       return false;
1001                   }
1002               }
1003           }
1004         return true;
1005       }
1006     case 2:
1007       {
1008         for(int j=0;j<tmp4[1];j++)
1009           {
1010             int b=tmp2[1]*(partCompactFormat[1].first+j);
1011             for(int k=0;k<tmp4[0];k++,w++)
1012               {
1013                 if(partCompactFormat[0].first+k+b!=*w)
1014                   return false;
1015               }
1016           }
1017         return true;
1018       }
1019     case 1:
1020       {
1021         for(int k=0;k<tmp4[0];k++,w++)
1022           {
1023             if(partCompactFormat[0].first+k!=*w)
1024               return false;
1025           }
1026         return true;
1027       }
1028     default:
1029       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::IsPartStructured : internal error !");
1030   }
1031 }
1032
1033 std::vector<int> MEDCouplingStructuredMesh::GetDimensionsFromCompactFrmt(const std::vector< std::pair<int,int> >& partCompactFormat)
1034 {
1035   std::vector<int> ret(partCompactFormat.size());
1036   for(std::size_t i=0;i<partCompactFormat.size();i++)
1037     ret[i]=partCompactFormat[i].second-partCompactFormat[i].first;
1038   return ret;
1039 }
1040
1041 /*!
1042  * This method is close to BuildExplicitIdsFrom except that instead of returning a DataArrayInt instance containing explicit ids it
1043  * enable elems in the vector of booleans (for performance reasons). As it is method for performance, this method is \b not
1044  * available in python.
1045  *
1046  * \param [in] st The entity structure.
1047  * \param [in] partCompactFormat The compact subpart to be enabled.
1048  * \param [in,out] vectToSwitchOn Vector which fetched items are enabled.
1049  *
1050  * \sa MEDCouplingStructuredMesh::BuildExplicitIdsFrom
1051  */
1052 void MEDCouplingStructuredMesh::SwitchOnIdsFrom(const std::vector<int>& st, const std::vector< std::pair<int,int> >& partCompactFormat, std::vector<bool>& vectToSwitchOn)
1053 {
1054   if(st.size()!=partCompactFormat.size())
1055     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::SwitchOnIdsFrom : input arrays must have the same size !");
1056   if((int)vectToSwitchOn.size()!=DeduceNumberOfGivenStructure(st))
1057     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::SwitchOnIdsFrom : invalid size of input vector of boolean regarding the structure !");
1058   std::vector<int> dims(GetDimensionsFromCompactFrmt(partCompactFormat));
1059   switch(st.size())
1060   {
1061     case 3:
1062       {
1063         for(int i=0;i<dims[2];i++)
1064           {
1065             int a=(partCompactFormat[2].first+i)*st[0]*st[1];
1066             for(int j=0;j<dims[1];j++)
1067               {
1068                 int b=(partCompactFormat[1].first+j)*st[0];
1069                 for(int k=0;k<dims[0];k++)
1070                   vectToSwitchOn[partCompactFormat[0].first+k+b+a]=true;
1071               }
1072           }
1073         break;
1074       }
1075     case 2:
1076       {
1077         for(int j=0;j<dims[1];j++)
1078           {
1079             int b=(partCompactFormat[1].first+j)*st[0];
1080             for(int k=0;k<dims[0];k++)
1081               vectToSwitchOn[partCompactFormat[0].first+k+b]=true;
1082           }
1083         break;
1084       }
1085     case 1:
1086       {
1087         for(int k=0;k<dims[0];k++)
1088           vectToSwitchOn[partCompactFormat[0].first+k]=true;
1089         break;
1090       }
1091     default:
1092       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : Dimension supported are 1,2 or 3 !");
1093   }
1094 }
1095
1096 /*!
1097  * This method builds the explicit entity array from the structure in \a st and the range in \a partCompactFormat.
1098  * If the range contains invalid values regarding sructure an exception will be thrown.
1099  *
1100  * \return DataArrayInt * - a new object.
1101  * \sa MEDCouplingStructuredMesh::IsPartStructured, MEDCouplingStructuredMesh::DeduceNumberOfGivenRangeInCompactFrmt, SwitchOnIdsFrom
1102  */
1103 DataArrayInt *MEDCouplingStructuredMesh::BuildExplicitIdsFrom(const std::vector<int>& st, const std::vector< std::pair<int,int> >& partCompactFormat)
1104 {
1105   if(st.size()!=partCompactFormat.size())
1106     throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : input arrays must have the same size !");
1107   int nbOfItems(1);
1108   std::vector<int> dims(st.size());
1109   for(std::size_t i=0;i<st.size();i++)
1110     {
1111       if(partCompactFormat[i].first<0 || partCompactFormat[i].first>st[i])
1112         throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : invalid input range 1 !");
1113       if(partCompactFormat[i].second<0 || partCompactFormat[i].second>st[i])
1114         throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : invalid input range 2 !");
1115       if(partCompactFormat[i].second<=partCompactFormat[i].first)
1116         throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : invalid input range 3 !");
1117       dims[i]=partCompactFormat[i].second-partCompactFormat[i].first;
1118       nbOfItems*=dims[i];
1119     }
1120   MEDCouplingAutoRefCountObjectPtr<DataArrayInt> ret(DataArrayInt::New());
1121   ret->alloc(nbOfItems,1);
1122   int *pt(ret->getPointer());
1123   switch(st.size())
1124   {
1125     case 3:
1126       {
1127         for(int i=0;i<dims[2];i++)
1128           {
1129             int a=(partCompactFormat[2].first+i)*st[0]*st[1];
1130             for(int j=0;j<dims[1];j++)
1131               {
1132                 int b=(partCompactFormat[1].first+j)*st[0];
1133                 for(int k=0;k<dims[0];k++,pt++)
1134                   *pt=partCompactFormat[0].first+k+b+a;
1135               }
1136           }
1137         break;
1138       }
1139     case 2:
1140       {
1141         for(int j=0;j<dims[1];j++)
1142           {
1143             int b=(partCompactFormat[1].first+j)*st[0];
1144             for(int k=0;k<dims[0];k++,pt++)
1145               *pt=partCompactFormat[0].first+k+b;
1146           }
1147         break;
1148       }
1149     case 1:
1150       {
1151         for(int k=0;k<dims[0];k++,pt++)
1152           *pt=partCompactFormat[0].first+k;
1153         break;
1154       }
1155     default:
1156       throw INTERP_KERNEL::Exception("MEDCouplingStructuredMesh::BuildExplicitIdsFrom : Dimension supported are 1,2 or 3 !");
1157   }
1158   return ret.retn();
1159 }
1160
1161 int MEDCouplingStructuredMesh::GetNumberOfCellsOfSubLevelMesh(const std::vector<int>& cgs, int mdim)
1162 {
1163   int ret(0);
1164   for(int i=0;i<mdim;i++)
1165     {
1166       int locRet(1);
1167       for(int j=0;j<mdim;j++)
1168         if(j!=i)
1169           locRet*=cgs[j];
1170         else
1171           locRet*=cgs[j]+1;
1172       ret+=locRet;
1173     }
1174   return ret;
1175 }