Tune PID
tune_pidRead-onlyIdempotent
Generate PID tuning parameters using Ziegler-Nichols and Cohen-Coon methods from a FOPDT process model. Returns Kp, Ki, Kd for the selected controller type and method, with reliability flags and method comparison. All inputs must be in strict SI units.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"process_gain": "<process_gain>",
"time_constant": "<time_constant>",
"dead_time": "<dead_time>"
},
"name": "tune_pid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | No | Tuning method to apply | both |
| dead_time | Yes | Process dead time theta in seconds | |
| process_gain | Yes | Static process gain K from step test | |
| time_constant | Yes | First-order time constant tau in seconds | |
| controller_type | No | Type of controller to tune | PID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| warnings | Yes | Reliability advisory messages for the computed parameters | |
| cohen_coon | Yes | Tuning parameters computed via the Cohen-Coon method | |
| ziegler_nichols | Yes | Tuning parameters computed via the Ziegler-Nichols open-loop method | |
| recommended_method | Yes | Which tuning method is preferred for this process model | |
| controllability_class | Yes | Textual controllability assessment based on the dead-time ratio | |
| controllability_ratio | Yes | Dead-time ratio r = θ/τ; values above 1.0 indicate a difficult process | |
| method_agreement_ratio | Yes | Cohen-Coon / Ziegler-Nichols Kp ratio; values between 0.8–1.2 indicate good agreement |