Worked example: Damages Allocation in United States Federal
6 min read
Published April 15, 2026 • By DocketMath Team
Example inputs
Run this scenario in DocketMath using the Damages Allocation calculator.
Below is a worked example showing how DocketMath performs damages allocation for a United States Federal (US-FED) scenario using jurisdiction-aware rules. This is a practical walkthrough for understanding the tool’s logic and the impact of changing inputs—not legal advice.
Scenario summary (federal case)
- Court/system: US federal
- Claim type (for allocation logic): Mixed damages categories that need allocation across components
- Timing: Damages assessed as of a single calculation date (e.g., end of the damages period)
- Assumption: You have already determined the total damages figure(s) to allocate across categories.
Inputs you would enter in DocketMath
Use the /tools/damages-allocation calculator. In plain terms, DocketMath needs the amounts that map to each damages bucket plus (where applicable) any weighting or characterization rules tied to federal allocation logic.
Example values for this walkthrough:
| Input | Meaning | Example value |
|---|---|---|
total_damages | Total damages to allocate | $480,000 |
economic_damages | Quantified out-of-pocket / lost profits portion | $315,000 |
non_economic_damages | Pain/suffering/other non-monetary portion (if applicable) | $95,000 |
statutory_or_punitive_component | Statutory enhancement or punitive-like component (if applicable in your model) | $70,000 |
tax_treatment_flag | Whether federal tax allocation rules should be applied | “Apply federal tax allocation” |
allocation_method | Which DocketMath allocation method to use in US-FED | “Jurisdiction-aware standard” |
calculation_date | Date used for any date-sensitive assumptions | 2026-04-15 |
Checklist for making sure your inputs are coherent:
Pitfall: If your category amounts don’t sum to total_damages, DocketMath will either (a) force a normalization step, or (b) report a discrepancy depending on the calculator configuration. That can create misleading allocation shares even when the “math looks right.”
Example run
You can run the same flow yourself using /tools/damages-allocation.
Run the Damages Allocation calculator using the example inputs above. Review the breakdown for intermediate steps (segments, adjustments, or rate changes) so you can see how each input moves the output. Save the result for reference and compare it to your actual scenario.
Step 1: Confirm category math
In this example:
- Economic: $315,000
- Non-economic: $95,000
- Statutory/punitive component: $70,000
Total: $315,000 + $95,000 + $70,000 = $480,000 ✅
That alignment matters because allocation percentages typically derive from category shares of the total.
Step 2: DocketMath allocation output (what the tool returns)
A jurisdiction-aware damages allocation run typically produces three sets of results:
- Allocated amounts by category
- Allocation percentages by category
- Any federal tax/characterization outputs enabled by flags
For these example inputs, the allocated amounts match the category inputs (because we constructed them to match total_damages). The main value is in how DocketMath computes proportions and applies any enabled federal allocation logic.
Allocated amounts (by category)
- Economic damages: $315,000
- Non-economic damages: $95,000
- Statutory/punitive component: $70,000
Allocation percentages (by category)
Compute each share as category / total:
| Category | Amount | Share of $480,000 |
|---|---|---|
| Economic | $315,000 | 65.625% |
| Non-economic | $95,000 | 19.7917% |
| Statutory/punitive component | $70,000 | 14.5833% |
Federal tax allocation (enabled in this run)
Because tax_treatment_flag is set to “Apply federal tax allocation,” DocketMath will categorize amounts according to its US-FED characterization rules (as implemented in the tool). The output may include:
- Tax-characterized portion(s) (e.g., where federal tax treatment differs by component type)
- Non-taxable/treated differently portions under the tool’s model
- A summary total consistent with the category allocations
Note: DocketMath’s tax characterization outputs depend on the model assumptions embedded in the US-FED calculator settings. Treat those results as allocation estimates within the tool, not as a substitute for professional tax analysis.
What to look for in the result panel
When you run the calculator, scan for:
- Category discrepancies (do outputs match the totals you entered?)
- Rounding behavior (percentages often round to 4–6 decimals, then reconcile back to $ amounts)
- Flag impacts (turning off tax treatment should change the tax portion breakdown while leaving raw category totals intact)
Sensitivity check
One of the fastest ways to validate your inputs is a “what if” sensitivity check. In federal cases, small changes in the mix of damage categories can significantly swing the allocation percentages and any derived downstream outputs (especially when a component is treated differently by enabled flags).
Below are controlled variations. Keep total_damages constant at $480,000 and change only one bucket each time.
Variation A: Increase economic damages, decrease non-economic
- Economic: $340,000
- Non-economic: $70,000
- Statutory/punitive: $70,000
Expected effect (shares):
- Economic share rises from 65.625% to 70.8333%
- Non-economic share drops from 19.7917% to 14.5833%
- Statutory/punitive share stays 14.5833%
Interpretation: The tool’s allocation is proportional to your category mix; shifting $25,000 from non-economic to economic changes the percentage shares by about ~5.21 percentage points between those two buckets.
Variation B: Increase statutory/punitive component
Use a version where only the statutory/punitive portion changes and the other categories are adjusted to keep the total constant:
- Economic: $295,000
- Non-economic: $95,000
- Statutory/punitive: $90,000
Total still $480,000.
Expected effect:
- Statutory/punitive share rises to 90,000 / 480,000 = 18.75%
- Economic share becomes 295,000 / 480,000 = 61.4583%
- Non-economic stays 19.7917%
Interpretation: If DocketMath treats the statutory/punitive component differently under its enabled federal logic, this variation can also change the tool’s tax-characterized totals.
Variation C: Toggle tax allocation flag
Run the same category amounts as the original example:
- Economic $315,000
- Non-economic $95,000
- Statutory/punitive $70,000
Only change:
tax_treatment_flag:- Case 1: “Apply federal tax allocation”
- Case 2: “Do not apply federal tax allocation” (or the equivalent option)
Expected effect:
- Category allocations and percentages should remain the same
- Tax-characterized breakdown (and any derived totals) should change or be omitted
Warning: If turning the tax flag off changes the category allocations, that indicates a configuration mismatch. In a well-structured tool setup, tax treatment should affect characterization outputs, not the underlying allocation by category.
Quick sanity table (Original vs Variation A)
| Category | Original ($) | Variation A ($) | Share change (percentage points) |
|---|---|---|---|
| Economic | 315,000 | 340,000 | +5.2076 |
| Non-economic | 95,000 | 70,000 | -5.2084 |
| Statutory/punitive | 70,000 | 70,000 | 0.0000 |