Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- DSR Sculpting Mode
-
Default Target DSCR sculpting Allowed Target DSCR sculpting, Straight-line principal, Level debt service
About this input
Selects target-DSCR sculpting, equal opening-debt principal, or fixed total debt service.
- DSR Interest Basis
-
Default Beginning debt Allowed Beginning debt, Average debt after provisional principal
About this input
Uses beginning debt or a disclosed noncircular average after provisional principal.
- DSR Maturity Years
-
Default 8 Allowed 5, 6, 7, 8, 9, 10
About this input
Selects the active debt-service and LLCR horizon from five through ten annual periods.
- DSR Opening Debt
-
Unit currency millions Default 500 Range 0.001 to 1000000000000
About this input
Positive debt balance at the beginning of year one; the 0.001 floor keeps coverage ratios within the supported numerical range.
- DSR Annual Interest Rate
-
Unit fraction/year Default 0.06 Range 0 to 1
About this input
Single annual rate applied under the selected interest-basis route.
- DSR Target DSCR
-
Unit x Default 1.4 Range 0.1 to 10
About this input
CFADS divided by planned debt service in the target-sculpting route.
- DSR Minimum Covenant DSCR
-
Unit x Default 1.2 Range 0 to 10
About this input
Threshold used to count active-year DSCR covenant breaches.
- DSR LLCR Discount Rate
-
Unit fraction/year Default 0.07 Range 0 to 1
About this input
Annual end-of-period rate used to present-value CFADS through maturity.
- DSR CFADS Grid
-
Default 10 rows
About this input
Exactly ten complete rows. Year must equal row position one through ten and CFADS must be a nonnegative numeric value.
Column Range or allowed values Year 1 to 10 CFADS 0 to 1000000000000
Outputs
- DSR Total Debt Service Conditional
-
Unit currency millions
About this output
Sum of cash interest and principal through the selected maturity.
- DSR Total Interest Conditional
-
Unit currency millions
About this output
Sum of annual cash interest under the selected interest-basis route.
- DSR Total Principal Conditional
-
Unit currency millions
About this output
Opening debt less the ending balloon balance.
- DSR Ending Balloon Balance Conditional
-
Unit currency millions
About this output
Debt remaining after the selected maturity year's modeled principal payment.
- DSR Minimum DSCR Conditional
-
Unit x
About this output
Lowest positive active-year CFADS divided by total debt service.
- DSR Average DSCR Conditional
-
Unit x
About this output
Arithmetic average of positive active-year DSCR observations.
- DSR LLCR Conditional
-
Unit x
About this output
Present value of CFADS through maturity divided by opening debt.
- DSR Covenant Breach Count Conditional
-
Unit years
About this output
Count of active debt-service years with DSCR below the entered covenant threshold.
- DSR Maximum Debt Service Conditional
-
Unit currency millions
About this output
Largest active-year sum of cash interest and principal.
- Model Status
-
No unit declared
About this output
OK means finite debt arithmetic with no covenant breach or balloon; CHECK identifies breaches or a remaining maturity balloon.
Methodology
Purpose and model boundary
This model creates a ten-year project debt schedule under target-DSCR sculpting, straight-line principal, or level debt service. It calculates annual interest, principal, debt service, ending debt, DSCR, loan life coverage ratio (LLCR), covenant breaches, and any balloon remaining at the selected maturity.
It is a debt-schedule and coverage diagnostic, not a credit decision, debt commitment, covenant interpretation, rating, refinancing assumption, or legal opinion. It does not size opening debt from LLCR or prove that entered CFADS is achievable.
Inputs and units
Debt, CFADS, interest, principal, and debt service use one user-consistent currency scale, shown as currency millions. The compact grid contains exactly ten positional rows: year 1 through year 10 and nonnegative CFADS for each year.
The amortization selector chooses target DSCR, straight-line principal, or level debt service. The interest selector uses beginning debt or a disclosed noncircular average after provisional principal. Maturity is 5 through 10 years. Opening debt must be positive. The model also accepts annual interest, target DSCR, minimum covenant DSCR, and the discount rate used only for LLCR.
Governing relationships
Only years through the selected maturity are active. Let B_t be beginning debt, C_t CFADS, r the annual interest rate, n maturity, and d the LLCR discount rate.
For straight-line principal, provisional and final principal are capped at beginning debt:
Principal_t = min(B_t, Opening debt / n)
For target sculpting, planned service is:
Planned debt service_t = C_t / Target DSCR
For level debt service, the fixed annual amount is:
Level service = Opening debt / sum(1 / (1 + r)^k), for k = 1...n
The zero-rate case is supported because the denominator becomes the number of active years.
Beginning-debt interest is B_t × r. The average-debt route first estimates provisional principal using beginning-debt interest, then calculates:
Interest_t = ((B_t + max(0, B_t - Provisional principal_t)) / 2) × r
This is intentionally noncircular. For target and level-service routes, final principal is:
Principal_t = min(B_t, max(0, Planned debt service_t - Interest_t))
Debt service is interest plus principal, and ending debt is max(0, B_t - Principal_t). Coverage is:
DSCR_t = CFADS_t / Debt service_t, when debt service is positive
LLCR = sum(CFADS_t / (1 + d)^t for active t) / Opening debt
An active year with positive debt service breaches when its DSCR is below the entered minimum covenant DSCR.
Calculation sequence
- Validate the amortization, interest, and maturity routes, scalar bounds, and ten positional CFADS rows.
- Mark years through maturity as active and carry beginning debt forward.
- Determine straight-line principal or the target/level service amount.
- Calculate interest using the selected beginning or noncircular average-debt basis.
- Calculate final principal, debt service, ending debt, DSCR, and the covenant-breach flag for each active year.
- Discount active-year CFADS and calculate LLCR.
- Aggregate service, interest, principal, minimum/average DSCR, maximum service, breach count, and the maturity balloon.
- Populate the debt-service and ending-balance chart, apply the reconciliation gate, and evaluate status.
Outputs and interpretation
Headline results include total debt service, total principal, ending balloon, minimum DSCR, LLCR, and covenant-breach count. Supporting values include total interest, average positive DSCR, and maximum annual debt service. The chart combines annual debt-service bars with the ending-debt path so amortization and payment burden can be read together.
Minimum and average DSCR use positive active-year DSCR observations. LLCR discounts CFADS only through the selected debt maturity. A balloon is reported rather than refinanced or forced into the last payment.
Validation and status logic
The workbook evaluates status in this order:
| Condition | Returned status |
|---|---|
| A sculpting, interest, or maturity route is unsupported, a scalar bound fails, or the ten positional CFADS rows are incomplete | NOT VALID: choose supported sculpting, interest, and maturity routes and complete ten annual CFADS rows |
| Debt service, coverage, present value, or the opening-debt reconciliation is nonnumeric, negative where prohibited, or outside the workbook's supported range | NOT VALID: debt service, coverage, or present-value arithmetic exceeds the supported range |
| One or more active years have positive debt service and DSCR below the entered covenant threshold | CHECK: one or more active years breach the entered DSCR covenant |
No breach applies and the maturity balloon exceeds 0.000000001 in the entered currency scale |
CHECK: a debt balloon remains at maturity |
| None of the preceding conditions applies | OK |
The covenant warning takes precedence over the balloon warning. The derived gate also requires Opening debt - Total principal - Balloon to close within 0.000000001 × max(1, Opening debt).
Assumptions and limitations
- CFADS is entered before debt service and is nonnegative. Taxes, reserves, maintenance cash flows, and working capital must already be reflected if relevant.
- The average-debt interest basis is a one-pass, noncircular approximation.
- One annual interest rate applies to one debt balance. Floating-rate curves, multiple tranches, fees, reserve accounts, refinancing, cash sweeps, and sculpting constraints beyond the selected method are excluded.
- LLCR uses end-of-period annual CFADS through maturity and does not size debt.
- Covenant results are arithmetic comparisons to a user-entered threshold, not legal conclusions.
- All shipped debt, rate, covenant, maturity, and CFADS values are synthetic illustrations.
Restrictions and non-computing states
The grid must contain exactly ten complete rows, and each year must equal its row position from 1 through 10. CFADS is nonnegative and within the published limits. Opening debt is from 0.001 through the published maximum. Interest and LLCR discount rates are from 0 through 1, target DSCR is from 0.1 through 10, and minimum covenant DSCR is from 0 through 10.
Inactive post-maturity CFADS remains in the fixed grid but does not enter service, DSCR, or LLCR. Zero interest is valid. Zero active CFADS can leave a balloon or produce covenant breaches rather than an input error. Errors in the entered values and in the shape of the grid are rejected before calculation; positional-year failures return workbook NOT VALID.
Errors and warnings
A rejected entry means an option, number, or fixed-grid entry did not satisfy the input rules. Workbook NOT VALID means the selected model domain or derived arithmetic failed. Workbook CHECK retains the schedule and identifies covenant breach first, then balloon risk. A connection or calculation-service failure is not a debt or covenant finding. OK confirms modeled arithmetic and the entered threshold comparison only.
References
Debt repayment, coverage, covenant, and balloon-risk context follows the OCC Comptroller's Handbook: Commercial Real Estate Lending. Infrastructure debt and sensitivity context follows the FHWA P3 Toolkit primers. No lender term, rating, project case, or proprietary model is embedded.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.