logit
Estimates logistic regression models by maximum likelihood for binary outcomes, supplying coefficients, confidence intervals, and diagnostics to validate evidence for causal decisions.
Instructions
Logit (logistic) regression via maximum likelihood. Validation: certified parity evidence.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Regressor names (alternative to formula). | |
| y | No | Dependent variable name (alternative to formula). | |
| tol | No | Convergence tolerance on log-likelihood change. | |
| alpha | No | Significance level for confidence intervals. | |
| 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 |
| robust | No | ``'nonrobust'`` for MLE SE, ``'hc1'`` / ``'robust'`` for sandwich SE. | nonrobust |
| cluster | No | Column name for clustered standard errors. | |
| formula | No | Formula like ``"y ~ x1 + x2"``. | |
| maxiter | No | Maximum Newton-Raphson iterations. | |
| weights | No | Column name for frequency/analytic weights. | |
| 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. | |
| at_values | No | Variable values for ``marginal_effects='at'``. | |
| data_path | No | 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. | |
| odds_ratio | No | Report odds ratios instead of log-odds coefficients. | |
| 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. | |
| marginal_effects | No | ``'average'`` (AME), ``'mean'`` (MEM), or ``'at'`` (MER). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||