runmat 0.5.7-dev.2 → 0.5.7-dev.4

package/dist/generated/builtins/polarscatter.js

@@ -0,0 +1,106 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "polarscatter",
+    "category": "plotting",
+    "keywords": [
+        "polarscatter",
+        "polar scatter",
+        "polar coordinates",
+        "theta rho",
+        "matlab polarscatter",
+        "marker plot"
+    ],
+    "summary": "Create scatter charts in polar coordinates.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "polarscatter is a rendering sink. Real GPU inputs are gathered before polar-to-cartesian conversion; the resulting scatter objects use the normal plotting renderer."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::polarscatter::tests",
+        "integration": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`polarscatter` converts angular/radial point data to cartesian scatter coordinates, marks the active axes as polar, and preserves the original `ThetaData` and `RData` on returned scatter handles.",
+    "behaviors": [
+        "`polarscatter(theta, rho)` interprets theta values as radians and requires theta and rho to have compatible element counts.",
+        "Vector theta with matrix rho, matrix theta with vector rho, and matching theta/rho matrices create one scatter object per matrix column.",
+        "`polarscatter(theta, rho, sz)` accepts scalar, vector, or matrix marker-size data. Matrix sizes are sliced by series when theta/rho expands to multiple scatter objects.",
+        "`polarscatter(theta, rho, sz, c)` accepts the same positional color forms as `scatter`, including color names, RGB triplets, scalar color values, and RGB matrices.",
+        "Marker strings, the `filled` flag, and common scatter name/value options share the parser used by `scatter`.",
+        "The returned value is a scalar scatter handle for one series or a row-vector of scatter handles for multiple series.",
+        "`get(h, 'ThetaData')` and `get(h, 'RData')` return the stored polar source coordinates. Setting either property recomputes the cartesian `XData` and `YData` used by the renderer.",
+        "The target axes are switched to polar mode with equal x/y scaling and symmetric cartesian limits based on the largest radius."
+    ],
+    "options": [
+        "Use `polarscatter(ax, theta, rho, ...)` to target existing axes.",
+        "Use marker symbols such as `'o'`, `'+'`, and `'x'` after the size/color arguments.",
+        "Use `hold on` before additional `polarscatter` calls to overlay more polar scatter objects on the same axes.",
+        "Use `set(h, ...)` on returned handles to update scatter properties after plotting."
+    ],
+    "examples": [
+        {
+            "description": "Create a polar scatter chart",
+            "input": "theta = linspace(0, 2*pi, 20);\nrho = abs(sin(theta));\nh = polarscatter(theta, rho);",
+            "output": "% h is a scatter handle with ThetaData and RData"
+        },
+        {
+            "description": "Use filled markers with sizes and colors",
+            "input": "theta = pi/4:pi/4:2*pi;\nrho = [19 6 12 18 16 11 15 15];\nsz = 100*[6 15 20 3 15 3 6 40];\nc = [1 2 2 2 1 1 2 1];\npolarscatter(theta, rho, sz, c, 'filled');"
+        },
+        {
+            "description": "Create multiple scatter series from a matrix",
+            "input": "theta = [0 pi/6 pi/2];\nrho = [1 2; 2 4; 5 6];\nps = polarscatter(theta, rho, [50 100; 75 125; 100 150]);",
+            "output": "% ps is a row-vector with one handle for each rho column"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does polarscatter keep the original polar data?",
+            "answer": "Yes. The renderer uses cartesian `XData` and `YData`, but the scatter handle also stores `ThetaData` and `RData` for MATLAB-style inspection and updates."
+        },
+        {
+            "question": "Are table-based polarscatter forms supported?",
+            "answer": "The numeric and axes-targeted plotting forms are supported. Table variable forms depend on the broader table plotting surface and are not treated as complete by this builtin alone."
+        }
+    ],
+    "links": [
+        {
+            "label": "scatter",
+            "url": "./scatter"
+        },
+        {
+            "label": "polarplot",
+            "url": "./polarplot"
+        },
+        {
+            "label": "hold",
+            "url": "./hold"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "key": "polarscatter",
+    "slug": "polarscatter",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=polarscatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polarscatter.js","sourceRoot":"","sources":["../../../src/generated/builtins/polarscatter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,cAAc;QACd,eAAe;QACf,mBAAmB;QACnB,WAAW;QACX,qBAAqB;QACrB,aAAa;KACd;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sKAAsK;KAChL;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,yCAAyC;QACjD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,qMAAqM;IACpN,WAAW,EAAE;QACX,6HAA6H;QAC7H,0IAA0I;QAC1I,0KAA0K;QAC1K,qKAAqK;QACrK,8GAA8G;QAC9G,sHAAsH;QACtH,oLAAoL;QACpL,+HAA+H;KAChI;IACD,SAAS,EAAE;QACT,kEAAkE;QAClE,oFAAoF;QACpF,8GAA8G;QAC9G,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,uFAAuF;YAChG,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,+JAA+J;SACzK;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,2GAA2G;YACpH,QAAQ,EAAE,0DAA0D;SACrE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,2JAA2J;SACtK;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,sLAAsL;SACjM;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/prctile.js

@@ -0,0 +1,76 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "prctile",
+    "category": "stats/summary",
+    "keywords": [
+        "prctile",
+        "percentile",
+        "quantile",
+        "statistics"
+    ],
+    "summary": "Compute sample percentiles.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::order_stats::tests",
+        "integration": null
+    },
+    "description": "`prctile(X,p)` computes sample percentiles along the first nonsingleton dimension using linear interpolation.",
+    "behaviors": [
+        "`p` must contain percentages in `[0,100]`.",
+        "`prctile(X,p,dim)` operates along a selected dimension.",
+        "NaNs are omitted by default in each slice.",
+        "`\"omitnan\"` omits NaNs in each slice; `\"includenan\"` returns NaN for slices containing NaN.",
+        "`\"Method\",\"linear\"` and `\"Method\",\"exact\"` use in-memory linear interpolation; `\"approximate\"` is rejected because tall arrays are not supported here."
+    ],
+    "examples": [
+        {
+            "description": "Median percentile",
+            "input": "m = prctile([1 3 10 20], 50)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Can p be a vector?",
+            "answer": "Yes. Vector `p` replaces the operated dimension with the number of requested percentiles."
+        }
+    ],
+    "links": [
+        {
+            "label": "quantile",
+            "url": "./quantile"
+        },
+        {
+            "label": "median",
+            "url": "./median"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/order_stats.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/order_stats.rs"
+    },
+    "key": "prctile",
+    "slug": "prctile",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=prctile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prctile.js","sourceRoot":"","sources":["../../../src/generated/builtins/prctile.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,YAAY;QACZ,UAAU;QACV,YAAY;KACb;IACD,SAAS,EAAE,6BAA6B;IACxC,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kCAAkC;KAC5C;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,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+GAA+G;IAC9H,WAAW,EAAE;QACX,4CAA4C;QAC5C,yDAAyD;QACzD,4CAA4C;QAC5C,iGAAiG;QACjG,kKAAkK;KACnK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,8BAA8B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oBAAoB;YAChC,QAAQ,EAAE,2FAA2F;SACtG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/predecessors.js

@@ -0,0 +1,36 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "predecessors",
+    "category": "graph",
+    "keywords": [
+        "predecessors",
+        "digraph",
+        "graph",
+        "nodes"
+    ],
+    "summary": "Return predecessor nodes.",
+    "status": "implemented",
+    "tested": {
+        "unit": "builtins::graph::tests"
+    },
+    "description": "`predecessors(G,node)` returns incoming neighbors for digraphs and adjacent neighbors for undirected graphs.",
+    "signatures": [
+        {
+            "label": "P = predecessors(G, node)",
+            "description": "Return predecessor nodes."
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/graph/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/graph/mod.rs"
+    },
+    "key": "predecessors",
+    "slug": "predecessors",
+    "aliases": [],
+    "categoryPath": [
+        "graph"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=predecessors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"predecessors.js","sourceRoot":"","sources":["../../../src/generated/builtins/predecessors.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,cAAc;QACd,SAAS;QACT,OAAO;QACP,OAAO;KACR;IACD,SAAS,EAAE,2BAA2B;IACtC,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,MAAM,EAAE,wBAAwB;KACjC;IACD,aAAa,EAAE,8GAA8G;IAC7H,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,2BAA2B;YACpC,aAAa,EAAE,2BAA2B;SAC3C;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/predict.js

@@ -0,0 +1,107 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "predict",
+    "category": "stats/ml",
+    "keywords": [
+        "predict",
+        "fitctree",
+        "classification tree",
+        "fitlm",
+        "linear model",
+        "dlnetwork",
+        "regression",
+        "prediction"
+    ],
+    "summary": "Predict responses from a fitted model.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU predictor inputs are gathered to host for model prediction."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::linear_model::tests; builtins::deep_learning::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`predict(mdl,Xnew)` evaluates supported fitted model objects, including `LinearModel` from `fitlm`, `ClassificationTree` from `fitctree`, and supported Deep Learning network objects, on new predictor data.",
+    "behaviors": [
+        "`Xnew` can be a numeric matrix with the same predictor column count used during fitting.",
+        "For table input, predictor variables are selected by the model's `PredictorNames` property.",
+        "For `LinearModel`, `[ypred,yci] = predict(...)` returns pointwise confidence intervals for curve predictions by default.",
+        "For `ClassificationTree`, `[label,score,node,cnum] = predict(...)` returns predicted class labels, posterior probabilities, one-based leaf node ids, and one-based class-number predictions.",
+        "For `dlnetwork`, `SeriesNetwork`, and `DAGNetwork` compatibility objects, `predict(net,Xnew)` returns the score/activation matrix for the supported sequential feed-forward layer subset also used by `forward`.",
+        "Deep Learning prediction accepts `ObservationsIn` with `rows` or `columns`; column-observation input is transposed before execution.",
+        "Linear-model name-value options `Alpha`, `Prediction`, and `Simultaneous` are accepted. `Prediction` can be `curve` or `observation`; `Simultaneous` must be false because simultaneous intervals are not supported yet.",
+        "Classification-tree prediction currently accepts matrix or table predictor data and raises explicit errors for unsupported pruning/subtree options."
+    ],
+    "examples": [
+        {
+            "description": "Predict from a linear model",
+            "input": "mdl = fitlm([0; 1; 2; 3], [1; 3; 5; 7]);\nyhat = predict(mdl, [4; 5])",
+            "output": "yhat is approximately [9; 11]."
+        },
+        {
+            "description": "Return confidence intervals",
+            "input": "[yhat, yci] = predict(mdl, [4; 5], 'Alpha', 0.01)",
+            "output": "yci is a two-column matrix with lower and upper bounds."
+        },
+        {
+            "description": "Predict classes from a classification tree",
+            "input": "tree = fitctree([0; 1; 2; 3], [0; 0; 1; 1], 'MaxNumSplits', 1, 'MinParentSize', 2);\n[label,score] = predict(tree, [0.5; 2.5])",
+            "output": "label is [0; 1], and score has one posterior-probability column per class."
+        },
+        {
+            "description": "Predict from a dlnetwork",
+            "input": "layers = {featureInputLayer(2,'Name','in'); fullyConnectedLayer(2,'Name','fc'); softmaxLayer('Name','prob')};\nnet = dlnetwork(layers);\nscores = predict(net, [1 2; 3 4])",
+            "output": "scores has one row per observation."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Which model classes are supported?",
+            "answer": "Currently `predict` supports `LinearModel` objects returned by `fitlm`, `ClassificationTree` objects returned by `fitctree`, and supported Deep Learning network compatibility objects."
+        }
+    ],
+    "links": [
+        {
+            "label": "dlnetwork",
+            "url": "./dlnetwork"
+        },
+        {
+            "label": "forward",
+            "url": "./forward"
+        },
+        {
+            "label": "fitctree",
+            "url": "./fitctree"
+        },
+        {
+            "label": "fitlm",
+            "url": "./fitlm"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/linear_model.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/linear_model.rs"
+    },
+    "key": "predict",
+    "slug": "predict",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=predict.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"predict.js","sourceRoot":"","sources":["../../../src/generated/builtins/predict.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,UAAU;QACV,qBAAqB;QACrB,OAAO;QACP,cAAc;QACd,WAAW;QACX,YAAY;QACZ,YAAY;KACb;IACD,SAAS,EAAE,wCAAwC;IACnD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iEAAiE;KAC3E;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,0EAA0E;QAClF,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,+MAA+M;IAC9N,WAAW,EAAE;QACX,0FAA0F;QAC1F,6FAA6F;QAC7F,0HAA0H;QAC1H,8LAA8L;QAC9L,kNAAkN;QAClN,sIAAsI;QACtI,0NAA0N;QAC1N,qJAAqJ;KACtJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,uEAAuE;YAChF,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,yDAAyD;SACpE;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,gIAAgI;YACzI,QAAQ,EAAE,4EAA4E;SACvF;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,4KAA4K;YACrL,QAAQ,EAAE,qCAAqC;SAChD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/primes.js

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "primes",
+    "category": "math/discrete",
+    "keywords": [
+        "primes",
+        "prime",
+        "number theory",
+        "discrete math",
+        "sieve"
+    ],
+    "summary": "Return prime numbers less than or equal to a scalar bound in MATLAB and RunMat.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "gpuArray scalar inputs are gathered to the host. The output is a host row vector because primes is a variable-size generator rather than an element-wise GPU operation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::discrete::primes::tests",
+        "integration": null
+    },
+    "description": "`primes(n)` returns a 1-by-N row vector containing every prime number less than or equal to scalar real integer `n`. Values below 2 return an empty 1-by-0 row vector.",
+    "behaviors": [
+        "`n` must be a scalar, finite, real integer value.",
+        "Double scalar inputs return a double row vector.",
+        "Single and supported unsigned integer tensor/scalar inputs preserve their output dtype (`single`, `uint8`, `uint16`, or `uint32`).",
+        "Signed integer and `uint64` scalar bounds are accepted and return a double row vector until RunMat tensors include signed integer and `uint64` array storage.",
+        "Logical, complex, non-scalar, non-finite, and fractional inputs raise an error.",
+        "Requests above RunMat's bounded sieve safety limit are rejected before allocation."
+    ],
+    "examples": [
+        {
+            "description": "Prime numbers less than or equal to 25",
+            "input": "p = primes(25)",
+            "output": "p = [2 3 5 7 11 13 17 19 23]"
+        },
+        {
+            "description": "Prime numbers less than or equal to an unsigned integer",
+            "input": "p = primes(uint16(12))",
+            "output": "p = uint16([2 3 5 7 11])"
+        },
+        {
+            "description": "No prime numbers below two",
+            "input": "p = primes(1)",
+            "output": "p = 1x0 empty double row vector"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does primes accept arrays?",
+            "answer": "No. MATLAB defines `n` as a scalar upper bound, and RunMat rejects non-scalar inputs."
+        },
+        {
+            "question": "Why does RunMat reject very large values of n?",
+            "answer": "The implementation uses a host sieve and rejects requests above its safety limit before allocation to avoid unbounded memory use."
+        },
+        {
+            "question": "Does primes keep integer output classes?",
+            "answer": "RunMat preserves supported unsigned integer tensor classes. Signed integer and `uint64` array classes are not yet represented by RunMat tensors, so those scalar bounds are accepted and returned as double row vectors for compatibility with common MATLAB call sites."
+        }
+    ],
+    "links": [
+        {
+            "label": "factorial",
+            "url": "./factorial"
+        },
+        {
+            "label": "nchoosek",
+            "url": "./nchoosek"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/discrete/primes.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/discrete/primes.rs"
+    },
+    "key": "primes",
+    "slug": "primes",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "discrete"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=primes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primes.js","sourceRoot":"","sources":["../../../src/generated/builtins/primes.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,QAAQ;QACR,OAAO;QACP,eAAe;QACf,eAAe;QACf,OAAO;KACR;IACD,SAAS,EAAE,iFAAiF;IAC5F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yKAAyK;KACnL;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,yCAAyC;QACjD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,wKAAwK;IACvL,WAAW,EAAE;QACX,mDAAmD;QACnD,kDAAkD;QAClD,oIAAoI;QACpI,+JAA+J;QAC/J,iFAAiF;QACjF,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,8BAA8B;SACzC;QACD;YACE,aAAa,EAAE,yDAAyD;YACxE,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,0BAA0B;SACrC;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,iCAAiC;SAC5C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,uFAAuF;SAClG;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,0QAA0Q;SACrR;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/pzmap.js

@@ -0,0 +1,139 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pzmap",
+    "category": "control",
+    "keywords": [
+        "pzmap",
+        "pole zero map",
+        "poles",
+        "zeros",
+        "control system",
+        "transfer function",
+        "state space",
+        "ss",
+        "tf"
+    ],
+    "summary": "Plot or return pole-zero locations for SISO transfer-function and state-space models.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`pzmap` computes host-side polynomial roots from transfer-function metadata, converting SISO state-space models to an equivalent transfer function before extraction. GPU-resident coefficient inputs are gathered by `tf` or `ss` before model construction."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`pzmap` performs model analysis and plotting, so it terminates numeric fusion chains."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::pzmap::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`pzmap(sys)` plots poles and zeros for supported SISO `tf` and `ss` models. Output forms return pole and zero locations as column vectors.",
+    "behaviors": [
+        "Supports SISO `tf` objects with real or complex coefficients.",
+        "Supports SISO `ss` objects by converting the state-space model to a transfer-function numerator and denominator.",
+        "No-output calls plot poles with `x` markers and zeros with `o` markers on the complex plane.",
+        "Statement-form plotting accepts one or more `tf` or `ss` systems.",
+        "Statement-form plotting accepts optional line-spec color/style arguments after each system, such as `pzmap(sys1, 'r', sys2, 'b')`; pole and zero markers for the same system use the same color.",
+        "Two-output calls return `[p, z]`, where each output is a column vector.",
+        "Single-output calls return the pole column vector.",
+        "Outputs use complex tensors when any pole or zero has a nonzero imaginary component.",
+        "Input/output delays raise clear unsupported-model diagnostics."
+    ],
+    "examples": [
+        {
+            "description": "Return poles and zeros",
+            "input": "H = tf([1 3 2], [1 4]);\n[p, z] = pzmap(H);\nfprintf(\"%.0f %.0f %.0f\\n\", p(1), z(1), z(2));",
+            "output": "-4 -1 -2"
+        },
+        {
+            "description": "Plot a pole-zero map",
+            "input": "s = tf('s');\nH = (s + 2) / (s^2 + 3*s + 4);\npzmap(H);\nfprintf(\"ok\\n\");",
+            "output": "ok"
+        },
+        {
+            "description": "Handle state-space models",
+            "input": "sys = ss(-1, 1, 1, 0);\n[p, z] = pzmap(sys);\nfprintf(\"%.0f %d\\n\", p(1), length(z));",
+            "output": "-1 0"
+        },
+        {
+            "description": "Handle complex poles",
+            "input": "H = tf(1, [1 0 1]);\n[p, z] = pzmap(H);\nfprintf(\"%d %d\\n\", length(p), length(z));",
+            "output": "2 0"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `pzmap` support state-space models?",
+            "answer": "Yes. RunMat supports SISO `ss` models by converting the state-space matrices to a transfer-function representation before computing poles and zeros. MIMO state-space models are rejected with an unsupported-model diagnostic."
+        },
+        {
+            "question": "What does `pzmap` return with one output?",
+            "answer": "RunMat returns the pole column vector. Use `[p, z] = pzmap(sys)` when zero locations are needed."
+        },
+        {
+            "question": "Does `pzmap` run on the GPU?",
+            "answer": "No. It is a model-analysis and plotting operation and returns host-resident tensors."
+        }
+    ],
+    "links": [
+        {
+            "label": "tf",
+            "url": "./tf"
+        },
+        {
+            "label": "ss",
+            "url": "./ss"
+        },
+        {
+            "label": "pole",
+            "url": "./pole"
+        },
+        {
+            "label": "zero",
+            "url": "./zero"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/pzmap.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/pzmap.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "pzmap(sys)\npzmap(sys1, 'r', sys2, 'b')\np = pzmap(sys)\n[p, z] = pzmap(sys)",
+            "output": "Pole-zero locations are returned when outputs are requested; otherwise a plot is rendered."
+        },
+        "points": [
+            "`sys` must be a SISO `tf` or `ss` object.",
+            "`p` and `z` are column vectors.",
+            "No-output calls render a plot through RunMat's plotting backend."
+        ]
+    },
+    "validation": {
+        "summary": "`pzmap` validates object class, delay properties, output shapes, real and complex root extraction, plotting smoke, multi-system statement form, and VM dispatch.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/pzmap.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/pzmap.rs"
+        }
+    },
+    "gpu_residency": "`pzmap` returns host-resident pole and zero tensors.",
+    "key": "pzmap",
+    "slug": "pzmap",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pzmap.js.map

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

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