The Cashflow Projection Model creates detailed forecasts of your loan portfolio's future cash flows by analyzing how loans will perform under different economic scenarios. It answers critical business questions like:
Cashflow Projection Model - User Guide
What This Model Does
The Cashflow Projection Model creates detailed forecasts of your loan portfolio's future cash flows by analyzing how loans will perform under different economic scenarios. It answers critical business questions like:
- How much money will we receive each month?
- What happens if the economy gets worse and more borrowers default?
- How will early loan payoffs affect our cash flow?
- What can we recover from loans that go bad?
The model produces month-by-month projections showing exactly when and how much cash you can expect to receive from your loan portfolio.
How the Model Calculates Cash Flows
❗ Step 1: Historical Performance Analysis
The model starts by examining your loan portfolio's historical performance:
Default Rate Calculation
- Analyzes charge-offs over the past 6 months for each loan segment
- Calculates a Monthly Default Rate (MDR) = (written_off_amount ÷ starting_outstanding_balance) × 100
- Converts to Annual Default Rate (CDR) using the formula: CDR = 1 - (1 - MDR/100)^12
- This tells us: "Historically, X% of loans in this segment default each year"
Prepayment Rate Calculation
- Examines early payoffs (payments above scheduled amounts) over the past 6 months
- Calculates Single Monthly Mortality (SMM) = (Extra Payments ÷ Remaining Balance) × 100
- Only applies when: non_delinquent_payments > principal_scheduled AND remaining_balance > 0
- Converts to Annual Prepayment Rate (CPR) using: CPR = 1 - (1 - SMM/100)^12
- This tells us: "Historically, Y% of loans in this segment pay off early each year"
Rate Aggregation
- Filter-Key Specific Rates: Average of 6-month historical rates for each loan segment
- Overall Portfolio Rates: Weighted average across all segments for comparison scenarios
❗ Step 2: Scenario Creation
The model creates 210 different economic scenarios by combining:
Default Rate Multipliers (7 scenarios)
- 0.0x = No defaults → Effect: Maximum cash flow, no losses, all scheduled payments received
- 0.5x = Half normal default rates → Effect: 50% fewer losses, higher cash flows than baseline
- 0.75x = Mild improvement → Effect: 25% fewer losses, slightly higher cash flows
- 1.0x = Normal conditions (baseline) → Effect: Expected historical performance levels
- 1.25x = Mild stress → Effect: 25% more losses, reduced cash flows
- 1.5x = Moderate stress → Effect: 50% more losses, notably reduced cash flows
- 2.0x = Severe stress → Effect: Double the losses, significantly reduced cash flows
Prepayment Rate Multipliers (5 scenarios)
- 0.0x = No early payoffs → Effect: Loans run to full term, maximum interest income over time
- 0.5x = Reduced prepayments → Effect: Slower principal recovery
- 1.0x = Normal prepayment activity → Effect: Expected historical prepayment patterns
- 1.5x = Increased prepayments → Effect: Faster principal recovery
- 2.0x = High prepayment environment → Effect: Rapid principal recovery
Recovery Rates (3 scenarios)
- 0% = No recovery from defaults → Effect: Maximum losses, conservative assumption
- 5% = Low recovery expectations → Effect: Small offset to default losses
- 10% = Moderate recovery expectations → Effect: Meaningful reduction in net losses
Aggregation Types (2 versions per scenario)
- Filter-Key Specific (aggregated=False): Uses each segment's historical rates
- Portfolio Aggregate (aggregated=True): Uses overall portfolio rates
What Each Variable Change Means for Your Business
Increasing Default Rates (CDR Multiplier)
Higher multipliers mean:
- ✅ Lower Total Cash Flow: More loans default, reducing overall collections
- ✅ Earlier Cash Flow: Defaults happen early, accelerating the end of cash flows
- ✅ Higher Gross Losses: More write-offs and charge-offs
- ✅ Reduced Portfolio Life: Portfolio pays down faster due to defaults
- ✅ Lower Interest Income: Defaulted loans stop generating interest
Increasing Prepayment Rates (CPR Multiplier)
Higher multipliers mean:
- ✅ Faster Principal Recovery: Get your money back sooner
- ✅ Lower Total Interest Income: Loans pay off before generating full interest
- ✅ Shorter Portfolio Life: Portfolio pays down much faster
- ✅ Front-Loaded Cash Flows: Higher cash flows early, lower cash flows later
- ✅ Reinvestment Risk: Need to find new investment opportunities sooner
Increasing Recovery Rates
Higher recovery rates mean:
- ✅ Lower Net Losses: Recover more money from defaulted loans
- ✅ Higher Total Cash Flow: Offset some default losses with collections
- ✅ Extended Cash Flow Timeline: Recoveries may come months after defaults
- ✅ Improved Portfolio Returns: Better overall profitability despite defaults
❗ Step 3: Monthly Cash Flow Calculations
For each scenario, the model calculates what happens month by month using a specific order of operations:
Order of Operations (Critical Sequence)
For each month, the model follows this precise sequence:
- Calculate Survival Factor: Determines what percentage of the original portfolio is still active
- Apply Scheduled Payments: Calculate regular principal and interest payments (adjusted by survival factor)
- Calculate Defaults: Determine loan losses based on total remaining scheduled payments (principal + interest + fees)
- Calculate Prepayments: Determine early payoffs based on total remaining unscheduled payments
- Calculate Recoveries: Apply recovery rate to default amounts
- Update Remaining Balance: Starting balance minus scheduled payments, prepayments, and net defaults
- Update Survival Factor: Reduce for next period based on current defaults and prepayments
Month 1 Calculations
- Starting Balance: Current outstanding loan amount
- Survival Factor: 100% (all loans start active)
- Scheduled Payments: Regular principal and interest due
- Expected Defaults: $0 (defaults begin in month 2)
- Expected Prepayments: Based on total remaining payments × prepayment rates
- Expected Recoveries: $0 (no defaults to recover from yet)
Month 2+ Calculations (Recursive Process)
- Starting Balance: Previous month's ending balance
- Survival Factor: Percentage of loans still active (compounds monthly reduction)
- Expected Scheduled Payments: Regular payments × Survival factor
- Expected Defaults: Total remaining scheduled payments × Monthly default rate × Survival factor
- Expected Prepayments: Total remaining unscheduled payments × Monthly prepayment rate × Survival factor
- Expected Recoveries: Expected defaults × Recovery rate
- Ending Balance: Starting balance - Scheduled payments - Prepayments - (Defaults - Recoveries)
❗ Step 4: Cash Flow Components
Each month's total cash flow consists of:
- Scheduled Principal: Regular loan principal payments
- Scheduled Interest & Fees: Interest and fee income
- Prepayments: Early principal repayments
- Recoveries: Collections from previously defaulted loans
Total Monthly Cash Flow = Scheduled Principal + Scheduled Interest & Fees + Prepayments + Recoveries - Defaults
Step 5: Portfolio Aggregation
Individual Segment Analysis
- Uses each loan segment's specific historical rates
- Shows performance differences between loan types/risk grades
- Useful for detailed risk analysis
Portfolio-Level Analysis
- Uses overall portfolio averages for comparison scenarios
- Provides baseline comparison against segment-specific projections
- Useful for high-level portfolio planning
Key Model Features
Survival Factor Modelling
The model tracks how your loan portfolio "survives" over time:
- Month 1: 100% of loans are active
- Month 2: Reduced by defaults and prepayments from Month 1
- Month 3: Further reduced by Month 2 activity
- This ensures realistic cash flow projections that account for portfolio runoff
Recursive Calculations
Each month's calculations depend on the previous month's results:
- Defaults in early months reduce future scheduled payments
- Prepayments accelerate principal recovery but reduce future interest
- The model properly accounts for these interdependencies
Enhanced Default and Prepayment Modeling
Critical Update: Defaults and prepayments are now calculated based on total remaining payments (principal + interest + fees), not just principal:
- More realistic modeling of cash flow losses when loans default or prepay
- Defaults reduce both principal and interest income streams
- Prepayments eliminate both future principal and interest payments
- Balance tracking uses net default impact (defaults minus recoveries)
Performance Optimizations
- Vectorized calculations for improved processing speed
- Parallel processing using 80% of available CPU cores
- Memory-efficient data handling and optimization
- Automatic fallback to sequential processing if needed