Description
Sum invited durations and invited-present-observed durations, count distinct qualifying activity IDs, and return their duration share when invitedDuration>0, otherwise zero with defined=false.
Activity and assistive-task records distinguish planned, attempted, completed, assisted, observed, and optional components. Shares depend on the selected denominator and credit policy. A supplied code, geometry, or time-budget calculation is separate from evaluating an individual's function or safe access.
Sum invited durations and invited-present-observed durations, count distinct qualifying activity IDs, and return their duration share when invitedDuration>0, otherwise zero with defined=false.
When to use this tool
Use Participation Observation Share when you need this specific task-count, assistance-code, timing, equipment-budget, or participation-record component.
How to use the tool and how it works
- Enter activityIds, durations, invited, present, observed. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read invitedDuration, observedParticipationDuration, participatingActivities, share, defined. Inspect defined before interpreting the associated values.
Require aligned activityIds, nonnegative durations, invited, present, and observed flags. Sum invited durations and invited-present-observed durations, count distinct qualifying activity IDs, and return their duration share when invitedDuration>0, otherwise zero with defined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| activityIds | Activity Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| durations | Durations | Required. Array of finite number; minimum 0; maximum items 256. |
| invited | Invited | Required. Array of boolean; maximum items 256. |
| present | Present | Required. Array of boolean; maximum items 256. |
| observed | Observed | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| invitedDuration | Invited Duration | Required. Finite number. |
| observedParticipationDuration | Observed Participation Duration | Required. Finite number. |
| participatingActivities | Distinct IDs among invited, present, observed rows. | Required. Safe integer. |
| share | Dimensionless share using the stated denominator, not a percentage numeral. | Required. Finite number. |
| defined | Whether the stated denominator or quantity is defined; inspect before using a placeholder. | Required. Boolean. |
{
"input": {
"activityIds": [
"a",
"b"
],
"durations": [
2,
3
],
"invited": [
true,
true
],
"present": [
true,
false
],
"observed": [
true,
true
]
},
"output": {
"invitedDuration": 5,
"observedParticipationDuration": 2,
"participatingActivities": 1,
"share": 0.4,
"defined": true
}
}Limitations and assumptions
- Rows count separately in duration sums even for repeated activities, while participatingActivities deduplicates IDs. The share measures recorded participation rather than engagement quality, functional capacity, or a validated clinical outcome.
- 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
Use the intended assessment and a complete task or access model when a local check is insufficient. Verify task definitions, credit policies, measurement units, and the context of the underlying observations.
References
Similar or alternative tools
- Participation Item Domain Count
Count rows with an exact requestedDomain match and included=true.
- Occupation Diary Double Task Credit
Allocate supplied simultaneous diary time equally or to the first task under an explicit policy.