GP2 clinical data dictionary repository

Welcome to the GP2 clinical data dictionary repository! This repo is the central, version-controlled source for GP2’s data dictionary. It helps researchers and collaborators keep variables consistent, document updates transparently, and make sure everyone uses and references the most up-to-date GP2 standard format for clinical data.

What's incuded?

You will find a .csv that can be browsed, downloaded for use in scripts/analysis, or you can make requests for additions!

How to view the data dictionary

If you are solely interested in browsing the items to determine what modalities and variables are captured in GP2 clinical datasets, directly click on the .csv file in this repo. It will show a preview of the data dictionary and there are options to search the document or download the file directly! This is a useful resource if you are a site/data manager or PI interested in preparing clinical data for transfer to GP2.

How you can contribute

We welcome contributions if you are interested in suggesting changes or additions to the GP2 data dictionary! There are two main ways to suggest changes or updates to the document in this repository:

1. Open an issue

• Report missing variables
• Suggest new terms or metadata
• Flag typos or unclear definitions

2. Submit a pull request (PR)

• Fork this repository (from the button top right)
• Clone the repo to your local
• Create a new branch for your changes (git checkout -b YOUR_BRANCH_NAME)
• Edit the dictionary file
• Commit and push your changes (git commit -m "Your commit message" and git push origin YOUR_BRANCH_NAME)
• Open a PR at your GitHub so we can review together

All changes are reviewed before merging to keep the dictionary consistent and reliable.

Update Process

• Issues are reviewed regularly by admin
• Approved changes are merged
• Each update is tagged with a version (e.g. v2025.08.11)
• You can find past versions on the releases page

How to use the dictionary

You can: Download the latest release from the Releases page OR clone the repo directly:

git clone https://github.com/lietsel-jones/data-dict-test.git

Then reference the dictionary in your own analyses or harmonization pipelines.

How to cite

If you use this data dictionary in your work, please cite it as: GP2 Data Dictionary. Version 1.1. GitHub Repository: https://github.com/lietsel-jones/data-dict-test.git. Accessed YYYY-MM-DD.

Maintainers

Maintainer: Lietsel Jones

Contributions are very welcome from the community!