beam - PLAXIS 3D Input commands documentation

beam bm

Adds beam features to lines.
Adds beam features to one or more existing lines in the geometry.
beam Line_1 Adds a beam feature to Line_1.
beam Line_2 Line_3 Adds beam features to Line_2 and Line_3.
beam (Line_6 Line_4) Adds beam features to Line_6 and Line_4.
beam Group_1 Adds beam features to all lines in Group_1. Group_1 should consist of only lines.
<{1,...}: <Line'|Polycurve'>>'
{1,...} 1 Sequence of one or more lines
Line Line object reference Name of the line to which a beam feature should be added
Polycurve Polycurve object reference Name of the polycurve to which a beam feature should be added
Mode Target
Geometry Global
{1,...} Beam
Creates a line between two points (which may either exist or will be created) and adds a beam feature to it.
beam Point_1 (5 6 7) Creates a new line between Point_1 and a new point with coordinates (5, 6, 7) and adds a beam feature to it.
beam Point_1 Point_4 Creates a new line between Point_1 and Point_4 and adds a beam feature to it.
beam (1 4 0) (6 5 8) Creates a new line between two new points with coordinates (1, 4, 0) and (6, 5, 8) and adds a beam feature to it.
<Point'|<Coords: Number' Number' Number'>'> <Point'|<Coords: Number' Number' Number'>'>
Point Point object reference Name of the start point of the beam
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Point Point object reference Name of the end point of the beam
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Mode Target
Geometry Global
{0..2} Point {1} Line {1} Beam
Creates lines between three or more points (which may either exist or will be created) and adds beam features to them.
beam Point_1 (5.1 6.4 7.2) Point_3 Creates two lines, one between Point_1 and a new point with coordinates (5.1, 6.4, 7.2) and one between the new point and Point_3, and adds beam features to both lines.
<Point{3,...}: <Point'|<Coords: Number' Number' Number'>'>>
Point{3,...} 3 Sequence of three or more points
Point Point object reference Names of the points between which the beam should be created
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Mode Target
Geometry Global
{0,...} Point {2,...} Line {2,...} Beam
Creates one or more lines by either giving absolute coordinates or relative coordinates, by giving the angles with respect to the xz- and the xy-plane and a length or a vector describing the direction and a length and adds beam features to them.
beam 1 2 0 "relative" 3 4 8 Creates a line from a new point with coordinates (1, 2, 0) to another new point which is 3 in the x-, 4 in the y- and 8 in the z-direction from the first point at (4, 6, 8) and adds a beam feature to it.
beam Point_1 "relative" 3 4 8 -5 -9 10 "angles" 0 30 16 Creates a line from Point_1 (1, 2, 0) to a new point which is 3 in the x-, 4 in the y- and 8 in the z-direction from the first point at (4, 6, 8). From that new point a line is created to another new point which is -5 in the x-, -9 in the y- and 10 in the z-direction from the previous point at (-1, -3, 18). From that point a new line is created which has an angle of 0 degrees with respect to the xy-plane, an angle of 30 degrees with respect to the xz-plane and a length of 16, this line ends at coordinates (12.86, -3, 26). Adds beam features to all lines.
beam (1 2 3) "angles" 45 50 10 "absolute" (4 5 6) Creates a line from a new point with coordinates (1, 2, 3) which has an angle of 45 degrees with respect to the xy-plane, an angle of 50 degrees with respect to the xz-plane and a length of 10. Then creates a line from the end point of the first line to a new point with coordinates (4, 5, 6) and adds beam features to all lines.
beam Point_2 "angles" 90 0 Volume_1 Creates a line from Point_2 with an angle of 90 degrees with respect to the xy-plane, an angle of 0 degrees with respect to the xz-plane, snaps it to Volume_1 and adds beam features to the line.
<Point'|<Coords: Number' Number' Number'>'> <{1,...}: <<<Text: "absolute"> <Point{1,...}: <Point'|<Coords: Number' Number' Number'>'>>>|<<Text: "angles"> <{1,...}: <Number'(°) Number'(°) <Number'|<Line'|Volume'|BoreholeVolume'|StructuralSurface'>>>'>>|<<Text: "relative"> <Coords{1,...}: <Coords: Number' Number' Number'>'>>|<<Text: "vector"> <{1,...}: <<Coords: Number' Number' Number'>' <Number'|<Line'|Volume'|BoreholeVolume'|StructuralSurface'>>>'>'>>>
Point Point object reference Point from which the beam must start
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
{1,...} 1 Sequence of one or more line sub-commands
Text "absolute" Create a beam by giving absolute coordinates
Point{1,...} 1 Sequence of one or more points
Point Point object reference Point where the beam ends
Coords Coordinates of the point where the beam ends
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Text "angles" Create one or more beams by giving two angles and a length per beam
{1,...} 1 Sequence of one or more specifications of angles and length of the beam or object to which the beam should snap
Number Angle Angle of the beam with respect to the xy-plane
Number Angle Angle of the beam with respect to the xz-plane
Number Length Length of the beam that should be created
Line Line object reference Name of the line to which the created beam should snap
Volume Volume object reference Name of the volume to which the created beam should snap
BoreholeVolume Soil volume object reference Name of the soil volume to which the created beam should snap
StructuralSurface Surface object reference Name of the surface to which the created beam should snap
Text "relative" Create one or more beams by giving relative coordinates
Coords{1,...} 1 Sequence of one or more coordinates
Coords Coordinates of the point, relative to the starting point, where the beam ends
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Text "vector" Create one or more beams by giving a vector and a length or object to which the beam should snap per beam
{1,...} 1 Sequence of one or more vectors and length of the beam or object to which the beam should snap
Coords Vector that defines the direction of the beam that should be created
Number x x-value
Number y y-value
Number z z-value
Number Length Length of the beam that should be created
Line Line object reference Name of the line to which the created beam should snap
Volume Volume object reference Name of the volume to which the created beam should snap
BoreholeVolume Soil volume object reference Name of the soil volume to which the created beam should snap
StructuralSurface Surface object reference Name of the surface to which the created beam should snap
Mode Target
Geometry Global
{0,...} Point {1,...} Line {1,...} Beam
Adds beam features to one or more existing lines in the geometry and directly sets their properties.
beam Line_1 "Material" BeamMat_1 Adds a beam feature to Line_1 and sets the material to BeamMat_1.
beam (Line_2 Line_3) "Material" BeamMat_1 Adds beam features to Line_2 and Line_3 and sets the material to BeamMat_1 for both beams.
<{1,...}: <Line'|Polycurve'>>'<PropValue{1,...}: <PropValue: Text' Any>'>
{1,...} 1 Sequence of one or more lines
Line Line object reference Name of the line to which a beam feature should be added
Polycurve Polycurve object reference Name of the polycurve to which a beam feature should be added
PropValue{1,...} 1 Sequence of one or more property-value pairs
PropValue Property-value pair
Text Property name Property name
Any Property value Property value
Mode Target
Geometry Global
{1,...} Beam
Creates a line between two points (which may either exist or will be created), adds a beam feature to it and directly sets its properties.
beam Point_1 (5 6 7) "Material" BeamMat_1 Creates a new line between Point_1 and a new point with coordinates (5, 6, 7), adds a beam feature to it and sets the material to BeamMat_1.
<Point'|<Coords: Number' Number' Number'>'> <Point'|<Coords: Number' Number' Number'>'><PropValue{1,...}: <PropValue: Text' Any>'>
Point Point object reference Name of the start point of the beam
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Point Point object reference Name of the end point of the beam
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
PropValue{1,...} 1 Sequence of one or more property-value pairs
PropValue Property-value pair
Text Property name Property name
Any Property value Property value
Mode Target
Geometry Global
{0..2} Point {1} Line {1} Beam
Creates lines between three or more points (which may either exist or will be created), adds beam features to them and directly sets their properties.
beam Point_1 (5.1 6.4 7.2) Point_3 "Material" BeamMat_1 Creates two lines, one between Point_1 and a new point with coordinates (5.1, 6.4, 7.2) and one between the new point and Point_3, adds beam features to both lines and sets the material to BeamMat_1 for both beams.
<Point{3,...}: <Point'|<Coords: Number' Number' Number'>'>><PropValue{1,...}: <PropValue: Text' Any>'>
Point{3,...} 3 Sequence of three or more points
Point Point object reference Names of the points between which the beam should be created
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
PropValue{1,...} 1 Sequence of one or more property-value pairs
PropValue Property-value pair
Text Property name Property name
Any Property value Property value
Mode Target
Geometry Global
{0,...} Point {2,...} Line {2,...} Beam
Creates one or more lines by either giving absolute coordinates or relative coordinates, by giving the angles with respect to the xz- and the xy-plane and a length or a vector describing the direction and a length, adds beam features to them and directly sets their properties.
beam 1 2 0 "relative" 3 4 8 "Material" BeamMat_1 Creates a line from a new point with coordinates (1, 2, 0) to another new point which is 3 in the x-, 4 in the y- and 8 in the z-direction from the first point at (4, 6, 8), adds a beam feature to it and sets the material to BeamMat_1.
<Point'|<Coords: Number' Number' Number'>'> <{1,...}: <<<Text: "absolute"> <Point{1,...}: <Point'|<Coords: Number' Number' Number'>'>>>|<<Text: "angles"> <{1,...}: <Number'(°) Number'(°) <Number'|<Line'|Volume'|BoreholeVolume'|StructuralSurface'>>>'>>|<<Text: "relative"> <Coords{1,...}: <Coords: Number' Number' Number'>'>>|<<Text: "vector"> <{1,...}: <<Coords: Number' Number' Number'>' <Number'|<Line'|Volume'|BoreholeVolume'|StructuralSurface'>>>'>'>>><PropValue{1,...}: <PropValue: Text' Any>'>
Point Point object reference Point from which the beam must start
Coords Coordinates
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
{1,...} 1 Sequence of one or more line sub-commands
Text "absolute" Create a beam by giving absolute coordinates
Point{1,...} 1 Sequence of one or more points
Point Point object reference Point where the beam ends
Coords Coordinates of the point where the beam ends
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Text "angles" Create one or more beams by giving two angles and a length per beam
{1,...} 1 Sequence of one or more specifications of angles and length of the beam or object to which the beam should snap
Number Angle Angle of the beam with respect to the xy-plane
Number Angle Angle of the beam with respect to the xz-plane
Number Length Length of the beam that should be created
Line Line object reference Name of the line to which the created beam should snap
Volume Volume object reference Name of the volume to which the created beam should snap
BoreholeVolume Soil volume object reference Name of the soil volume to which the created beam should snap
StructuralSurface Surface object reference Name of the surface to which the created beam should snap
Text "relative" Create one or more beams by giving relative coordinates
Coords{1,...} 1 Sequence of one or more coordinates
Coords Coordinates of the point, relative to the starting point, where the beam ends
Number x x-coordinate
Number y y-coordinate
Number z z-coordinate
Text "vector" Create one or more beams by giving a vector and a length or object to which the beam should snap per beam
{1,...} 1 Sequence of one or more vectors and length of the beam or object to which the beam should snap
Coords Vector that defines the direction of the beam that should be created
Number x x-value
Number y y-value
Number z z-value
Number Length Length of the beam that should be created
Line Line object reference Name of the line to which the created beam should snap
Volume Volume object reference Name of the volume to which the created beam should snap
BoreholeVolume Soil volume object reference Name of the soil volume to which the created beam should snap
StructuralSurface Surface object reference Name of the surface to which the created beam should snap
PropValue{1,...} 1 Sequence of one or more property-value pairs
PropValue Property-value pair
Text Property name Property name
Any Property value Property value
Mode Target
Geometry Global
{0,...} Point {1,...} Line {1,...} Beam