Dyna_segment
geometric-functions dyna_segment
syntax
- dyna_segment(startpoint, endpoint, distance)
- dyna_segment_with_ends(startpoint, endpoint, distance)
definition
- dyna_segment(startpoint, endpoint, distance) results in a new domain-unit, with four generated subitems (see description) :
- Point: the generated first point data items of the segment
- NextPoint: the generated last point data items of the segment
- SequenceNr: the relation between each point and it’s segment.
- Ordinal: the order of the points in each segment.
The dyna_segment function results in a set of entries with the segments generated by the dyna_segment function. The number or rows of the dyna_segment is 1 less than the dyna_point function.
Points are generated at segments, configured by the startpoint and nextpoint data items. In the figure above the light green lines are the segments, the dark green dots the dyna_segments.
The distance between the points is configured with the distance parameter or literal.
The dyna_segment_with_ends functions like the dyna_segment function, only the end coordinates are always added to the resulting attributes.
applies to
- startpoint and endpoint data items with fpoint or dpoint value-type
- literal or parameter dist with float32 or float64 value type
conditions
The domain unit and values-unit of the startpoint and endpoint arguments must match.
see also
example
unit<uint32> CalcSegment := dyna_segment(startpoint, endpoint, 5f);
| startpoint | endpoint |
|---|---|
| {13732, 371391} | {13738, 371384} |
| {13738, 371384} | {13746, 371378} |
| {13746, 371378} | {13758, 371369} |
| {13758, 371369} | {13764, 371364} |
| {13764, 371364} | {13768, 371360} |
domain Segment, nr of rows = 5
| point | NextPoint | SequenceNr | Ordinal |
|---|---|---|---|
| {13735.3, 371387} | {13732, 371391} | 0 | 0 |
| {13738.6, 371384} | {13735.3, 371387} | 1 | 0 |
| {13742.6, 371381} | {13738.6, 371384} | 1 | 1 |
| {13746.6, 371378} | {13742.6, 371378} | 2 | 0 |
| {13750.6, 371375} | {13746.6, 371378} | 2 | 1 |
| {13754.6, 371372} | {13750.6, 371375} | 2 | 2 |
| {13758.6, 371369} | {13754.6, 371372} | 3 | 0 |
| {13762.4, 371365} | {13758.6, 371369} | 3 | 1 |
| {13766.1, 371362} | {13762.4, 371365} | 4 | 0 |
domain CalcSegment, nr of rows = 9