runmat 0.4.9-dev.1 → 0.4.9

package/dist/generated/builtins/tand.js

@@ -0,0 +1,109 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "tand",
+    "category": "math/trigonometry",
+    "keywords": [
+        "tand",
+        "tangent",
+        "degrees",
+        "angle",
+        "trigonometry",
+        "elementwise"
+    ],
+    "summary": "Tangent of angles expressed in degrees with MATLAB-exact poles at +/-90 and exact zeros at multiples of 180.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "elementwise",
+        "notes": "GPU inputs are gathered to the host so the reference implementation can guarantee MATLAB-exact values at canonical multiples of 45, 90, and 180 degrees, including the +/-Inf poles at +/-90."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline",
+        "notes": "Fusion is intentionally disabled for v1 because the WGSL `tan(x*pi/180)` form would replace MATLAB's +/-Inf poles with very large but finite values."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::trigonometry::tand::tests",
+        "integration": null
+    },
+    "description": "`y = tand(x)` evaluates the tangent of each angle in `x`, interpreting the values in degrees rather than radians. The implementation reduces the angle modulo 360 and special-cases 0, 45, 90, 135, and 180 (and their negative/wrapped counterparts) so multiples of 180 return an exact 0, multiples of 45 return ±1, and the poles at +90 and -90 return +Inf and -Inf respectively.",
+    "behaviors": [
+        "Operates element-wise on scalars, vectors, matrices, and N-D tensors.",
+        "Integer and logical inputs are promoted to double precision before evaluation.",
+        "Returns exactly 0 at multiples of 180 and exactly ±1 at multiples of 45.",
+        "Returns +Inf at +90 (and angles equivalent under modulo 360) and -Inf at -90 (and equivalent angles).",
+        "Complex inputs delegate to the analytic extension of `tan` after scaling by `pi/180`; exact-value treatment for complex operands is deferred.",
+        "Output shape matches the input shape; non-finite inputs propagate as `NaN`.",
+        "String inputs are unsupported and raise a builtin-scoped error."
+    ],
+    "examples": [
+        {
+            "description": "Tangent of a canonical degree angle",
+            "input": "y = tand(45)",
+            "output": "y = 1"
+        },
+        {
+            "description": "Tangent at the +/-90 poles returns +/-Inf",
+            "input": "y = tand([90 -90])",
+            "output": "y = [Inf -Inf]"
+        },
+        {
+            "description": "Tangent of a multiple of 180 returns exactly zero",
+            "input": "y = tand(180)",
+            "output": "y = 0"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why does `tand(90)` return Inf instead of a very large finite number?",
+            "answer": "MATLAB defines `tand(90) = Inf` and `tand(-90) = -Inf` at the poles. Naively evaluating `tan(90*pi/180)` would return a huge finite number because `pi/180` is not exact in floating point, so RunMat short-circuits the poles to match MATLAB."
+        },
+        {
+            "question": "Is `tand(x)` equivalent to `tan(x*pi/180)`?",
+            "answer": "Mathematically yes, but the floating-point result differs at canonical angles. `tand` guarantees exact values at multiples of 45 and 180, and infinite values at +/-90."
+        },
+        {
+            "question": "Does `tand` support arrays?",
+            "answer": "Yes. Scalars, vectors, matrices, and N-D tensors are all handled element-wise; the shape of the input is preserved."
+        }
+    ],
+    "links": [
+        {
+            "label": "sind",
+            "url": "./sind"
+        },
+        {
+            "label": "cosd",
+            "url": "./cosd"
+        },
+        {
+            "label": "tan",
+            "url": "./tan"
+        },
+        {
+            "label": "deg2rad",
+            "url": "./deg2rad"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/trigonometry/tand.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/trigonometry/tand.rs"
+    },
+    "key": "tand",
+    "slug": "tand",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "trigonometry"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=tand.js.map

package/dist/generated/builtins/tand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tand.js","sourceRoot":"","sources":["../../../src/generated/builtins/tand.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,8GAA8G;IACzH,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,+LAA+L;KACzM;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,sJAAsJ;KAChK;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,yXAAyX;IACxY,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,0EAA0E;QAC1E,uGAAuG;QACvG,+IAA+I;QAC/I,6EAA6E;QAC7E,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uEAAuE;YACnF,QAAQ,EAAE,iPAAiP;SAC5P;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,yKAAyK;SACpL;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,qHAAqH;SAChI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EAs5PjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAiZ9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}
+{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EA+uQjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAka9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}