Proxy Wave Transition Token Tool

Description

Compare them literally and serialize the ordered pair as transitionKey.

Longitudinal ageing research links observations to people, waves, and sources. A person may appear in multiple records, so distinct-person coverage and record counts answer different questions and require explicit duplicate rules.

Compare them literally and serialize the ordered pair as transitionKey.

When to use this tool

Use Proxy Wave Transition Token when you need a record-coverage or source-support diagnostic in ageing research.

How to use the tool and how it works

Enter previousMode, nextMode, suppliedModes. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read changed, transitionKey. Inspect changed before interpreting the associated values.

Require previousMode and nextMode within suppliedModes. Compare them literally and serialize the ordered pair as transitionKey.^[1]

Input field	Meaning and units	Accepted input
previousMode	Previous Mode	Required. Text; maximum UTF-16 length 8192.
nextMode	Next Mode	Required. Text; maximum UTF-16 length 8192.
suppliedModes	Supplied Modes	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.

Output field	Interpretation	Returned shape
changed	Changed	Required. Boolean.
transitionKey	Transition Key	Required. Text; maximum UTF-16 length 8192.

json

{
  "input": {
    "previousMode": "self",
    "nextMode": "proxy",
    "suppliedModes": [
      "self",
      "proxy"
    ]
  },
  "output": {
    "changed": true,
    "transitionKey": "[\"self\",\"proxy\"]"
  }
}

Limitations and assumptions

Mode vocabulary and proxy status are supplied; no respondent identity, capacity, consent, data comparability, or valid proxy authorization is verified.
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.

Alternative or Complementary methods

Review the original study design, identifiers, and missing-data definitions. Use the full longitudinal dataset for inference rather than treating a local coverage flag as evidence of representativeness.

References

Calculation and input contract: gerontology/proxy-wave-transition-token — tool.io

Similar or alternative tools

Aging Panel Wave Support Share
Count distinct people in selectedWave and its observed subset, dividing or returning zero with defined false when no eligible people remain.
Aging Cohort Selective Attrition Share
Return each retention rate, their difference, and retained-group share among all retained.