You are here: Start » AVL.NET » Function Reference » Surface » Surface Features » AVL.SurfaceProfileAlongPath

AVL.SurfaceProfileAlongPath

Creates a series of segments across the input path, measures the average surface height on each of the segments, and creates the final profile from those values.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void SurfaceProfileAlongPath
(
	AvlNet.ScanMapState ioState,
	AvlNet.Surface inSurface,
	AvlNet.Path inScanPath,
	AvlNet.CoordinateSystem2D? inScanPathAlignment,
	float? inSamplingStep,
	int inScanWidth,
	AvlNet.InterpolationMethod inSurfaceInterpolation,
	int? inMaxInterpolationLength,
	float inSmoothingStdDev,
	AvlNet.Profile outProfile,
	AvlNet.Path outPath,
	AvlNet.Path outAlignedScanPath,
	IList<AvlNet.Path> diagSamplingPoints
)

Parameters

Name Type Range Default Description
ioStateAvlNet.ScanMapState
inSurfaceAvlNet.SurfaceInput surface.
inScanPathAvlNet.PathPath along which the profile is extracted.
inScanPathAlignmentAvlNet.CoordinateSystem2D?Adjusts the scan path to the position of the inspected object. Default value: atl::NIL.
inSamplingStepfloat?<0.0f, INF>Distance between consecutive sampling points on the scan path; if Nil, the bigger of surface X and Y scales is chosen. Default value: atl::NIL.
inScanWidthint<1, INF>5Width of the scan field. Default value: 5.
inSurfaceInterpolationAvlNet.InterpolationMethodBilinearInterpolation method used for extraction of surface points. Default value: Bilinear.
inMaxInterpolationLengthint?Maximal number of consecutive not existing profile points. Default value: atl::NIL.
inSmoothingStdDevfloat<0.0f, INF>0.6fStandard deviation of the gaussian smoothing applied to the extracted profile. Default value: 0.6f.
outProfileAvlNet.ProfileThe resulting profile of the surface height.
outPathAvlNet.PathThe path consisting of the points from which the resulting profile is extracted.
outAlignedScanPathAvlNet.PathPath along which the scan is performed.
diagSamplingPointsSystem.Collections.Generic.IList<AvlNet.Path>Array of paths each one containing the sampling points that contributed to a single value of the extracted profile; in the image coordinate system.

Errors

List of possible exceptions:

Error type Description
DomainError Non-positive sampling step on input in SurfaceProfileAlongPath.
DomainError Non-positive scale on input in SurfaceProfileAlongPath.

Function Overrides

See also