Skip to main content

Class: CircleVectorBuilder

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:14

Builds flight path vectors from simple GeoCircle paths.

Constructors

Constructor

new CircleVectorBuilder(): CircleVectorBuilder

Returns

CircleVectorBuilder

Methods

build()

build(vectors, index, circle, start, end, flags, heading, isHeadingTrue): 1

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:33

Builds a flight path vector from a GeoCircle.

Parameters

ParameterTypeDefault valueDescription
vectorsFlightPathVector[]undefinedThe flight path vector array to which to add the vector.
indexnumberundefinedThe index in the array at which to add the vector.
circleReadonlyGeoCircleundefinedThe circle which defines the vector path.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe start point.
endReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe end point.
flagsnumber0The flags to set on the vector. Defaults to none (0).
headingnull | numbernullThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTruebooleanfalseWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.

Returns

1

The number of vectors that were built and added to the array, which is always equal to 1.


buildGreatCircle()

Call Signature

buildGreatCircle(vectors, index, start, end, defaultCourse?, flags?, heading?, isHeadingTrue?): number

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:64

Builds a flight path vector from a great-circle path between two points.

Parameters
ParameterTypeDescription
vectorsFlightPathVector[]The flight path vector array to which to add the vector.
indexnumberThe index in the array at which to add the vector.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceThe start point.
endReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceThe end point.
defaultCourse?numberA default course to use to define a path when the start and end points are coincident or antipodal. If the default course is positive, then it will define the path's initial bearing at the start point. If the default course is negative, then its negative will define the path's final bearing at the end point. If not defined, then no vector will be built for coincident or antipodal start and end points.
flags?numberThe flags to set on the vector. Defaults to none (0).
heading?null | numberThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTrue?booleanWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.
Returns

number

The number of vectors that were built and added to the array.

Call Signature

buildGreatCircle(vectors, index, start, initialCourse, distance, flags?, heading?, isHeadingTrue?): number

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:89

Builds a flight path vector from a great-circle path originating at a point and initial course and ending after a given distance.

Parameters
ParameterTypeDescription
vectorsFlightPathVector[]The flight path vector array to which to add the vector.
indexnumberThe index in the array at which to add the vector.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceThe start point.
initialCoursenumberThe initial true course (bearing) of the path as measured at the start point, in degrees.
distancenumberThe distance of the path, in great-arc radians.
flags?numberThe flags to set on the vector. Defaults to none (0).
heading?null | numberThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTrue?booleanWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.
Returns

number

The number of vectors that were built and added to the array.

Call Signature

buildGreatCircle(vectors, index, start, initialCourse, end, flags?, heading?, isHeadingTrue?): number

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:114

Builds a flight path vector from a great-circle path originating at a point and initial course and ending at another point.

Parameters
ParameterTypeDescription
vectorsFlightPathVector[]The flight path vector array to which to add the vector.
indexnumberThe index in the array at which to add the vector.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceThe start point.
initialCoursenumberThe initial true course (bearing) of the path as measured at the start point, in degrees.
endReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceThe end point.
flags?numberThe flags to set on the vector. Defaults to none (0).
heading?null | numberThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTrue?booleanWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.
Returns

number

The number of vectors that were built and added to the array.


buildTurn()

buildTurn(vectors, index, turnRadius, turnDirection, center, start, end, flags, heading, isHeadingTrue): 1

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:236

Builds a flight path vector from a path representing a constant-radius turn.

Parameters

ParameterTypeDefault valueDescription
vectorsFlightPathVector[]undefinedThe flight path vector array to which to add the vector.
indexnumberundefinedThe index in the array at which to add the vector.
turnRadiusnumberundefinedThe radius of the turn, in meters.
turnDirectionVectorTurnDirectionundefinedThe direction of the turn.
centerReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe center of the turn.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe start point.
endReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe end point.
flagsnumber0The flags to set on the vector. Defaults to none (0).
headingnull | numbernullThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTruebooleanfalseWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.

Returns

1

The number of vectors that were built and added to the array, which is always equal to 1.


buildTurnToCourse()

buildTurnToCourse(vectors, index, start, turnRadius, turnDirection, fromCourse, toCourse, flags, heading, isHeadingTrue): number

Defined in: src/sdk/flightplan/flightpath/vectorbuilders/CircleVectorBuilder.ts:274

Builds a flight path vector representing a constant-radius turn from a defined start point and initial course toward a defined final course.

Parameters

ParameterTypeDefault valueDescription
vectorsFlightPathVector[]undefinedThe flight path vector array to which to add the vector.
indexnumberundefinedThe index in the array at which to add the vector.
startReadonly<Omit<Float64Array<ArrayBufferLike>, "set" | "sort" | "copyWithin">> | LatLonInterfaceundefinedThe start point.
turnRadiusnumberundefinedThe radius of the turn, in meters.
turnDirectionVectorTurnDirectionundefinedThe direction of the turn.
fromCoursenumberundefinedThe initial true course at the start of the turn, in degrees.
toCoursenumberundefinedThe final true course at the end of the turn, in degrees.
flagsnumber0The flags to set on the vector. Defaults to none (0).
headingnull | numbernullThe heading-to-fly to assign to the vector, in degrees, or null if no heading is to be assigned. Defaults to null.
isHeadingTruebooleanfalseWhether the heading-to-fly assigned to the vector is relative to true north instead of magnetic north. Defaults to false.

Returns

number

The number of vectors that were built and added to the array.