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 |
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 |
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 |
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 |
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 |
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 |