scax-engine 0.1.0 → 0.1.1

package/README.md

@@ -2,8 +2,14 @@
 
 눈 모델(Gullstrand / Navarro)에 대한 광선 추적, Sturm 간격 분석, 아핀 왜곡 추정, 유발 난시·프리즘 편위 계산을 제공하는 TypeScript 안경광학 시뮬레이션(단안 기준, OD) 라이브러리입니다. ESM, CJS, UMD 빌드를 지원합니다.
 
+
 English documentation: [README-en.md](README-en.md)
 
+## SCAX란?
+
+scax는 안경광학에서 기본적으로 쓰이는 데이터입니다. **S**는 구면렌즈 도수, **C**는 원주렌즈 도수, **AX**는 원주렌즈의 축입니다.
+
+
 ## 요구 사항
 
 - **Node.js** 20 이상(로컬 개발·테스트)

package/dist/scax-engine.cjs

@@ -8339,6 +8339,13 @@ class ApertureStopSurface extends Surface {
     }
 }
 
+const DegToTABO = (degree) => {
+    const d = Number(degree);
+    if (!Number.isFinite(d))
+        return 0;
+    return (((180 - d) % 180) + 180) % 180;
+};
+
 class ToricSurface extends Surface {
     constructor(props) {
         super({ type: "toric", name: props.name, position: props.position, tilt: props.tilt });
@@ -8554,7 +8561,8 @@ class STSurface extends Surface {
         const { s, c, ax, n_before = 1.0, n = 1.0, n_after = n_before, referencePoint, thickness = ST_DEFAULT_THICKNESS_MM, } = props;
         this.s = s;
         this.c = c;
-        this.ax = ax;
+        // paraxial-surface와 동일: 처방 축은 TABO(°), 굴절/기하에는 수학 좌표 각(0~180)로 변환해 저장한다.
+        this.ax = DegToTABO(ax);
         this.n_before = normalizeRefractiveIndexSpec(n_before);
         this.n = normalizeRefractiveIndexSpec(n);
         this.n_after = normalizeRefractiveIndexSpec(n_after);
@@ -8803,13 +8811,6 @@ const TABOToDeg = (TABOAngle) => {
     return (((180 - t) % 180) + 180) % 180;
 };
 
-const DegToTABO = (degree) => {
-    const d = Number(degree);
-    if (!Number.isFinite(d))
-        return 0;
-    return (((180 - d) % 180) + 180) % 180;
-};
-
 /**
  * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
  * - 광원 광선을 생성하고
@@ -9177,12 +9178,19 @@ class SCAXEngineCore {
         }
         return { m, j0, j45 };
     }
+    /** 난시 주경선 TABO 각도: 180° 동치이므로 표시·비교는 항상 [0, 180)으로 맞춘다. */
+    normalizeTaboMeridian180(value) {
+        const d = Number(value ?? 0);
+        if (!Number.isFinite(d))
+            return 0;
+        return ((d % 180) + 180) % 180;
+    }
     principalMeridiansFromVector(m, j0, j45) {
         if (!Number.isFinite(m) || !Number.isFinite(j0) || !Number.isFinite(j45))
             return [];
         const axisDeg = (((0.5 * Math.atan2(j45, j0) * 180) / Math.PI) % 180 + 180) % 180;
-        const taboAxis = this.normalizeAngle360(TABOToDeg(axisDeg));
-        const orthogonalTabo = this.normalizeAngle360(taboAxis + 90);
+        const taboAxis = this.normalizeTaboMeridian180(TABOToDeg(axisDeg));
+        const orthogonalTabo = (taboAxis + 90) % 180;
         const r = Math.hypot(j0, j45);
         const meridians = [
             { tabo: taboAxis, d: m - r },

package/dist/scax-engine.js

@@ -8337,6 +8337,13 @@ class ApertureStopSurface extends Surface {
     }
 }
 
+const DegToTABO = (degree) => {
+    const d = Number(degree);
+    if (!Number.isFinite(d))
+        return 0;
+    return (((180 - d) % 180) + 180) % 180;
+};
+
 class ToricSurface extends Surface {
     constructor(props) {
         super({ type: "toric", name: props.name, position: props.position, tilt: props.tilt });
@@ -8552,7 +8559,8 @@ class STSurface extends Surface {
         const { s, c, ax, n_before = 1.0, n = 1.0, n_after = n_before, referencePoint, thickness = ST_DEFAULT_THICKNESS_MM, } = props;
         this.s = s;
         this.c = c;
-        this.ax = ax;
+        // paraxial-surface와 동일: 처방 축은 TABO(°), 굴절/기하에는 수학 좌표 각(0~180)로 변환해 저장한다.
+        this.ax = DegToTABO(ax);
         this.n_before = normalizeRefractiveIndexSpec(n_before);
         this.n = normalizeRefractiveIndexSpec(n);
         this.n_after = normalizeRefractiveIndexSpec(n_after);
@@ -8801,13 +8809,6 @@ const TABOToDeg = (TABOAngle) => {
     return (((180 - t) % 180) + 180) % 180;
 };
 
-const DegToTABO = (degree) => {
-    const d = Number(degree);
-    if (!Number.isFinite(d))
-        return 0;
-    return (((180 - d) % 180) + 180) % 180;
-};
-
 /**
  * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
  * - 광원 광선을 생성하고
@@ -9175,12 +9176,19 @@ class SCAXEngineCore {
         }
         return { m, j0, j45 };
     }
+    /** 난시 주경선 TABO 각도: 180° 동치이므로 표시·비교는 항상 [0, 180)으로 맞춘다. */
+    normalizeTaboMeridian180(value) {
+        const d = Number(value ?? 0);
+        if (!Number.isFinite(d))
+            return 0;
+        return ((d % 180) + 180) % 180;
+    }
     principalMeridiansFromVector(m, j0, j45) {
         if (!Number.isFinite(m) || !Number.isFinite(j0) || !Number.isFinite(j45))
             return [];
         const axisDeg = (((0.5 * Math.atan2(j45, j0) * 180) / Math.PI) % 180 + 180) % 180;
-        const taboAxis = this.normalizeAngle360(TABOToDeg(axisDeg));
-        const orthogonalTabo = this.normalizeAngle360(taboAxis + 90);
+        const taboAxis = this.normalizeTaboMeridian180(TABOToDeg(axisDeg));
+        const orthogonalTabo = (taboAxis + 90) % 180;
         const r = Math.hypot(j0, j45);
         const meridians = [
             { tabo: taboAxis, d: m - r },

package/dist/scax-engine.umd.js

@@ -8343,6 +8343,13 @@
 	    }
 	}
 
+	const DegToTABO = (degree) => {
+	    const d = Number(degree);
+	    if (!Number.isFinite(d))
+	        return 0;
+	    return (((180 - d) % 180) + 180) % 180;
+	};
+
 	class ToricSurface extends Surface {
 	    constructor(props) {
 	        super({ type: "toric", name: props.name, position: props.position, tilt: props.tilt });
@@ -8558,7 +8565,8 @@
 	        const { s, c, ax, n_before = 1.0, n = 1.0, n_after = n_before, referencePoint, thickness = ST_DEFAULT_THICKNESS_MM, } = props;
 	        this.s = s;
 	        this.c = c;
-	        this.ax = ax;
+	        // paraxial-surface와 동일: 처방 축은 TABO(°), 굴절/기하에는 수학 좌표 각(0~180)로 변환해 저장한다.
+	        this.ax = DegToTABO(ax);
 	        this.n_before = normalizeRefractiveIndexSpec(n_before);
 	        this.n = normalizeRefractiveIndexSpec(n);
 	        this.n_after = normalizeRefractiveIndexSpec(n_after);
@@ -8807,13 +8815,6 @@
 	    return (((180 - t) % 180) + 180) % 180;
 	};
 
-	const DegToTABO = (degree) => {
-	    const d = Number(degree);
-	    if (!Number.isFinite(d))
-	        return 0;
-	    return (((180 - d) % 180) + 180) % 180;
-	};
-
 	/**
 	 * legacy simulator.js를 TypeScript로 옮긴 핵심 시뮬레이터입니다.
 	 * - 광원 광선을 생성하고
@@ -9181,12 +9182,19 @@
 	        }
 	        return { m, j0, j45 };
 	    }
+	    /** 난시 주경선 TABO 각도: 180° 동치이므로 표시·비교는 항상 [0, 180)으로 맞춘다. */
+	    normalizeTaboMeridian180(value) {
+	        const d = Number(value ?? 0);
+	        if (!Number.isFinite(d))
+	            return 0;
+	        return ((d % 180) + 180) % 180;
+	    }
 	    principalMeridiansFromVector(m, j0, j45) {
 	        if (!Number.isFinite(m) || !Number.isFinite(j0) || !Number.isFinite(j45))
 	            return [];
 	        const axisDeg = (((0.5 * Math.atan2(j45, j0) * 180) / Math.PI) % 180 + 180) % 180;
-	        const taboAxis = this.normalizeAngle360(TABOToDeg(axisDeg));
-	        const orthogonalTabo = this.normalizeAngle360(taboAxis + 90);
+	        const taboAxis = this.normalizeTaboMeridian180(TABOToDeg(axisDeg));
+	        const orthogonalTabo = (taboAxis + 90) % 180;
 	        const r = Math.hypot(j0, j45);
 	        const meridians = [
 	            { tabo: taboAxis, d: m - r },

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

@@ -294,6 +294,8 @@ export declare class SCAXEngineCore {
     private isRayInsidePupil;
     private powerVectorFromCylinder;
     private aggregatePowerVector;
+    /** 난시 주경선 TABO 각도: 180° 동치이므로 표시·비교는 항상 [0, 180)으로 맞춘다. */
+    private normalizeTaboMeridian180;
     private principalMeridiansFromVector;
     private principalMeridiansFromPowers;
     private normalizePrismAmount;

package/dist/types/surfaces/st-surface.d.ts

@@ -17,6 +17,7 @@ export type STSurfaceProps = {
     r?: number;
     s: number;
     c: number;
+    /** 실린더 축, TABO(°). 내부 저장은 TABOToDeg 변환 후 각도이다. */
     ax: number;
     n_before: RefractiveIndexSpec;
     n: RefractiveIndexSpec;

package/package.json

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