process-improve 1.2.7__tar.gz → 1.2.8__tar.gz

{process_improve-1.2.7 → process_improve-1.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: process-improve
-Version: 1.2.7
+Version: 1.2.8
 Summary: Designed Experiments; Latent Variables (PCA, PLS, multivariate methods with missing data); Process Monitoring; Batch data analysis.
 Keywords: Designed Experiments,Latent Variables,PCA,PLS,Multivariate Data Analysis,Batch data analysis
 Author: Kevin Dunn
@@ -14,6 +14,8 @@ Requires-Dist: pandas>=2.3.3
 Requires-Dist: patsy>=1.0.2
 Requires-Dist: plotly>=6.5.2
 Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydoe3>=1.0
 Requires-Dist: ridgeplot>=0.5.0
 Requires-Dist: scikit-image>=0.25.2
 Requires-Dist: scikit-learn>=1.7.2
@@ -119,6 +121,50 @@ outliers = pls.detect_outliers(conf_level=0.95)
 contrib = pls.score_contributions(pls.scores_.iloc[0].values)
 ```
 
+### DOE — Experimental Strategy Recommendation
+
+Plan a complete multi-stage experimental program before running any experiments:
+
+```python
+from process_improve.experiments.factor import Factor, Response
+from process_improve.experiments.strategy import recommend_strategy
+
+# Define factors for a fermentation optimization
+factors = [
+    Factor(name="Temperature", low=25, high=40, units="degC"),
+    Factor(name="pH", low=5.0, high=7.5),
+    Factor(name="Glucose", low=10, high=50, units="g/L"),
+    Factor(name="Yeast extract", low=1, high=10, units="g/L"),
+    Factor(name="Agitation", low=100, high=400, units="rpm"),
+    Factor(name="Aeration", low=0.5, high=2.0, units="vvm"),
+    Factor(name="Inoculum", low=2, high=10, units="%v/v"),
+]
+responses = [Response(name="Yield", goal="maximize", units="g/L")]
+
+# Get a complete experimental plan
+strategy = recommend_strategy(
+    factors=factors,
+    responses=responses,
+    budget=40,
+    domain="fermentation",
+)
+
+# Inspect the multi-stage strategy
+for stage in strategy["stages"]:
+    print(f"Stage {stage['stage_number']}: {stage['stage_name']}")
+    print(f"  Design: {stage['design_type']}, Runs: {stage['estimated_runs']}")
+    print(f"  Purpose: {stage['purpose']}")
+
+# Review reasoning, risks, and alternatives
+print(strategy["budget_allocation"])
+print(strategy["reasoning"])
+```
+
+The engine applies ~50 deterministic rules (from Montgomery, NIST, Stat-Ease)
+to recommend screening, optimization, and confirmation stages — with
+budget-aware allocation and domain-specific advice for fermentation, cell
+culture, pharma, and 5 other application domains.
+
 ## Features
 
 - **PCA** with SVD, NIPALS, and missing data (TSR) algorithms
@@ -130,6 +176,7 @@ contrib = pls.score_contributions(pls.scores_.iloc[0].values)
 - **Cross-validation** for component selection (PRESS with Wold's criterion)
 - **Interactive plots** (Plotly) for scores, loadings, SPE, and T²
 - **Designed experiments** — full factorial, fractional factorial, response surface
+- **DOE strategy recommender** — multi-stage experimental planning (screening, optimization, confirmation) with budget-aware allocation and 8 application domains
 - **Process monitoring** — Shewhart, CUSUM, EWMA control charts
 - **Batch data analysis** — alignment, feature extraction, multivariate batch monitoring
 

{process_improve-1.2.7 → process_improve-1.2.8}/README.md

@@ -74,6 +74,50 @@ outliers = pls.detect_outliers(conf_level=0.95)
 contrib = pls.score_contributions(pls.scores_.iloc[0].values)
 ```
 
+### DOE — Experimental Strategy Recommendation
+
+Plan a complete multi-stage experimental program before running any experiments:
+
+```python
+from process_improve.experiments.factor import Factor, Response
+from process_improve.experiments.strategy import recommend_strategy
+
+# Define factors for a fermentation optimization
+factors = [
+    Factor(name="Temperature", low=25, high=40, units="degC"),
+    Factor(name="pH", low=5.0, high=7.5),
+    Factor(name="Glucose", low=10, high=50, units="g/L"),
+    Factor(name="Yeast extract", low=1, high=10, units="g/L"),
+    Factor(name="Agitation", low=100, high=400, units="rpm"),
+    Factor(name="Aeration", low=0.5, high=2.0, units="vvm"),
+    Factor(name="Inoculum", low=2, high=10, units="%v/v"),
+]
+responses = [Response(name="Yield", goal="maximize", units="g/L")]
+
+# Get a complete experimental plan
+strategy = recommend_strategy(
+    factors=factors,
+    responses=responses,
+    budget=40,
+    domain="fermentation",
+)
+
+# Inspect the multi-stage strategy
+for stage in strategy["stages"]:
+    print(f"Stage {stage['stage_number']}: {stage['stage_name']}")
+    print(f"  Design: {stage['design_type']}, Runs: {stage['estimated_runs']}")
+    print(f"  Purpose: {stage['purpose']}")
+
+# Review reasoning, risks, and alternatives
+print(strategy["budget_allocation"])
+print(strategy["reasoning"])
+```
+
+The engine applies ~50 deterministic rules (from Montgomery, NIST, Stat-Ease)
+to recommend screening, optimization, and confirmation stages — with
+budget-aware allocation and domain-specific advice for fermentation, cell
+culture, pharma, and 5 other application domains.
+
 ## Features
 
 - **PCA** with SVD, NIPALS, and missing data (TSR) algorithms
@@ -85,6 +129,7 @@ contrib = pls.score_contributions(pls.scores_.iloc[0].values)
 - **Cross-validation** for component selection (PRESS with Wold's criterion)
 - **Interactive plots** (Plotly) for scores, loadings, SPE, and T²
 - **Designed experiments** — full factorial, fractional factorial, response surface
+- **DOE strategy recommender** — multi-stage experimental planning (screening, optimization, confirmation) with budget-aware allocation and 8 application domains
 - **Process monitoring** — Shewhart, CUSUM, EWMA control charts
 - **Batch data analysis** — alignment, feature extraction, multivariate batch monitoring
 

process_improve-1.2.8/process_improve/experiments/__init__.py

@@ -0,0 +1,48 @@
+"""Designed experiments: factorial designs, linear models, optimization, and design generation."""
+
+from process_improve.experiments.analysis import analyze_experiment
+from process_improve.experiments.augment import augment_design
+from process_improve.experiments.designs import generate_design
+from process_improve.experiments.designs_factorial import full_factorial
+from process_improve.experiments.evaluate import evaluate_design
+from process_improve.experiments.factor import Constraint, DesignResult, Factor, Response, ResponseGoal
+from process_improve.experiments.knowledge import doe_knowledge
+from process_improve.experiments.models import Model, lm, predict, summary
+from process_improve.experiments.optimization import optimize_responses
+from process_improve.experiments.strategy import recommend_strategy
+from process_improve.experiments.structures import (
+    Column,
+    Expt,
+    c,
+    expand_grid,
+    gather,
+    supplement,
+)
+from process_improve.experiments.visualization import visualize_doe
+
+__all__ = [
+    "Column",
+    "Constraint",
+    "DesignResult",
+    "Expt",
+    "Factor",
+    "Model",
+    "Response",
+    "ResponseGoal",
+    "analyze_experiment",
+    "augment_design",
+    "c",
+    "doe_knowledge",
+    "evaluate_design",
+    "expand_grid",
+    "full_factorial",
+    "gather",
+    "generate_design",
+    "lm",
+    "optimize_responses",
+    "predict",
+    "recommend_strategy",
+    "summary",
+    "supplement",
+    "visualize_doe",
+]