← Back to Skills Marketplace
wu-uk

scipy-curve-fit

by wu-uk · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
76
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hvac-control-scipy-curve-fit
Description
Use scipy.optimize.curve_fit for nonlinear least squares parameter estimation from experimental data.
README (SKILL.md)

Using scipy.optimize.curve_fit for Parameter Estimation

Overview

scipy.optimize.curve_fit is a tool for fitting models to experimental data using nonlinear least squares optimization.

Basic Usage

from scipy.optimize import curve_fit
import numpy as np

# Define your model function
def model(x, param1, param2):
    return param1 * (1 - np.exp(-x / param2))

# Fit to data
popt, pcov = curve_fit(model, x_data, y_data)

# popt contains the optimal parameters [param1, param2]
# pcov contains the covariance matrix

Fitting a First-Order Step Response

import numpy as np
from scipy.optimize import curve_fit

# Known values from experiment
y_initial = ...  # Initial output value
u = ...          # Input magnitude during step test

# Define the step response model
def step_response(t, K, tau):
    """First-order step response with fixed initial value and input."""
    return y_initial + K * u * (1 - np.exp(-t / tau))

# Your experimental data
t_data = np.array([...])  # Time points
y_data = np.array([...])  # Output readings

# Perform the fit
popt, pcov = curve_fit(
    step_response,
    t_data,
    y_data,
    p0=[K_guess, tau_guess],      # Initial guesses
    bounds=([K_min, tau_min], [K_max, tau_max])  # Parameter bounds
)

K_estimated, tau_estimated = popt

Setting Initial Guesses (p0)

Good initial guesses speed up convergence:

# Estimate K from steady-state data
K_guess = (y_data[-1] - y_initial) / u

# Estimate tau from 63.2% rise time
y_63 = y_initial + 0.632 * (y_data[-1] - y_initial)
idx_63 = np.argmin(np.abs(y_data - y_63))
tau_guess = t_data[idx_63]

p0 = [K_guess, tau_guess]

Setting Parameter Bounds

Bounds prevent physically impossible solutions:

bounds = (
    [lower_K, lower_tau],    # Lower bounds
    [upper_K, upper_tau]     # Upper bounds
)

Calculating Fit Quality

R-squared (Coefficient of Determination)

# Predicted values from fitted model
y_predicted = step_response(t_data, K_estimated, tau_estimated)

# Calculate R-squared
ss_residuals = np.sum((y_data - y_predicted) ** 2)
ss_total = np.sum((y_data - np.mean(y_data)) ** 2)
r_squared = 1 - (ss_residuals / ss_total)

Root Mean Square Error (RMSE)

residuals = y_data - y_predicted
rmse = np.sqrt(np.mean(residuals ** 2))

Complete Example

import numpy as np
from scipy.optimize import curve_fit

def fit_first_order_model(data, y_initial, input_value):
    """
    Fit first-order model to step response data.

    Returns dict with K, tau, r_squared, fitting_error
    """
    t_data = np.array([d["time"] for d in data])
    y_data = np.array([d["output"] for d in data])

    def model(t, K, tau):
        return y_initial + K * input_value * (1 - np.exp(-t / tau))

    # Initial guesses
    K_guess = (y_data[-1] - y_initial) / input_value
    tau_guess = t_data[len(t_data)//3]  # Rough guess

    # Fit with bounds
    popt, _ = curve_fit(
        model, t_data, y_data,
        p0=[K_guess, tau_guess],
        bounds=([0, 0], [np.inf, np.inf])
    )

    K, tau = popt

    # Calculate quality metrics
    y_pred = model(t_data, K, tau)
    ss_res = np.sum((y_data - y_pred) ** 2)
    ss_tot = np.sum((y_data - np.mean(y_data)) ** 2)
    r_squared = 1 - (ss_res / ss_tot)
    fitting_error = np.sqrt(np.mean((y_data - y_pred) ** 2))

    return {
        "K": float(K),
        "tau": float(tau),
        "r_squared": float(r_squared),
        "fitting_error": float(fitting_error)
    }

Common Issues

  1. RuntimeError: Optimal parameters not found

    • Try better initial guesses
    • Check that data is valid (no NaN, reasonable range)
  2. Poor fit (low R^2):

    • Data might not be from step response phase
    • System might not be first-order
    • Too much noise in measurements
  3. Unrealistic parameters:

    • Add bounds to constrain solution
    • Check units are consistent
Usage Guidance
This is a documentation-style, instruction-only skill for fitting data with scipy.curve_fit. It does not ask for credentials or install packages, but it assumes numpy/scipy are available in the environment. Before using: ensure your data arrays (t_data, y_data) are valid (no NaNs), confirm units and bounds make sense for your system, and provide reasonable initial guesses to avoid convergence issues. If you need the skill to run in an environment without numpy/scipy, install those packages from trusted sources first.
Capability Analysis
Type: OpenClaw Skill Name: hvac-control-scipy-curve-fit Version: 0.1.0 The skill bundle provides standard documentation and Python code examples for using the SciPy library to perform nonlinear least squares curve fitting. There are no indicators of malicious intent, data exfiltration, or prompt injection; the content is entirely focused on mathematical modeling and parameter estimation in SKILL.md.
Capability Assessment
Purpose & Capability
Name and description match the content: the SKILL.md explains how to use scipy.optimize.curve_fit to fit first-order step responses and compute fit quality. There are no unrelated requirements (no env vars, binaries, or external services).
Instruction Scope
Instructions stay within the stated purpose: they define model functions, compute initial guesses, run curve_fit, and compute metrics (R^2, RMSE). The file does not instruct reading unrelated system files, exporting data to external endpoints, or accessing secrets.
Install Mechanism
No install spec or downloaded code is included (instruction-only), so nothing is written to disk. The SKILL.md assumes numpy and scipy are available but does not attempt to install them; this is reasonable for a usage guide.
Credentials
The skill requests no environment variables, credentials, or config paths. No sensitive access is requested or needed for the documented functionality.
Persistence & Privilege
always is false and the skill does not request or describe modifying agent/system configuration or maintaining persistent credentials. It is a transient, instruction-only skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hvac-control-scipy-curve-fit
  3. After installation, invoke the skill by name or use /hvac-control-scipy-curve-fit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Bulk publish from all-task-skills-dedup
Metadata
Slug hvac-control-scipy-curve-fit
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is scipy-curve-fit?

Use scipy.optimize.curve_fit for nonlinear least squares parameter estimation from experimental data. It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.

How do I install scipy-curve-fit?

Run "/install hvac-control-scipy-curve-fit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is scipy-curve-fit free?

Yes, scipy-curve-fit is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does scipy-curve-fit support?

scipy-curve-fit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created scipy-curve-fit?

It is built and maintained by wu-uk (@wu-uk); the current version is v0.1.0.

💬 Comments