polyline processing

polyline processing

The polyline processing module accepts a 3D polyline and can either increase or decrease the number of line segments of the polyline. A splining algorithm smooths the line trajectory once the number of points are specified. This module is useful for applications such as a fly over application (along a polyline path drawn by the user). If the user drawn line is jagged with erratically spaced line segments, polyline processing smooths the path and creates evenly spaced line segments along the path.

Ports

DirectionNameTypeDescription
InputInput FieldFieldThe line field to use for splining or smoothing.
InputZ ScaleNumberThe factor for vertical scaling.
OutputOutput DataFieldA line field containing the smoothed or splined line.
OutputOutput ObjectRenderableA renderable object displaying the sample data.

Properties

PropertyTypeDescription
Z ScaleDoubleVertical scaling for writing lines.
Specification MethodChoice: Number Of Points, Path Step SizeThe output line segment size can be adjusted via two options. Number of Points mode allows line smoothing adjustments by specifying the number of line segments. Path Step Size mode allows smoothing adjustments by specifying the step size in the units of the input mesh.
Number Of PointsIntegerIf the Specification Method is set to Number Of Points, the total number of points in the path can be set using this control.
Path Step SizeDoubleIf the Specification Method is set to Path Step Size, the length of each path step in the units of the input mesh.
Max Path Step CountIntegerThe max number of lines to create using the Path Step Size specification method.
Resample At EndBooleanIf the Resample At End toggle is ON, the line is segmented before and after being smoothed or splined.
ToleranceDoubleThe Tolerance parameter determines how close two disjoint points must be before the two polylines are merged.
Sampling MethodChoice: Spline, Smooth, Preserve NodesThe Sampling Method allows the user to change how the polyline is created. Spline connects each point with a path determined by the gradient of the points. Smooth keeps to the original path with sharp corners smoothed using the Smoothing Percentage. Preserve Nodes keeps the same path as the input but breaks the path into smaller segments.
Smoothing OrderIntegerThe Smoothing Order determines the number of points to be used for splining. More points creates a smoother line that departs more from the original.
Smoothing PercentageDoubleThe Smoothing Percentage determines the degree of smoothing. Higher values creates a smoother line that departs more from the original.
Smoothing IterationsIntegerThe Smoothing Iterations is analogous to multiple polyline processing modules connected in series. This provides a means to further smooth erratic lines while staying close to the original points.
Translate Export By OriginBooleanThe Translate Export by Origin toggle will cause the output to be written in the user’s coordinate space. When this is turned off the output will be written around the origin.
ELF FilenameStringThis button allows the user to output the created polyline as an ELF file.