regression-modeler

Automated regression modeling tool — performs linear regression (OLS) or logistic regression (Logit) on tabular data, producing comprehensive statistical results with plain-language interpretation.

Capabilities

Feature	Description
Linear Regression	OLS with coefficients, R², adjusted R², F-test, AIC/BIC, Durbin-Watson
Logistic Regression	Logit with coefficients, Odds Ratio, Pseudo R², likelihood ratio test
Multicollinearity Detection	VIF values for each predictor with warning levels
Plain-Language Interpretation	Clear explanations of what each metric and coefficient means
Auto Detection	Automatically switches to logistic regression when the target is binary (0/1)

Quick Start

# Linear regression: predict price using all numeric columns as predictors
python3 scripts/regression_analyzer.py data.csv --target price

# Logistic regression: predict churn (0/1) with specified features
python3 scripts/regression_analyzer.py users.csv --target churn --features "age,income,tenure"

# Save results to JSON
python3 scripts/regression_analyzer.py data.csv --target sales --output result.json

Detailed Usage

Basic Invocation

python3 scripts/regression_analyzer.py <data_file> --target <target_column> [options]

Specifying Regression Type

# Force linear regression
python3 scripts/regression_analyzer.py data.csv -t y --type linear

# Force logistic regression
python3 scripts/regression_analyzer.py data.csv -t label --type logistic

# Auto-detect (default)
python3 scripts/regression_analyzer.py data.csv -t y --type auto

Selecting Feature Columns

# Manually specify (comma-separated)
python3 scripts/regression_analyzer.py data.csv -t price -f "sqft,bedrooms,bathrooms"

# Omit to automatically use all numeric columns
python3 scripts/regression_analyzer.py data.csv -t price

Parameters

Parameter	Short	Required	Default	Description
input	—	Yes	—	Input file path (CSV/TSV/Excel/JSON)
--target	-t	Yes	—	Target variable (dependent variable) column name
--features	-f	No	All numeric columns	Predictor column names, comma-separated
--type	-T	No	auto	Regression type: linear / logistic / auto
--output	-o	No	stdout	Output JSON file path
--no-const	—	No	false	Do not add an intercept term
--keep-na	—	No	false	Keep rows with missing values (for debugging)

Output Structure (JSON)

{
  "type": "linear",
  "r_squared": 0.8523,
  "r_squared_adj": 0.8471,
  "f_statistic": 162.34,
  "f_p_value": 0.0,
  "coefficients": {
    "sqft": {"coefficient": 135.42, "p_value": 0.0001, ...},
    "bedrooms": {"coefficient": 8021.5, "p_value": 0.032, ...}
  },
  "vif": {"sqft": 2.31, "bedrooms": 1.87},
  "interpretation": {
    "model_summary": ["R² = 0.8523 (good model fit...)"],
    "variable_analysis": ["sqft: coefficient = 135.42... positive effect..."]
  }
}

Dependencies

• Python 3.8+
• pandas
• numpy
• statsmodels
• scipy

pip install pandas numpy statsmodels scipy