runmat 0.4.5-dev.1 → 0.4.5-dev.3

package/dist/generated/builtins/ppval.js

@@ -0,0 +1,77 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "ppval",
+    "category": "math/interpolation",
+    "keywords": [
+        "ppval",
+        "piecewise polynomial",
+        "spline",
+        "pchip"
+    ],
+    "summary": "Evaluate a piecewise-polynomial structure.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU query points are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "uniform"
+    },
+    "description": "`ppval(pp, xq)` evaluates a piecewise-polynomial structure produced by `spline` or `pchip` at query points `xq`.",
+    "behaviors": [
+        "Accepts pp structures with `form`, `breaks`, `coefs`, `pieces`, `order`, and `dim` fields.",
+        "Uses Horner evaluation within each interval.",
+        "Extrapolates outside the break range, matching MATLAB pp evaluation behavior."
+    ],
+    "examples": [
+        {
+            "description": "Evaluate a spline pp structure",
+            "input": "pp = spline([1 2 3], [1 4 9]);\nyq = ppval(pp, [1.5 2.5])",
+            "output": "yq = [2.25 6.25]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "yq = ppval(pp, xq)"
+        },
+        "points": [
+            "`pp` is a piecewise-polynomial structure, typically returned by `spline` or `pchip`.",
+            "`xq` contains query points. Scalar queries return scalars, and array queries preserve their shape.",
+            "RunMat evaluates each interval with Horner's method using the pp coefficient table.",
+            "Queries outside the break range are extrapolated from the first or last polynomial piece."
+        ]
+    },
+    "links": [
+        {
+            "label": "spline",
+            "url": "./spline"
+        },
+        {
+            "label": "pchip",
+            "url": "./pchip"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "ppval",
+    "slug": "ppval",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=ppval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ppval.js","sourceRoot":"","sources":["../../../src/generated/builtins/ppval.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,OAAO;QACP,sBAAsB;QACtB,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,oEAAoE;KAC9E;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,SAAS;KACvB;IACD,aAAa,EAAE,kHAAkH;IACjI,WAAW,EAAE;QACX,4FAA4F;QAC5F,8CAA8C;QAC9C,+EAA+E;KAChF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,oBAAoB;SAC9B;QACD,QAAQ,EAAE;YACR,sFAAsF;YACtF,oGAAoG;YACpG,qFAAqF;YACrF,2FAA2F;SAC5F;KACF;IACD,OAAO,EAAE;QACP;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,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,84 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "spline",
+    "category": "math/interpolation",
+    "keywords": [
+        "spline",
+        "cubic spline",
+        "interpolation",
+        "pp",
+        "ppval"
+    ],
+    "summary": "Construct or evaluate a cubic spline interpolant.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`spline(x, y)` returns a piecewise-polynomial structure for cubic spline interpolation. `spline(x, y, xq)` evaluates that spline directly at query points.",
+    "behaviors": [
+        "Returns a pp structure with `form`, `breaks`, `coefs`, `pieces`, `order`, and `dim` fields.",
+        "The direct evaluation form extrapolates outside the sample range, matching MATLAB's standalone `spline` behavior.",
+        "Dense real numeric inputs are supported in the initial implementation."
+    ],
+    "examples": [
+        {
+            "description": "Build and evaluate a spline",
+            "input": "x = [1 2 3];\ny = [1 4 9];\npp = spline(x, y);\nyq = ppval(pp, [1.5 2.5])",
+            "output": "yq = [2.25 6.25]"
+        },
+        {
+            "description": "Direct evaluation",
+            "input": "x = [1 2 3];\ny = [1 4 9];\nyq = spline(x, y, 1.5)",
+            "output": "yq = 2.25"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "pp = spline(x, y)\nyq = spline(x, y, xq)"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations.",
+            "`y` contains the sampled values to interpolate.",
+            "`spline(x, y)` returns a piecewise-polynomial structure compatible with `ppval`.",
+            "`spline(x, y, xq)` evaluates the cubic spline directly at query points.",
+            "Standalone `spline` extrapolates outside the sample range using the first or last polynomial piece."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "ppval",
+            "url": "./ppval"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "spline",
+    "slug": "spline",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=spline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline.js","sourceRoot":"","sources":["../../../src/generated/builtins/spline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,QAAQ;QACR,cAAc;QACd,eAAe;QACf,IAAI;QACJ,OAAO;KACR;IACD,SAAS,EAAE,mDAAmD;IAC9D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,8DAA8D;KACxE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,4JAA4J;IAC3K,WAAW,EAAE;QACX,6FAA6F;QAC7F,mHAAmH;QACnH,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,2EAA2E;YACpF,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,WAAW;SACtB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,0CAA0C;SACpD;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,iDAAiD;YACjD,kFAAkF;YAClF,yEAAyE;YACzE,qGAAqG;SACtG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins-manifest.js

@@ -2376,6 +2376,26 @@ export const builtinManifest = [
         "summary": "Rewind the file position indicator to the beginning of an open file.",
         "exampleCount": 3
     },
+    {
+        "key": "fsolve",
+        "title": "fsolve",
+        "slug": "fsolve",
+        "aliases": [],
+        "category": "math/optim",
+        "categoryPath": [
+            "math",
+            "optim"
+        ],
+        "keywords": [
+            "fsolve",
+            "nonlinear solve",
+            "root finding",
+            "Jacobian",
+            "Levenberg-Marquardt"
+        ],
+        "summary": "Solve scalar or vector nonlinear equation systems using finite-difference Levenberg-Marquardt iterations.",
+        "exampleCount": 2
+    },
     {
         "key": "fspecial",
         "title": "fspecial",
@@ -2439,6 +2459,26 @@ export const builtinManifest = [
         "summary": "Write binary data to a file identifier with MATLAB-compatible precision, skip, and machine-format semantics.",
         "exampleCount": 6
     },
+    {
+        "key": "fzero",
+        "title": "fzero",
+        "slug": "fzero",
+        "aliases": [],
+        "category": "math/optim",
+        "categoryPath": [
+            "math",
+            "optim"
+        ],
+        "keywords": [
+            "fzero",
+            "root finding",
+            "zero",
+            "brent",
+            "optimization"
+        ],
+        "summary": "Find a zero of a scalar nonlinear function using bracket expansion and Brent's method.",
+        "exampleCount": 3
+    },
     {
         "key": "gamma",
         "title": "gamma",
@@ -3118,6 +3158,47 @@ export const builtinManifest = [
         "summary": "Prompt the user for input. Return either the typed text or a parsed numeric value.",
         "exampleCount": 1
     },
+    {
+        "key": "interp1",
+        "title": "interp1",
+        "slug": "interp1",
+        "aliases": [],
+        "category": "math/interpolation",
+        "categoryPath": [
+            "math",
+            "interpolation"
+        ],
+        "keywords": [
+            "interp1",
+            "interpolation",
+            "linear",
+            "nearest",
+            "spline",
+            "pchip"
+        ],
+        "summary": "Interpolate one-dimensional sampled data at query points.",
+        "exampleCount": 2
+    },
+    {
+        "key": "interp2",
+        "title": "interp2",
+        "slug": "interp2",
+        "aliases": [],
+        "category": "math/interpolation",
+        "categoryPath": [
+            "math",
+            "interpolation"
+        ],
+        "keywords": [
+            "interp2",
+            "2-D interpolation",
+            "bilinear",
+            "nearest",
+            "meshgrid"
+        ],
+        "summary": "Interpolate values over a two-dimensional gridded surface.",
+        "exampleCount": 2
+    },
     {
         "key": "intersect",
         "title": "intersect",
@@ -4604,6 +4685,27 @@ export const builtinManifest = [
         "summary": "Create arrays filled with ones within the MATLAB language.",
         "exampleCount": 3
     },
+    {
+        "key": "optimset",
+        "title": "optimset",
+        "slug": "optimset",
+        "aliases": [],
+        "category": "math/optim",
+        "categoryPath": [
+            "math",
+            "optim"
+        ],
+        "keywords": [
+            "optimset",
+            "options",
+            "TolX",
+            "TolFun",
+            "MaxIter",
+            "Display"
+        ],
+        "summary": "Create or update an optimization options structure for fzero and fsolve.",
+        "exampleCount": 1
+    },
     {
         "key": "or",
         "title": "or",
@@ -4726,6 +4828,25 @@ export const builtinManifest = [
         "summary": "Suspend execution until the user presses a key or a specified time elapses.",
         "exampleCount": 5
     },
+    {
+        "key": "pchip",
+        "title": "pchip",
+        "slug": "pchip",
+        "aliases": [],
+        "category": "math/interpolation",
+        "categoryPath": [
+            "math",
+            "interpolation"
+        ],
+        "keywords": [
+            "pchip",
+            "piecewise cubic hermite",
+            "shape preserving",
+            "interpolation"
+        ],
+        "summary": "Shape-preserving piecewise cubic Hermite interpolation.",
+        "exampleCount": 1
+    },
     {
         "key": "peaks",
         "title": "peaks",
@@ -4986,6 +5107,25 @@ export const builtinManifest = [
         "summary": "Element-wise exponentiation A .^ B with MATLAB-compatible broadcasting, complex support, and GPU fallbacks.",
         "exampleCount": 6
     },
+    {
+        "key": "ppval",
+        "title": "ppval",
+        "slug": "ppval",
+        "aliases": [],
+        "category": "math/interpolation",
+        "categoryPath": [
+            "math",
+            "interpolation"
+        ],
+        "keywords": [
+            "ppval",
+            "piecewise polynomial",
+            "spline",
+            "pchip"
+        ],
+        "summary": "Evaluate a piecewise-polynomial structure.",
+        "exampleCount": 1
+    },
     {
         "key": "prod",
         "title": "prod",
@@ -6012,6 +6152,26 @@ export const builtinManifest = [
         "summary": "Sort matrix rows lexicographically with optional column and direction control.",
         "exampleCount": 8
     },
+    {
+        "key": "spline",
+        "title": "spline",
+        "slug": "spline",
+        "aliases": [],
+        "category": "math/interpolation",
+        "categoryPath": [
+            "math",
+            "interpolation"
+        ],
+        "keywords": [
+            "spline",
+            "cubic spline",
+            "interpolation",
+            "pp",
+            "ppval"
+        ],
+        "summary": "Construct or evaluate a cubic spline interpolant.",
+        "exampleCount": 2
+    },
     {
         "key": "split",
         "title": "split",
@@ -7516,9 +7676,11 @@ export const builtinDocLoaders = {
     "fprintf": () => import("./builtins/fprintf.js").then((mod) => mod.default),
     "fread": () => import("./builtins/fread.js").then((mod) => mod.default),
     "frewind": () => import("./builtins/frewind.js").then((mod) => mod.default),
+    "fsolve": () => import("./builtins/fsolve.js").then((mod) => mod.default),
     "fspecial": () => import("./builtins/fspecial.js").then((mod) => mod.default),
     "fullfile": () => import("./builtins/fullfile.js").then((mod) => mod.default),
     "fwrite": () => import("./builtins/fwrite.js").then((mod) => mod.default),
+    "fzero": () => import("./builtins/fzero.js").then((mod) => mod.default),
     "gamma": () => import("./builtins/gamma.js").then((mod) => mod.default),
     "gather": () => import("./builtins/gather.js").then((mod) => mod.default),
     "gca": () => import("./builtins/gca.js").then((mod) => mod.default),
@@ -7553,6 +7715,8 @@ export const builtinDocLoaders = {
     "imfilter": () => import("./builtins/imfilter.js").then((mod) => mod.default),
     "ind2sub": () => import("./builtins/ind2sub.js").then((mod) => mod.default),
     "input": () => import("./builtins/input.js").then((mod) => mod.default),
+    "interp1": () => import("./builtins/interp1.js").then((mod) => mod.default),
+    "interp2": () => import("./builtins/interp2.js").then((mod) => mod.default),
     "intersect": () => import("./builtins/intersect.js").then((mod) => mod.default),
     "inv": () => import("./builtins/inv.js").then((mod) => mod.default),
     "ipermute": () => import("./builtins/ipermute.js").then((mod) => mod.default),
@@ -7626,12 +7790,14 @@ export const builtinDocLoaders = {
     "num2str": () => import("./builtins/num2str.js").then((mod) => mod.default),
     "numel": () => import("./builtins/numel.js").then((mod) => mod.default),
     "ones": () => import("./builtins/ones.js").then((mod) => mod.default),
+    "optimset": () => import("./builtins/optimset.js").then((mod) => mod.default),
     "or": () => import("./builtins/or.js").then((mod) => mod.default),
     "orderfields": () => import("./builtins/orderfields.js").then((mod) => mod.default),
     "pad": () => import("./builtins/pad.js").then((mod) => mod.default),
     "pagefun": () => import("./builtins/pagefun.js").then((mod) => mod.default),
     "path": () => import("./builtins/path.js").then((mod) => mod.default),
     "pause": () => import("./builtins/pause.js").then((mod) => mod.default),
+    "pchip": () => import("./builtins/pchip.js").then((mod) => mod.default),
     "peaks": () => import("./builtins/peaks.js").then((mod) => mod.default),
     "permute": () => import("./builtins/permute.js").then((mod) => mod.default),
     "pie": () => import("./builtins/pie.js").then((mod) => mod.default),
@@ -7645,6 +7811,7 @@ export const builtinDocLoaders = {
     "polyval": () => import("./builtins/polyval.js").then((mod) => mod.default),
     "pow2": () => import("./builtins/pow2.js").then((mod) => mod.default),
     "power": () => import("./builtins/power.js").then((mod) => mod.default),
+    "ppval": () => import("./builtins/ppval.js").then((mod) => mod.default),
     "prod": () => import("./builtins/prod.js").then((mod) => mod.default),
     "pwd": () => import("./builtins/pwd.js").then((mod) => mod.default),
     "qr": () => import("./builtins/qr.js").then((mod) => mod.default),
@@ -7696,6 +7863,7 @@ export const builtinDocLoaders = {
     "size": () => import("./builtins/size.js").then((mod) => mod.default),
     "sort": () => import("./builtins/sort.js").then((mod) => mod.default),
     "sortrows": () => import("./builtins/sortrows.js").then((mod) => mod.default),
+    "spline": () => import("./builtins/spline.js").then((mod) => mod.default),
     "split": () => import("./builtins/split.js").then((mod) => mod.default),
     "sprintf": () => import("./builtins/sprintf.js").then((mod) => mod.default),
     "sqrt": () => import("./builtins/sqrt.js").then((mod) => mod.default),