Skip to content

Draft data management - #28

Open
svteichman wants to merge 22 commits into
mainfrom
draft_data_management
Open

Draft data management#28
svteichman wants to merge 22 commits into
mainfrom
draft_data_management

Conversation

@svteichman

@svteichman svteichman commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Purpose/implementation Section

Chapter 5: clinical data management

What changes are being implemented in this Pull Request?

This pull request adds a draft of chapter 5: clinical data management.

What was your approach?

I transferred the content for this chapter from the Google Drive, editing and re-ordering as needed to make it fit into the framework of the course.

What GitHub issue does your pull request address?

No current issues.

Tell potential reviewers what kind of feedback you are soliciting.

I would like to get feedback on the overall structure of this chapter, as this is my first addition to this course. I would also appreciate any ideas of where to add images.

New Content Checklist

@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

No spelling errors! 🎉
Comment updated at 2026-07-23-01:11:34 with changes from ce5630f

@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

No broken url errors! 🎉
Comment updated at 2026-07-23-01:11:39 with changes from ce5630f

@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Re-rendered previews from the latest commit:

* note not all html features will be properly displayed in the "quick preview" but it will give you a rough idea.

Updated at 2026-08-21 with changes from the latest commit 66e59df

@svteichman

Copy link
Copy Markdown
Collaborator Author

@carriewright11 this is a draft of chapter 5 (with the updates we discussed in our last meeting). It is mostly complete, but is missing a conclusion and images. I can add these to the pull request but first wanted to make sure that this all looks good, because it is my first contribution to this course or any of the ITCR courses. I can brainstorm where to add images/what images to add but am open to any ideas that you or @kweav have, if you had anything in mind.

Comment thread 03-data_management.Rmd
Comment thread 03-data_management.Rmd
#### Open source options

Open-source tools provide a cost-effective and flexible alternative to proprietary software for handling clinical data. These tools are often developed and maintained by vibrant communities and can be customized to fit specific research needs.

@kweav kweav Jun 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Possible figure here that open source software doesn't mean data won't be protected (but still have to do work to make sure data is protected)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

May be better later in the section (looks like line 74)

Comment thread 03-data_management.Rmd
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd
Comment thread 03-data_management.Rmd
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd Outdated
@kweav

kweav commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Overall readability score: 52.48 (🟢 +0)

File Readability
index.md 40.25 (🟢 +0)
About.md 50.79 (🟢 +0)
02-data_uses.md 36.84 (🟢 +0)
index.md 40.25 (🟢 +0)
About.md 50.79 (🟢 +0)
02-data_uses.md 36.84 (🟢 +0)
View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File Readability FRE GF ARI CLI DCRS
index.md 40.25 46.06 14.11 13.4 13.92 9.57
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
About.md 50.79 43.59 10.53 12.5 14.65 8.16
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
02-data_uses.md 36.84 18.35 11.76 17.4 17.64 7.02
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
index.md 40.25 46.06 14.11 13.4 13.92 9.57
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
About.md 50.79 43.59 10.53 12.5 14.65 8.16
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
02-data_uses.md 36.84 18.35 11.76 17.4 17.64 7.02
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0

Averages:

  Readability FRE GF ARI CLI DCRS
Average 52.48 49.59 11.79 13.44 12.65 7.73
  🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0 🟢 +0
View metric targets
Metric Range Ideal score
Flesch Reading Ease 100 (very easy read) to 0 (extremely difficult read) 60
Gunning Fog 6 (very easy read) to 17 (extremely difficult read) 8 or less
Auto. Read. Index 6 (very easy read) to 14 (extremely difficult read) 8 or less
Coleman Liau Index 6 (very easy read) to 17 (extremely difficult read) 8 or less
Dale-Chall Readability 4.9 (very easy read) to 9.9 (extremely difficult read) 6.9 or less

Comment thread 03-data_management.Rmd Outdated
@svteichman

Copy link
Copy Markdown
Collaborator Author

@carriewright11 this PR is ready for your review now!

@carriewright11
carriewright11 self-requested a review July 24, 2026 15:00

@carriewright11 carriewright11 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Had some minor comments

Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd

### Testing data handling tools

Before implementing data handling methods in an actual clinical trial, it is crucial to run tests using **dummy data**. This step ensures that the data handling process is robust, efficient, and free from errors across different conditions, without risking sensitive patient information.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lets link out to the synthetic data section ... also might be good to describe https://www.questionpro.com/blog/synthetic-data-vs-simulated-data/ - either here or there and clarify what dummy data is vs synthetic vs simulated

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mentioned this in issue #45 about linking to the synthetic data section.

Comment thread 03-data_management.Rmd

### Data Management Plan

A Data Management Plan (DMP) outlines how data will be handled during and after a research project. Typically created at the beginning of a project, it is stored in project documentation repositories or institutional databases. Often required by funding agencies, a DMP may include plans for testing with dummy data to ensure data integrity. The importance of a DMP lies in its role in planning and managing data throughout the project, ensuring that data is handled consistently and responsibly [[@DataManagement]](https://www.tableau.com/learn/articles/what-is-data-management).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Depending on what the updates were for the data management plans for NIH (i don't know how much it simplified it - but previously for grant funded research you had to have a plan) - we might want to reference our course and or the NIH links

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment thread 03-data_management.Rmd

Data Use Agreements (DUAs) define the terms and conditions for data sharing and use. Encountered before data is shared with external parties, they are stored in legal or administrative offices. DUAs are required when sharing data with external collaborators but are typically not directly related to dummy data. DUAs are important for protecting data privacy and ensuring that data is used appropriately [[@DataCompliance]](https://www.ibm.com/topics/data-compliance).

### Data Sharing Agreements

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it would be nice to modify these a bit more to make it clear what the difference is between a DUA and DSA... https://casrai.org/guides/data-sharing-agreements-between-collaborators-and-institutions

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see that the summary describes them in a more distinct way.

Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd

Honest brokers act as neutral intermediaries between the data source and researchers, typically regulated by Institutional Review Boards (IRBs) or equivalent bodies. They are responsible for de-identifying data to ensure that researchers cannot trace the data back to individual patients. Honest brokers must complete specific training, such as Collaborative Institutional Training Initiative (CITI) Research Ethics and HIPAA training, before accessing data. They play a crucial role in maintaining the confidentiality and integrity of clinical data.

## Documentation

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could have an image that briefly describes DMP, SAP, SOP, DUA, and DSA

@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

OTTR Check Results

Summary

  • Spelling check: ❌ FAILED (1 errors found, threshold: 0)
  • URL check: ✅ PASSED (0 errors found, threshold: 0)
  • Quiz format check: ✅ PASSED (0 errors found, threshold: 0)

⚠️ Some Checks Failed Click here to download detailed error reports

Last Updated: 2026-08-21-15:52:14

svteichman and others added 2 commits August 21, 2026 11:51
Co-authored-by: Carrie Wright <23014755+carriewright11@users.noreply.github.com>
Co-authored-by: Carrie Wright <23014755+carriewright11@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants