Trial Reward Cap Credit Term Tool

Description

Clamp credit to the remaining cap and available earned amount, then return earned-minus-credit.

Experimental incentives map recorded performance or points to a supplied reward policy. A capped credit or reference difference describes that policy's arithmetic, not participant motivation, clinical status or an actual payment obligation.

Clamp credit to the remaining cap and available earned amount, then return earned-minus-credit.

When to use this tool

Use Trial Reward Cap Credit Term when you need a trial-reward or participant-incentive calculation.

How to use the tool and how it works

Enter earned, priorReward, cap, withheld. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read credited, uncredited. Use the output convention below.

Require nonnegative earned, prior reward, cap and withholding no greater than earned. Clamp credit to the remaining cap and available earned amount, then return earned-minus-credit.^[1]

Input field	Meaning and units	Accepted input
earned	Earned	Required. Finite number; minimum 0.
priorReward	Prior Reward	Required. Finite number; minimum 0.
cap	Cap	Required. Finite number; minimum 0.
withheld	Withheld	Required. Finite number; minimum 0.

Output field	Interpretation	Returned shape
credited	Credited	Required. Finite number.
uncredited	Uncredited	Required. Finite number.

json

{
  "input": {
    "earned": 20,
    "priorReward": 90,
    "cap": 100,
    "withheld": 2
  },
  "output": {
    "credited": 10,
    "uncredited": 10
  }
}

Limitations and assumptions

Prior reward can exceed cap, yielding zero credit. Uncredited includes withholding and cap exclusion; no actual participant payment or ethical approval is determined.
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

Review the approved study and payment procedures and complete source records. Evaluate behavioral or ethical interpretation separately from local incentive arithmetic.

References

Calculation and input contract: experimental-psychology/trial-reward-cap-credit-term — tool.io

Similar or alternative tools

Trial Reward Loss Reference Balance
Select reward for correct or negative penalty otherwise and subtract reference.
Flanker Congruency Response Gap Term Tool
Calculate flanker congruency response gap term from explicit caller-supplied inputs.