xml-clothoid

This is a non-composite/composite builder that constructs a clothoid geometry. The following clothoid definition is supported:

builder type: non-composite/composite, accepts point geometries in composite mode

geometry constructed: clothoid geometry

data parameters:

Data Name	Value	Required/ Optional
data-string	The coordinate data string denotes the start, and (optionally) end and intersection points. The coordinate data may be received as point geometries. These points can be named or unnamed. The named point geometries can also be received in any order: their names must be one of “start, end”, or “pi”. If the point geometries are unnamed, then the order of the points is significant: the first point received is assumed as the start point, the next point as the end point, and the last point as the point of intersection. Use the “point-order” data parameter to change this. Notes: The names are case-insensitive. “poi” may be substituted for “pi”.	Optional if the points are to be passed in as point geometries; otherwise Required
point-order	Specifies which order points should be received in when they are unnamed. Range: start-end-pi \| start-pi-end Default: start-end-pi	Optional
start-curvature / start-radius	The curvature at the start of the clothoid must be specified as either a curvature (start-curvature) or a radius (start-radius). Range: A positive real number. Default: There are no default values.	Required
end-curvature / end-radius	The curvature at the end of the clothoid must be specified as either a curvature (end-curvature) or a radius (end-radius).	Required
length	The length of the clothoid.	Required
start-angle	The angle that aligns with the start-tangent of the clothoid.	Optional, if POI is specified, otherwise required
start-angle_uom	Specifies whether the start angle is in degrees or radians. Range: deg \| degree \| rad \| radians Default: deg	Optional
direction	Specifies the traversal direction from the start to the end point of the elliptical arc. Range: cw \| ccw Default: There are no default values	Optional
axis-order	Indicates the axis for a coordinate. Range: A permutation of the numbers 1..N, where N is the number of dimensions. Each number is separated by a comma “,”. Default: “1,2,...,N”	Optional; used only if data-string is specified
axis-separator	The string separating each axis of a coordinate in the `data-string`. Range: String \| “whitespace” – this includes the tab, newline, and space characters. Default: “,”	Optional; used only if data-string is specified
coord-separator	The string separating each coordinate in the `data-string`. Range: String Default: “whitespace” – this includes the tab, newline, and space characters.	Optional; used only if data-string is specified
allow-mixed-dimensions	This allows the datastring to process coordinates with differing dimensions. Range: true, false Default: false	Optional; used only if data-string is specified
decimal	The string representing the decimal point for each real number in the data-string. Range: String Default: “.”	Optional; used only if data-string is specified
coordinate-system	Specifies the coordinate system name. If the expression sequence for the coordinate-system evaluates to the empty string, then the coordinate system for the feature being built will not be set. Range: String	Optional
demote-incomplete-geometry	This optional data parameter allows the xml-clothoid geometry builder to return a non-geometrical object when no data-string is given or when the value of the data-string is the empty string. Range: false \| true Default: false	Optional
incomplete-geometry-traits	This optional data parameter takes effect only when the demote-incomplete-geometry data parameter is set to true. This parameter lists the xml-elliptical-arc data parameters that should be loaded into the demoted arc geometry as traits. For example, when this geometry builder fails to construct an arc and demote-incomplete-geometry is set to true and the value for this parameter is set to “radius direction”, then the builder will construct a null geometry with radius and direction traits. Range: whitespace-separated list of arc data parameter names Default: There are no default values.	Optional
name	Specifies the geometry’s name. Range: String	Optional