How ML Stats Calculates Portfolio Projections
The Portfolio Income Modeler estimates sustainability month by month using configured portfolio weights, annual price growth assumptions, annual dividend yields, and inflation-adjusted income targets.
What the model returns
- Summary metrics including final portfolio value, principal change, and shortfall totals.
- Annual and monthly detail rows for income targets, dividends, withdrawals, bucket movements, ending value, and shortfalls.
- Initial and final holdings snapshots under the configured strategy assumptions.
- Monthly time-series used for charts (portfolio value and target-vs-withdrawal).
Standard withdrawal mode
- Convert annual growth assumptions to monthly compounding rates and apply to each holding.
- Convert annual dividend yield to monthly income and add to cash balance.
- Withdraw income target from cash first, then sell holdings if needed based on sale strategy.
- Record any unmet amount as monthly shortfall.
- If DRIP is enabled, reinvest remaining cash by current holding weights.
- If rebalance cadence triggers, rebalance to target weights using total holdings plus cash.
Three Bucket withdrawal mode
Three Bucket mode treats the portfolio as near-term, intermediate, and long-term reserves instead of one fully rebalanced portfolio.
- Bucket 1 is sized from monthly income, 12 months per year, and the Bucket 1 Years input.
- Bucket 2 is sized from monthly income, 12 months per year, and the Bucket 2 Years input.
- Remaining portfolio value is assigned to Bucket 3. Within each bucket, value is distributed across that bucket's holdings by their allocation weights.
- The user-facing bucket model uses broad asset class sleeves: near-term cash, intermediate bonds, and long-term stocks.
- Each month, the model applies growth, adds dividends, funds spending from cash, then withdraws from Bucket 1, Bucket 2, and Bucket 3 as a last resort.
- Sales inside the active bucket use the selected sale order. Equal sale order is proportional within the active bucket.
- On the selected cadence, Bucket 1 is replenished from Bucket 2 first. Bucket 2, and any remaining Bucket 1 need, can be replenished from Bucket 3 only when Bucket 3 had positive growth that month.
- Normal full-portfolio rebalancing is not applied in Three Bucket mode because it would undo the bucket structure.
Max monthly income mode
When enabled, the model runs repeated simulations to search for the highest monthly income that keeps ending value near a target within a configured tolerance band. The search uses the selected withdrawal mode.
Monte Carlo analysis
Monte Carlo analysis reuses the same monthly engine and selected withdrawal mode while sampling inflation, portfolio growth, and dividend yield assumptions across repeated scenarios.
Important assumptions
- Annual growth and yield inputs are deterministic assumptions, not forecasts.
- Costs, taxes, slippage, and fees are not modeled.
- Custom override rows are user-entered assumptions for scenario testing.
- The current user-facing presets use broad asset classes rather than specific securities.
Important note
Results are informational and educational. They are not guarantees of future investment performance and are not recommendations to buy, sell, hold, allocate, or rebalance.