fastlowess-wasm 2.0.0 → 3.0.0

package/README.md

@@ -16,6 +16,7 @@
   <a href="https://anaconda.org/conda-forge/r-rfastlowess"><img src="https://img.shields.io/badge/rfastlowess_(R)-44A833?logo=anaconda&logoColor=white" alt="rfastlowess (R)"></a>
   <br>
   <a href="https://github.com/thisisamirv/lowess-project/actions/workflows/ci.yml"><img src="https://github.com/thisisamirv/lowess-project/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/ropensci/software-review/issues/769"><img src="https://badges.ropensci.org/769_status.svg" alt="Status at rOpenSci Software Peer Review"></a>
 </p>
 
 <p align="center">
@@ -47,6 +48,10 @@ The fastest, most robust, and most feature-complete language-agnostic LOWESS (Lo
 >
 > Currently available for R, Python, Rust, Julia, Node.js, WebAssembly, and C++. See the [Installation Guide](https://lowess.readthedocs.io/getting-started/installation/) for detailed installation instructions.
 
+### GPU Backend
+
+In addition to `parallel = true` (multi-core CPU), the batch `Lowess` class in every binding — except WebAssembly — as well as the `fastLowess` Rust crate itself, can run on the GPU via `wgpu` (Vulkan/Metal/DX12). It's opt-in and worth enabling for high-throughput processing of large datasets (roughly 10k+ points); for smaller inputs the CPU backend is typically faster. `StreamingLowess`/`OnlineLowess` remain CPU-only. See the [GPU Backend guide](https://lowess.readthedocs.io/en/latest/user-guide/gpu-backend/) for installation instructions and usage.
+
 ## Documentation
 
 > [!NOTE]
@@ -57,7 +62,7 @@ The fastest, most robust, and most feature-complete language-agnostic LOWESS (Lo
 
 ## LOESS vs. LOWESS
 
-| Feature | LOESS (This Crate) | LOWESS |
+| Feature | LOESS | LOWESS (This Crate) |
 | --- | --- | --- |
 | **Polynomial Degree** | Linear, Quadratic, Cubic, Quartic | Linear (Degree 1) |
 | **Dimensions** | Multivariate (n-D support) | Univariate (1-D only) |
@@ -131,11 +136,9 @@ A variety of features, supporting a range of use cases:
 | Prediction Intervals | yes | no | no |
 | Cross-Validation | 2 options | no | no |
 | Parallel Execution | yes | no | no |
-| GPU Acceleration | yes* | no | no |
+| GPU Acceleration | yes | no | no |
 | `no-std` Support | yes | no | no |
 
-\* GPU acceleration is currently in beta and may not be available on all platforms.
-
 ## Validation
 
 All implementations are **numerical twins** of R's `lowess`:
@@ -176,7 +179,7 @@ model <- Lowess(
     parallel = TRUE
 )
 custom_weights <- rep(1, length(x))
-result <- model$fit(x, y, custom_weights = custom_weights)
+result <- fit(model, x, y, custom_weights = custom_weights)
 
 # Result structure:
 result$x,
@@ -477,11 +480,11 @@ result.cv_scores()
 
 ## Contributing
 
-Contributions are welcome! Please see the [Contributing Guide](https://lowess.readthedocs.io/contributing/) for more information.
+Contributions are welcome! Please see the [Contributing Guide](https://lowess.readthedocs.io/en/latest/contributing/) for more information.
 
 ## Changelog
 
-See the [Changelog](https://lowess.readthedocs.io/changelog/) for a history of changes.
+See the [Changelog](https://lwoess.readthedocs.io/en/latest/changelog/) for a history of changes.
 
 ## License
 

package/fastlowess_wasm.d.ts

@@ -87,15 +87,15 @@ export class StreamingLowess {
 export class OnlineLowess {
     free(): void;
     constructor(options?: SmoothOptions, onlineOpts?: OnlineOptions);
-    /** Add a single point and get the smoothed output (or undefined if not enough points yet). */
-    add_point(x: number, y: number): OnlineOutput | undefined;
+    /** Add a single point and get the smoothed output (or null if not enough points yet). */
+    add_point(x: number, y: number): OnlineOutput | null;
 }
 
 /** Result from a single online update step. */
 export class OnlineOutput {
     free(): void;
-    get smoothed(): number;
-    get std_error(): number | undefined;
+    get y(): number;
+    get standard_error(): number | undefined;
     get residual(): number | undefined;
     get robustness_weight(): number | undefined;
     get iterations_used(): number | undefined;
@@ -145,8 +145,8 @@ export class OnlineOutput {
     readonly iterations_used: number | undefined;
     readonly residual: number | undefined;
     readonly robustness_weight: number | undefined;
-    readonly smoothed: number;
-    readonly std_error: number | undefined;
+    readonly standard_error: number | undefined;
+    readonly y: number;
 }
 
 export function init_panic_hook(): void;
@@ -194,8 +194,8 @@ export interface InitOutput {
     readonly onlineoutput_iterations_used: (a: number) => number;
     readonly onlineoutput_residual: (a: number) => [number, number];
     readonly onlineoutput_robustness_weight: (a: number) => [number, number];
-    readonly onlineoutput_smoothed: (a: number) => number;
-    readonly onlineoutput_std_error: (a: number) => [number, number];
+    readonly onlineoutput_standard_error: (a: number) => [number, number];
+    readonly onlineoutput_y: (a: number) => number;
     readonly streaminglowess_finalize: (a: number) => [number, number, number];
     readonly streaminglowess_new: (a: any, b: any) => [number, number, number];
     readonly streaminglowess_process_chunk: (a: number, b: any, c: any) => [number, number, number];

package/fastlowess_wasm.js

@@ -276,14 +276,14 @@ export class OnlineLowess {
     /**
      * @param {number} x
      * @param {number} y
-     * @returns {OnlineOutput | undefined}
+     * @returns {any}
      */
     add_point(x, y) {
         const ret = wasm.onlinelowess_add_point(this.__wbg_ptr, x, y);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
-        return ret[0] === 0 ? undefined : OnlineOutput.__wrap(ret[0]);
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
      * @param {any} options
@@ -340,18 +340,18 @@ export class OnlineOutput {
         return ret[0] === 0 ? undefined : ret[1];
     }
     /**
-     * @returns {number}
+     * @returns {number | undefined}
      */
-    get smoothed() {
-        const ret = wasm.onlineoutput_smoothed(this.__wbg_ptr);
-        return ret;
+    get standard_error() {
+        const ret = wasm.onlineoutput_standard_error(this.__wbg_ptr);
+        return ret[0] === 0 ? undefined : ret[1];
     }
     /**
-     * @returns {number | undefined}
+     * @returns {number}
      */
-    get std_error() {
-        const ret = wasm.onlineoutput_std_error(this.__wbg_ptr);
-        return ret[0] === 0 ? undefined : ret[1];
+    get y() {
+        const ret = wasm.onlineoutput_y(this.__wbg_ptr);
+        return ret;
     }
 }
 if (Symbol.dispose) OnlineOutput.prototype[Symbol.dispose] = OnlineOutput.prototype.free;
@@ -411,72 +411,72 @@ export function init_panic_hook() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_92b29b0548f8b746: function(arg0, arg1) {
+        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_Number_9a4e0ecb0fa16705: function(arg0) {
+        __wbg_Number_3890faa6d3ff057d: function(arg0) {
             const ret = Number(arg0);
             return ret;
         },
-        __wbg___wbindgen_bigint_get_as_i64_d968e41184ae354f: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_c4ecf48528083721: function(arg0, arg1) {
             const v = arg1;
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_fa956cfa2d1bd751: function(arg0) {
+        __wbg___wbindgen_boolean_get_c9c83ebd41b34df3: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_c25d447a39f5578f: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_a57024b9c6e4a48b: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_aca499c5de7ff5e5: function(arg0, arg1) {
+        __wbg___wbindgen_in_ac983077f137f2e6: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_bigint_2f76dc55065b4273: function(arg0) {
+        __wbg___wbindgen_is_bigint_8ffbbef442139384: function(arg0) {
             const ret = typeof(arg0) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_1ff95bcc5517c252: function(arg0) {
+        __wbg___wbindgen_is_function_5e4570eb24ffa122: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_ea9085d691f535d3: function(arg0) {
+        __wbg___wbindgen_is_null_7d13f41e1a2d5140: function(arg0) {
             const ret = arg0 === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_a27215656b807791: function(arg0) {
+        __wbg___wbindgen_is_object_a2790eb24c211ea0: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_undefined_c05833b95a3cf397: function(arg0) {
+        __wbg___wbindgen_is_undefined_6cff064c44e0d823: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_e659fcf7b0e32763: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_0a18949a61670320: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_db4c3b15f63fc170: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_acf2776254a8d832: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_394265ed1e1b84ee: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_136b9679cab35cfb: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_b0ca35b86a603356: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_d154f1e671052120: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -484,18 +484,18 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_344f42d3211c4765: function(arg0, arg1) {
+        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_8a2dd23819f8a60a: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_1c5886ab9c57d1c7: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_89b2b13e91a60321: function(arg0) {
+        __wbg_done_669171204c3dcae2: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
+        __wbg_error_757e9472f8410341: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
             try {
@@ -506,11 +506,11 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_get_c7eb1f358a7654df: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_d173c0308df22d37: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_unchecked_6e0ad6d2a41b06f6: function(arg0, arg1) {
+        __wbg_get_unchecked_e20b893aeafc3fca: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -518,7 +518,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_4480b9e0068a8adb: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_993d02d2d254cad1: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -528,7 +528,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_309b927aaf7a3fc7: function(arg0) {
+        __wbg_instanceof_Uint8Array_f935dbb0aa7cdeed: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -538,27 +538,27 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_0677c962b281d01a: function(arg0) {
+        __wbg_isArray_6339f732981044bf: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_isSafeInteger_04f36e4056f1b851: function(arg0) {
+        __wbg_isSafeInteger_f3d6cd19ccfe4512: function(arg0) {
             const ret = Number.isSafeInteger(arg0);
             return ret;
         },
-        __wbg_iterator_6f722e4a93058b71: function() {
+        __wbg_iterator_5cebbb86e33c6dd6: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_0133fa10e3234c57: function(arg0) {
+        __wbg_length_36bd29c6848c2144: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_1f0964f4a5e2c6d8: function(arg0) {
+        __wbg_length_46f80504ebb6ebb4: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_370319915dc99107: function(arg0) {
+        __wbg_length_ecfa2c63d3d0d82c: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
@@ -566,22 +566,26 @@ function __wbg_get_imports() {
             const ret = new Error();
             return ret;
         },
-        __wbg_new_cd45aabdf6073e84: function(arg0) {
+        __wbg_new_77cc4f4f472aeb81: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_next_6dbf2c0ac8cde20f: function(arg0) {
+        __wbg_next_42cf16ee0dafc9e2: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
+            return ret;
+        }, arguments); },
+        __wbg_next_8f26b64fa5e9f64b: function(arg0) {
             const ret = arg0.next;
             return ret;
         },
-        __wbg_next_71f2aa1cb3d1e37e: function() { return handleError(function (arg0) {
-            const ret = arg0.next();
+        __wbg_onlineoutput_new: function(arg0) {
+            const ret = OnlineOutput.__wrap(arg0);
             return ret;
-        }, arguments); },
-        __wbg_prototypesetcall_21a175a0a8157491: function(arg0, arg1, arg2) {
+        },
+        __wbg_prototypesetcall_35505001a41def4c: function(arg0, arg1, arg2) {
             Float64Array.prototype.set.call(getArrayF64FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_prototypesetcall_4770620bbe4688a0: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_de8e0d9553586985: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
@@ -591,7 +595,7 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg_value_a5d5488a9589444a: function(arg0) {
+        __wbg_value_1e2369fab29b420e: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
@@ -860,11 +864,15 @@ function __wbg_finalize_init(instance, module) {
 
 async function __wbg_load(module, imports) {
     if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
         if (typeof WebAssembly.instantiateStreaming === 'function') {
             try {
                 return await WebAssembly.instantiateStreaming(module, imports);
             } catch (e) {
-                const validResponse = module.ok && expectedResponseType(module.type);
+                const validResponse = expectedResponseType(module.type);
 
                 if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
                     console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);

package/package.json

@@ -5,7 +5,7 @@
     "Amir Valizadeh <thisisamirv@gmail.com>"
   ],
   "description": "High-performance LOWESS (Locally Weighted Scatterplot Smoothing)",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",