scipy-optimization
Skill81 starsChanged 12 months agoMITView on GitHub
Optimize pump designs and system parameters using scipy.optimize
We split this skill into the rules it gives an agent
15 rules. About 0 are common, 10 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 95
No gradient information available
- Distinctive: line 249
Choose good initial guess: Start near expected solution
- Distinctive: line 251
Formulate smooth objectives: Avoid discontinuities
- Very specific: line 254
Smooth, gradient-available: Use 'BFGS' or 'L-BFGS-B'
- Very specific: line 255
With constraints: Use 'SLSQP' or 'trust-constr'
- Very specific: line 256
Noisy/discontinuous: Use 'Nelder-Mead' or derivative-free methods
- Very specific: line 257
Multiple local minima: Use differential_evolution first, then refine
- Very specific: line 258
Curve fitting: Use curve_fit or least_squares
- Distinctive: line 262
Use reasonable tolerances (not too tight)
- Distinctive: line 264
Check optimization success flag
- Distinctive: line 270
Keep constraints smooth and differentiable
- Distinctive: line 279
Ignoring bounds: Not constraining to physical limits
- Distinctive: line 280
No validation: Not checking if solution makes engineering sense
- Distinctive: line 284
Vectorize operations: Use NumPy arrays instead of loops
- Distinctive: line 286
Use appropriate method: Don't use global optimization if local is sufficient
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SciPy Optimization for Engineering Design
Overview
The scipy.optimize module provides a comprehensive suite of optimization algorithms for solving engineering design problems. This skill focuses on applying these methods to pump design optimization, system parameter tuning, and performance analysis.
Key capabilities:
- Unconstrained optimization: Find optimal parameters without restrictions
- Constrained optimization: Optimize with design constraints and bounds
- Curve fitting: Fit models to experimental data
- Global optimization: Find global minima in multi-modal problems
- Multi-objective optimization: Balance competing design objectives
Optimization Methods
1. minimize() - Unconstrained and Constrained Optimization
The workhorse function for most optimization tasks.
from scipy.optimize import minimize
import numpy as np
# Basic usage
def objective(x):
"""Objective function to minimize"""
return x[0]**2 + x[1]**2
result = minimize(objective, x0=[1.0, 1.0])
print(f"Optimal point: {result.x}")
print(f"Optimal value: {result.fun}")Common algorithms:
'Nelder-Mead': Derivative-free, robust but slower'BFGS': Quasi-Newton method, fast for smooth functions'L-BFGS-B': BFGS with bounds'SLSQP': Sequential Least Squares with constraints'trust-constr': General constrained optimization (preferred)
2. least_squares() - Curve Fitting and Residual Minimization
Specialized for problems of the form: minimize sum(residuals^2)
from scipy.optimize import least_squares
def residuals(params, x_data, y_data):
"""Calculate residuals between model and data"""
a, b, c = params
y_model = a * x_data**2 + b * x_data + c
return y_model - y_data
# Fit quadratic to data
x_data = np.array([1, 2, 3, 4, 5])
y_data = np.array([2.1, 3.9, 9.2, 15.8, 25.1])
result = least_squares(residuals, x0=[1, 1, 1], args=(x_data, y_data))Key features:
- Handles bounds on variables
- Robust loss functions (handles outliers)
- Efficient for large residual problems
- Returns Jacobian information
3. differential_evolution() - Global Optimization
Finds global minimum using evolutionary algorithms. Essential for multi-modal problems.
from scipy.optimize import differential_evolution
def complex_function(x):
"""Function with multiple local minima"""
return np.sin(x[0]) * np.cos(x[1]) + (x[0] - 1)**2 + (x[1] + 2)**2
# Search over bounds
bounds = [(-5, 5), (-5, 5)]
result = differential_evolution(complex_function, bounds)When to use:
- Multiple local minima expected
- No gradient information available
- Need robust global solution
- Can afford longer computation time
4. Constrained Optimization
Optimize subject to equality and inequality constraints.
from scipy.optimize import minimize, NonlinearConstraint, LinearConstraint
def objective(x):
return x[0]**2 + x[1]**2
# Equality constraint: x[0] + x[1] = 1
def eq_constraint(x):
return x[0] + x[1] - 1
# Inequality constraint: x[0]^2 + x[1]^2 >= 0.5
def ineq_constraint(x):
return x[0]**2 + x[1]**2 - 0.5
constraints = [
{'type': 'eq', 'fun': eq_constraint},
{'type': 'ineq', 'fun': ineq_constraint}
]
result = minimize(objective, x0=[0.5, 0.5],
method='SLSQP', constraints=constraints)Engineering Applications
1. Pump Efficiency Maximization
Optimize pump geometry (impeller diameter, blade angle, width) to maximize efficiency at design point.
Problem formulation:
- Objective: Maximize efficiency η(D, β, b)
- Constraints:
- Minimum flow rate requirement
- Maximum power consumption
- Geometric constraints (e.g., D_min ≤ D ≤ D_max)
- NPSH requirements
Approach:
def pump_efficiency(params):
"""Calculate pump efficiency (negative for minimization)"""
D, beta, b = params # diameter, blade angle, width
# Simplified efficiency model
Q = calculate_flow_rate(D, beta, b)
H = calculate_head(D, beta, b)
P = calculate_power(D, beta, b)
eta = (rho * g * Q * H) / P
return -eta # Negative for maximization
bounds = [(0.1, 0.5), (20, 45), (0.02, 0.1)] # D, beta, b
result = minimize(pump_efficiency, x0=[0.3, 30, 0.05],
method='L-BFGS-B', bounds=bounds)2. Impeller Geometry Optimization
Optimize blade profile, shroud contour, and hub geometry for specific duty point.
Key considerations:
- Velocity triangles at inlet/outlet
- Blade loading distribution
- Cavitation performance (NPSH)
- Structural integrity (stress limits)
3. System Cost Minimization
Find optimal pump size and operating speed to minimize total lifecycle cost.
Cost components:
- Capital cost (pump + motor + VFD)
- Energy cost (operating hours × efficiency)
- Maintenance cost
- Replacement cost (NPV)
Formulation:
def total_cost(params):
"""Total lifecycle cost"""
pump_size, speed_rpm = params
# Capital cost
capital = cost_pump(pump_size) + cost_motor(pump_size, speed_rpm)
# Operating cost (20 year life)
annual_energy = operating_hours * power(pump_size, speed_rpm) * electricity_rate
operating = annual_energy * 20
# Maintenance
maintenance = maintenance_rate * capital * 20
return capital + operating + maintenance4. Multi-Objective Optimization
Balance competing objectives (e.g., efficiency vs cost, flow vs head).
Pareto front approach:
def weighted_objectives(params, weight):
"""Combine objectives with weighting"""
eta = pump_efficiency(params)
cost = pump_cost(params)
# Normalize and combine
return -weight * eta + (1 - weight) * cost
# Sweep weights to find Pareto front
pareto_solutions = []
for w in np.linspace(0, 1, 21):
result = minimize(lambda x: weighted_objectives(x, w),
x0=[0.3, 30, 0.05], bounds=bounds)
pareto_solutions.append(result.x)5. Curve Fitting to Experimental Data
Fit pump characteristic curves (H-Q, η-Q, P-Q) to test data.
Applications:
- Develop performance models from test data
- Extrapolate performance to off-design conditions
- Identify empirical coefficients in analytical models
Example:
from scipy.optimize import curve_fit
def pump_curve(Q, a, b, c):
"""Quadratic head-flow relationship"""
return a - b * Q - c * Q**2
# Fit to test data
Q_test = np.array([0, 50, 100, 150, 200]) # m³/h
H_test = np.array([120, 115, 105, 90, 70]) # m
params, covariance = curve_fit(pump_curve, Q_test, H_test)
print(f"H = {params[0]:.2f} - {params[1]:.4f}*Q - {params[2]:.6f}*Q²")Best Practices
1. Problem Formulation
- Scale variables: Normalize to similar magnitudes (0-1 or -1 to 1)
- Choose good initial guess: Start near expected solution
- Define clear bounds: Prevent physically impossible solutions
- Formulate smooth objectives: Avoid discontinuities
2. Algorithm Selection
- Smooth, gradient-available: Use
'BFGS'or'L-BFGS-B' - With constraints: Use
'SLSQP'or'trust-constr' - Noisy/discontinuous: Use
'Nelder-Mead'or derivative-free methods - Multiple local minima: Use
differential_evolutionfirst, then refine - Curve fitting: Use
curve_fitorleast_squares
3. Convergence Tips
- Try multiple initial guesses
- Use reasonable tolerances (not too tight)
- Provide analytical gradients if possible
- Check optimization success flag
- Validate physical feasibility of results
4. Constraint Formulation
- Express as g(x) ≥ 0 for inequality constraints
- Express as h(x) = 0 for equality constraints
- Keep constraints smooth and differentiable
- Avoid redundant constraints
Common Pitfalls
- Poor scaling: Variables of vastly different magnitudes
- Bad initial guess: Starting far from feasible region
- Wrong algorithm: Using gradient-based methods on non-smooth functions
- Tight tolerances: Asking for more precision than achievable
- Ignoring bounds: Not constraining to physical limits
- No validation: Not checking if solution makes engineering sense
Performance Optimization Tips
- Vectorize operations: Use NumPy arrays instead of loops
- Provide Jacobians: Analytical gradients are faster and more accurate
- Use appropriate method: Don't use global optimization if local is sufficient
- Cache expensive computations: Store intermediate results
- Start with simple model: Refine complexity iteratively
Integration with Pump Design Workflow
1. Define design variables (D, β, b, ω, etc.)
2. Establish objective function (maximize η, minimize cost)
3. Define constraints (Q_min, NPSH, stress limits)
4. Set bounds (physical limits)
5. Choose optimization algorithm
6. Run optimization with multiple initial guesses
7. Validate results (CFD, analytical checks)
8. Perform sensitivity analysis
9. Generate documentation and plotsExample Workflow
import numpy as np
from scipy.optimize import minimize, differential_evolution
import matplotlib.pyplot as plt
# Step 1: Define problem
def objective(x):
D, beta = x
return -calculate_efficiency(D, beta)
def constraint_flow(x):
D, beta = x
return calculate_flow_rate(D, beta) - Q_min
def constraint_power(x):
D, beta = x
return P_max - calculate_power(D, beta)
# Step 2: Set up optimization
bounds = [(0.2, 0.6), (20, 50)]
constraints = [
{'type': 'ineq', 'fun': constraint_flow},
{'type': 'ineq', 'fun': constraint_power}
]
# Step 3: Solve with global optimizer first
result_global = differential_evolution(
objective, bounds, constraints=constraints
)
# Step 4: Refine with local optimizer
result_local = minimize(
objective, x0=result_global.x,
method='SLSQP', bounds=bounds,
constraints=constraints
)
# Step 5: Report results
print(f"Optimal diameter: {result_local.x[0]:.3f} m")
print(f"Optimal blade angle: {result_local.x[1]:.1f}°")
print(f"Maximum efficiency: {-result_local.fun:.2%}")References
- SciPy Optimization Documentation
- Optimization Methods Tutorial
- Engineering optimization textbooks for problem formulation
- Pump design handbooks for realistic constraints and models
In this repository29 other files it gives its agents.
- cavitation-risk-dbSkill
- coolprop-dbSkill
- hydraulic-components-dbSkill
- material-properties-dbSkill
- nasa-earthdataSkill
- nist-refpropSkill
- pump-performance-dbSkill
- turbulence-models-dbSkill
- engineering-context-initSkill
- error-handler-fluidsSkill
- fluid-property-calculatorSkill
- get-available-resourcesSkill
- pump-selection-helperSkill
- unit-converterSkill
- ansys-simulationSkill
- comsol-multiphysicsSkill
- openfoam-cfdSkill
- solidworks-cadSkill
- fluids-packageSkill
- matplotlib-visualizationSkill
- networkx-flow-networksSkill
- numpy-numericsSkill
- pint-unitsSkill
- pyvista-visualizationSkill
- sympy-symbolicSkill
- thermo-packageSkill
- fluid-dynamics-workflowSkill
- structural-analysis-workflowSkill
- thermodynamics-workflowSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

