Salome HOME
help example mistake
[modules/geom.git] / doc / salome / gui / GEOM / input / tui_basic_geom_objs.doc
index d9c30a23b4bbdf7bc79237a996866c6cf340823a..5e1f733128b81a9643d67209b1c41b3ba834e5d1 100644 (file)
@@ -17,9 +17,19 @@ px = geompy.MakeVertex(100., 0., 0.)
 py = geompy.MakeVertex(0., 100., 0.)
 pz = geompy.MakeVertex(0., 0., 100.)
 
-# create a curve and a vertex on it
+# create a curve and a vertices on it
 Arc = geompy.MakeArc(py, pz, px)
+# create vertex by parameter
 p_on_arc = geompy.MakeVertexOnCurve(Arc, 0.25)
+#create vertex by point projection
+p_on_arc2 = geompy.MakeVertexOnCurveByCoord(Arc, 100, -10, 10)
+
+# create a face and vertices on it
+Add_line = geompy.MakeLineTwoPnt(px, py)
+arc_face = geompy.MakeFaceWires([Arc, Add_line], 1)
+p_on_face1 = geompy.MakeVertexOnSurface(arc_face, 0.5, 0.5)
+p_on_face2 = geompy.MakeVertexOnSurfaceByCoord(Face_1, 35, 35, 35)
+
 
 # add objects in the study
 id_p0       = geompy.addToStudy(p0,   "Vertex 0")
@@ -28,7 +38,10 @@ id_px       = geompy.addToStudy(px,   "Vertex X")
 id_py       = geompy.addToStudy(py,   "Vertex Y")
 id_pz       = geompy.addToStudy(pz,   "Vertex Z")
 id_Arc      = geompy.addToStudy(Arc,  "Arc")
-id_p_on_arc = geompy.addToStudy(p_on_arc, "Vertex on Arc")
+id_p_on_arc = geompy.addToStudy(p_on_arc, "Vertex on Arc by parameter")
+id_p_on_arc2 = geompy.addToStudy(p_on_arc, "Vertex on Arc by point projection")
+id_p_on_face1 = geompy.addToStudy(p_on_face1, "Vertex on face by parameter")
+id_p_on_face2 = geompy.addToStudy(p_on_face2, "Vertex on face by point projection")
 
 # display vertices
 gg.createAndDisplayGO(id_p0)
@@ -116,21 +129,65 @@ gg = salome.ImportComponentGUI("GEOM")
 
 # create vertices
 p0 = geompy.MakeVertex(0., 0., 0.)
-p50 = geompy.MakeVertex(50., 50., 50.)
+p1 = geompy.MakeVertex(50., 50., 50.)
+p2 = geompy.MakeVertex(0., 50., 0.)
 
-# create a vector from two points
-vector  = geompy.MakeVector(p0, p50)
+# create a normal vector from two points
+normal  = geompy.MakeVector(p0, p1)
+
+# create a major axis vector from two points
+major   = geompy.MakeVector(p0, p2)
 
 # create an ellipse from a point, a vector and radiuses
-ellipse = geompy.MakeEllipse(p50, vector, 50, 25)
+ellipse1 = geompy.MakeEllipse(p1, normal, 50, 25)
+
+# create an ellipse from a point, a normal vector, radiuses and a major axis vector
+ellipse2 = geompy.MakeEllipse(p1, normal, 50, 25, major)
 
 # add objects in the study
-id_vector  = geompy.addToStudy(vector, "Vector")
-id_ellipse = geompy.addToStudy(ellipse,"Ellipse")
+id_normal   = geompy.addToStudy(normal,   "Normal")
+id_major    = geompy.addToStudy(major,    "Major Axis")
+id_ellipse1 = geompy.addToStudy(ellipse1, "Ellipse 1")
+id_ellipse2 = geompy.addToStudy(ellipse2, "Ellipse 2")
 
 # display the ellipse and its normal vector
-gg.createAndDisplayGO(id_vector)
-gg.createAndDisplayGO(id_ellipse)
+gg.createAndDisplayGO(id_normal)
+gg.createAndDisplayGO(id_major)
+gg.createAndDisplayGO(id_ellipse1)
+gg.createAndDisplayGO(id_ellipse2)
+\endcode
+
+\anchor tui_creation_arc
+<br><h2>Creation of an Arc</h2>
+
+\code
+import geompy
+import salome
+gg = salome.ImportComponentGUI("GEOM")
+
+# create vertices
+p0 = geompy.MakeVertex(0., 0., 0.)
+p1 = geompy.MakeVertex(100., 0., 0.)
+p2 = geompy.MakeVertex(50., 0., 50.)
+
+# create an arc from a three points
+arc1 = geompy.MakeArc(p0, p1, p2)
+
+# create an arc from a center point, a start point and end point
+arc2 = geompy.MakeArcCenter(p0, p1, p2, 1)
+
+# create an arc from a center point, a major point and minor point
+arc3 = geompy.MakeArcOfEllipse(p0, p1, p2)
+
+# add objects in the study
+id_arc1 = geompy.addToStudy(arc1, "Arc 1")
+id_arc2 = geompy.addToStudy(arc2, "Arc 2")
+id_arc3 = geompy.addToStudy(arc3, "Arc 3")
+
+# display the arcs
+gg.createAndDisplayGO(id_arc1)
+gg.createAndDisplayGO(id_arc2)
+gg.createAndDisplayGO(id_arc3)
 \endcode
  
 \anchor tui_creation_curve
@@ -155,7 +212,7 @@ polyline = geompy.MakePolyline([p0, p1, p2, p3, p4])
 bezier = geompy.MakeBezier([p0, p1, p2, p3, p4])
 
 #create a b-spline curve from a list of points
-interpol = geompy.MakeInterpol([p0, p1, p2, p3, p4])
+interpol = geompy.MakeInterpol([p0, p1, p2, p3, p4], False)
 
 # add objects in the study
 id_p0       = geompy.addToStudy(p0,       "Point1")
@@ -224,8 +281,9 @@ p3 = geompy.MakeVertex(200., 200., 200.)
 p4 = geompy.MakeVertex(100., 100.,   0.)
 p5 = geompy.MakeVertex(0.  , 100.,   0.)
 
-# create a vector from the given components
-vector = geompy.MakeVectorDXDYDZ(100., 100., 100.)
+# create a vectors from the given components
+vector1 = geompy.MakeVectorDXDYDZ(100., 100., 100.)
+vector2 = geompy.MakeVectorDXDYDZ(-100., 0., 100.)
 
 # create a vector from two points
 vector_arc = geompy.MakeVector(p2, p5)
@@ -241,8 +299,12 @@ isPlanarWanted = 1
 face = geompy.MakeFace(wire, isPlanarWanted)
 trimsize = 1000.
 
+# create a Local Coordinate System
+
+LCS = geompy.MakeMarker(100., 100., 101., 1, 0, 0, 0, 1, 0)
+
 # create a plane from a point, a vector and a trimsize
-plane1 = geompy.MakePlane(p1, vector, trimsize)
+plane1 = geompy.MakePlane(p1, vector1, trimsize)
 
 # create a plane from three points and a trimsize
 plane2 = geompy.MakePlaneThreePnt(p1, p2, p3, trimsize)
@@ -250,23 +312,78 @@ plane2 = geompy.MakePlaneThreePnt(p1, p2, p3, trimsize)
 # create a plane from the given face
 plane3 = geompy.MakePlaneFace(face, trimsize)
 
+# create a plane from two vectors and a trimsize
+plane4 = geompy.MakePlane2Vec(vector1, vector2, trimsize)
+
+# create a plane with the Local Coordinate System and a trimsize
+plane5 = geompy.MakePlaneLCS(LCS, trimsize, 1)
+
 # add objects in the study
 id_face   = geompy.addToStudy(face,  "Face")
 id_plane1 = geompy.addToStudy(plane1,"Plane1")
 id_plane2 = geompy.addToStudy(plane2,"Plane2")
 id_plane3 = geompy.addToStudy(plane3,"Plane3")
+id_plane4 = geompy.addToStudy(plane4,"Plane4")
+id_plane5 = geompy.addToStudy(plane5,"Plane5")
 
 # display the points and the vectors
 gg.createAndDisplayGO(id_face)
 gg.createAndDisplayGO(id_plane1)
 gg.createAndDisplayGO(id_plane2)
 gg.createAndDisplayGO(id_plane3)
+gg.createAndDisplayGO(id_plane4)
+gg.createAndDisplayGO(id_plane5)
 gg.setDisplayMode(id_plane1,1)
 gg.setTransparency(id_plane1,0.5)
 gg.setDisplayMode(id_plane2,1)
 gg.setTransparency(id_plane2,0.5)
 gg.setDisplayMode(id_plane3,1)
-gg.setTransparency(id_plane3,0.5) 
+gg.setTransparency(id_plane3,0.5)
+gg.setDisplayMode(id_plane4,1)
+gg.setTransparency(id_plane4,0.5)
+gg.setDisplayMode(id_plane5,1)
+gg.setTransparency(id_plane5,0.5)
+\endcode
+
+\anchor tui_creation_lcs
+<br><h2>Creation of a Local Coordinate System</h2>
+\code
+import GEOM
+import geompy
+import math
+import SALOMEDS
+
+#Create vertexes, vectors and shapes to construct local CS
+Vertex_1 = geompy.MakeVertex(50, 50, 50)
+Vertex_2 = geompy.MakeVertex(70, 70, 70)
+Vertex_3 = geompy.MakeVertex(0, 0, 0)
+Vector_X = geompy.MakeVectorDXDYDZ(50, 0, 0)
+Vector_Y = geompy.MakeVectorDXDYDZ(0, 50, 0)
+Face_1 = geompy.MakeFaceHW(100, 100, 1)
+Box_1 = geompy.MakeBoxTwoPnt(Vertex_1, Vertex_2)
+
+#Construct local CS by manual definition
+LocalCS_1 = geompy.MakeMarker(0, 0, 0, 1, 0, 0, 0, 1, 0)
+
+#Construct local CS by center point and two vectors (X and Y directions)
+LocalCS_2 = geompy.MakeMarkerPntTwoVec(Vertex_3, Vector_X, Vector_Y)
+
+#Construct local CS from shape orientation
+LocalCS_FACE = geompy.MakeMarkerFromShape(Face_1)
+LocalCS_BOX = geompy.MakeMarkerFromShape(Box_1)
+
+#Add created object to study
+geompy.addToStudy( Face_1, "Face_1" )
+geompy.addToStudy( Vertex_1, "Vertex_1" )
+geompy.addToStudy( Vertex_2, "Vertex_2" )
+geompy.addToStudy( Box_1, "Box_1" )
+geompy.addToStudy( Vertex_3, "Vertex_3" )
+geompy.addToStudy( Vector_X, "Vector_X" )
+geompy.addToStudy( Vector_Y, "Vector_Y" )
+geompy.addToStudy( LocalCS_1, "LocalCS_1" )
+geompy.addToStudy( LocalCS_2, "LocalCS_3" )
+geompy.addToStudy( LocalCS_FACE, "LocalCS_FACE" )
+geompy.addToStudy( LocalCS_BOX, "LocalCS_BOX" )
 \endcode
 
-*/
\ No newline at end of file
+*/