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

package/dist/generated/builtins/triplot.js

@@ -0,0 +1,103 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "triplot",
+    "category": "plotting",
+    "keywords": [
+        "triplot",
+        "triangulation",
+        "triangle mesh",
+        "mesh edges",
+        "plotting"
+    ],
+    "summary": "Draw the edges of a 2-D triangular mesh.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`triplot` is a plotting sink. RunMat gathers connectivity and coordinate inputs, builds a NaN-separated line object for triangle edges, and then uses the existing line rendering path."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::triplot::tests",
+        "integration": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`triplot` plots the edges of a 2-D triangulation. The common numeric form accepts an M-by-3 one-based connectivity matrix plus X and Y coordinate vectors. RunMat also accepts triangulation-like structs or `DelaunayTri` objects with connectivity and point properties for compatibility with saved or user-constructed triangulation data.",
+    "behaviors": [
+        "`triplot(TRI, X, Y)` draws all triangle edges as one line graphics object.",
+        "`triplot(TRI, X, Y, LineSpec)` applies MATLAB line shorthand such as `'r--'`.",
+        "`triplot(TRI, X, Y, Name, Value, ...)` supports shared line styling properties including `Color`, `LineWidth`, `LineStyle`, `DisplayName`, `Parent`, and `Visible`.",
+        "`triplot(ax, ...)` and `triplot(..., 'Parent', ax)` target a specific axes.",
+        "`triplot(TR)` accepts a struct or `DelaunayTri` object with `ConnectivityList`/`Triangulation` and an N-by-2 or wider `Points`/`X` matrix. The first two point columns are used as X and Y coordinates.",
+        "Connectivity entries must be positive finite integer indices within the coordinate vectors."
+    ],
+    "examples": [
+        {
+            "description": "Plot a two-triangle square mesh",
+            "input": "TRI = [1 2 3; 2 4 3];\nX = [0 1 0 1];\nY = [0 0 1 1];\nh = triplot(TRI, X, Y);"
+        },
+        {
+            "description": "Style triangulation edges",
+            "input": "TRI = [1 2 3];\nX = [0 1 0];\nY = [0 0 1];\nh = triplot(TRI, X, Y, 'r--', 'LineWidth', 2, 'DisplayName', 'mesh');"
+        },
+        {
+            "description": "Use a triangulation-like struct or object",
+            "input": "TR.ConnectivityList = [1 2 3];\nTR.Points = [0 0; 1 0; 0 1];\ntriplot(TR);\ndt = DelaunayTri(TR.Points);\ntriplot(dt);"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What does triplot return?",
+            "answer": "`triplot` returns the line graphics handle containing the triangulation edges. The handle can be queried and styled with `get` and `set` like other line objects."
+        },
+        {
+            "question": "Does triplot render filled triangles?",
+            "answer": "No. `triplot` draws mesh edges only. Use patch-style graphics when filled faces are needed."
+        },
+        {
+            "question": "Does triplot preserve gpuArray residency?",
+            "answer": "No. The current implementation gathers connectivity and point data before constructing the edge list. It is a plotting sink, and the produced line object follows the normal line renderer path."
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "line",
+            "url": "./line"
+        },
+        {
+            "label": "patch",
+            "url": "./patch"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/triplot.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/triplot.rs"
+    },
+    "key": "triplot",
+    "slug": "triplot",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=triplot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triplot.js","sourceRoot":"","sources":["../../../src/generated/builtins/triplot.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,eAAe;QACf,eAAe;QACf,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,0CAA0C;IACrD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yLAAyL;KACnM;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,oCAAoC;QAC5C,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,gVAAgV;IAC/V,WAAW,EAAE;QACX,4EAA4E;QAC5E,+EAA+E;QAC/E,qKAAqK;QACrK,6EAA6E;QAC7E,yMAAyM;QACzM,6FAA6F;KAC9F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,gFAAgF;SAC1F;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,mHAAmH;SAC7H;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,wHAAwH;SAClI;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,6FAA6F;SACxG;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,kMAAkM;SAC7M;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,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,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/trnd.js

@@ -0,0 +1,84 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "trnd",
+    "category": "stats/random",
+    "keywords": [
+        "trnd",
+        "student t",
+        "random",
+        "statistics",
+        "distribution"
+    ],
+    "summary": "Generate Student's t random numbers.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "elementwise",
+        "notes": "Sampling currently runs on the host RNG; GPU inputs are gathered to host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::trnd::tests",
+        "integration": null
+    },
+    "description": "`trnd(nu)` generates Student's t random numbers with `nu` degrees of freedom. Size arguments can be supplied as separate dimensions or as a size vector.",
+    "behaviors": [
+        "`nu` must be a positive scalar or a positive array of degrees of freedom.",
+        "Scalar `nu` broadcasts over the requested output size.",
+        "Array `nu` requires the requested size to match the shape of `nu`.",
+        "`nu = Inf` generates standard normal random numbers."
+    ],
+    "examples": [
+        {
+            "description": "Scalar sample",
+            "input": "r = trnd(10)"
+        },
+        {
+            "description": "Matrix sample",
+            "input": "r = trnd(1, 5, 5)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How does RunMat generate trnd samples?",
+            "answer": "RunMat draws a standard normal variate and scales it by an independent chi-square variate generated through a gamma sampler."
+        }
+    ],
+    "links": [
+        {
+            "label": "tcdf",
+            "url": "./tcdf"
+        },
+        {
+            "label": "tpdf",
+            "url": "./tpdf"
+        },
+        {
+            "label": "tinv",
+            "url": "./tinv"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/trnd.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/trnd.rs"
+    },
+    "key": "trnd",
+    "slug": "trnd",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=trnd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trnd.js","sourceRoot":"","sources":["../../../src/generated/builtins/trnd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,MAAM;QACN,WAAW;QACX,QAAQ;QACR,YAAY;QACZ,cAAc;KACf;IACD,SAAS,EAAE,sCAAsC;IACjD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,2EAA2E;KACrF;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,sCAAsC;QAC9C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,0JAA0J;IACzK,WAAW,EAAE;QACX,2EAA2E;QAC3E,wDAAwD;QACxD,oEAAoE;QACpE,sDAAsD;KACvD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,cAAc;SACxB;QACD;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,mBAAmB;SAC7B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,8HAA8H;SACzI;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/tsne.js

@@ -0,0 +1,101 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "tsne",
+    "category": "stats/ml",
+    "keywords": [
+        "tsne",
+        "t-SNE",
+        "dimensionality reduction",
+        "embedding",
+        "statistics",
+        "machine learning"
+    ],
+    "summary": "Embed high-dimensional observations using t-distributed stochastic neighbor embedding.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host. t-SNE runs on CPU because it is iterative, dense, and metadata-heavy."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::tsne::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`tsne(X)` embeds the rows of a numeric observation matrix into a lower-dimensional numeric matrix. `[Y,loss] = tsne(...)` also returns the final Kullback-Leibler divergence.",
+    "behaviors": [
+        "`X` must be a real numeric vector or 2-D matrix. Matrix rows are observations; a column vector has one predictor per row, while a row vector is one observation with multiple predictors.",
+        "Rows containing `NaN` are omitted before fitting. `Inf` values are rejected.",
+        "`NumDimensions` selects the output dimension and defaults to 2. `InitialY` can match either all input rows or the complete rows that remain after `NaN` omission.",
+        "`Algorithm` accepts `\"barneshut\"` and `\"exact\"`. RunMat computes a bounded exact CPU embedding for both modes so scripts receive compatible outputs without silent shape changes.",
+        "`Distance` supports `\"euclidean\"`, `\"fasteuclidean\"`, `\"seuclidean\"`, `\"fastseuclidean\"`, `\"cityblock\"`, `\"chebychev\"`, `\"minkowski\"`, `\"mahalanobis\"`, `\"cosine\"`, `\"correlation\"`, `\"spearman\"`, `\"hamming\"`, and `\"jaccard\"`. The `\"minkowski\"` option uses the default exponent 2. Custom function-handle distances are rejected explicitly.",
+        "`Standardize` centers and scales each predictor column before distance computation. `NumPCAComponents` applies PCA before pairwise distance computation when it is positive and smaller than the predictor count.",
+        "`Perplexity`, `Exaggeration`, `LearnRate`, `Theta`, `Verbose`, `NumPrint`, and `CacheSize` are parsed and validated for MATLAB-style script compatibility. `Theta`, `Verbose`, `NumPrint`, and `CacheSize` do not affect the exact CPU optimizer.",
+        "`Options` accepts a statset-style struct with `MaxIter`, `TolFun`, and empty `OutputFcn`. Nonempty `OutputFcn` is rejected because RunMat does not invoke iteration callbacks from builtins yet.",
+        "RunMat rejects very large dense exact workloads before allocation to avoid unbounded pairwise, PCA, and Mahalanobis memory use."
+    ],
+    "examples": [
+        {
+            "description": "Embed observations into two dimensions",
+            "input": "X = [0 0; 0.2 0.1; 9.8 9.9; 10 10.1];\nY = tsne(X, 'Perplexity', 2)",
+            "output": "`Y` is a 4-by-2 embedding matrix."
+        },
+        {
+            "description": "Request the final loss",
+            "input": "[Y,loss] = tsne(X, 'Algorithm', 'exact', 'Options', struct('MaxIter', 250))",
+            "output": "`loss` is the final Kullback-Leibler divergence for the embedding."
+        },
+        {
+            "description": "Omit incomplete rows",
+            "input": "Y = tsne([1 2; NaN 3; 10 11])",
+            "output": "`Y` has two rows because the incomplete observation is omitted."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does RunMat implement Barnes-Hut acceleration?",
+            "answer": "No. `Algorithm=\"barneshut\"` is accepted for compatibility, but RunMat currently uses its bounded exact CPU optimizer for both algorithm names."
+        },
+        {
+            "question": "Are stochastic results bit-for-bit identical to MATLAB?",
+            "answer": "No. RunMat uses its own RNG stream behind `rng`, so output shape and semantics are compatible but random initial embeddings are not bit-for-bit identical."
+        }
+    ],
+    "links": [
+        {
+            "label": "svd",
+            "url": "./svd"
+        },
+        {
+            "label": "kmeans",
+            "url": "./kmeans"
+        },
+        {
+            "label": "pdist",
+            "url": "./pdist"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/tsne.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/tsne.rs"
+    },
+    "key": "tsne",
+    "slug": "tsne",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=tsne.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tsne.js","sourceRoot":"","sources":["../../../src/generated/builtins/tsne.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,0BAA0B;QAC1B,WAAW;QACX,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,wFAAwF;IACnG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wGAAwG;KAClH;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,kCAAkC;QAC1C,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,+KAA+K;IAC9L,WAAW,EAAE;QACX,2LAA2L;QAC3L,8EAA8E;QAC9E,mKAAmK;QACnK,uLAAuL;QACvL,8WAA8W;QAC9W,mNAAmN;QACnN,mPAAmP;QACnP,kMAAkM;QAClM,iIAAiI;KAClI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,mCAAmC;SAC9C;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,6EAA6E;YACtF,QAAQ,EAAE,oEAAoE;SAC/E;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,iEAAiE;SAC5E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,4JAA4J;SACvK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uDAAuD;QAChE,KAAK,EAAE,oGAAoG;KAC5G;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/ttest2.js

@@ -0,0 +1,98 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "ttest2",
+    "category": "stats/summary",
+    "keywords": [
+        "ttest2",
+        "t-test",
+        "hypothesis test",
+        "welch",
+        "statistics",
+        "student t"
+    ],
+    "summary": "Perform a two-sample Student's t-test.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host for the sample reductions and distribution calculations."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::hypothesis::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`ttest2(x,y)` tests whether two independent samples have equal means. It supports the default equal-variance test and Welch's unequal-variance test through `\"Vartype\",\"unequal\"`.",
+    "behaviors": [
+        "`x` and `y` may be numeric or logical vectors, matrices, or N-D arrays.",
+        "Vector inputs are treated as single samples and may have different lengths.",
+        "Array inputs are tested along the first nonsingleton dimension by default, or along `Dim` when specified.",
+        "Array inputs must have the same size along all dimensions except the test dimension.",
+        "`NaN` values are omitted independently from each sample before each test.",
+        "`gpuArray` inputs are accepted through the host-gather compatibility path; outputs are host values.",
+        "`Tail` accepts `\"both\"`, `\"right\"`, or `\"left\"`; `\"larger\"` and `\"smaller\"` are accepted as compatibility aliases.",
+        "`Alpha` must be a scalar in the open interval `(0,1)`.",
+        "The fourth output is a struct with `tstat`, `df`, and `sd` fields."
+    ],
+    "examples": [
+        {
+            "description": "Default equal-variance two-sample t-test",
+            "input": "[h,p,ci,stats] = ttest2([1;2;3;4], [2;4;6;8])"
+        },
+        {
+            "description": "Welch one-sided test",
+            "input": "[h,p] = ttest2(x, y, \"Vartype\", \"unequal\", \"Tail\", \"left\")"
+        },
+        {
+            "description": "Test rows independently",
+            "input": "h = ttest2(A, B, \"Dim\", 2)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does ttest2 implement Welch's test?",
+            "answer": "Yes. Pass `\"Vartype\",\"unequal\"` to compute the unequal-variance test with Satterthwaite degrees of freedom."
+        },
+        {
+            "question": "What happens when a sample has fewer than two finite observations?",
+            "answer": "The corresponding test returns `h = false` and `NaN` numeric outputs."
+        }
+    ],
+    "links": [
+        {
+            "label": "tcdf",
+            "url": "./tcdf"
+        },
+        {
+            "label": "tinv",
+            "url": "./tinv"
+        },
+        {
+            "label": "tpdf",
+            "url": "./tpdf"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/hypothesis.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/hypothesis.rs"
+    },
+    "key": "ttest2",
+    "slug": "ttest2",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=ttest2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttest2.js","sourceRoot":"","sources":["../../../src/generated/builtins/ttest2.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,QAAQ;QACR,iBAAiB;QACjB,OAAO;QACP,YAAY;QACZ,WAAW;KACZ;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,0FAA0F;KACpG;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,6CAA6C;QACrD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,wLAAwL;IACvM,WAAW,EAAE;QACX,yEAAyE;QACzE,6EAA6E;QAC7E,2GAA2G;QAC3G,sFAAsF;QACtF,2EAA2E;QAC3E,qGAAqG;QACrG,8HAA8H;QAC9H,wDAAwD;QACxD,oEAAoE;KACrE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,+CAA+C;SACzD;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,oEAAoE;SAC9E;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,8BAA8B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,oEAAoE;YAChF,QAAQ,EAAE,uEAAuE;SAClF;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/uigetdir.js

@@ -0,0 +1,83 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "uigetdir",
+    "category": "io/repl_fs",
+    "keywords": [
+        "uigetdir",
+        "folder dialog",
+        "directory picker",
+        "filesystem"
+    ],
+    "summary": "Open a host folder-selection dialog and return the selected folder path.",
+    "status": "implemented",
+    "coverage": {
+        "unit": "builtins::io::repl_fs::uigetdir::tests",
+        "integration": "crates/runmat-vm/tests/io_uigetdir.rs"
+    },
+    "description": "`uigetdir` requests a folder selection from the active RunMat filesystem provider and returns MATLAB-compatible output values. Interactive hosts can implement the provider hook to show a native or browser folder picker; noninteractive hosts return the standard cancellation value.",
+    "signatures": [
+        {
+            "label": "folder = uigetdir()",
+            "description": "Open a folder-selection dialog using the provider's default starting folder."
+        },
+        {
+            "label": "folder = uigetdir(startPath)",
+            "description": "Open a folder-selection dialog with an initial folder."
+        },
+        {
+            "label": "folder = uigetdir(startPath, title)",
+            "description": "Open a folder-selection dialog with an initial folder and title."
+        }
+    ],
+    "examples": [
+        {
+            "input": "folder = uigetdir;\nif isequal(folder, 0)\n    return;\nend\nlisting = dir(folder);",
+            "description": "Prompt for a folder and list its contents unless the dialog is cancelled."
+        },
+        {
+            "input": "folder = uigetdir(pwd, 'Select input image folder');",
+            "description": "Use the current folder as the initial location and set a dialog title."
+        }
+    ],
+    "returns": [
+        "`folder` is a character vector containing the selected folder path.",
+        "`folder` is `0` when the user cancels or the active noninteractive provider has no folder picker."
+    ],
+    "notes": [
+        "`uigetdir` does not create, read, or list folders itself; it only returns the selected folder path.",
+        "RunMat validates malformed provider selections and reports deterministic `RunMat:uigetdir:*` errors."
+    ],
+    "errors": [
+        {
+            "identifier": "RunMat:uigetdir:InvalidArgument",
+            "when": "The start path or title is not a scalar text value, or too many input arguments are supplied."
+        },
+        {
+            "identifier": "RunMat:uigetdir:TooManyOutputs",
+            "when": "More than one output argument is requested."
+        },
+        {
+            "identifier": "RunMat:uigetdir:HostError",
+            "when": "The active filesystem provider fails while opening the folder-selection UI."
+        },
+        {
+            "identifier": "RunMat:uigetdir:InvalidSelection",
+            "when": "The active filesystem provider returns an empty or otherwise malformed folder path."
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/repl_fs/uigetdir.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/uigetdir.rs"
+    },
+    "gpu_residency": "No. Folder-selection dialogs are host/UI operations and always execute outside GPU residency. Textual arguments are gathered before provider dispatch.",
+    "key": "uigetdir",
+    "slug": "uigetdir",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=uigetdir.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uigetdir.js","sourceRoot":"","sources":["../../../src/generated/builtins/uigetdir.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,UAAU;QACV,eAAe;QACf,kBAAkB;QAClB,YAAY;KACb;IACD,SAAS,EAAE,0EAA0E;IACrF,QAAQ,EAAE,aAAa;IACvB,UAAU,EAAE;QACV,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,uCAAuC;KACvD;IACD,aAAa,EAAE,0RAA0R;IACzS,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,qBAAqB;YAC9B,aAAa,EAAE,8EAA8E;SAC9F;QACD;YACE,OAAO,EAAE,8BAA8B;YACvC,aAAa,EAAE,wDAAwD;SACxE;QACD;YACE,OAAO,EAAE,qCAAqC;YAC9C,aAAa,EAAE,kEAAkE;SAClF;KACF;IACD,UAAU,EAAE;QACV;YACE,OAAO,EAAE,qFAAqF;YAC9F,aAAa,EAAE,2EAA2E;SAC3F;QACD;YACE,OAAO,EAAE,sDAAsD;YAC/D,aAAa,EAAE,wEAAwE;SACxF;KACF;IACD,SAAS,EAAE;QACT,qEAAqE;QACrE,mGAAmG;KACpG;IACD,OAAO,EAAE;QACP,qGAAqG;QACrG,sGAAsG;KACvG;IACD,QAAQ,EAAE;QACR;YACE,YAAY,EAAE,iCAAiC;YAC/C,MAAM,EAAE,+FAA+F;SACxG;QACD;YACE,YAAY,EAAE,gCAAgC;YAC9C,MAAM,EAAE,6CAA6C;SACtD;QACD;YACE,YAAY,EAAE,2BAA2B;YACzC,MAAM,EAAE,6EAA6E;SACtF;QACD;YACE,YAAY,EAAE,kCAAkC;YAChD,MAAM,EAAE,qFAAqF;SAC9F;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,wJAAwJ;IACzK,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/uint32.js

@@ -0,0 +1,83 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "uint32",
+    "category": "math/elementwise",
+    "keywords": [
+        "uint32",
+        "cast",
+        "integer",
+        "conversion",
+        "numeric"
+    ],
+    "summary": "Convert values to unsigned 32-bit integer class.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs gather for saturating conversion and are re-uploaded when possible."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::elementwise::uint32::tests",
+        "integration": null
+    },
+    "description": "`uint32(X)` converts numeric, logical, character, symbolic-constant, and gatherable gpuArray inputs to unsigned 32-bit integer values using saturating rounded conversion.",
+    "behaviors": [
+        "Rounds fractional numeric values to the nearest integer.",
+        "Clamps negative values and `NaN` to `0`.",
+        "Clamps values larger than `intmax('uint32')` to `4294967295`.",
+        "Preserves array shape and marks tensor output as `uint32`.",
+        "Rejects complex, string, cell, struct, object, and function-handle inputs."
+    ],
+    "examples": [
+        {
+            "description": "Saturating scalar conversion",
+            "input": "uint32([-1 3.5 4294967296])",
+            "output": "ans =\n  1x3 uint32 array\n           0           4  4294967295"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `uint32` preserve array shape?",
+            "answer": "Yes. Non-scalar array inputs keep their original dimensions and are tagged with the `uint32` numeric class."
+        }
+    ],
+    "links": [
+        {
+            "label": "uint16",
+            "url": "./uint16"
+        },
+        {
+            "label": "intmax",
+            "url": "./intmax"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/elementwise/uint32.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/elementwise/uint32.rs"
+    },
+    "gpu_residency": "GPU inputs gather for conversion and return a host uint32 result.",
+    "gpu_behavior": [
+        "There is no provider-native uint32 storage hook yet; gpuArray inputs gather to host and return a host uint32 result."
+    ],
+    "key": "uint32",
+    "slug": "uint32",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "elementwise"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=uint32.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uint32.js","sourceRoot":"","sources":["../../../src/generated/builtins/uint32.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,QAAQ;QACR,MAAM;QACN,SAAS;QACT,YAAY;QACZ,SAAS;KACV;IACD,SAAS,EAAE,kDAAkD;IAC7D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gFAAgF;KAC1F;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,4CAA4C;QACpD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,4KAA4K;IAC3L,WAAW,EAAE;QACX,0DAA0D;QAC1D,0CAA0C;QAC1C,+DAA+D;QAC/D,4DAA4D;QAC5D,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,iEAAiE;SAC5E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,6GAA6G;SACxH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,eAAe,EAAE,mEAAmE;IACpF,cAAc,EAAE;QACd,sHAAsH;KACvH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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