Skip to content

Draft data management#28

Open
svteichman wants to merge 13 commits into
mainfrom
draft_data_management
Open

Draft data management#28
svteichman wants to merge 13 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-06-22-17:54:55 with changes from d2acfb0

@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

No broken url errors! 🎉
Comment updated at 2026-06-22-17:55:04 with changes from d2acfb0

@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-06-22 with changes from the latest commit d2acfb0

@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
- Data Cleaning and Processing: Ensuring data consistency, accuracy, and completeness by detecting and rectifying errors, missing values, and inconsistencies.
- Data Analysis: Using statistical and analytical tools to generate insights from the data that can inform clinical decisions and study outcomes.
- Data Sharing and Reporting: Providing access to data for collaborators, regulators, or stakeholders in a secure and controlled manner and generating reports that summarize findings.

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 showing how these activities relate (e.g., data is collected and then stored. Data may be checked and then shared and then analysis (with more checking) and then more sharing (of reports)) sort of thing

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

- **Data Quality**: Refers to the accuracy, completeness, consistency, and reliability of data. High-quality data is essential for producing valid and reliable research outcomes. It involves processes such as data validation, error checking, and quality control measures.
- **Data Handling**: Encompasses the broader scope of managing the data lifecycle, from collection and storage to processing, analysis, and sharing. While data quality is a component of data handling, the latter also involves aspects like data security, access management, and regulatory compliance.

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 showing that data quality is just a part of data handling

Comment thread 03-data_management.Rmd Outdated
Comment thread 03-data_management.Rmd
- **Scalability**: The tool should be able to handle the volume of data expected in the study and scale as the study progresses.
- **User-Friendliness**: A user-friendly interface can reduce the learning curve for researchers and data managers, improving efficiency and reducing errors.
- **Regulatory Compliance**: The tool should comply with relevant data privacy and security regulations to protect patient data.
- **Support and Documentation**: Adequate support, including user manuals, tutorials, and customer service, is essential for troubleshooting and maximizing the tool's potential.

@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.

Add a note about institutional support / access as well possibly? Institutional suppport for REDCap is an example.

Comment thread 03-data_management.Rmd
- **User-Friendliness**: A user-friendly interface can reduce the learning curve for researchers and data managers, improving efficiency and reducing errors.
- **Regulatory Compliance**: The tool should comply with relevant data privacy and security regulations to protect patient data.
- **Support and Documentation**: Adequate support, including user manuals, tutorials, and customer service, is essential for troubleshooting and maximizing the tool's potential.

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.

In line with seeking recommendations which is said at the end of this section, I wonder about adding a point about it being a mainstream/commonly used tool. Like probably don't pick something that isn't commonly used in the field.

Comment thread 03-data_management.Rmd

Examples of popular open-source data handling tools include:

- **REDCap**: A secure, web-based application for building and managing online surveys and databases, widely used in clinical research for data collection and 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.

Add a note that it has robust capability for data quality checks, can produce basic reports (stats & visualizations), but is not capable of advanced statistical modeling or more sophisticated analyses

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

When moving between multiple data handling tools, it is important to consider interoperability. As an example, REDCap and R play very nicely together via API tokens, but this may not be true of all electronic data capture systems or databases. The sharing, integration and redistribution of data between systems - whether internally or externally - needs to be carefully planned, tested and documented.

### Testing data handling tools

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 think for this section we might want to provide a few examples of this. Really communicate that simulating can mean writing a script that uses statistical / probabilistic modeling frameworks to create a dataset and you add some noise (such as removing data or putting in a few errors). And once you've simulated that data, you put it through the rest of the handling pipeline (storing, transferring between tools, running the proposed analysis on it). But it can also mean inputting data (like data collection) where you go through a case report form and answer the questions a few dozen times and then continue with the data handling pipeline.

Comment thread 03-data_management.Rmd Outdated

- **Creating Realistic Dummy Data**: Dummy data should mimic the real data in terms of format, structure, and complexity. It should include various scenarios (e.g., missing data, outliers, data entry errors) to test the system's error-handling capabilities.
- **Simulating the Full Data Handling Workflow**: The process should involve every stage of data handling, from data collection and entry to storage, cleaning, analysis, and reporting. This comprehensive simulation helps identify potential issues early, such as data loss, security vulnerabilities, or errors in data processing algorithms.
- **Refining and Optimizing Data Handling Methods**: Based on the findings from dummy data tests, researchers can refine their data handling protocols, adjust tools and settings, and optimize workflows to ensure smooth operations when real data is introduced.

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.

Do we want to mention that they may want to refine their survey instruments / case report forms based on these tests as well? That was a huge focus of the redcap course at Hopkins that every case report form should be tested and often the case report form itself gets refined (e.g., a question is rephrased or moved or marked as required or .,,,, ) not just settings or proposed analysis steps

Comment thread 03-data_management.Rmd Outdated
- **Access Control and Encryption**: Tools should support robust access controls, ensuring that only authorized users have access to the data. Encryption should be used for both data at rest and data in transit to prevent unauthorized access.
- **Compliance and Auditing**: Tools should facilitate compliance with regulatory standards and provide auditing capabilities to track data access and usage.

When selecting data handling tools, it is crucial to prioritize those that offer comprehensive privacy features to safeguard sensitive information and maintain public trust in clinical research.

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 think this sentence may fit better before the bulleted list? Feels like the bulleted list needs some sort of transition sentence before it

@kweav

kweav commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Overall readability score: 51.25 (🔴 -1.23)

File Readability
03-data_management.md 38.26 (🔴 -61.74)
View detailed metrics

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

File Readability FRE GF ARI CLI DCRS
03-data_management.md 38.26 19.67 12.34 15.6 16.18 7.79
  🔴 -61.74 🔴 -80.33 🔴 -6.34 🔴 -9.6 🔴 -10.18 🔴 -2.89

Averages:

  Readability FRE GF ARI CLI DCRS
Average 51.25 47.98 11.92 13.63 12.85 7.79
  🔴 -1.23 🔴 -1.61 🔴 -0.13 🔴 -0.19 🔴 -0.2 🔴 -0.06
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

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.

2 participants