StudyCell
The intersection of one arm and one epoch. It lists the elements a participant in that arm passes through during that epoch.
- Kind
- Concrete class
- Group
- Study design
- Attributes
- 6, 5 required
- NCI code
- C188810
Official definition
A partitioning of a study arm into individual pieces, which are associated with an epoch and any number of sequential elements within that epoch.
In practice
In a protocol document: One box in the study schema diagram.
Attributes
6 attributes, 5 of them required by the USDM API schema and 3 holding the id of another object instead of the object itself (marked by id).
| Attribute | Type | Card. | Definition |
|---|---|---|---|
| idrequired | string | cardinality 1 | The identifier of this object, unique within the file. |
| armIdrequired | StudyArmby id | cardinality 1 | A USDM relationship between the StudyCell and StudyArm classes which identifies the study arm associated with a study cell. |
| epochIdrequired | StudyEpochby id | cardinality 1 | A USDM relationship between the StudyCell and StudyEpoch classes which identifies the study epoch associated with a study cell. |
| elementIdsrequired | StudyElementby id | cardinality 1..* | A USDM relationship between the StudyCell and StudyElement classes which identifies the set of study elements associated with the study cell. |
| extensionAttributes | ExtensionAttribute | cardinality 0..* | Extension attributes attached to this object, for information the standard does not define. Added by the API; not part of the logical model. |
| instanceTyperequired | string | cardinality 1 | The name of the class, carried by every object in a USDM JSON file. Added by the API; not part of the logical model. |
Smallest valid StudyCell
The attributes a JSON file must carry for a StudyCell, and the kind of value each takes. This is the shape, with types named in place of values. Everything else in the table above is optional.
StudyCell, required attributes only
{
"id": "StudyCell_1",
"armId": id of StudyArm,
"epochId": id of StudyEpoch,
"elementIds": [id of StudyElement, …],
"instanceType": "StudyCell"
}
Where StudyCell is used
These classes hold or point to a StudyCell.
- StudyDesign.studyCellsnested
Example
A StudyCell from the example study. Coded values are shortened to one line.
StudyCell_1
{
"id": "StudyCell_1",
"armId": "StudyArm_1",
"epochId": "StudyEpoch_1",
"elementIds": [
"StudyElement_1"
],
"instanceType": "StudyCell"
}
Related classes
Other classes in study design: