runmat 0.5.7-dev.3 → 0.5.7-dev.4

package/dist/generated/builtins/plotmatrix.js

@@ -0,0 +1,94 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "plotmatrix",
+    "category": "plotting",
+    "keywords": [
+        "plotmatrix",
+        "scatter",
+        "matrix plot",
+        "plotting",
+        "statistics"
+    ],
+    "summary": "Create a scatter plot matrix from matrix columns.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`plotmatrix` is a rendering sink. MATLAB accepts gpuArray inputs for this builtin but executes on the CPU. RunMat gathers input matrices when needed, slices columns on the host, and delegates rendering to existing `scatter` and `histogram` plotting paths."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::plotmatrix::tests",
+        "integration": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`plotmatrix` builds a grid of axes where each off-diagonal subplot compares one variable column against another. The one-input form also places histograms on the diagonal. Matrix rows are observations and columns are variables; vector inputs are treated as one variable.",
+    "behaviors": [
+        "`plotmatrix(X)` creates an `n` by `n` grid for the `n` variables in `X`, with diagonal histograms and off-diagonal scatter plots.",
+        "`plotmatrix(X,LineSpec)` applies the line specification to off-diagonal scatter plots while retaining diagonal histograms.",
+        "`plotmatrix(X,Y)` creates an `n` by `m` rectangular grid for `n` columns in `X` and `m` columns in `Y`; diagonal histogram outputs are empty for this form.",
+        "`plotmatrix(X,Y,lineSpec)` applies the line specification to scatter plots in the matrix.",
+        "`plotmatrix(ax,...)` uses the supplied axes as the compatibility big-axes target.",
+        "`[S,AX,BigAx,H,HAx] = plotmatrix(X)` returns the scatter handle matrix, axes handle matrix, current big-axes handle, diagonal histogram handles, and diagonal histogram axes handles.",
+        "Inputs must be numeric and must have the same number of observations when both `X` and `Y` are supplied.",
+        "Diagonal histograms are created through the same `histogram` builtin path as direct histogram calls."
+    ],
+    "examples": [
+        {
+            "description": "Plot pairwise relationships between columns",
+            "input": "X = [1 10; 2 20; 3 30; 4 40];\nS = plotmatrix(X);"
+        },
+        {
+            "description": "Compare X columns against a separate response column",
+            "input": "X = [1 10; 2 20; 3 30];\nY = [4; 5; 6];\n[S,AX] = plotmatrix(X, Y, 'r+');"
+        },
+        {
+            "description": "Inspect diagonal histogram handles",
+            "input": "X = [1 10; 2 20; 3 30];\n[S,AX,BigAx,H,HAx] = plotmatrix(X);\nnumel(H)",
+            "output": "ans =\n     2"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does plotmatrix preserve gpuArray residency?",
+            "answer": "No. `plotmatrix` is a CPU-rendered plotting sink, matching MATLAB's documented gpuArray behavior for this function. Individual scatter/histogram rendering then follows the existing plotting paths."
+        },
+        {
+            "question": "What is BigAx in RunMat?",
+            "answer": "RunMat returns a valid axes handle and leaves it as `gca` so scripts can pass it to labeling/property helpers. The current renderer does not model MATLAB's invisible spanning axes as a distinct object."
+        }
+    ],
+    "links": [
+        {
+            "label": "scatter",
+            "url": "./scatter"
+        },
+        {
+            "label": "histogram",
+            "url": "./histogram"
+        },
+        {
+            "label": "subplot",
+            "url": "./subplot"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/plotmatrix.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/plotmatrix.rs"
+    },
+    "key": "plotmatrix",
+    "slug": "plotmatrix",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=plotmatrix.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plotmatrix.js","sourceRoot":"","sources":["../../../src/generated/builtins/plotmatrix.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,YAAY;QACZ,SAAS;QACT,aAAa;QACb,UAAU;QACV,YAAY;KACb;IACD,SAAS,EAAE,mDAAmD;IAC9D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iQAAiQ;KAC3Q;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,uCAAuC;QAC/C,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,gRAAgR;IAC/R,WAAW,EAAE;QACX,mIAAmI;QACnI,4HAA4H;QAC5H,6JAA6J;QAC7J,2FAA2F;QAC3F,mFAAmF;QACnF,uLAAuL;QACvL,0GAA0G;QAC1G,sGAAsG;KACvG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,mDAAmD;SAC7D;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,2EAA2E;SACrF;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,sMAAsM;SACjN;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,2MAA2M;SACtN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/plotyy.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=plotyy.d.ts.map

package/dist/generated/builtins/plotyy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotyy.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/plotyy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA6GjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/plotyy.js

@@ -0,0 +1,114 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "plotyy",
+    "category": "plotting",
+    "keywords": [
+        "plotyy",
+        "dual y axis",
+        "plotting",
+        "legacy"
+    ],
+    "summary": "Plot two data sets with independent left and right Y axes.",
+    "status": "done",
+    "version_added": "0.5.3",
+    "tests": {
+        "unit": "builtins::plotting::plotyy::tests",
+        "vm": "runmat-vm plotting::plotyy_dispatches_and_returns_dual_axes_outputs"
+    },
+    "description": "`plotyy` creates two overlaid Cartesian axes in the current figure, plots the first data set against the left Y axis, plots the second data set against the right Y axis, and returns the axes and line handles. It is a legacy MATLAB compatibility helper; new MATLAB code generally uses `yyaxis`.",
+    "syntax": [
+        "ax = plotyy(X1, Y1, X2, Y2)",
+        "[ax, h1, h2] = plotyy(X1, Y1, X2, Y2)",
+        "[ax, h1, h2] = plotyy(X1, Y1, X2, Y2, fun)",
+        "[ax, h1, h2] = plotyy(X1, Y1, X2, Y2, fun1, fun2)"
+    ],
+    "arguments": [
+        {
+            "name": "X1, Y1",
+            "type": "numeric arrays",
+            "description": "Data plotted against the left Y axis. Data shape handling is delegated to the low-level `line` primitive."
+        },
+        {
+            "name": "X2, Y2",
+            "type": "numeric arrays",
+            "description": "Data plotted against the right Y axis. Data shape handling is delegated to the low-level `line` primitive."
+        },
+        {
+            "name": "fun, fun1, fun2",
+            "type": "function handle | string | character vector",
+            "description": "Optional plotting function selectors. Supported values are `plot`, `line`, `semilogx`, `semilogy`, and `loglog`."
+        }
+    ],
+    "outputs": [
+        {
+            "name": "ax",
+            "type": "numeric row vector",
+            "description": "Two axes handles `[left right]`."
+        },
+        {
+            "name": "h1",
+            "type": "numeric scalar | numeric row vector",
+            "description": "Line handle or handles for the left axes."
+        },
+        {
+            "name": "h2",
+            "type": "numeric scalar | numeric row vector",
+            "description": "Line handle or handles for the right axes."
+        }
+    ],
+    "examples": [
+        {
+            "description": "Plot two series with separate Y axes",
+            "input": "[ax,h1,h2] = plotyy(1:3, [10 20 30], 1:3, [100 400 900]);\nget(ax(2), 'YAxisLocation')",
+            "output": "right"
+        },
+        {
+            "description": "Use logarithmic plotting functions",
+            "input": "[ax,h1,h2] = plotyy(1:3, [10 20 30], 1:3, [100 400 900], 'semilogx', 'semilogy');\n{get(ax(1),'XScale'), get(ax(2),'YScale')}",
+            "output": "{'log', 'log'}"
+        }
+    ],
+    "notes": [
+        "`plotyy` returns the left axes as the current axes after plotting.",
+        "The right axes shares the primary plot viewport and stores `YAxisLocation` as `right`.",
+        "For compatibility with existing RunMat plotting primitives, line creation uses the same handle and data-shape behavior as `line`."
+    ],
+    "gpu_residency": "`plotyy` is a plotting sink. It delegates line creation to the existing low-level `line` path, so GPU-resident inputs follow the same residency behavior as `line` and are not gathered by `plotyy` itself.",
+    "related": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "line",
+            "url": "./line"
+        },
+        {
+            "label": "semilogx",
+            "url": "./semilogx"
+        },
+        {
+            "label": "semilogy",
+            "url": "./semilogy"
+        },
+        {
+            "label": "loglog",
+            "url": "./loglog"
+        }
+    ],
+    "implemented_in": [
+        {
+            "label": "crates/runmat-runtime/src/builtins/plotting/ops/plotyy.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/plotyy.rs"
+        }
+    ],
+    "key": "plotyy",
+    "slug": "plotyy",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=plotyy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plotyy.js","sourceRoot":"","sources":["../../../src/generated/builtins/plotyy.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,aAAa;QACb,UAAU;QACV,QAAQ;KACT;IACD,SAAS,EAAE,4DAA4D;IACvE,QAAQ,EAAE,MAAM;IAChB,eAAe,EAAE,OAAO;IACxB,OAAO,EAAE;QACP,MAAM,EAAE,mCAAmC;QAC3C,IAAI,EAAE,qEAAqE;KAC5E;IACD,aAAa,EAAE,uSAAuS;IACtT,QAAQ,EAAE;QACR,6BAA6B;QAC7B,uCAAuC;QACvC,4CAA4C;QAC5C,mDAAmD;KACpD;IACD,WAAW,EAAE;QACX;YACE,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,gBAAgB;YACxB,aAAa,EAAE,2GAA2G;SAC3H;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,gBAAgB;YACxB,aAAa,EAAE,4GAA4G;SAC5H;QACD;YACE,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,6CAA6C;YACrD,aAAa,EAAE,kHAAkH;SAClI;KACF;IACD,SAAS,EAAE;QACT;YACE,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,oBAAoB;YAC5B,aAAa,EAAE,kCAAkC;SAClD;QACD;YACE,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,qCAAqC;YAC7C,aAAa,EAAE,2CAA2C;SAC3D;QACD;YACE,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,qCAAqC;YAC7C,aAAa,EAAE,4CAA4C;SAC5D;KACF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,wFAAwF;YACjG,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,+HAA+H;YACxI,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,OAAO,EAAE;QACP,oEAAoE;QACpE,wFAAwF;QACxF,mIAAmI;KACpI;IACD,eAAe,EAAE,6MAA6M;IAC9N,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,OAAO,EAAE,2DAA2D;YACpE,KAAK,EAAE,0GAA0G;SAClH;KACF;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/plus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plus.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/plus.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAiPjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"plus.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/plus.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAsPjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/plus.js

@@ -44,6 +44,7 @@ const builtinDoc = {
         "Complex operands follow MATLAB's analytic rule `(a + ib) + (c + id) = (a + c) + i(b + d)`.",
         "Empty dimensions propagate naturally—if either operand has a zero-sized dimension after broadcasting, the result is empty with the broadcasted shape.",
         "Integer inputs promote to double precision before addition, mirroring MATLAB behaviour and keeping numeric tower rules consistent with other RunMat arithmetic builtins.",
+        "Sparse real matrices interoperate with sparse, dense, logical, character, scalar, and complex operands. Sparse-sparse addition preserves sparse storage; dense, nonzero scalar, and complex interop returns full real or complex storage when implicit zeros become nonzero.",
         "The optional `'like'` prototype makes the output adopt the residency (host or GPU) and complexity characteristics of the prototype, which is particularly useful for keeping implicit-expansion expressions on the device."
     ],
     "examples": [
@@ -111,6 +112,10 @@ const builtinDoc = {
             "question": "Can I mix complex and real operands?",
             "answer": "Absolutely. The result is complex, with broadcasting rules identical to MATLAB."
         },
+        {
+            "question": "Does `plus` preserve sparse matrices?",
+            "answer": "Sparse-sparse addition returns sparse storage, including scalar sparse expansion when the result fits the sparse materialization limit. Adding dense, complex, or nonzero full scalar operands returns full storage because implicit sparse zeros become stored nonzero values."
+        },
         {
             "question": "What about string arrays?",
             "answer": "String arrays are not numeric and therefore raise an error when passed to `plus`."

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

@@ -1 +1 @@
-{"version":3,"file":"plus.js","sourceRoot":"","sources":["../../../src/generated/builtins/plus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plus.js","sourceRoot":"","sources":["../../../src/generated/builtins/plus.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/pointLocation.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=pointLocation.d.ts.map

package/dist/generated/builtins/pointLocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointLocation.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/pointLocation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA4DjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pointLocation.js

@@ -0,0 +1,65 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pointLocation",
+    "category": "geometry/triangulation",
+    "keywords": [
+        "pointLocation",
+        "DelaunayTri",
+        "triangulation",
+        "barycentric",
+        "geometry"
+    ],
+    "summary": "Locate query points in a DelaunayTri triangulation.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`pointLocation` reads host triangulation topology and returns dense host results."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::geometry::triangulation::tests",
+        "integration": null
+    },
+    "description": "`pointLocation(dt, q)` returns the containing triangle index for each query point in a 2-D `DelaunayTri` object. With two outputs, RunMat also returns barycentric coordinates.",
+    "behaviors": [
+        "Accepts query matrices or paired coordinate vectors.",
+        "Returns an N-by-1 tensor of one-based triangle indices.",
+        "Outside points return NaN.",
+        "With two requested outputs, returns `[ti, bc]` where `bc` is N-by-3."
+    ],
+    "examples": [
+        {
+            "description": "Locate a point",
+            "input": "dt = DelaunayTri([0 0; 1 0; 0 1]);\nti = pointLocation(dt, [0.25 0.25]);"
+        }
+    ],
+    "faqs": [],
+    "links": [
+        {
+            "label": "DelaunayTri",
+            "url": "./DelaunayTri"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/geometry/triangulation.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/geometry/triangulation.rs"
+    },
+    "key": "pointlocation",
+    "slug": "pointlocation",
+    "aliases": [],
+    "categoryPath": [
+        "geometry",
+        "triangulation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pointLocation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pointLocation.js","sourceRoot":"","sources":["../../../src/generated/builtins/pointLocation.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE;QACV,eAAe;QACf,aAAa;QACb,eAAe;QACf,aAAa;QACb,UAAU;KACX;IACD,SAAS,EAAE,qDAAqD;IAChE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mFAAmF;KAC7F;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0CAA0C;QAClD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,iLAAiL;IAChM,WAAW,EAAE;QACX,sDAAsD;QACtD,yDAAyD;QACzD,4BAA4B;QAC5B,sEAAsE;KACvE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,0EAA0E;SACpF;KACF;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;QACV,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pol2cart.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=pol2cart.d.ts.map

package/dist/generated/builtins/pol2cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pol2cart.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/pol2cart.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAwGjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pol2cart.js

@@ -0,0 +1,109 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pol2cart",
+    "category": "math/trigonometry",
+    "keywords": [
+        "pol2cart",
+        "polar",
+        "cylindrical",
+        "cartesian",
+        "coordinates",
+        "trigonometry",
+        "gpu"
+    ],
+    "summary": "Transform polar or cylindrical coordinates to Cartesian coordinates.",
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "Real gpuArray inputs stay resident when the active provider implements unary sin/cos and broadcasted elementwise multiply. Providers without those hooks fall back to the host implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline",
+        "notes": "pol2cart returns multiple outputs and is treated as a terminal coordinate transform."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::trigonometry::pol2cart::tests",
+        "integration": "builtins::math::trigonometry::pol2cart::tests::gpu_inputs_keep_resident_outputs"
+    },
+    "description": "`[x,y] = pol2cart(theta,rho)` converts polar coordinates to Cartesian coordinates. `[x,y,z] = pol2cart(theta,rho,z)` converts cylindrical coordinates and returns the elevation after MATLAB-style implicit expansion.",
+    "behaviors": [
+        "Inputs must be real floating-point scalars, vectors, matrices, or N-D tensors.",
+        "`theta`, `rho`, and optional `z` must have the same size or compatible sizes for implicit expansion.",
+        "`x` is computed as `rho .* cos(theta)` and `y` is computed as `rho .* sin(theta)`.",
+        "For cylindrical coordinates, the output `z` is the input elevation expanded to the same size as `x` and `y`.",
+        "Complex inputs are rejected, matching current MATLAB behavior.",
+        "Integer, logical, string, char, cell, struct, and object inputs are rejected because MATLAB documents `pol2cart` for real `single` and `double` data.",
+        "With no explicit multi-output context, RunMat returns the first output, `x`, matching MATLAB's single-output assignment behavior."
+    ],
+    "examples": [
+        {
+            "description": "Converting polar coordinates",
+            "input": "theta = [0 pi/4 pi/2 pi];\nrho = [5 5 10 10];\n[x,y] = pol2cart(theta,rho)",
+            "output": "x = [5.0000 3.5355 0 -10.0000]\ny = [0 3.5355 10.0000 0]"
+        },
+        {
+            "description": "Converting cylindrical coordinates",
+            "input": "theta = [0 pi/2]';\nrho = [1 2 3];\nz = 7;\n[x,y,z] = pol2cart(theta,rho,z)",
+            "output": "x =\n     1     2     3\n     0     0     0\ny =\n     0     0     0\n     1     2     3\nz =\n     7     7     7\n     7     7     7"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What angle units does `pol2cart` use?",
+            "answer": "`theta` is in radians, measured counterclockwise from the positive x-axis."
+        },
+        {
+            "question": "Can I request only two outputs with three inputs?",
+            "answer": "Yes. `[x,y] = pol2cart(theta,rho,z)` computes the cylindrical transform but returns only `x` and `y`."
+        },
+        {
+            "question": "Does `pol2cart` accept complex inputs?",
+            "answer": "No. Current MATLAB releases reject complex inputs, and RunMat does the same."
+        },
+        {
+            "question": "Does RunMat keep `pol2cart` on the GPU?",
+            "answer": "Yes for real gpuArray inputs when the active provider supports the required sin, cos, and broadcasted multiply hooks. The returned `x`, `y`, and requested `z` outputs remain gpuArray values. Providers without those hooks fall back to host evaluation."
+        }
+    ],
+    "links": [
+        {
+            "label": "atan2",
+            "url": "./atan2"
+        },
+        {
+            "label": "hypot",
+            "url": "./hypot"
+        },
+        {
+            "label": "cos",
+            "url": "./cos"
+        },
+        {
+            "label": "sin",
+            "url": "./sin"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/trigonometry/pol2cart.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/trigonometry/pol2cart.rs"
+    },
+    "key": "pol2cart",
+    "slug": "pol2cart",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "trigonometry"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pol2cart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pol2cart.js","sourceRoot":"","sources":["../../../src/generated/builtins/pol2cart.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,UAAU;QACV,OAAO;QACP,aAAa;QACb,WAAW;QACX,aAAa;QACb,cAAc;QACd,KAAK;KACN;IACD,SAAS,EAAE,sEAAsE;IACjF,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,gMAAgM;KAC1M;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,sFAAsF;KAChG;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,iFAAiF;KACjG;IACD,aAAa,EAAE,wNAAwN;IACvO,WAAW,EAAE;QACX,gFAAgF;QAChF,sGAAsG;QACtG,oFAAoF;QACpF,8GAA8G;QAC9G,gEAAgE;QAChE,uJAAuJ;QACvJ,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,0DAA0D;SACrE;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6EAA6E;YACtF,QAAQ,EAAE,uIAAuI;SAClJ;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,4EAA4E;SACvF;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,uGAAuG;SAClH;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,4PAA4P;SACvQ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/polarhistogram.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=polarhistogram.d.ts.map

package/dist/generated/builtins/polarhistogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polarhistogram.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/polarhistogram.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAgHjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/polarhistogram.js

@@ -0,0 +1,117 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "polarhistogram",
+    "category": "plotting",
+    "keywords": [
+        "polarhistogram",
+        "polar histogram",
+        "angular histogram",
+        "theta bins",
+        "matlab polarhistogram",
+        "plotting"
+    ],
+    "summary": "Create histogram charts in polar coordinates.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`polarhistogram` is a rendering sink. Angular samples are materialized for `histcounts` binning, then the resulting bin counts are rendered as polar wedge geometry through `runmat-plot`."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::polarhistogram::tests and runmat_plot::plots::bar::tests",
+        "vm": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`polarhistogram(theta)` bins angular samples in radians and renders each bin as a polar wedge whose radius is the bin count or normalized bin value. Theta values wrap periodically into the selected angular range. The returned handle reuses MATLAB-style histogram object properties such as `BinEdges`, `BinCounts`, `Values`, `Data`, `NumBins`, `BinWidth`, `BinLimits`, `Normalization`, `DisplayStyle`, `FaceColor`, `FaceAlpha`, `EdgeColor`, and `DisplayName`.",
+    "behaviors": [
+        "`polarhistogram(theta)` creates a histogram object handle and marks the target axes as polar with equal x/y scaling. With no bin controls it uses six angular bins spanning `[0, 2*pi]`.",
+        "`polarhistogram(theta, nbins)` and `polarhistogram(theta, edges)` use the same scalar bin-count and explicit edge-vector semantics as `histcounts`.",
+        "Finite theta samples are wrapped into the chosen angular range before binning; non-finite samples are ignored by the histogram counts and exposed as `NaN` in normalized stored `Data`.",
+        "Name/value bin controls such as `BinEdges`, `NumBins`, `BinWidth`, `BinLimits`, `Normalization`, and `BinMethod` are forwarded through the same binning implementation as `histogram`.",
+        "`polarhistogram('BinEdges', edges, 'BinCounts', counts)` creates a polar histogram from precomputed bin counts without sample data.",
+        "`DisplayStyle` accepts `bar` and `stairs`; `stairs` renders the outer polar bin arcs without filled radial wedges.",
+        "Common bar styling arguments such as `FaceColor`, `EdgeColor`, `LineWidth`, `BarWidth`, `FaceAlpha`, and `DisplayName` are accepted.",
+        "The target axes form `polarhistogram(ax, ...)` plots into an existing axes handle.",
+        "The returned handle has type `histogram`; `get` exposes histogram state and supported `set` calls update `Normalization`, `DisplayName`, `DisplayStyle`, `FaceColor`, `FaceAlpha`, and `EdgeColor`."
+    ],
+    "examples": [
+        {
+            "description": "Create a polar histogram",
+            "input": "theta = 2*pi*rand(1, 1000);\nh = polarhistogram(theta);",
+            "output": "% h is a histogram object handle"
+        },
+        {
+            "description": "Use explicit angular bin edges",
+            "input": "theta = [0 0.2 1.0 2.0];\nedges = 0:pi/4:2*pi;\nh = polarhistogram(theta, edges);\nget(h, 'BinEdges');"
+        },
+        {
+            "description": "Normalize and style the chart",
+            "input": "theta = 2*pi*rand(1, 500);\nh = polarhistogram(theta, 'NumBins', 16, 'Normalization', 'probability', 'FaceColor', 'red', 'DisplayName', 'angles');\nget(h, 'Normalization')",
+            "output": "ans =\n    'probability'"
+        },
+        {
+            "description": "Plot precomputed polar bin counts with stairs display",
+            "input": "edges = [0 pi 2*pi];\ncounts = [4 2];\nh = polarhistogram('BinEdges', edges, 'BinCounts', counts, 'DisplayStyle', 'stairs');\nget(h, 'BinCounts');"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are theta values interpreted in degrees?",
+            "answer": "No. Like MATLAB, `polarhistogram` interprets theta samples and explicit bin edges in radians."
+        },
+        {
+            "question": "Does polarhistogram return a special handle type?",
+            "answer": "The returned object follows the histogram handle path, so `get(h, 'Type')` returns `histogram` and histogram properties such as `BinEdges`, `BinCounts`, `Values`, `Data`, `NumBins`, `BinWidth`, `BinLimits`, `Normalization`, `DisplayStyle`, and `DisplayName` are available."
+        },
+        {
+            "question": "What happens to angles outside 0 to 2*pi?",
+            "answer": "Finite values are wrapped periodically into the selected angular range before binning. For example, `0`, `2*pi`, and `-2*pi` contribute to the same default angular bin."
+        },
+        {
+            "question": "Can polarhistogram plot GPU arrays?",
+            "answer": "GPU-resident inputs are accepted through the underlying histogram evaluation path, but the current implementation gathers angular samples for binning before rendering polar wedge geometry. A direct provider binning fast path belongs to the queued GPU audit work."
+        }
+    ],
+    "links": [
+        {
+            "label": "histogram",
+            "url": "./histogram"
+        },
+        {
+            "label": "histcounts",
+            "url": "./histcounts"
+        },
+        {
+            "label": "polarplot",
+            "url": "./polarplot"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/polarhistogram.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/polarhistogram.rs"
+    },
+    "key": "polarhistogram",
+    "slug": "polarhistogram",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=polarhistogram.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polarhistogram.js","sourceRoot":"","sources":["../../../src/generated/builtins/polarhistogram.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,gBAAgB;QAChB,iBAAiB;QACjB,mBAAmB;QACnB,YAAY;QACZ,uBAAuB;QACvB,UAAU;KACX;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4LAA4L;KACtM;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8EAA8E;QACtF,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,4cAA4c;IAC3d,WAAW,EAAE;QACX,0LAA0L;QAC1L,qJAAqJ;QACrJ,yLAAyL;QACzL,wLAAwL;QACxL,qIAAqI;QACrI,oHAAoH;QACpH,sIAAsI;QACtI,oFAAoF;QACpF,qMAAqM;KACtM;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,wGAAwG;SAClH;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,6KAA6K;YACtL,QAAQ,EAAE,0BAA0B;SACrC;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,oJAAoJ;SAC9J;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,kRAAkR;SAC7R;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,0KAA0K;SACrL;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,wQAAwQ;SACnR;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/polarscatter.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=polarscatter.d.ts.map

package/dist/generated/builtins/polarscatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polarscatter.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/polarscatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAqGjB,CAAC;AAEF,eAAe,UAAU,CAAC"}