Skip to content

Main content

Gender Category Wave Label Change Tool

Document a supplied category-label change across survey waves without assuming category equivalence.

Loading tool…

Description

Require nonempty categoryCode, compare previousLabel and currentLabel literally, and format both quoted strings with a change arrow.

Identity and survey records can preserve a person's stated wording, display preference, source, and missing-value convention. A formatter should not infer an identity or turn a recorded label into permission for publication.

Require nonempty categoryCode, compare previousLabel and currentLabel literally, and format both quoted strings with a change arrow.

When to use this tool

Use Gender Category Wave Label Change when you need to organize supplied identity-related record fields while preserving their stated scope.

How to use the tool and how it works

  1. Enter categoryCode, previousLabel, currentLabel. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read changed, changeLabel. Inspect changed before interpreting the associated values.

Require nonempty categoryCode, compare previousLabel and currentLabel literally, and format both quoted strings with a change arrow.1

Input fieldMeaning and unitsAccepted input
categoryCodeCategory CodeRequired. Text; maximum UTF-16 length 8192.
previousLabelPrevious LabelRequired. Text; maximum UTF-16 length 8192.
currentLabelCurrent LabelRequired. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
changedWhether the stated literal transformation changed its input.Required. Boolean.
changeLabelChange LabelRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "categoryCode": "G3",
    "previousLabel": "Other",
    "currentLabel": "Self-described"
  },
  "output": {
    "changed": true,
    "changeLabel": "G3: \"Other\" → \"Self-described\""
  }
}

Limitations and assumptions

  • This records a label change, not proof of equivalence between survey waves or stability of the population or construct.
  • 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

Confirm preferences, consent, source wording, and the purpose of collection before displaying or combining personal records.

References

  1. Calculation and input contract: gender-studies/gender-category-wave-label-change — tool.io

Similar or alternative tools