@math.gl/projection 0.0.0-stage → 5.0.0-alpha.12

package/dist/experimental/projection-pipeline.d.ts

@@ -0,0 +1,142 @@
+import type { DeformationModel } from "./deformation.js";
+import type { ProjectionCoordinate, ProjectionOutput } from "./scalar-output.js";
+export type { ProjectionCoordinate, ProjectionOutput } from "./scalar-output.js";
+import type { ProjectionDescriptor } from "./projection-descriptor.js";
+import type { ProjectionParameters, ProjectionPlugin } from "./types.js";
+import type { ProjectionArray } from "./typescript-projection.js";
+import type { DatumGridCollection, VerticalGridCollection } from "./grids/types.js";
+/** Decimal years; a flat call accepts one epoch or one per coordinate record. */
+export type PipelineEpochs = number | Float32Array | Float64Array;
+export type PipelineHelmertRates = {
+    /** Metres per decimal year. */
+    readonly translation?: readonly [number, number, number];
+    /** Arcseconds per decimal year, using the step's rotation convention. */
+    readonly rotation?: readonly [number, number, number];
+    /** Parts per million per decimal year. */
+    readonly scalePPM?: number;
+};
+export type PipelineUnit = 'deg' | 'rad' | 'm' | 'ft' | 'us-ft';
+export type PipelineCoordinateSystem = {
+    readonly space: 'geographic' | 'projected' | 'geocentric';
+    /** Units in stored X/Y/Z order. Geographic steps require longitude/latitude order. */
+    readonly units: readonly [PipelineUnit, PipelineUnit, PipelineUnit];
+};
+export type PipelineEllipsoid = Readonly<Partial<Record<'ellps' | 'a' | 'b' | 'rf' | 'f' | 'R', string>>>;
+export type PipelineProjectionOutput = {
+    readonly space: 'geographic';
+    readonly unit: 'deg' | 'rad';
+} | {
+    readonly space: 'projected';
+    readonly unit: 'm';
+};
+type Direction = {
+    readonly inverse?: boolean;
+    /** Omit this step when calling project/projectFlat. */
+    readonly omitForward?: boolean;
+    /** Omit this step when calling unproject/unprojectFlat. */
+    readonly omitInverse?: boolean;
+};
+export type PipelineStep = Direction & ({
+    readonly type: 'unitconvert';
+    readonly xy?: {
+        readonly from: PipelineUnit;
+        readonly to: PipelineUnit;
+    };
+    readonly z?: {
+        readonly from: PipelineUnit;
+        readonly to: PipelineUnit;
+    };
+} | {
+    readonly type: 'axisswap';
+    readonly order: readonly [number, number] | readonly [number, number, number];
+} | {
+    readonly type: 'projection';
+    readonly name: string;
+    readonly parameters?: ProjectionParameters;
+    /** Required for ob_tran; geographic helper output can be degrees or radians. */
+    readonly output?: PipelineProjectionOutput;
+} | {
+    readonly type: 'cart';
+    readonly ellipsoid?: PipelineEllipsoid;
+} | {
+    readonly type: 'helmert';
+    readonly translation: readonly [number, number, number];
+    readonly rotation?: readonly [number, number, number];
+    readonly scalePPM?: number;
+    readonly convention?: 'position_vector' | 'coordinate_frame';
+    /** Use a full rotation matrix and its mathematical inverse. Default false. */
+    readonly exact?: boolean;
+    /** Decimal year at which the base parameters apply. Required with rates. */
+    readonly referenceEpoch?: number;
+    readonly rates?: PipelineHelmertRates;
+} | {
+    readonly type: 'deformation';
+    readonly model: DeformationModel;
+    /** 'coordinate' uses the separate scalar/batch/per-record epoch argument. */
+    readonly sourceEpoch: number | 'coordinate';
+    readonly targetEpoch: number;
+} | {
+    readonly type: 'push' | 'pop';
+    readonly components: readonly (1 | 2 | 3)[];
+} | {
+    readonly type: 'hgridshift';
+    readonly grids: string;
+} | {
+    readonly type: 'vgridshift';
+    readonly grids: string;
+    readonly multiplier?: number;
+});
+type Registration = ProjectionPlugin | ProjectionDescriptor;
+type Result<P, T> = Extract<P, ProjectionDescriptor> extends never ? T : Promise<T>;
+export type ProjectionPipelineOptions<P extends Registration = ProjectionPlugin> = {
+    readonly input: PipelineCoordinateSystem;
+    readonly steps: readonly PipelineStep[];
+    readonly projections?: readonly P[];
+    readonly datumGrids?: DatumGridCollection;
+    readonly verticalGrids?: VerticalGridCollection;
+};
+/** Explicit forward/reverse operations; no CRS/epoch inference or string pipeline parser.
+ * General execution reuses guarded scratch; specialized flat stages use numeric
+ * locals and never allocate coordinate arrays inside the flat loop. M and additional ordinates are preserved, never interpreted.
+ */
+export declare class ProjectionPipeline<P extends Registration = ProjectionPlugin> {
+    readonly input: PipelineCoordinateSystem;
+    readonly output: PipelineCoordinateSystem;
+    private readonly forwardFactories;
+    private readonly inverseFactories;
+    private stackSize;
+    private readonly coordinateScratch;
+    private coordinateStack?;
+    private readonly required;
+    private readonly deferred;
+    private requiresZ;
+    private requiresEpoch;
+    private compiled?;
+    private pending?;
+    constructor(options: ProjectionPipelineOptions<P>);
+    /** Load only implementations named by pipeline steps; failures can be retried. */
+    preload(): Promise<this>;
+    project(coordinate: readonly number[], epoch?: number): Result<P, number[]>;
+    unproject(coordinate: readonly number[], epoch?: number): Result<P, number[]>;
+    /** Reuse a scalar output; the epoch remains separate from all coordinate ordinates. */
+    projectTo<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T, epoch?: number): Result<P, T>;
+    unprojectTo<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T, epoch?: number): Result<P, T>;
+    projectToSync<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T, epoch?: number): T;
+    unprojectToSync<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T, epoch?: number): T;
+    private scalarToLoaded;
+    projectFlat<T extends ProjectionArray>(coordinates: T, dimension?: number, epochs?: PipelineEpochs): Result<P, T>;
+    unprojectFlat<T extends ProjectionArray>(coordinates: T, dimension?: number, epochs?: PipelineEpochs): Result<P, T>;
+    projectSync(coordinate: readonly number[], epoch?: number): number[];
+    unprojectSync(coordinate: readonly number[], epoch?: number): number[];
+    projectFlatSync<T extends ProjectionArray>(coordinates: T, dimension?: number, epochs?: PipelineEpochs): T;
+    unprojectFlatSync<T extends ProjectionArray>(coordinates: T, dimension?: number, epochs?: PipelineEpochs): T;
+    private compile;
+    private operations;
+    private scalar;
+    private flat;
+    private coordinateEpoch;
+    private run;
+    private balanced;
+    private prepare;
+}
+//# sourceMappingURL=projection-pipeline.d.ts.map

package/dist/experimental/projection-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-pipeline.d.ts","sourceRoot":"","sources":["../../src/experimental/projection-pipeline.ts"],"names":[],"mappings":"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"}