Description
Return the matching endpoint value at or outside either bound; within the interval return endpointValue zero and interiorNeedsInterpolation true.
Linear interpolation blends endpoint values by a normalized coordinate. Its value weights, inverse slope, and sensitivities to moving nodes answer different questions and use different units.
Return the matching endpoint value at or outside either bound; within the interval return endpointValue zero and interiorNeedsInterpolation true.
When to use this tool
Use Interpolation: Clamped Interpolant Endpoint Value when you need one explicitly defined linear interpolation term.
How to use the tool and how it works
- Enter x, lowerX, upperX, lowerValue, upperValue. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read result. Expand result to inspect the returned fields.
Require lowerX < upperX. Return the matching endpoint value at or outside either bound; within the interval return endpointValue zero and interiorNeedsInterpolation true.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| x | X | Required. Finite number. |
| lowerX | Lower X | Required. Finite number. |
| upperX | Upper X | Required. Finite number. |
| lowerValue | Lower Value | Required. Finite number. |
| upperValue | Upper Value | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| result | Result | Required. Object. |
| result.outsideOrEndpoint | Outside Or Endpoint | Calculated result member: boolean. |
| result.endpointValue | Endpoint Value | Calculated result member: number. |
| result.interiorNeedsInterpolation | Interior Needs Interpolation | Calculated result member: boolean. |
{
"input": {
"x": -1,
"lowerX": 0,
"upperX": 2,
"lowerValue": 3,
"upperValue": 4
},
"output": {
"result": {
"outsideOrEndpoint": true,
"endpointValue": 3,
"interiorNeedsInterpolation": false
}
}
}Limitations and assumptions
- The interior zero is a placeholder, not an interpolated value; this helper does not evaluate the interior curve.
- Outputs are nested inside result. 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
Validate endpoints and units and use a complete evaluator when clamping, extrapolation, or uncertainty propagation is required.
References
Similar or alternative tools
- Normalized Hermite Endpoint Value
Select rightValue when rightEndpoint is true and leftValue otherwise.
- Interpolation: Piecewise Knot Side Selection
Select the interval using tieSide at an interior knot, retain the first or last interval at domain endpoints, and return -1 outside.