You are here: Popular Formats > XML (Extensible Markup Language) Reader/Writer > xfMap > Feature Mapping Rules > xml-circle

xml-circle

This is a non-composite and composite builder that constructs a circular arc geometry. The following circle definition is supported:

  1. A circle defined by three distinct control points that are coincident to the circle.
  2. A circle defined by a center point and a radius.

builder type: non-composite

geometry constructed: arc geometry

data parameters:

Data Name

Value

Required/
Optional

data-string
  1. The coordinate data string denoting the coincident points in the order of circle traversal.
  2. The coordinate data string denoting the circle's center point.

Range: String

Required
radius

The radius of the circle.

Range: A positive, real number

Default: There are no default values.

 Required, if the data-string specifies the center point of the circle.

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

dimension

The dimension of the coordinates.

Range: String representing a positive integer, or the “implicit” literal, which forces the dimension to be automatically determined even if axis-order is specified.

Default: When not specified the dimension will be automatically determined.

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

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

name

Specifies the geometry’s name.

Range: String

Optional