UNumflow 0.3.0

UNumflow

.NET bindings for the u-numflow numerical library.

Features

• Distributions: Uniform, Triangular, PERT, Normal, LogNormal, Weibull, Exponential, Gamma, Beta and χ² — Cdf, Quantile, Mean, Variance, and Sample(n, seed): the same seed always gives the same values, and the uniforms behind them come from the open interval (0, 1), so no variate is infinite
• Interval sets: unions of half-open intervals [start, end) with Union, Intersection, Difference, Clip, Contains and a Measure that counts every point once, however much the input overlapped
• Parameters are checked when you create a distribution — a Distribution that exists is a valid one

Installation

dotnet add package UNumflow

Usage

using UNumflow;

// Critical values and probabilities
var chi = Distribution.ChiSquared(4);
double critical = chi.Quantile(0.95);       // 9.4877…
double p = chi.Cdf(critical);               // 0.95

// Reproducible samples
double[] lives = Distribution.Weibull(shape: 2, scale: 100).Sample(1000, seed: 42);

// Coverage arithmetic: overlapping stops are down-time once
var planned = IntervalSet.From([(0, 24)]);
var unplanned = IntervalSet.From([(10, 30)]);
var week = IntervalSet.From([(0, 168)]);
double upHours = week.Difference(planned.Union(unplanned)).Measure; // 138

Errors

A refused request raises NumflowException. Message is readable text; Reason is a stable code to branch on and Details is the error body with the values behind it:

try
{
    Distribution.Normal(0, sigma: -1);
}
catch (NumflowException e)
{
    // e.Reason == "parameter_out_of_range"
    // e.Details: { "parameter": "distribution.sigma", "min": null, "exclusive_min": 0, "max": null, "got": -1, ... }
}

In parameter_out_of_range, min and max are inclusive bounds and are always present — null when that end is unbounded or open. An open (exclusive) end is exclusive_min / exclusive_max, present only when the bound is open.

Platforms

The package carries the native library for win-x64, linux-x64 and linux-arm64 (glibc 2.39 or later), osx-x64 and osx-arm64; no separate install is needed.

License

MIT