scax-engine 0.1.3 → 0.1.5

package/README.md

@@ -1,6 +1,6 @@
 # scax-engine
 
-눈 모델(Gullstrand / Navarro)에 대한 광선 추적, Sturm 간격 분석, 아핀 왜곡 추정, 유발 난시·프리즘 편위 계산을 제공하는 TypeScript 안경광학 시뮬레이션(단안 기준, OD) 라이브러리입니다. ESM, CJS, UMD 빌드를 지원합니다.
+눈 모델(Gullstrand / Navarro)에 대한 광선 추적, Sturm 간격 분석, 유발 난시·프리즘 편위 계산을 제공하는 TypeScript 안경광학 시뮬레이션(단안 기준, OD) 라이브러리입니다. ESM, CJS, UMD 빌드를 지원합니다.
 
 
 English documentation: [README-en.md](README-en.md)
@@ -69,7 +69,7 @@ const next = engine.simulate();
 
 ### `new SCAXEngine(props?)`
 
-시뮬레이션 엔진 인스턴스를 생성합니다. 내부 `Sturm`, `Affine` 헬퍼는 인스턴스당 한 번만 생성됩니다.
+시뮬레이션 엔진 인스턴스를 생성합니다. 내부 `Sturm` 헬퍼는 인스턴스당 한 번만 생성됩니다.
 
 #### `props`
 
@@ -103,13 +103,13 @@ const next = engine.simulate();
 
 생성자와 동일한 설정 경로를 다시 실행합니다. `props`를 기준으로 eye / lens / 표면 / 광원을 재구성하며, 생략된 키에는 위 기본값이 적용됩니다.
 
-- `Sturm`, `Affine` 인스턴스는 재생성되지 않지만, `update` 직후에는 Sturm·affine 분석 캐시가 비워지며 `simulate` 등으로 다시 채워집니다.
+- `Sturm` 인스턴스는 재생성되지 않지만, `update` 직후에는 Sturm 분석 캐시가 비워지며 `simulate` 등으로 다시 채워집니다.
 
 ### `engine.dispose()`
 
 엔진 인스턴스가 잡고 있던 추적/분석 캐시와 표면 trace history를 정리합니다.
 
-- 해제 대상: traced rays, Sturm/affine 캐시, surface incident/refracted history
+- 해제 대상: traced rays, Sturm 캐시, surface incident/refracted history
 - UI에서 엔진을 자주 새로 만들 때(예: 프레임별/슬라이더 연속 갱신) 이전 인스턴스에 `dispose()`를 호출하면 메모리 사용량을 안정적으로 유지할 수 있습니다.
 
 ### 인스턴스 메서드
@@ -152,7 +152,6 @@ const next = engine.simulate();
 
 - `sturmCalculation(rays?)` — 추적 광선(인자 생략 시 마지막 `rayTracing`/`simulate` 결과)으로 Sturm 슬라이스·스펙트럼선별 분석 객체를 계산해 반환합니다. `simulate()` 호출 시 내부에서 Sturm도 갱신됩니다.
 
-- `getAffineAnalysis()` — 현재 설정으로 망막 대응점 쌍을 만들어 아핀 적합을 수행(또는 캐시 재사용)합니다. 유효한 쌍이 부족하면 `null`이 될 수 있습니다.
 
 ## UMD
 

package/dist/scax-engine.cjs

@@ -8932,7 +8932,7 @@ const TABOToDeg = (TABOAngle) => {
  * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
  * - 광원 광선을 생성하고
  * - 표면들을 순서대로 통과시키며 굴절을 계산한 뒤
- * - 망막 대응쌍, Sturm 분석, 왜곡(affine) 분석까지 제공합니다.
+ * - Sturm 분석까지 제공합니다.
  */
 class SCAXEngineCore {
     constructor(props = {}) {
@@ -9137,9 +9137,9 @@ class SCAXEngineCore {
             traced_rays: tracedRays,
             info: {
                 astigmatism: {
-                    eye: [this.principalMeridiansFromPowers([this.eyePower])],
+                    eye: this.principalMeridiansFromPowers([this.eyePower]),
                     lens: this.lensPowers.map((power) => this.principalMeridiansFromPowers([power])),
-                    combined: [this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers])],
+                    combined: this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers]),
                 },
                 prism: {
                     eye: this.toPrismSummaryItem(lightDeviation.eye_prism_effect),
@@ -9265,27 +9265,18 @@ class SCAXEngineCore {
         this.lastSturmGapAnalysis = this.sturm.calculate(rays, this.effectiveCylinderFromOpticSurfaces(), this.lastSourceRaysForSturm, this.sturmEyeProfileWorldZBounds() ?? null);
         return this.lastSturmGapAnalysis;
     }
-    /**
-     * 3) Affine 왜곡 추정 전용 함수
-     * 광선 대응쌍(sx,sy)->(tx,ty)에 대해 최소자승 2D affine을 적합합니다.
-     */
-    estimateAffineDistortion(pairs) {
-        const inputPairs = Array.isArray(pairs) ? pairs : [];
-        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
-        return this.lastAffineAnalysis;
-    }
-    /**
-     * 현재 eye+lens 설정 기준 affine 왜곡 결과를 반환합니다.
-     * traced ray/affine 결과는 기존 계산값을 우선 재사용합니다.
-     */
     getAffineAnalysis() {
+        /*
         if (!this.tracedRays.length) {
-            this.simulate();
+          this.simulate();
         }
         if (!this.lastAffineAnalysis) {
-            this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
+          this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
         }
         return this.lastAffineAnalysis;
+        */
+        // Affine analysis is intentionally disabled for now.
+        return null;
     }
     surfaceOrderZ(surface) {
         const z = Number(this.readSurfacePosition(surface)?.z);
@@ -9537,6 +9528,13 @@ class SCAXEngineCore {
         }
         return 2 * Math.hypot(j0, j45);
     }
+    // Kept for later review/release.
+    estimateAffineDistortion(pairs) {
+        const inputPairs = Array.isArray(pairs) ? pairs : [];
+        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
+        return this.lastAffineAnalysis;
+    }
+    // Kept for later review/release.
     createAffinePairs(rays) {
         return (Array.isArray(rays) ? rays : [])
             .map((ray) => {

package/dist/scax-engine.js

@@ -8930,7 +8930,7 @@ const TABOToDeg = (TABOAngle) => {
  * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
  * - 광원 광선을 생성하고
  * - 표면들을 순서대로 통과시키며 굴절을 계산한 뒤
- * - 망막 대응쌍, Sturm 분석, 왜곡(affine) 분석까지 제공합니다.
+ * - Sturm 분석까지 제공합니다.
  */
 class SCAXEngineCore {
     constructor(props = {}) {
@@ -9135,9 +9135,9 @@ class SCAXEngineCore {
             traced_rays: tracedRays,
             info: {
                 astigmatism: {
-                    eye: [this.principalMeridiansFromPowers([this.eyePower])],
+                    eye: this.principalMeridiansFromPowers([this.eyePower]),
                     lens: this.lensPowers.map((power) => this.principalMeridiansFromPowers([power])),
-                    combined: [this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers])],
+                    combined: this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers]),
                 },
                 prism: {
                     eye: this.toPrismSummaryItem(lightDeviation.eye_prism_effect),
@@ -9263,27 +9263,18 @@ class SCAXEngineCore {
         this.lastSturmGapAnalysis = this.sturm.calculate(rays, this.effectiveCylinderFromOpticSurfaces(), this.lastSourceRaysForSturm, this.sturmEyeProfileWorldZBounds() ?? null);
         return this.lastSturmGapAnalysis;
     }
-    /**
-     * 3) Affine 왜곡 추정 전용 함수
-     * 광선 대응쌍(sx,sy)->(tx,ty)에 대해 최소자승 2D affine을 적합합니다.
-     */
-    estimateAffineDistortion(pairs) {
-        const inputPairs = Array.isArray(pairs) ? pairs : [];
-        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
-        return this.lastAffineAnalysis;
-    }
-    /**
-     * 현재 eye+lens 설정 기준 affine 왜곡 결과를 반환합니다.
-     * traced ray/affine 결과는 기존 계산값을 우선 재사용합니다.
-     */
     getAffineAnalysis() {
+        /*
         if (!this.tracedRays.length) {
-            this.simulate();
+          this.simulate();
         }
         if (!this.lastAffineAnalysis) {
-            this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
+          this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
         }
         return this.lastAffineAnalysis;
+        */
+        // Affine analysis is intentionally disabled for now.
+        return null;
     }
     surfaceOrderZ(surface) {
         const z = Number(this.readSurfacePosition(surface)?.z);
@@ -9535,6 +9526,13 @@ class SCAXEngineCore {
         }
         return 2 * Math.hypot(j0, j45);
     }
+    // Kept for later review/release.
+    estimateAffineDistortion(pairs) {
+        const inputPairs = Array.isArray(pairs) ? pairs : [];
+        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
+        return this.lastAffineAnalysis;
+    }
+    // Kept for later review/release.
     createAffinePairs(rays) {
         return (Array.isArray(rays) ? rays : [])
             .map((ray) => {

package/dist/scax-engine.umd.js

@@ -8936,7 +8936,7 @@
 	 * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
 	 * - 광원 광선을 생성하고
 	 * - 표면들을 순서대로 통과시키며 굴절을 계산한 뒤
-	 * - 망막 대응쌍, Sturm 분석, 왜곡(affine) 분석까지 제공합니다.
+	 * - Sturm 분석까지 제공합니다.
 	 */
 	class SCAXEngineCore {
 	    constructor(props = {}) {
@@ -9141,9 +9141,9 @@
 	            traced_rays: tracedRays,
 	            info: {
 	                astigmatism: {
-	                    eye: [this.principalMeridiansFromPowers([this.eyePower])],
+	                    eye: this.principalMeridiansFromPowers([this.eyePower]),
 	                    lens: this.lensPowers.map((power) => this.principalMeridiansFromPowers([power])),
-	                    combined: [this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers])],
+	                    combined: this.principalMeridiansFromPowers([this.eyePower, ...this.lensPowers]),
 	                },
 	                prism: {
 	                    eye: this.toPrismSummaryItem(lightDeviation.eye_prism_effect),
@@ -9269,27 +9269,18 @@
 	        this.lastSturmGapAnalysis = this.sturm.calculate(rays, this.effectiveCylinderFromOpticSurfaces(), this.lastSourceRaysForSturm, this.sturmEyeProfileWorldZBounds() ?? null);
 	        return this.lastSturmGapAnalysis;
 	    }
-	    /**
-	     * 3) Affine 왜곡 추정 전용 함수
-	     * 광선 대응쌍(sx,sy)->(tx,ty)에 대해 최소자승 2D affine을 적합합니다.
-	     */
-	    estimateAffineDistortion(pairs) {
-	        const inputPairs = Array.isArray(pairs) ? pairs : [];
-	        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
-	        return this.lastAffineAnalysis;
-	    }
-	    /**
-	     * 현재 eye+lens 설정 기준 affine 왜곡 결과를 반환합니다.
-	     * traced ray/affine 결과는 기존 계산값을 우선 재사용합니다.
-	     */
 	    getAffineAnalysis() {
+	        /*
 	        if (!this.tracedRays.length) {
-	            this.simulate();
+	          this.simulate();
 	        }
 	        if (!this.lastAffineAnalysis) {
-	            this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
+	          this.lastAffineAnalysis = this.estimateAffineDistortion(this.createAffinePairs(this.tracedRays));
 	        }
 	        return this.lastAffineAnalysis;
+	        */
+	        // Affine analysis is intentionally disabled for now.
+	        return null;
 	    }
 	    surfaceOrderZ(surface) {
 	        const z = Number(this.readSurfacePosition(surface)?.z);
@@ -9541,6 +9532,13 @@
 	        }
 	        return 2 * Math.hypot(j0, j45);
 	    }
+	    // Kept for later review/release.
+	    estimateAffineDistortion(pairs) {
+	        const inputPairs = Array.isArray(pairs) ? pairs : [];
+	        this.lastAffineAnalysis = this.affine.estimate(inputPairs);
+	        return this.lastAffineAnalysis;
+	    }
+	    // Kept for later review/release.
 	    createAffinePairs(rays) {
 	        return (Array.isArray(rays) ? rays : [])
 	            .map((ray) => {

package/dist/types/scax-engine.d.ts

@@ -97,9 +97,9 @@ export type PrismSummaryItem = {
 };
 export type SimulationResultInfo = {
     astigmatism: {
-        eye: AstigmatismSummaryItem[];
+        eye: AstigmatismSummaryItem;
         lens: AstigmatismSummaryItem[];
-        combined: AstigmatismSummaryItem[];
+        combined: AstigmatismSummaryItem;
     };
     prism: {
         eye: PrismSummaryItem;
@@ -112,7 +112,7 @@ export type AffineAnalysisResult = ReturnType<Affine["estimate"]>;
  * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
  * - 광원 광선을 생성하고
  * - 표면들을 순서대로 통과시키며 굴절을 계산한 뒤
- * - 망막 대응쌍, Sturm 분석, 왜곡(affine) 분석까지 제공합니다.
+ * - Sturm 분석까지 제공합니다.
  */
 export declare class SCAXEngineCore {
     private static readonly EYE_ROTATION_PIVOT_FROM_CORNEA_MM;
@@ -289,15 +289,6 @@ export declare class SCAXEngineCore {
             };
         }[];
     };
-    /**
-     * 3) Affine 왜곡 추정 전용 함수
-     * 광선 대응쌍(sx,sy)->(tx,ty)에 대해 최소자승 2D affine을 적합합니다.
-     */
-    private estimateAffineDistortion;
-    /**
-     * 현재 eye+lens 설정 기준 affine 왜곡 결과를 반환합니다.
-     * traced ray/affine 결과는 기존 계산값을 우선 재사용합니다.
-     */
     getAffineAnalysis(): AffineAnalysisResult;
     private surfaceOrderZ;
     private readSurfacePosition;
@@ -327,6 +318,7 @@ export declare class SCAXEngineCore {
     private applyLightSourceTransformToRay;
     private calculateLightDeviation;
     private effectiveCylinderFromOpticSurfaces;
+    private estimateAffineDistortion;
     private createAffinePairs;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scax-engine",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Optical calculation engine for an eye model, with ESM, CJS, and UMD builds.",
   "main": "./dist/scax-engine.cjs",
   "module": "./dist/scax-engine.js",