64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# `zfin projections`
|
|
|
|
Retirement projections: percentile bands of your portfolio's projected
|
|
value, a benchmark comparison, and safe-withdrawal dollars at multiple
|
|
horizons and confidence levels.
|
|
|
|
```
|
|
Usage: zfin projections [opts]
|
|
```
|
|
|
|
Configuration lives in
|
|
[`projections.srf`](../config/projections-srf.md). What the output
|
|
shows (accumulation block, earliest-retirement grid, or drawdown-only)
|
|
depends on which inputs you set -- see
|
|
[Plan for retirement](../../guides/plan-retirement.md) and
|
|
[the model](../../explanation/projections-model.md).
|
|
|
|
## Sub-modes (mutually exclusive)
|
|
|
|
| Flag | View |
|
|
|---------------------|-----------------------------------------------------------------------|
|
|
| (default) | Percentile bands + benchmark + safe withdrawal. |
|
|
| `--vs <DATE>` | Side-by-side with a historical snapshot's projection. |
|
|
| `--convergence` | The model's predicted retirement date over time. |
|
|
| `--return-backtest` | Expected-return claim vs. realized forward CAGR (pair with `--real`). |
|
|
|
|
## Options
|
|
|
|
| Flag | Effect |
|
|
|-------------------------|-----------------------------------------------------------------------------------------|
|
|
| `--as-of <DATE>` | Project against a historical snapshot (auto-snaps to nearest earlier). |
|
|
| `--overlay-actuals` | Plot your realized trajectory from `--as-of` to today on the bands. Requires `--as-of`. |
|
|
| `--no-events` | Exclude life events (baseline view). |
|
|
| `--real` | With `--return-backtest`, render CPI-adjusted. |
|
|
| `--export-chart <PATH>` | Render the band chart to a 1920x1080 PNG and exit (default mode only). |
|
|
|
|
Dates accept `YYYY-MM-DD` or relative shortcuts (`1W`/`1M`/`1Q`/`1Y`).
|
|
|
|
## Example
|
|
|
|
```bash
|
|
ZFIN_HOME=examples/pre-retirement-both zfin projections
|
|
```
|
|
|
|
```
|
|
Accumulation phase:
|
|
Years until possible retirement: 19 (2046-04-12, ages 65/62)
|
|
Median portfolio at retirement: $7,871,732.10
|
|
Range (10th-90th percentile): $5,807,693.45 to $18,240,675.15
|
|
|
|
Safe Withdrawal (FIRECalc historical simulation)
|
|
25 Year 35 Year 50 Year
|
|
99% safe withdrawal $314,920 $293,374 $264,002
|
|
```
|
|
|
|
## See also
|
|
|
|
- [Plan for retirement](../../guides/plan-retirement.md) -- the guided walkthrough.
|
|
- [`projections.srf` reference](../config/projections-srf.md) -- every input field.
|
|
- [The retirement projection model](../../explanation/projections-model.md) -- the method and caveats.
|
|
|
|
---
|
|
|
|
[CLI command reference](index.md)
|