scax-engine 0.1.0

package/dist/types/affine/affine.d.ts

@@ -0,0 +1,45 @@
+export type AffinePair = {
+    sx: number;
+    sy: number;
+    tx: number;
+    ty: number;
+};
+/**
+ * 2D affine 왜곡 추정 전용 클래스입니다.
+ * [x'; y'] = [[a b c], [d e f]] * [x y 1]^T 형태를 최소자승으로 적합합니다.
+ */
+export default class Affine {
+    private lastResult;
+    private lastPairs;
+    estimate(pairs: AffinePair[]): {
+        count: number;
+        residualAvgPct: number;
+        residualMaxPct: number;
+        residuals: {
+            sx: number;
+            sy: number;
+            px: number;
+            py: number;
+            rx: number;
+            ry: number;
+            magnitude: number;
+            pct: number;
+        }[];
+        a: any;
+        b: any;
+        c: any;
+        d: any;
+        e: any;
+        f: any;
+    } | null;
+    /**
+     * 마지막 affine 추정 결과를 반환합니다.
+     */
+    getLastResult(): unknown;
+    /**
+     * 마지막 affine 추정에 사용된 입력쌍을 반환합니다.
+     */
+    getLastPairs(): AffinePair[];
+    private fitAffine2D;
+}
+//# sourceMappingURL=affine.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export { default as SCAXEngine } from "./scax-engine";
+export { SCAXEngineCore } from "./scax-engine";
+export { default as Ray } from "./ray/ray";
+export type { RayProps } from "./ray/ray";
+export type { AffinePair } from "./affine/affine";
+export type { EyeModel, PupilType, LightSourceConfig, LensConfig, EyeConfig, EyePowerInput, SCAXEngineProps, SCAxPower, AstigmatismSummaryItem, PrismSummaryItem, SimulationResultInfo, SimulateResult, AffineAnalysisResult, } from "./scax-engine";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/light-sources/light-source.d.ts

@@ -0,0 +1,57 @@
+import { Vector3 } from "three";
+import Ray from "../ray/ray.js";
+/** 프라우호퍼 c선 (빨강) */
+export declare const CHROMATIC_RED_NM = 656.28;
+export declare const CHROMATIC_RED_COLOR = 16281969;
+/** 프라우호퍼 e선 (초록) */
+export declare const CHROMATIC_GREEN_NM = 546.07;
+export declare const CHROMATIC_GREEN_COLOR = 4906624;
+export declare class LightSource {
+    protected rays: Ray[];
+    constructor();
+    protected directionFromVergence(origin: Vector3, z: number, vergence: number): Vector3;
+    protected createRayFromPoint(origin: Vector3, z: number, vergence: number): void;
+    protected createChromaticRayFromPoint(origin: Vector3, z: number, vergence: number, line: "e" | "C", chromaticVergenceOffset?: number): void;
+    addRay(ray: Ray): void;
+    emitRays(): Ray[];
+}
+export type GridLightSourceProps = {
+    width: number;
+    height: number;
+    division: number;
+    z: number;
+    vergence: number;
+};
+export declare class GridLightSource extends LightSource {
+    private width;
+    private height;
+    private division;
+    private z;
+    private vergence;
+    constructor(props: GridLightSourceProps);
+}
+export type GridRGLightSourceProps = GridLightSourceProps;
+export declare class GridRGLightSource extends LightSource {
+    private width;
+    private height;
+    private division;
+    private z;
+    private vergence;
+    constructor(props: GridRGLightSourceProps);
+}
+export type RadialLightSourceProps = {
+    radius: number;
+    division: number;
+    angle_division: number;
+    z: number;
+    vergence: number;
+};
+export declare class RadialLightSource extends LightSource {
+    private radius;
+    private division;
+    private angle_division;
+    private z;
+    private vergence;
+    constructor(props: RadialLightSourceProps);
+}
+//# sourceMappingURL=light-source.d.ts.map

package/dist/types/optics/refractive-index.d.ts

@@ -0,0 +1,11 @@
+export type FraunhoferLine = "g" | "F" | "e" | "d" | "C" | "r";
+export type RefractiveIndexByLine = Partial<Record<FraunhoferLine, number>>;
+export type RefractiveIndexSpec = number | RefractiveIndexByLine;
+export declare function resolveRefractiveIndex(spec: RefractiveIndexSpec, line: FraunhoferLine): number;
+export declare function normalizeRefractiveIndexSpec(spec: RefractiveIndexSpec): number | {
+    F: number;
+    e: number;
+    d: number;
+    C: number;
+} | Partial<Record<FraunhoferLine, number>>;
+//# sourceMappingURL=refractive-index.d.ts.map

package/dist/types/parameters/constants.d.ts

@@ -0,0 +1,194 @@
+/**
+ * 프라운호퍼 파장과 색상
+ */
+export declare const WAVELENGTHS: {
+    g: {
+        nm: number;
+        color: number;
+    };
+    F: {
+        nm: number;
+        color: number;
+    };
+    e: {
+        nm: number;
+        color: number;
+    };
+    d: {
+        nm: number;
+        color: number;
+    };
+    C: {
+        nm: number;
+        color: number;
+    };
+    r: {
+        nm: number;
+        color: number;
+    };
+};
+/**
+ * 매질별 프라운오퍼 파장과 굴절률
+ */
+export declare const FRAUNHOFER_REFRACTIVE_INDICES: {
+    air: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    crown_glass: {
+        g: number;
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+        r: number;
+    };
+    plastic_150: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    plastic_160: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    plastic_167: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    plastic_174: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    cornea: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    aqueous: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    vitreous: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    lens: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    lens_anterior: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    lens_nucleus_anterior: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    lens_nucleus_posterior: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+    lens_posterior: {
+        F: number;
+        e: number;
+        d: number;
+        C: number;
+    };
+};
+/**
+ * 동공 크기
+ */
+export declare const PUPIL_SIZE: {
+    /** 축동 — 동공 수축 */
+    constricted: number;
+    /** 일반 */
+    neutral: number;
+    /** 산동 — 동공 확대 */
+    dilated: number;
+    /** 동공 미사용(차단/필터 비활성) */
+    none: number;
+};
+/**
+ * 망막 뒤 광선 연장 거리
+ */
+export declare const RETINA_EXTRA_AFTER_MM = 18;
+/**
+ * epsilon
+ */
+export declare const EPSILON = 1e-9;
+/**
+ * 굴절 후 광선을 아주 조금 전진시켜 self-intersection을 방지하기 위한 거리(mm)
+ */
+export declare const RAY_SURFACE_ESCAPE_MM = 0.002;
+/**
+ * ST(Sphere-Toric) 복합면에서 굴절력 0으로 판단하는 임계값(D)
+ */
+export declare const ST_POWER_EPS_D = 1e-9;
+/**
+ * ST(Sphere-Toric) 복합면의 기본 두께(mm)
+ */
+export declare const ST_DEFAULT_THICKNESS_MM = 0.05;
+/**
+ * 안구 보정 ST면(eye)의 기본 위치: 각막 전면 바로 앞(mm)
+ */
+export declare const EYE_ST_SURFACE_OFFSET_MM = 0.02;
+/**
+ * 안경 렌즈 ST면(lens)의 기본 정간거리 Vertex Distance(mm)
+ */
+export declare const SPECTACLE_VERTEX_DISTANCE_MM = 12;
+/**
+ * Toric 면 교점 탐색 시 현재 점과의 자기 재교차를 피하기 위한 최소 전진 거리(mm)
+ */
+export declare const TORIC_MIN_T_MM = 0.000001;
+/**
+ * Toric 면 교점 계산(뉴턴법) 최대 반복 횟수
+ */
+export declare const TORIC_MAX_ITERS = 24;
+/**
+ * 광선 시작점이 이미 Toric 면 위에 있다고 판단하는 허용 오차(mm)
+ */
+export declare const TORIC_ON_SURFACE_TOL_MM = 0.000001;
+/**
+ * 동일 z 부근 연속 표면에서 수치 오차로 인한 미세 간격을 허용하는 오차(mm)
+ */
+export declare const TORIC_COINCIDENT_SURFACE_TOL_MM = 0.003;
+/**
+ * Sturm 분석에서 Top2 선택 시 허용하는 최소 z 간격(mm)
+ */
+export declare const DEFAULT_STURM_TOP2_MIN_GAP_MM = 0;
+/**
+ * Sturm 분석에서 Top2 선택 시 허용하는 최소 축 각도 차(도)
+ */
+export declare const DEFAULT_STURM_TOP2_MIN_ANGLE_GAP_DEG = 45;
+/**
+ * 실효 난시량이 이 값(D) 이상이면 U/V 중간점을 CLC 근사 중심으로 우선 사용
+ */
+export declare const DEFAULT_EFFECTIVE_CYLINDER_THRESHOLD_D = 0.125;
+/**
+ * Sturm z-scan 간격(mm)
+ */
+export declare const DEFAULT_STURM_STEP_MM = 0.01;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/parameters/eye/eyemodel-parameter.d.ts

@@ -0,0 +1,36 @@
+import Surface from "../../surfaces/surface";
+interface BaseEyeSurfaceParameter {
+    name: string;
+    z: number;
+}
+interface SphericalEyeSurfaceParameter extends BaseEyeSurfaceParameter {
+    type: "spherical";
+    radius: number;
+    n_before: number;
+    n_after: number;
+}
+interface AsphericalEyeSurfaceParameter extends BaseEyeSurfaceParameter {
+    type: "aspherical";
+    radius: number;
+    conic: number;
+    n_before: number;
+    n_after: number;
+}
+interface SphericalImageEyeSurfaceParameter extends BaseEyeSurfaceParameter {
+    type: "spherical-image";
+    radius: number;
+}
+type EyeSurfaceParameter = SphericalEyeSurfaceParameter | AsphericalEyeSurfaceParameter | SphericalImageEyeSurfaceParameter;
+export interface EyeModelParameterConfig {
+    unit: string;
+    axis: string;
+    origin?: string;
+    surfaces: EyeSurfaceParameter[];
+}
+export declare class EyeModelParameter {
+    private readonly parameter;
+    constructor(parameter: EyeModelParameterConfig);
+    createSurface(): Surface[];
+}
+export {};
+//# sourceMappingURL=eyemodel-parameter.d.ts.map

package/dist/types/parameters/eye/gullstrand-parameter.d.ts

@@ -0,0 +1,6 @@
+import { EyeModelParameter, EyeModelParameterConfig } from "./eyemodel-parameter";
+export declare class GullstrandParameter extends EyeModelParameter {
+    static parameter: EyeModelParameterConfig;
+    constructor();
+}
+//# sourceMappingURL=gullstrand-parameter.d.ts.map

package/dist/types/parameters/eye/navarro-parameter.d.ts

@@ -0,0 +1,6 @@
+import { EyeModelParameter, EyeModelParameterConfig } from "./eyemodel-parameter";
+export declare class NavarroParameter extends EyeModelParameter {
+    static parameter: EyeModelParameterConfig;
+    constructor();
+}
+//# sourceMappingURL=navarro-parameter.d.ts.map

package/dist/types/ray/ray.d.ts

@@ -0,0 +1,27 @@
+import { Vector3 } from "three";
+export type RayProps = {
+    origin: Vector3;
+    direction: Vector3;
+    frounhofer_line: 'g' | 'F' | 'e' | 'd' | 'C' | 'r';
+};
+/**
+ * 프라운호퍼 D선 광선이 기본 입니다.
+ * 기본 색은 노란색입니다.
+ */
+export default class Ray {
+    private points;
+    private origin;
+    private direction;
+    private frounhofer_line;
+    private wavelengthNm;
+    private displayColor;
+    constructor({ origin, direction, frounhofer_line }: RayProps);
+    appendPoint(point: Vector3): void;
+    endPoint(): Vector3;
+    getDirection(): Vector3;
+    getWavelengthNm(): number;
+    getFraunhoferLine(): "g" | "F" | "e" | "d" | "C" | "r";
+    clone(): Ray;
+    continueFrom(nextOrigin: Vector3, nextDirection: Vector3): void;
+}
+//# sourceMappingURL=ray.d.ts.map