Skip to main content

JsSolver

Struct JsSolver 

Source
pub struct JsSolver { /* private fields */ }
Expand description

Top-level solver handle exposed to JavaScript.

Wraps the algorithm router and iterative solvers, providing a high-level API that accepts CSR arrays directly from JS typed arrays.

Implementations§

Source§

impl JsSolver

Source

pub fn new() -> Self

Construct a new solver with default parameters.

  • max_iterations: 1000
  • tolerance: 1e-6
  • alpha (PageRank teleport): 0.15
Source

pub fn set_max_iterations(&mut self, max_iterations: usize)

Set the maximum number of iterations for iterative solvers.

Source

pub fn set_tolerance(&mut self, tolerance: f64)

Set the convergence tolerance.

Source

pub fn set_alpha(&mut self, alpha: f64)

Set the teleportation probability for PageRank.

Source

pub fn solve( &self, values: &[f32], col_indices: &[u32], row_ptrs: &[u32], rows: usize, cols: usize, rhs: &[f32], ) -> Result<JsValue, JsError>

Solve a sparse linear system Ax = b.

The matrix A is provided in CSR format via three flat arrays. Returns a JSON-serialisable result object on success.

§Arguments
  • values - Non-zero values (Float32Array).
  • col_indices - Column indices for each non-zero (Uint32Array).
  • row_ptrs - Row pointers of length rows + 1 (Uint32Array).
  • rows - Number of rows.
  • cols - Number of columns.
  • rhs - Right-hand side vector b (Float32Array).
§Errors

Returns JsError on invalid input or non-convergence.

Source

pub fn pagerank( &self, values: &[f32], col_indices: &[u32], row_ptrs: &[u32], rows: usize, source: usize, tolerance: f64, ) -> Result<JsValue, JsError>

Compute Personalized PageRank from a single source node.

Uses the power-iteration method with teleportation probability alpha (configurable via set_alpha).

§Arguments
  • values - Edge weights (Float32Array).
  • col_indices - Column indices (Uint32Array).
  • row_ptrs - Row pointers (Uint32Array).
  • rows - Number of nodes.
  • source - Source node index.
  • tolerance - Convergence tolerance (L1 residual).
§Errors

Returns JsError on invalid input.

Source

pub fn estimate_complexity( &self, values: &[f32], col_indices: &[u32], row_ptrs: &[u32], rows: usize, cols: usize, ) -> Result<JsValue, JsError>

Estimate the computational complexity of solving a system with the given matrix without performing the actual solve.

Returns a JSON object with the selected algorithm, estimated FLOPS, estimated iterations, memory usage, and complexity class.

Trait Implementations§

Source§

impl From<JsSolver> for JsValue

Source§

fn from(value: JsSolver) -> Self

Converts to this type from the input type.
Source§

impl FromWasmAbi for JsSolver

Source§

type Abi = u32

The Wasm ABI type that this converts from when coming back out from the ABI boundary.
Source§

unsafe fn from_abi(js: u32) -> Self

Recover a Self from Self::Abi. Read more
Source§

impl IntoWasmAbi for JsSolver

Source§

type Abi = u32

The Wasm ABI type that this converts into when crossing the ABI boundary.
Source§

fn into_abi(self) -> u32

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.
Source§

impl LongRefFromWasmAbi for JsSolver

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRef<JsSolver>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl OptionFromWasmAbi for JsSolver

Source§

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.
Source§

impl OptionIntoWasmAbi for JsSolver

Source§

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option. Read more
Source§

impl RefFromWasmAbi for JsSolver

Source§

type Abi = u32

The Wasm ABI type references to Self are recovered from.
Source§

type Anchor = RcRef<JsSolver>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.
Source§

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi. Read more
Source§

impl RefMutFromWasmAbi for JsSolver

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRefMut<JsSolver>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl TryFromJsValue for JsSolver

Source§

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.
Source§

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.
Source§

impl VectorFromWasmAbi for JsSolver

Source§

type Abi = <Box<[JsValue]> as FromWasmAbi>::Abi

Source§

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[JsSolver]>

Source§

impl VectorIntoWasmAbi for JsSolver

Source§

impl WasmDescribe for JsSolver

Source§

impl WasmDescribeVector for JsSolver

Source§

impl SupportsConstructor for JsSolver

Source§

impl SupportsInstanceProperty for JsSolver

Source§

impl SupportsStaticProperty for JsSolver

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ReturnWasmAbi for T
where T: IntoWasmAbi,

Source§

type Abi = <T as IntoWasmAbi>::Abi

Same as IntoWasmAbi::Abi
Source§

fn return_abi(self) -> <T as ReturnWasmAbi>::Abi

Same as IntoWasmAbi::into_abi, except that it may throw and never return in the case of Err.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<S, T> Upcast<T> for S
where T: UpcastFrom<S> + ?Sized, S: ?Sized,

Source§

fn upcast(&self) -> &T
where Self: ErasableGeneric, T: ErasableGeneric<Repr = Self::Repr>,

Perform a zero-cost type-safe upcast to a wider ref type within the Wasm bindgen generics type system. Read more
Source§

fn upcast_into(self) -> T
where Self: Sized + ErasableGeneric, T: ErasableGeneric<Repr = Self::Repr>,

Perform a zero-cost type-safe upcast to a wider type within the Wasm bindgen generics type system. Read more
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more