Skip to main content

line-segments

schema/objects/line-segments/2.2.0/line-segments.schema.json

A collection of lines composed of straight segments. Often the collection will be broken down into connected linear structures called strings or polylines. The Parts mechanism can be used for capturing the details of that additional structure.

segments

The vertices and indices of the segments.

vertices : Table of vertex coordinates. Columns: x, y, z.

indices : Table of 0-based indices into vertices. Each pair is a segment. Columns: n0, n1.

If the segments are organised into strings or polylines then adjacent segments will usually share an index. In those cases the indices are also often sequential. An example of the indices for four connected segments might be [(0, 1), (1, 2), (2, 3), (3, 4)]. If the segments formed a closed loop then your last pair could be (3, 0) indicating that the last vertex in the segment chain was the same as the first.

parts

A structure defining chunks A structure defining chunks of segments in the line collection. Parts allow us to combine individual segments into longer elements.

chunks - Each chunk is a tuple defining the first index and the length of a chunk of vertices. The chunk refers to a contiguous piece of the segment array. Chunks do not have to include all segments, and chunks can overlap. Columns: offset, count

attributes — the parts can have an optional attribute list in the standard manner.

Properties

line-segments (v2.2.0)

A collection of lines composed of straight segments. Optionally, consecutive chunks of segments can be grouped and attributed.

PropertyTypeDescriptionFlags
nameStringName of the object.⬆️ ✅
uuidbase-object-propertiesIdentifier of the object.⬆️ ✅
descriptionStringOptional field for adding additional description to uniquely identify this object.⬆️
extensionsObjectExtended properties that may be associated to the object, but not specified in the schema⬆️
tagsObjectKey-value pairs of user-defined metadata⬆️
lineagelineageInformation about the history of the object⬆️
bounding_boxbounding-boxBounding box of the spatial data.⬆️ ✅
coordinate_reference_systemcrsCoordinate system of the spatial data⬆️ ✅
schemaString
segmentssegmentsVertices and segments.
partsline-segmentsAn optional structure defining segment chunks the line collection is composed of.

Legend

FlagDescription
⬆️Inherited property
Required property