Description
Return each retention rate, their difference, and retained-group share among all retained.
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.
Return each retention rate, their difference, and retained-group share among all retained.
When to use this tool
Use Aging Cohort Selective Attrition Share when you need a record-coverage or source-support diagnostic in ageing research.
How to use the tool and how it works
- Enter initialGroup, retainedGroup, initialOther, retainedOther. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read groupRetention, otherRetention, retentionGap, retainedGroupShare. Use the output convention below.
Require positive initial group and other counts and retained counts within each, with at least one retained person overall. Return each retention rate, their difference, and retained-group share among all retained.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| initialGroup | Initial Group | Required. Safe integer; minimum 1. |
| retainedGroup | Retained Group | Required. Safe integer; minimum 0. |
| initialOther | Initial Other | Required. Safe integer; minimum 1. |
| retainedOther | Retained Other | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| groupRetention | Group Retention | Required. Finite number. |
| otherRetention | Other Retention | Required. Finite number. |
| retentionGap | Retention Gap | Required. Finite number. |
| retainedGroupShare | Retained Group Share | Required. Finite number. |
{
"input": {
"initialGroup": 100,
"retainedGroup": 60,
"initialOther": 200,
"retainedOther": 160
},
"output": {
"groupRetention": 0.6,
"otherRetention": 0.8,
"retentionGap": -0.20000000000000007,
"retainedGroupShare": 0.2727272727272727
}
}Limitations and assumptions
- Retention gap and retained composition have different denominators; no cause of attrition, bias correction, clinical outcome, or population representativeness is established.
- 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 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
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.
- Cohort Age Period Birth Year Identity
Return periodYear-ageYears and subtract recordedBirthYear for identityResidual.