geometry edge create command


geometry edge create keyword

Primary keywords:

by-node    by-position    by-arc    by-ray

Create an edge. The following keywords are available as different methods of edge creation.

by-node i1 i2 ... <[edgecreateoptions]>

Create one or more edges by giving a series of node ID numbers. At least two ID numbers must be given, to create a single edge. If an edge already exists connecting those to nodes, no new edge will be created.

by-position v1 v2 ... <[edgecreateoptions]>

Create one or more edges by giving a series of positions. At least two positions must be given, to create a single edge. If an node already exists at that location within a relative tolerance of 1e-7, then that node will be used instead of creating a new one. If an edge already exists between those two nodes, no new edge will be created.

by-arc keyword <[edgecreateoptions]>

Create edges describing a circular arc section in space. The arc is described by the locations origin, start, and end. origin defines the center of the arc, and start defines both the starting direction and the arc radius. The end location defines the plane and sweep angle of the arc but the distance from the origin is ignored. The arc will be broken into segments linear lengths.

The following keywords control the arc definition:

end v

The end location of the arc, defines the plane of the arc and the total sweep angle. The default end location is (0,0,1).

origin v

The origin of the arc. The default origin is (0,0,0).

segments i

The number of linear segments into which the arc is divided. Each segment will be a single edge, and segments+1 nodes will be created and/or found. The default number of segments is 10.

start v

The starting position of the arc, and also defins the arc radius. The default start position is (1,0,0).

by-ray keyword <[edgecreateoptions]>

Create edges described by a starting location, a direction, and a distance. The ray may be broken into a number of segments, each of which will be a separate edge.

The following keywrods control the ray definition:

base v

The base of the ray, from which the edges will project. The default base location is (0,0,0).

direction v

The direction in which the edges will extend from the base. The length is ignored. The default direction is (1,0,0).

length f

The length of the edge(s) that will be generated. The default length is 1.0.

segments i

The number of segments that the ray will be divided into. The default segments is 1.

Block of Common Options for Edge Creation

The following keywords may be used in any edge creation keyword to add group or extra variable designations to any created edge. Note that created nodes are not modified, and existing edges that are used instead are also not modofied. The following keywords are available: by-arc, by-node, by-position and by-ray.

group s <slot slot >

Add the group name s using slot slot to all created edges. Use of the group logic is described in Group. If not specified the slot name Default is used. More than one group keyword may be given.

extra i a

Add the value a to created edges in extra variable index i. More than one extra keyword may be given.