Description
Clamp elapsed policy phase-in time to a supplied full-period fraction.
Policy analysis depends on declared eligibility bounds, reference periods, indicator direction and resource denominators. A linear phase-in or household weight is an explicit scenario assumption. A preferred-direction change, age predicate or cost contribution does not establish policy effectiveness, causal impact, actual eligibility or the governing legal rule.
Clamp elapsed policy phase-in time to a supplied full-period fraction.
When to use this tool
Use Regulatory Phase In Period Factor when you already have elapsedPeriods, suppliedPhaseInPeriods and need to clamp elapsed policy phase-in time to a supplied full-period fraction.
How to use the tool and how it works
- Enter elapsedPeriods, suppliedPhaseInPeriods. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read phaseInFactor. Use the output convention below.
Require suppliedPhaseInPeriods>0; return min(1,max(0,elapsedPeriods/phaseInPeriods)).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| elapsedPeriods | Elapsed Periods | Required. Finite number. |
| suppliedPhaseInPeriods | Supplied Phase In Periods | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| phaseInFactor | Elapsed/supplied duration, clamped to [0,1]; no official phase-in rule is selected. | Required. Finite number. |
{
"input": {
"elapsedPeriods": 3,
"suppliedPhaseInPeriods": 12
},
"output": {
"phaseInFactor": 0.25
}
}Limitations and assumptions
- Negative elapsed time gives zero; this is a supplied linear scenario, not an effective legal phase-in schedule.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use the full eligibility or phase-in rule and its source when evaluating a real policy record. For effectiveness questions, use a study design that addresses the comparator, timing and population; local costs or direction flags alone do not supply that evidence.
References
Similar or alternative tools
- Policy Exposure Before After Date Tag
Label a policy observation as before or after a supplied effective date.
- Policy Eligibility Age Boundary
Check an age against supplied lower and upper eligibility bounds.