-// Copyright (C) 2007-2008 CEA/DEN, EDF R&D, OPEN CASCADE
+// Copyright (C) 2007-2015 CEA/DEN, EDF R&D, OPEN CASCADE
//
-// Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
-// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
+// Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
+// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
//
-// This library is free software; you can redistribute it and/or
-// modify it under the terms of the GNU Lesser General Public
-// License as published by the Free Software Foundation; either
-// version 2.1 of the License.
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Lesser General Public
+// License as published by the Free Software Foundation; either
+// version 2.1 of the License, or (at your option) any later version.
//
-// This library is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// Lesser General Public License for more details.
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// Lesser General Public License for more details.
//
-// You should have received a copy of the GNU Lesser General Public
-// License along with this library; if not, write to the Free Software
-// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
-// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
+// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
+
// File : SMESH_BasicHypothesis.idl
// Author : Paul RASCLE, EDF
//
#include "SMESH_Hypothesis.idl"
#include "SMESH_Mesh.idl"
-
/*!
* StdMeshers: interfaces to standard hypotheses and algorithms
*/
double GetFineness();
};
+ /*!
+ * Common inteface of 1D hypotheses that can be reversed
+ */
+ interface Reversible1D
+ {
+ /*!
+ * Set list of edges to reverse
+ */
+ void SetReversedEdges( in SMESH::long_array list );
+
+ /*!
+ * Returns list of edges to reverse
+ */
+ SMESH::long_array GetReversedEdges();
+
+ /*!
+ * Set entry of the main object
+ */
+ void SetObjectEntry( in string entry );
+
+ /*!
+ * Get the entry of the main object
+ */
+ string GetObjectEntry();
+ };
+
/*!
* StdMeshers_NumberOfSegments: interface of "Nb. Segments" hypothesis
*/
- interface StdMeshers_NumberOfSegments : SMESH::SMESH_Hypothesis
+ interface StdMeshers_NumberOfSegments : SMESH::SMESH_Hypothesis, Reversible1D
{
/*!
* Builds and returns point distribution according to passed density function
/*!
* StdMeshers_Arithmetic1D: interface of "Arithmetic 1D" hypothesis
*/
- interface StdMeshers_Arithmetic1D : SMESH::SMESH_Hypothesis
+ interface StdMeshers_Arithmetic1D : SMESH::SMESH_Hypothesis, Reversible1D
{
/*!
* Sets <start segment length> or <end segment length> parameter value
+ * * OBSOLETE *. Avoid such a way of interface design
+ * * It is recommended to dedicate a method to each parameter.
*/
void SetLength(in double length, in boolean isStartLength)
raises (SALOME::SALOME_Exception);
+ /*!
+ * Sets <start segment length> parameter value
+ */
+ void SetStartLength(in double length)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Sets <end segment length> parameter value
+ */
+ void SetEndLength(in double length)
+ raises (SALOME::SALOME_Exception);
+
/*!
* Returns <start segment length> or <end segment length> parameter value
*/
double GetLength(in boolean isStartLength);
+
+ };
+
+ /*!
+ * StdMeshers_Arithmetic1D: interface of "Geometric 1D" hypothesis
+ */
+ interface StdMeshers_Geometric1D : SMESH::SMESH_Hypothesis, Reversible1D
+ {
+ /*!
+ * Sets length of the first segment
+ */
+ void SetStartLength(in double length)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Sets value of Common Ratio
+ */
+ void SetCommonRatio(in double factor)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Returns length of the first segment
+ */
+ double GetStartLength();
+
+ /*!
+ * Returns value of Common Ratio
+ */
+ double GetCommonRatio();
+
};
/*!
/*!
* StdMeshers_StartEndLength: interface of "Start and End Length" hypothesis
*/
- interface StdMeshers_StartEndLength : SMESH::SMESH_Hypothesis
+ interface StdMeshers_StartEndLength : SMESH::SMESH_Hypothesis, Reversible1D
{
/*!
* Sets <start segment length> or <end segment length> parameter value
+ * * OBSOLETE *. Avoid such a way of interface design.
+ * * It is recommended to dedicate a method to each parameter.
*/
void SetLength(in double length, in boolean isStartLength)
raises (SALOME::SALOME_Exception);
+ /*!
+ * Sets <start segment length> parameter value
+ */
+ void SetStartLength(in double length)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Sets <end segment length> parameter value
+ */
+ void SetEndLength(in double length)
+ raises (SALOME::SALOME_Exception);
+
/*!
* Returns <start segment length> or <end segment length> parameter value
*/
double GetLength(in boolean isStartLength);
+
};
double GetDeflection();
};
+ /*!
+ * StdMeshers_FixedPoints1D: interface of "Fixed points 1D" hypothesis
+ */
+ interface StdMeshers_FixedPoints1D : SMESH::SMESH_Hypothesis, Reversible1D
+ {
+ /*!
+ * Sets some points on edge using parameter on curve from 0 to 1
+ * (additionally it is neecessary to check orientation of edges and
+ * create list of reversed edges if it is needed) and sets numbers
+ * of segments between given points (default values are equals 1)
+ */
+ void SetPoints(in SMESH::double_array listParams)
+ raises (SALOME::SALOME_Exception);
+ void SetNbSegments(in SMESH::long_array listNbSeg)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Returns list of point's parameters
+ */
+ SMESH::double_array GetPoints();
+
+ /*!
+ * Returns list of numbers of segments
+ */
+ SMESH::long_array GetNbSegments();
+
+ };
+
+ /*!
+ * StdMeshers_Adaptive1D: interface of "Adaptive" hypothesis
+ */
+ interface StdMeshers_Adaptive1D : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Sets minimal allowed segment length
+ */
+ void SetMinSize(in double minSegLen) raises (SALOME::SALOME_Exception);
+ double GetMinSize();
+
+ /*!
+ * Sets maximal allowed segment length
+ */
+ void SetMaxSize(in double maxSegLen) raises (SALOME::SALOME_Exception);
+ double GetMaxSize();
+
+ /*!
+ * Sets <deflection> parameter value,
+ * i.e. a maximal allowed distance between a segment and an edge.
+ */
+ void SetDeflection(in double deflection) raises (SALOME::SALOME_Exception);
+ double GetDeflection();
+ };
/*!
* StdMeshers_MaxElementVolume: interface of "Max. Hexahedron or Tetrahedron Volume" hypothesis
};
/*!
- * StdMeshers_Propagation: interface of "Propagation" hypothesis.
+ * StdMeshers_Propagation: interface of "Propagation of 1D Hyp. on
+ * Opposite Edges" hypothesis.
* Presence of this hypothesis on any edge propagates any other 1D
* hypothesis from this edge on all edges, opposite to it.
* It concerns only edges of quadrangle faces.
};
/*!
- * StdMeshers_QuadranglePreference: interface of "QuadranglePreference" hypothesis.
- * This hypothesis is used by StdMeshers_Quadrangle_2D algorithm.
- * Presence of this hypothesis forces construction of quadrangles if the number
- * of nodes on opposite edges is not the same in the case where the global number
- * of nodes on edges is even
+ * StdMeshers_Propagation: interface of "Propagation of Node
+ * Distribution on Opposite Edges" hypothesis.
+ * Presence of this hypothesis on any edge propagates distribution of nodes
+ * from this edge on all edges, opposite to it.
+ * It concerns only edges of quadrangle faces.
*/
- interface StdMeshers_QuadranglePreference : SMESH::SMESH_Hypothesis
+ interface StdMeshers_PropagOfDistribution : SMESH::SMESH_Hypothesis
{
};
/*!
- * StdMeshers_TrianglePreference: interface of "TrianglePreference" hypothesis.
+ * StdMeshers_QuadranglePreference: interface of "QuadranglePreference" hypothesis.
* This hypothesis is used by StdMeshers_Quadrangle_2D algorithm.
- * Presence of this hypothesis forces construction of triangles in the refinement
- * area if the number of nodes on opposite edges is not the same.
+ * Presence of this hypothesis forces construction of quadrangles if the number
+ * of nodes on opposite edges is not the same in the case where the global number
+ * of nodes on edges is even
*/
- interface StdMeshers_TrianglePreference : SMESH::SMESH_Hypothesis
+ interface StdMeshers_QuadranglePreference : SMESH::SMESH_Hypothesis
{
};
};
+ /*!
+ * StdMeshers_NumberOfLayers2D: interface of "Nb. Layers" hypothesis.
+ * This hypothesis is used by "Radial quadrangle" algorithm.
+ * It specifies number of segments between the internal
+ * and the external surfaces.
+ */
+ interface StdMeshers_NumberOfLayers2D : StdMeshers_NumberOfLayers
+ {
+ };
+
+ /*!
+ * StdMeshers_LayerDistribution2D: interface of "Distribution of Layers" hypothesis.
+ * This hypothesis is used by "Radial quadrangle" algorithm.
+ * It specifies 1D hypothesis defining distribution of segments between the internal
+ * and the external surfaces.
+ */
+ interface StdMeshers_LayerDistribution2D : StdMeshers_LayerDistribution
+ {
+ };
+
/*!
* interface of "ProjectionSource1D" hypothesis.
* This hypothesis specifies a meshed edge to take a mesh pattern from
double GetLength();
};
+ /*!
+ * StdMeshers_QuadrangleParams: interface of "Quadrangle Params" hypothesis
+ */
+ enum QuadType
+ {
+ QUAD_STANDARD,
+ QUAD_TRIANGLE_PREF,
+ QUAD_QUADRANGLE_PREF,
+ QUAD_QUADRANGLE_PREF_REVERSED,
+ QUAD_REDUCED,
+ QUAD_NB_TYPES /* this is not a type of quadrangulation */
+ };
+
+ interface StdMeshers_QuadrangleParams : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set base vertex for triangles
+ */
+ void SetTriaVertex( in long vertID );
+
+ /*!
+ * Returns base vertex for triangles
+ */
+ long GetTriaVertex();
+
+ /*!
+ * Set entry of the main object
+ */
+ void SetObjectEntry( in string entry );
+
+ /*!
+ * Get the entry of the main object
+ */
+ string GetObjectEntry();
+
+ /*!
+ * Set the type of quadrangulation
+ */
+ void SetQuadType( in QuadType type );
+
+ /*!
+ * Get the type of quadrangulation
+ */
+ QuadType GetQuadType();
+
+ /*!
+ * Set positions of enforced nodes
+ */
+ void SetEnforcedNodes(in GEOM::ListOfGO vertices, in SMESH::nodes_array points)
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * Returns positions of enforced nodes
+ */
+ void GetEnforcedNodes(out GEOM::ListOfGO vertices, out SMESH::nodes_array points);
+
+ /*!
+ * Returns entries of shapes defining enforced nodes
+ */
+ SMESH::string_array GetEnfVertices();
+ };
+
+ /*!
+ * interface of "Source edges" hypothesis.
+ * This hypothesis specifies groups of edges of other mesh to be imported
+ * in this mesh
+ */
+ interface StdMeshers_ImportSource1D : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set edges to import from other mesh
+ */
+ void SetSourceEdges(in SMESH::ListOfGroups groups);
+ SMESH::string_array GetSourceEdges();
+
+ /*!
+ * Set to import the whole other mesh or not, and if yes, to
+ * copy groups of not. By default the mesh is not copied.
+ */
+ void SetCopySourceMesh(in boolean toCopyMesh, in boolean toCopyGroups);
+ void GetCopySourceMesh(out boolean toCopyMesh,out boolean toCopyGroups);
+ };
+
+ /*!
+ * interface of "Source faces" hypothesis.
+ * This hypothesis specifies groups of faces of other mesh to be imported
+ * in this mesh
+ */
+ interface StdMeshers_ImportSource2D : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set faces to import from other mesh
+ */
+ void SetSourceFaces(in SMESH::ListOfGroups groups);
+ SMESH::string_array GetSourceFaces();
+
+ /*!
+ * Set to import the whole other mesh or not, and if yes, to
+ * copy groups of not. By default the mesh is not copied.
+ */
+ void SetCopySourceMesh(in boolean toCopyMesh,in boolean toCopyGroups);
+ void GetCopySourceMesh(out boolean toCopyMesh,out boolean toCopyGroups);
+ };
+
+ /*!
+ * Method of computing translation of a node at Viscous Layers construction
+ */
+ enum VLExtrusionMethod {
+ // node is translated along normal to a surface with possible further smoothing
+ SURF_OFFSET_SMOOTH,
+ // node is translated along the average normal of surrounding faces till
+ // intersection with a neighbor face translated along its own normal
+ // by the layers thickness
+ FACE_OFFSET,
+ // node is translated along the average normal of surrounding faces
+ // by the layers thickness
+ NODE_OFFSET
+ };
+
+ /*!
+ * interface of "Viscous Layers" hypothesis.
+ * This hypothesis specifies parameters of layers of prisms to build
+ * near mesh boundary. This hypothesis can be used by several 3D algorithms:
+ * NETGEN 3D, Hexahedron(i,j,k), MG_Tetra
+ */
+ interface StdMeshers_ViscousLayers : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set faces to exclude from treatment
+ */
+ void SetIgnoreFaces(in SMESH::long_array faceIDs) raises (SALOME::SALOME_Exception);
+ SMESH::long_array GetIgnoreFaces();
+
+ /*!
+ * Set faces either to exclude from treatment or to make the Viscous Layers on.
+ */
+ void SetFaces(in SMESH::long_array faceIDs,
+ in boolean toIgnore) raises (SALOME::SALOME_Exception);
+ SMESH::long_array GetFaces();
+ boolean GetIsToIgnoreFaces();
+
+ /*!
+ * Set total thickness of layers of prisms
+ */
+ void SetTotalThickness(in double thickness) raises (SALOME::SALOME_Exception);
+ double GetTotalThickness();
+
+ /*!
+ * Set number of layers of prisms
+ */
+ void SetNumberLayers(in short nb) raises (SALOME::SALOME_Exception);
+ short GetNumberLayers();
+
+ /*!
+ * Set factor (>=1.0) of growth of layer thickness towards inside of mesh
+ */
+ void SetStretchFactor(in double factor) raises (SALOME::SALOME_Exception);
+ double GetStretchFactor();
+
+ void SetMethod( in VLExtrusionMethod how );
+ VLExtrusionMethod GetMethod();
+ };
+
+ /*!
+ * interface of "Viscous Layers 2D" hypothesis.
+ * This hypothesis specifies parameters of layers of quadrilaterals to build
+ * near mesh boundary. This hypothesis can be used by several 2D algorithms:
+ * Mefisto, Quadrangle (mapping), NETGEN, BLSURF
+ */
+ interface StdMeshers_ViscousLayers2D : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set edges to exclude from treatment
+ */
+ void SetIgnoreEdges(in SMESH::long_array edgeIDs) raises (SALOME::SALOME_Exception);
+ SMESH::long_array GetIgnoreEdges();
+
+ /*!
+ * Set edges either to exclude from treatment or to make the Viscous Layers on.
+ */
+ void SetEdges(in SMESH::long_array edgeIDs,
+ in boolean toIgnore) raises (SALOME::SALOME_Exception);
+ SMESH::long_array GetEdges();
+ boolean GetIsToIgnoreEdges();
+
+ /*!
+ * Set total thickness of layers of prisms
+ */
+ void SetTotalThickness(in double thickness) raises (SALOME::SALOME_Exception);
+ double GetTotalThickness();
+
+ /*!
+ * Set number of layers of prisms
+ */
+ void SetNumberLayers(in short nb) raises (SALOME::SALOME_Exception);
+ short GetNumberLayers();
+
+ /*!
+ * Set factor (>=1.0) of growth of layer thickness towards inside of mesh
+ */
+ void SetStretchFactor(in double factor) raises (SALOME::SALOME_Exception);
+ double GetStretchFactor();
+ };
+
+ /*!
+ * interface of "Body fitting Parameters" hypothesis.
+ * This hypothesis specifies
+ * - Size threshold
+ * - Definition of the Cartesian grid
+ * - Direction of grid axes
+ */
+ interface StdMeshers_CartesianParameters3D : SMESH::SMESH_Hypothesis
+ {
+ /*!
+ * Set size threshold. A polyhedral cell got by cutting an initial
+ * hexahedron by geometry boundary is considered small and is removed if
+ * it's size is \a threshold times less than the size of the initial hexahedron.
+ * threshold must be > 1.0
+ */
+ void SetSizeThreshold(in double threshold) raises (SALOME::SALOME_Exception);
+ double GetSizeThreshold();
+
+ /*!
+ * \brief Return true if the grid is defined by spacing functions and
+ * not by node coordinates in given direction (X==0,...)
+ */
+ boolean IsGridBySpacing(in short axis);
+
+ /*!
+ * Set coordinates of nodes along an axis (countered from zero)
+ */
+ void SetGrid(in SMESH::double_array coords,
+ in short axis) raises (SALOME::SALOME_Exception);
+ SMESH::double_array GetGrid(in short axis) raises (SALOME::SALOME_Exception);
+
+ /*!
+ * \brief Set grid spacing along an axis
+ * \param spaceFunctions - functions defining spacing values at given point on axis
+ * \param internalPoints - points dividing a grid into parts along an axis
+ * \param axis - index of an axis counterd from zero, i.e. 0==X, 1==Y, 2==Z
+ *
+ * Parameter t of spaceFunction f(t) is a position [0,1] withing bounding box of
+ * the shape to mesh or withing an interval defined by internal points
+ */
+ void SetGridSpacing(in SMESH::string_array spaceFunctions,
+ in SMESH::double_array internalPoints,
+ in short axis) raises (SALOME::SALOME_Exception);
+
+ void GetGridSpacing(out SMESH::string_array spaceFunctions,
+ out SMESH::double_array internalPoints,
+ in short axis) raises (SALOME::SALOME_Exception);
+ /*!
+ * Set custom direction of axes
+ */
+ void SetAxesDirs(in SMESH::DirStruct x,
+ in SMESH::DirStruct y,
+ in SMESH::DirStruct z ) raises (SALOME::SALOME_Exception);
+ void GetAxesDirs(out SMESH::DirStruct x,
+ out SMESH::DirStruct y,
+ out SMESH::DirStruct z );
+ /*!
+ * Set/unset a fixed point, at which a node will be created provided that grid
+ * is defined by spacing in all directions
+ */
+ void SetFixedPoint(in SMESH::PointStruct p, in boolean toUnset);
+ boolean GetFixedPoint(out SMESH::PointStruct p);
+
+ /*!
+ * Enables implementation of geometrical edges into the mesh. If this feature
+ * is disabled, sharp edges of the shape are lost ("smoothed") in the mesh if
+ * they don't coincide with the grid lines
+ */
+ void SetToAddEdges(in boolean toAdd);
+ boolean GetToAddEdges();
+
+ /*!
+ * Returns axes at which a number of generated hexahedra is maximal
+ */
+ void ComputeOptimalAxesDirs(in GEOM::GEOM_Object shape,
+ in boolean isOrthogonal,
+ out SMESH::DirStruct x,
+ out SMESH::DirStruct y,
+ out SMESH::DirStruct z )
+ raises (SALOME::SALOME_Exception);
+
+ /*!
+ * \brief Computes node coordinates by spacing functions
+ * \param x0 - lower coordinate
+ * \param x1 - upper coordinate
+ * \param spaceFuns - space functions
+ * \param points - internal points
+ * \param axisName - e.g. "X"
+ * \return the computed coordinates
+ */
+ SMESH::double_array ComputeCoordinates(in double x0,
+ in double x1,
+ in SMESH::string_array spaceFuns,
+ in SMESH::double_array points,
+ in string axisName )
+ raises (SALOME::SALOME_Exception);
+ };
+
/*!
* StdMeshers_SegmentAroundVertex_0D: interface of "SegmentAroundVertex" algorithm
*/
{
};
+ /*!
+ * StdMeshers_QuadFromMedialAxis_1D2D: interface of "Quadrangle (Medial Axis Projection)" algorithm
+ */
+ interface StdMeshers_QuadFromMedialAxis_1D2D : SMESH::SMESH_2D_Algo
+ {
+ };
+
/*!
* StdMeshers_Hexa_3D: interface of "Hexahedron (i,j,k)" algorithm
*/
{
};
+ /*!
+ * StdMeshers_Projection_1D2D: interface of "Projection 1D-2D" algorithm
+ */
+ interface StdMeshers_Projection_1D2D : SMESH::SMESH_2D_Algo
+ {
+ };
+
/*!
* StdMeshers_Projection_1D: interface of "Projection 1D" algorithm
*/
{
};
+ /*!
+ * StdMeshers_RadialQuadrangle_1D2D: interface of "Radial quadrangle" algorithm
+ */
+ interface StdMeshers_RadialQuadrangle_1D2D : SMESH::SMESH_2D_Algo
+ {
+ };
+
+ /*!
+ * StdMeshers_Import_1D2D: interface of "Use existing 2D elements" algorithm
+ */
+ interface StdMeshers_Import_1D2D : SMESH::SMESH_2D_Algo
+ {
+ };
+ /*!
+ * StdMeshers_Import_1D: interface of "Use existing 1D elements" algorithm
+ */
+ interface StdMeshers_Import_1D : SMESH::SMESH_1D_Algo
+ {
+ };
+ /*!
+ * StdMeshers_Cartesian_3D: interface of "Body fitting" algorithm
+ */
+ interface StdMeshers_Cartesian_3D : SMESH::SMESH_3D_Algo
+ {
+ };
+
};
#endif
