capstat-core 0.2.0__tar.gz

capstat_core-0.2.0/.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+
+# uv
+.uv/
+
+# Tooling caches
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Node / TypeScript (apps/web)
+node_modules/
+.next/
+out/
+dist/
+*.tsbuildinfo
+next-env.d.ts
+
+# Docs build
+site/
+
+# OS / editor
+.DS_Store
+*.swp
+.idea/
+.vscode/

capstat_core-0.2.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.5
+Name: capstat-core
+Version: 0.2.0
+Summary: Reference-validated SPC, process capability, and MSA statistics.
+Project-URL: Homepage, https://github.com/Xindaan/capstat
+Project-URL: Repository, https://github.com/Xindaan/capstat
+Author: André Leopold
+License-Expression: MIT
+Keywords: gage-rr,msa,process-capability,quality,spc,statistics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.26
+Requires-Dist: scipy>=1.11
+Description-Content-Type: text/markdown
+
+# capstat-core
+
+Reference-validated statistics for statistical process control (SPC),
+process capability, and measurement system analysis (MSA).
+
+`capstat-core` is a pure Python library (numpy + scipy only) with **zero web
+dependencies**; it is independently publishable on PyPI. Every statistical
+result is validated against published reference values.
+
+Part of the [capstat](https://github.com/Xindaan/capstat) project. See the
+repository root for documentation and the full toolkit (API + web app).
+
+## License
+
+MIT © André Leopold

capstat_core-0.2.0/README.md

@@ -0,0 +1,15 @@
+# capstat-core
+
+Reference-validated statistics for statistical process control (SPC),
+process capability, and measurement system analysis (MSA).
+
+`capstat-core` is a pure Python library (numpy + scipy only) with **zero web
+dependencies**; it is independently publishable on PyPI. Every statistical
+result is validated against published reference values.
+
+Part of the [capstat](https://github.com/Xindaan/capstat) project. See the
+repository root for documentation and the full toolkit (API + web app).
+
+## License
+
+MIT © André Leopold

capstat_core-0.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "capstat-core"
+version = "0.2.0" # x-release-please-version
+description = "Reference-validated SPC, process capability, and MSA statistics."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "André Leopold" }]
+keywords = ["spc", "process-capability", "msa", "gage-rr", "statistics", "quality"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Typing :: Typed",
+]
+dependencies = [
+    "numpy>=1.26",
+    "scipy>=1.11",
+]
+
+[project.urls]
+Homepage = "https://github.com/Xindaan/capstat"
+Repository = "https://github.com/Xindaan/capstat"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/capstat_core"]

capstat_core-0.2.0/src/capstat_core/__init__.py

@@ -0,0 +1,206 @@
+"""capstat-core: reference-validated SPC, capability, and MSA statistics.
+
+Every statistic exposed here is validated against published reference values;
+see ``tests/references/`` for the sources and the certified numbers.
+
+The public API is populated milestone by milestone (see TASK.md). Available
+today: descriptive summary statistics, robust location/scale estimators, and
+normality testing.
+"""
+
+from __future__ import annotations
+
+from capstat_core.acceptance_sampling import (
+    AOQLimit,
+    LotDecision,
+    OCCurve,
+    SamplingPlan,
+    SamplingPlanReport,
+    aoq_limit,
+    average_outgoing_quality,
+    average_total_inspection,
+    design_single_sampling_plan,
+    evaluate_plan,
+    inspect_lot,
+    oc_curve,
+    probability_of_acceptance,
+    quality_for_acceptance,
+)
+from capstat_core.bias import (
+    BiasReport,
+    bias,
+)
+from capstat_core.capability import (
+    CapabilityReport,
+    capability,
+)
+from capstat_core.constants import A2, A3, B3, B4, D3, D4, E2, c4, d2, d2_star, d3
+from capstat_core.control_charts import (
+    ChartPair,
+    ControlChart,
+    ControlLimits,
+    i_mr_chart,
+    xbar_r_chart,
+    xbar_s_chart,
+)
+from capstat_core.descriptive import (
+    DescriptiveSummary,
+    describe,
+    kurtosis,
+    lag1_autocorrelation,
+    mean,
+    skewness,
+    std_dev,
+    variance,
+)
+from capstat_core.gage_rr import (
+    GageRRReport,
+    gage_rr,
+    gage_rr_range,
+)
+from capstat_core.linearity import (
+    LinearityReport,
+    linearity,
+)
+from capstat_core.nonnormal import (
+    BoxCoxCapability,
+    CapabilityAnalysis,
+    DistributionFit,
+    PercentileCapability,
+    analyze_capability,
+    box_cox_capability,
+    fit_distribution,
+    percentile_capability,
+)
+from capstat_core.normality import (
+    NormalityAssessment,
+    NormalityTestResult,
+    anderson_darling,
+    anderson_darling_pvalue,
+    assess_normality,
+    shapiro_wilk,
+)
+from capstat_core.robust import (
+    MAD_NORMAL_CONSISTENCY,
+    iqr,
+    mad,
+    median,
+    trimmed_mean,
+    winsorized_mean,
+)
+from capstat_core.rules import (
+    NELSON_RULES,
+    WESTERN_ELECTRIC_RULES,
+    RuleViolation,
+    nelson_rules,
+    western_electric_rules,
+)
+from capstat_core.sampling_scheme import (
+    InspectionSeverity,
+    LotResult,
+    SchemeHistory,
+    SchemeStep,
+    SwitchingRules,
+    apply_switching_rules,
+)
+from capstat_core.stability import (
+    StabilityReport,
+    stability,
+)
+from capstat_core.time_weighted import (
+    CusumChart,
+    EwmaChart,
+    cusum_chart,
+    ewma_chart,
+)
+
+__all__ = [
+    "A2",
+    "A3",
+    "B3",
+    "B4",
+    "D3",
+    "D4",
+    "E2",
+    "MAD_NORMAL_CONSISTENCY",
+    "NELSON_RULES",
+    "WESTERN_ELECTRIC_RULES",
+    "AOQLimit",
+    "BiasReport",
+    "BoxCoxCapability",
+    "CapabilityAnalysis",
+    "CapabilityReport",
+    "ChartPair",
+    "ControlChart",
+    "ControlLimits",
+    "CusumChart",
+    "DescriptiveSummary",
+    "DistributionFit",
+    "EwmaChart",
+    "GageRRReport",
+    "InspectionSeverity",
+    "LinearityReport",
+    "LotDecision",
+    "LotResult",
+    "NormalityAssessment",
+    "NormalityTestResult",
+    "OCCurve",
+    "PercentileCapability",
+    "RuleViolation",
+    "SamplingPlan",
+    "SamplingPlanReport",
+    "SchemeHistory",
+    "SchemeStep",
+    "StabilityReport",
+    "SwitchingRules",
+    "__version__",
+    "analyze_capability",
+    "anderson_darling",
+    "anderson_darling_pvalue",
+    "aoq_limit",
+    "apply_switching_rules",
+    "assess_normality",
+    "average_outgoing_quality",
+    "average_total_inspection",
+    "bias",
+    "box_cox_capability",
+    "c4",
+    "capability",
+    "cusum_chart",
+    "d2",
+    "d2_star",
+    "d3",
+    "describe",
+    "design_single_sampling_plan",
+    "evaluate_plan",
+    "ewma_chart",
+    "fit_distribution",
+    "gage_rr",
+    "gage_rr_range",
+    "i_mr_chart",
+    "inspect_lot",
+    "iqr",
+    "kurtosis",
+    "lag1_autocorrelation",
+    "linearity",
+    "mad",
+    "mean",
+    "median",
+    "nelson_rules",
+    "oc_curve",
+    "percentile_capability",
+    "probability_of_acceptance",
+    "quality_for_acceptance",
+    "shapiro_wilk",
+    "skewness",
+    "stability",
+    "std_dev",
+    "trimmed_mean",
+    "variance",
+    "western_electric_rules",
+    "winsorized_mean",
+    "xbar_r_chart",
+    "xbar_s_chart",
+]
+
+__version__ = "0.2.0"  # x-release-please-version

capstat_core-0.2.0/src/capstat_core/_validation.py

@@ -0,0 +1,38 @@
+"""Internal input validation shared by the public statistics modules.
+
+Not part of the public API.
+"""
+
+from __future__ import annotations
+
+import numpy as np
+import numpy.typing as npt
+
+__all__ = ["as_sample"]
+
+
+def as_sample(x: npt.ArrayLike, *, minimum: int = 1) -> npt.NDArray[np.float64]:
+    """Validate and coerce ``x`` into a one-dimensional float64 sample.
+
+    Rejecting non-finite input here (rather than silently propagating ``nan``)
+    keeps every downstream statistic total: if a call returns a number, that
+    number is meaningful.
+
+    Raises
+    ------
+    ValueError
+        If the sample is not one-dimensional, holds fewer than ``minimum``
+        observations, or contains NaN or infinite values.
+    """
+    arr = np.asarray(x, dtype=np.float64)
+    if arr.ndim != 1:
+        raise ValueError(
+            f"expected a one-dimensional sample, got {arr.ndim} dimension(s)"
+        )
+    if arr.size < minimum:
+        raise ValueError(
+            f"sample must contain at least {minimum} observation(s), got {arr.size}"
+        )
+    if not np.all(np.isfinite(arr)):
+        raise ValueError("sample contains NaN or infinite values")
+    return arr