psplot
Plots propensity score distributions for treated and control groups to diagnose common support, with optional trimming lines.
Instructions
Propensity score distribution plot (common support diagnostic).
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": {
"covariates": "<covariates>",
"data_path": "<data_path>",
"treat": "<treat>"
},
"name": "psplot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ax | No | ax parameter. | |
| trim | No | If set, draw vertical lines at (trim, 1-trim) to show the recommended trimming region. | |
| title | No | title parameter (Optional[str]). | |
| treat | Yes | Binary treatment column. | |
| colors | No | Colors for (control, treated). | |
| detail | No | Payload depth: 'minimal' (~150 tokens) for sub-step calls where only the point estimate is needed; 'standard' (~1K tokens) for diagnostics + coefficient table; 'agent' (~2K tokens, default) adds violations / next_steps / suggested_functions so the LLM can plan its next call without another round-trip. | agent |
| labels | No | Labels for (control, treated). | |
| n_bins | No | Number of histogram bins. | |
| figsize | No | figsize parameter (tuple). | |
| as_handle | No | If true, cache the fitted result on the server and return result_id + result_uri alongside the JSON payload so a subsequent tools/call can chain without re-running. | |
| data_path | Yes | Absolute path or URL to a data file. Supported: .csv / .tsv / .txt (delimited), .parquet / .pq, .feather / .arrow, .xlsx / .xls, .dta (Stata), .json / .jsonl. Schemes: file://, s3://, gs://, https://. | |
| result_id | No | Optional handle to a previously-fitted result (returned by an earlier call when as_handle=true). Tools that operate on a fitted object accept this in place of re-supplying data_path + columns. | |
| covariates | Yes | Covariates used to estimate the propensity score. | |
| data_columns | No | Optional column projection. Parquet/Feather/Stata loaders honour this for fast partial reads. | |
| data_sample_n | No | Optional uniform random subsample size (seed=0, deterministic) — useful on huge panels. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||