© 2024 IQVIA - All Rights Reserved

Read Replica Data Model


Clinical Data Interchange Standards Consortium (CDISC)

CDISC is an open, multidisciplinary, non-profit organization committed to the development of industry standards to support the electronic acquisition, exchange, submission, and archiving of clinical trials data and metadata for medical and biopharmaceutical product development.

Operational Data Model (CDISC ODM)

Here is how the Clinical Data Interchange Standards Consortium describes the ODM in the introduction of the specification:

The Operational Data Model (ODM) is a vendor neutral, platform independent format for interchange and archive of clinical study data. The model includes the clinical data along with its associated metadata, administrative data, reference data and audit information. All of the information that needs to be shared among different software systems during the setup, operation, analysis, submission or for long term retention as part of an archive is included in the model.

Clinical data management systems vary significantly in the information they store and the rules they enforce. The ODM model has been designed to represent a wide range of study information so as to be compatible with most existing clinical data management systems. Systems that do not have all of the features represented by the ODM model may still be ODM compatible as long as they comply with the conformity rules provided in the section on System Conformity.

The ODM has been designed to be compliant with guidance and regulations published by the FDA for computer systems used in clinical studies. This document is intended to be both the formal specification of the ODM and a user guide for those involved in transferring or archiving of clinical data using the model.

To the maximum extent possible, the ClinSpark data model is based on the CDISC Operational Data Model (ODM) standard. In fact, a significant portion of the database schema for ClinSpark was generated directly from the ODM XML schema.  ODM scope is limited to the core entities of clinical study data.  The ClinSpark data model includes this but goes far beyond this scope.  As such the CDISC ODM and it's related documentation are excellent sources of information to understand the subset of the ClinSpark data model which overlaps.  

The CDISC ODM documentation can be freely downloaded from here.  We recommend that anyone intending to work with and understand the ClinSpark data model spend some time getting familiar with the ODM, as it provides valuable insights into both design and intended usage.

Study Data Tabulation Model (CDISC SDTM)

The SDTM defines a standard structure for study data tabulations that are to be submitted as part of a product application to a regulatory authority such as the United States Food and Drug Administration (FDA).  The ClinSpark data model is influenced by this specification where applicable.  The SDTM specification documentation can be found on the CDISC site.

Laboratory Data Model (CDISC LAB)

The CDISC Laboratory Data Team (LAB) has as its mission the development of a standard model for the acquisition and interchange of laboratory data.  The specification and all related documentation can be found on the CDISC LAB homepage.  To the extent possible, the ClinSpark data model adheres to the CDISC LAB specification.  Model entities which come directly from this specification include:

  • Base Specimen
  • Base Battery
  • Base Result

Additionally the way that ClinSpark handles the concept of Assession comes directly from the CDISC LAB standard, section 3.4.8.  Here is the guidance from this section:

Accession data identifies the specimen collection kit and the laboratory from where it came. The convention that seems to be standard for all laboratories is that one accession number identifies one accession used at one subject visit. Central Laboratory ID must always be populated or required.

ClinSpark Data Model

To the extent possible and practical, the ClinSpark data model is based on the CDSIC ODM 1.3.2 data model.  A few of the benefits of this are:

  • Standards-based simplifies interoperability.  ClinSpark natively produces and accepts CDISC data, simplifying integration with other products and vendors supporting this standard.
  • Simplified training and transferable knowledge.  CDISC ODM is fairly widely used within the industry.  This makes our data model relatively easy for new users familiar with ODM to comprehend. 
  • High quality data foundation vs proprietary makes data more future-proof. 

The following section highlights a series of key subject areas within the ClinSpark data model.  This section covers both CDISC and non-CDISC entities, since this is the nature of the ClinSpark data model.  

The entity diagrams and the relationships between them is intended to help readers understand what can be found in tables and also how tables can be joined using SQL.  This is not meant to be comprehensive, it should be used in conjunction with the other schema documentation provided.

Study Design

The following subject areas are involved with study design.  

Note that ClinSpark has made significant extensions to the ODM in a number of areas.  Two examples are device connectivity and importation from the volunteer record.  There is no provision within ODM for either of these features.  To support this, extensions have been made to data within the ItemGroup and ItemRef domains.  This allows noting fields which will have their values populated from direct capture from medical devices, or from a volunteer record within the database.  Other such extensions exist throughout the ClinSpark data model.  As such, domains which originate in the CDISC standard often contain a superset of the data described by CDISC and also additions created by Foundry Health.

Org, Volunteer, Study, Sites, StudySites and Subjects


TableFrom CDISC?Notes
1orgNoAn org represents an entity performing clinical research (CRO / CRU). Orgs can have multiple sites that execute studies.
2studyYesThis element collects static structural information about an individual study.  A study is related to a given clinical trial protocol.
3siteNoA site is a physical place belonging to an organization.  An organization having multiple physical clinical sites will have multiple site rows.
4study_siteNoAn association between a physical site and a study.  A study site is different than a physical location.  Often, pharma sponsors will specify sites with arbitrary codes and those codes must pass through during data export time. In addition, this domain encapsulates recruitment efforts for a given study / site.
5volunteerNoA volunteer is someone who indicates that they are interested in participating in clinical research for the given org.
6subjectYesSomeone participating in clinical research within the context of a given study. Creates glue between the volunteer and the participation.

Form Definition


TableFrom CDISC?Notes
1StudyMetaDataYesStudyMetaData (MetadataVersion in CDISC) defines the types of study events, forms, item groups, and items that form the study data.  This is basically an aggregation of all CRF design elements for a study.
2FormYes

A Form (FormDef in CDISC) describes a type of form that can occur in a study. 

A form is basically a container for item groups. This class explicitly excludes the required 'repeating' (Yes|No) attribute from the domain due to the fact that phase 1 studies are different and that it's likely that most of the forms will repeat as they are related to a study event. At ODM build time, we'll check for those forms that repeat and ensure that we create the repeating attribute properly. 

3ItemGroupYes

An ItemGroup (ItemGroupDef in CDISC) describes a type of item group that can occur within a study.

It basically is collection of related items in a given form.

4ItemYes

An Item (ItemDef in CDISC) describes a type of item that can occur within a study. Item properties include name, datatype, measurement units, range or codelist restrictions, and several other properties.

It basically represents the definition of a piece of data collected.

5ItemGroupRefYesA reference to a given ItemGroup.  This reference can hold data about the association.
6ItemRefYesA reference to a given Item.  This reference can hold data about the association.
7MethodYesODM representation that allows a value of an Item to be computed. In ODM, this OID can be found on an ItemRef - meaning that item is computed by this method via invocation of the formal expression

Activity Plans

An activity plan is a schedule of events for a given cohort.  Activity Plans do not appear in CDSIC.  In ODM, there is the notion of a FormRef. However, this design doesn't fit well with ph1 trials where forms are commonly repeated for a given study event (ie many PKs in a given day). As such, FormRef is implicitly available by way of Scheduled Activities that are a part of a Segment / Activity Plan.


TableFrom CDISC?Notes
1StudyYesThis element collects static structural information about an individual study.  A study is related to a given clinical trial protocol.
2Activity PlanNoA schedule of events for a given cohort. Plans can be assigned to multiple cohorts. A timed plan must have a reference time in order to properly provide UI feedback as segments and scheduled activities are set.

Untimed Activity Plan:
  • Reference time must be null
  • Single segment; segment must be root and must have offset second set to zero


Timed Activity Plan:
  • Must have a reference time
  • Can have 1-n segments; always sort by offset seconds
  • Reference segment must have offset seconds of zero

Activity Plan fills the role of the FormRef in the ODM.

3SegmentPartially

Holds a group of scheduled activities in an activity plan. The segment's offset seconds is essentially the time of the reference event.  All scheduled activities are relative to this.

Modeled somewhat off of CDISC SDM:

"Segments are often seen as the basic building blocks of study design. A segment usually specifies a combination of planned observations and interventions, which may or may not involve treatment, during a period of time."

4Scheduled ActivityNoWraps a form, but adds metadata including timing.
5FormYesA form is basically a container for item groups.
6Study EventYesA study event represents a given 'visit'. In phase 1 trials this will commonly simply refer to a 'day'. When scheduling forms for a given schedule, the builder must associate the study event. Note: there are common study events that are typically reserved for special events: unscheduled, common (AE, CM), etc

Epochs and Cohorts


TableFrom CDISC?Notes
1epochNoAn epoch is typically specified in a study protocol and typically signifies some milestone type events within the trial. ie: screening, treatment, followup, etc
2cohortNoA cohort is a way to break up epochs into different groupings. Protocols will occasionally indicate that epochs should be broken up (perhaps in different trial arms to test different dose levels, etc), or this can just purely be an organizational thing
3cohort_assignmentNo

Binds a Volunteer as a Subject within a given cohort along with an Activity Plan. We allow assigning different schedules, and we allow for later scheduling a subject.

4activity_planNoA schedule of events for a given cohort.
6subjectYesSomeone participating in clinical research within the context of a given study.

Clinical Data

Parallel data and definition objects in CDISC

CDISC ODM defines a pattern for modelling the definition of a clinical data element and the data captured.  This pattern has one element describe the definition, and another element record the data for a particular clinical collection of this element type.  ClinSpark adheres to this pattern, though as noted in the table below, the suffix "Def" is removed from the definition elements.  Here are the examples

Data Definition ElementData Capture ElementNotes
Item (ItemDef in CDISC)ItemDataRepresent the definition of a piece of data collected
ItemGroup (ItemGroupDef in CDISC)ItemGroupDataAggregates item data
Form (FormDef in CDISC)FormDataBasically a container for item groups
StudyEvent (StudyEventDef in CDISC)StudyEventDataClinical data for a study event (visit) for a given subject

With this in mind, below is a view of how these elements relate to each other.


Note that form_data can have linkage to forms through scheduled activities or unscheduled.

ItemGroupData has an item_group_repeat_key which is used to track repeats.


TableFrom CDISC?Notes
1formYesBasically a container for item groups.
2form_dataYesForm data represents data collected for a given subject. Instead of storing the scheduled time on this domain, we leverage the relationship to the encapsulated scheduledActivity domain and thus its relationship to the segment. We purposely don't set formRepeatKey in the domain. It is calculated later on when building ODM.
3item_groupYesA collection of related items in a given form
4item_group_refYesA given item group within a form definition.
5item_group_dataYesAggregates item data
6itemYesRepresents the definition of a piece of data collected.
7item_refYesA given item within an item group definition.
8item_dataYesA piece of collected data
9study_eventYesA study event represents a given 'visit'. In phase 1 trials this will commonly simply refer to a 'day'. When scheduling forms for a given schedule, the builder must associate the study event. Note: there are common study events that are typically reserved for special events: unscheduled, common (AE, CM), etc
10study_event_dataYesClinical data for a study event (visit) for a given subject

Study Data



TableFrom CDISC?Notes
1item_dataYesA piece of collected data
2item_group_dataYesAggregates item data
3form_dataYesForm data represents data collected for a given subject. Instead of storing the scheduled time on this domain, we leverage the relationship to the encapsulated scheduledActivity domain and thus its relationship to the segment.
4study_event_dataYesClinical data for a study event (visit) for a given subject
5study_eventYesA study event represents a given 'visit'. In phase 1 trials this will commonly simply refer to a 'day'. When scheduling forms for a given schedule, the builder must associate the study event. Note: there are common study events that are typically reserved for special events: unscheduled, common (AE, CM), etc
6subjectYesSomeone participating in clinical research within the context of a given study.

Queries

Queries and Annotations can be seen on ItemData entities like this:



TableFrom CDISC?Notes
1item_data_queryNoA query related to a piece of item data
2item_data_query_commentNoA given comment related to a given query
3item_data_sample_annotationNoComments added directly on the item

Lab Data

Lab data can be reached via ItemData. 


TableFrom CDISC?Notes
1item_dataYesA piece of collected data.  Note that lab orders and all results are associated to a given Item Data.  You will need to join through Item Data when working with lab data.
2base_specimenYes (CDISC LAB)Modeled off of CDISC Lab. A specimen is collected from a subject and assigned to a given item data instance. There can be multiple batteries (test groups) associated to a given specimen. Combines Accession Level and Base Specimen from spec.
3base_batteryYes (CDISC LAB)A panel related to a specimen - typically this is just a 1 to 1 relationship, meaning there is often 1 base_battery for a single specimen.
4base_test_resultYes (CDISC LAB)Combines CDISC Lab BaseTest and BaseResult.  These are the results from the lab.
5lab_orderNoWhen specimens are collected, this domain represents that an order is generated. It causes a manifest file to be created (PDF) and potentially a file order to be dumped on to the file system and made available to web services.
6lab_interfaceNoEncapsulates how to send and receive orders and results from a particular safety lab.  Sites may have multiple labs, and if so each of these will have their own lab interface instance.
7study_lab_panelNoSomething that can be ordered from item level
8specimen_containerNoWhen setting up samples or labs, users can optionally choose a container.
9lab_repeatNoA domain that allows for the management of lab repeat workflows

Samples


TableFrom CDISC?Notes
1sample_path_step
A step in the path to fulfill a given sample
2sample_task
Coarse grained description of what needs to be done for a given sample path step; this could be an enum on the class, but having it here gives a bit more flexibility and can encode some further instructions.
3sample_path
Container for the sample path steps
4specimen_container
When setting up samples or labs, users can optionally choose a container
5sample_transfer
A given step may require a transfer of sample material; this domain captures that
6sample_shipment
Signifies a sample container being removed
7sample_container
Something that we place sample path step data into
8sample_container_item
An individual sample that is placed into a container
9sample_batch_dataNoAllows for doing a step with a group of samples. Furthermore, it allows the steps for the relevant sample path step data objects to span a period of time. Non-ODM.
10sample_path_step_dataNoFor forms that require sample data to be collected, this domain tracks accordingly. Non-ODM.
11item_dataYesAll sample data can be joined through item_data_id


Volunteers

Volunteers are not a part of CDISC. 


TableFrom CDISC?Notes
1volunteerNoSomeone who indicates that they are interested in participating in clinical research for the given org.  Someone who indicates that they are interested in participating in clinical research for the given org.
2volunteer_medical_conditionNoAssociates a given condition to a given volunteer
3volunteer_noteNoA simple note that can be attached to the volunteer record
4volunteer_correspondenceNoRepresents a call or text to / from a volunteer by way of Twilio
5volunteer_substance_useNoWe purposely don't track SUOCCUR, it allows us to indicate that the vlunteer is not using the substance.
6recruitment_appointmentNoAllows for a given volunteer to be assigned to a given time slot
7study_siteNoAn association between a study and a site
8subjectYesSomeone participating in clinical research within the context of a given study.

Users


TableFrom CDISC?Notes
1application_userNoA user in the system
2studyYesIn this context, these are study restrictions.  Studies which appear here mean the user is whitelisted to working only with data from these studies.
3application_user_roleNoRoles which the user has
4application_user_role_secure_actionsYesSecure Actions are permissions which the role entitles the user to.



Exported and Printed Copies Are Uncontrolled