Model Builder
Build and auto-select models, configure synthetic predictor variables, and create custom simulations.
How to Use This Tool
Follow these steps to build and analyze your models
How to Use This Tool
Follow these steps to build and analyze your models
1. Select Predictors
Check relevant variables. Hover info icons for definitions. The six predictor variables in the published Approval model are pre-selected as a default. Only relevant for Run Analysis — Auto-Build tests all predictors automatically and overrides your selection. Maximum 20 variables for Run Analysis.
2. Add Synthetic Variable (Optional)
Optionally create a synthetic variable to explore alongside your selected inputs. This helps test how a hypothetical factor might affect the outcome—and reveals which real-world variables show similar patterns. The algorithm adjusts the synthetic variable iteratively to match the parameters you specify. Works with both Run Analysis and Auto-Build.
3. Select Outcome
Choose what to model: Presidential Approval, Vote Intention, or Tax Cut Support. Presidential Approval is selected as a default.
4. Run Analysis or Auto-Build
Run Analysis estimates a model using your selected predictors. Auto-Build Optimal Model ignores your predictor selections and instead tests every available predictor, adding each one that meaningfully improves Tjur R² (forward stepwise). Use Auto-Build as a ceiling benchmark or starting point, then refine manually with Run Analysis. Note: Auto-Build does not use a synthetic variable — enable it afterwards and re-run with Run Analysis if desired.
Auto-Build vs. the published model: Auto-Build optimizes on Tjur R² and is best understood as a predictive benchmark. The published model selects predictors on theoretical grounds first — fit is a behavior check, not the selection criterion. A theory-driven model may score lower on fit and still be the more defensible choice for public release. The step log is designed to prompt that comparison.
5. Review Results
Examine probabilities, margins, and diagnostics. The Variables to Improve Your Model section scores and ranks candidates not yet in your model — click Add to selection on any card to check that variable, then re-run. After Auto-Build, the step log shows which predictor was added at each stage and the Tjur R² gain.
6. Build Simulator
Set hypothetical values to see their effects, including values for any synthetic variables you configured.
7. Iterate
Each run is saved automatically to the Saved Analyses tray above the results. Click Load on any card to restore its predictors, outcome, and synthetic setting and re-run. Compare runs side-by-side using the Tjur R², AUC, and Brier metrics shown on each card.
Understanding Your Results
After running your analysis, results are organized into up to three sections:
Full Model
Complete model including all selected predictors and the synthetic variable (if configured)
Base Model
Model performance without the synthetic variable (appears only when synthetic is configured)
Synthetic Variable Performance
How well the synthetic variable met your specifications and its impact on model performance (appears only when synthetic is configured)