cdisc-org / DDF-RA

This is the repository for all code and documentation for the DDF-RA project.
MIT License
18 stars 1 forks source link

Intervention Dose and Adminstration #40

Closed dih-cdisc closed 10 months ago

dih-cdisc commented 1 year ago

Intervention, dose, administration route etc

Child tickets:

Item Ticket
Model #172
CT #171
API #173
IG Done, no ticket
Examples #210
EMuhlbradt commented 1 year ago

Erin/Craig: The eCPT contains a large table with multiple attributes associated with an administered interventions (see section 6.1., table 1 in eCPT (attached). Previous discussions with Chris/Gaston/Jarod indicated that these should really be modeled as attributes of a separate/new class of something like 'Administered Investigational Intervention' and not added as attributes to the existing class. The table contains things like:

  1. Route of Administration
  2. Dosage Level
  3. Dose Formulation
  4. Dose Strength
  5. Name/Description
  6. etc. Consider using that table as a guide to create a new class and attributes? Also consider that there may be more than one compound within the study, and/or each attribute of each intervention (even if only one compound is used in the study) may have more than one response (e.g., different arms with different routes of administration for the same compound). The model must be flexible enough to accommodate this.
EMuhlbradt commented 1 year ago

CPT_CoreBWE-v009.docx

dih-cdisc commented 1 year ago

Seems like a large task so we can defer this for a while but now we have a framework to work from.

BSnoeijerCD commented 1 year ago

Hi team, I compared M11 variables from Daves diagram, SDTM TS, CT.gov, CTIS/IDMP in attached spreadsheet. A good basis for adding it to the model. (https://app.zenhub.com/files/534339959/d151b479-13e4-483a-9954-7965ff9e101a/download).

As discussed with Dave last Tuesday:

image.png

BSnoeijerCD commented 1 year ago

Comment from Mikkel at the SME meeting of 01/08 based on the above diagram: The study builder links to elements instead of arms. This is more precise. The relationship would be the same (many-many). I agree that it is more precise. Other data models (like ct.gov) refer to arms but the arms can be indirectly linked via the elements as well.

BSnoeijerCD commented 1 year ago

Good comment from Diana Wold: duration of intervention can be added as well with standard coding.

BSnoeijerCD commented 1 year ago

@EMuhlbradt: For M11 Section 6 - A table would be created of intervention elements. Please share the details when known so I can include it in the spreadsheet.

dih-cdisc commented 1 year ago

Initial sketch design @BSnoeijerCD

2023 10 09 Interventions

BSnoeijerCD commented 1 year ago

@dih-cdisc To allow for the automated calculation of InterventionDuration I suggested a link to Procedure as an administration will be often recorded as an activity-procedure in the SoA as well. This might be complex and we can also consider this for the next phase.

We need a use parameter to indicate what TS parameter should be mapped to the treatment. We have the following TS parameters: TRT/CMPTRT/PLACEBO/TCNTRL. I thought this roughly aligned with the M11 Use parameter and thus can be added for both purposes.

BSnoeijerCD commented 1 year ago

@dih-cdisc Based on the Ct.gov review: the following Intervention Types are included in their list:

BSnoeijerCD commented 1 year ago

@dih-cdisc To allow for the automated calculation of InterventionDuration I suggested a link to Procedure as an administration will be often recorded as an activity-procedure in the SoA as well. This might be complex and we can also consider this for the next phase.

We need a use parameter to indicate what TS parameter should be mapped to the treatment. We have the following TS parameters: TRT/CMPTRT/PLACEBO/TCNTRL. I thought this roughly aligned with the M11 Use parameter and thus can be added for both purposes.

@dih-cdisc: Can we combine Role and Use with regard to the above? So add the Treatment, comparator treatment, placebo to the role list? Control type (TCNRL) can then be directly derived from that.

BSnoeijerCD commented 1 year ago

@dih-cdisc @EMuhlbradt @czwickl First step: changing names and adding attributes to StudyIntervention Class. I made some notes with questions. Note: Two additional changes from Daves diagram:

StudyIntervention Class

I will remove the notes in the final 2.6 version again.

BSnoeijerCD commented 1 year ago

Another version with added arrows from source to destination relationship. This might be more clear to Erin and Craig:

StudyIntervention Class

And we can evaluate whether this would be good to do for the whole diagram.

BSnoeijerCD commented 1 year ago

@daveih @EMuhlbradt @czwickl Here is the complete provisional version. I think it is good to go through the questions we still have on our scrum meeting tomorrow. USDM_UML

Additional notes / questions:

czwickl commented 1 year ago

@dih-cdisc @BSnoeijerCD @EMuhlbradt Notes from scrum meeting discussion on 2023-10-19 (Berber, Erin, Craig):

Please comment if any of these misrepresent our decisions or if anything is missing from the list. We ask Dave to review for agreement or comment on any items of concern that will need further discussion.

EMuhlbradt commented 1 year ago

@dih-cdisc @BSnoeijerCD @czwickl : for the class StudyIntervention:

For the propose attribute 'designation': Given the specificity of the intended meaning of the term (whether the study intervention is a IMP or an AxMP, we think the proposed attribute 'designation' is maybe too vague. Berber and Dave to consider an attribute name update should take place. Something like 'medicinalProductDesignation' or 'mpDesignation'?

EMuhlbradt commented 1 year ago

@dih-cdisc @BSnoeijerCD @czwickl

Sprint 8 draft file of changes to review: DDF.Terminology_Sprint.8.changes_2023-10-25pm.xlsx

dih-cdisc commented 1 year ago

@dih-cdisc @BSnoeijerCD @czwickl : for the class StudyIntervention:

For the propose attribute 'designation': Given the specificity of the intended meaning of the term (whether the study intervention is a IMP or an AxMP, we think the proposed attribute 'designation' is maybe too vague. Berber and Dave to consider an attribute name update should take place. Something like 'medicinalProductDesignation' or 'mpDesignation'?

"productDesignation"? just a bit shorter.

dih-cdisc commented 1 year ago

@EMuhlbradt @czwickl @BSnoeijerCD will pick up on the new CT spreadsheet once we have resolved few queries above and the renames in the other ticket for release 2.6 for the API changes

BSnoeijerCD commented 1 year ago

@dih-cdisc @BSnoeijerCD @czwickl : for the class StudyIntervention: For the propose attribute 'designation': Given the specificity of the intended meaning of the term (whether the study intervention is a IMP or an AxMP, we think the proposed attribute 'designation' is maybe too vague. Berber and Dave to consider an attribute name update should take place. Something like 'medicinalProductDesignation' or 'mpDesignation'?

"productDesignation"? just a bit shorter.

@dih-cdisc @czwickl @EMuhlbradt productDesignation is also more general. Medicinal might be controversial. So I am ok with productDesignation as well.

EMuhlbradt commented 1 year ago

@dih-cdisc @BSnoeijerCD DDF.Terminology_Sprint.8.changes_2023-10-26.xlsx

Updated draft CT file listing all changes (new and changes) with updates from today's discussions

BSnoeijerCD commented 1 year ago

@EMuhlbradt @daveih @czwickl

Checked Excel file and found the following issues:

EMuhlbradt commented 1 year ago

@BSnoeijerCD @dih-cdisc @czwickl : All draft CT updates have been made in the 2-6 release branch on Github. I look forward to QC comments.

EMuhlbradt commented 1 year ago

@EMuhlbradt @daveih @czwickl

Checked Excel file and found the following issues:

  • AS indicated before, I renamed the relationship that goes from studyDesign to studyIntervention class to studyInterventions instead of investigationalInterventions. This is in alignment with the class name change. It is also more appropriate as we do not only want the include investigational Interventions in this new class but all study related intervention. Can you align the CT with that new name?
  • the class name was only partly removed from the following attributes in CT. Dave and I indicated to remove the full name in the Excel file:

    • propertyResponseCodes should be responseCodes in CT
    • surrogateReference should be reference in CT
  • CT missed these changes for previous/next relationships

    • previousEncounter, nextEncounter should be previous and next
    • previousActivity, nextActivity should be previous and next
  • CT missed the following name changes for children relationships (as discussed during one of the scrums this week and indicated in the Excel, we were planning to change them as well )

    • bcCategoryChildren should be children
    • contentChildren should be children
  • I send out an E-mail about the re-added content relationship to studyDesign. I think that is not correct as it was moved from studyDesign to studyProtocolDocumentVersion (see UML). Version 2.5 already includes a new relationship from studyDesign to this new studyProtocolDocumentVersion class called documentVersion.

@BSnoeijerCD -> Thanks for these; all changes made in the CT deliverables in 2-6 branch release.

BSnoeijerCD commented 1 year ago

@dih-cdisc Uploaded CT aligned UML version.

BSnoeijerCD commented 1 year ago

@EMuhlbradt @czwickl While preparing the presentation for the SME meeting, I found that during my check I missed the new relationship from procedure to StudyIntervention. Could you add this relationship to the CT? The relationship is called studyIntervention. This relationship allows users to link a procedure to a specific study intervention. In that way the intervention can be is directly related to the study timeline.

BSnoeijerCD commented 1 year ago

@EMuhlbradt @czwickl While preparing the presentation for the SME meeting, I found that during my check I missed the new relationship from procedure to StudyIntervention. Could you add this relationship to the CT? The relationship is called studyIntervention. This relationship allows users to link a procedure to a specific study intervention. In that way the intervention can be is directly related to the study timeline.

dih-cdisc commented 1 year ago

Summary of changes for Intervention and Dosing. Also includes name changes

DDF USDM Model Informative