Skip to content

clinicedc/clinicedc

Repository files navigation

pypi actions uv Ruff downloads django-packages

clinicedc - A clinical trials data management framework built on Django

A data management framework built on Django for multisite randomized longitudinal clinical trials.

Documentation: clinicedc.readthedocs.io

Source code: https://github.com/clinicedc/clinicedc

Here is a python module that extends Django to empower you to build an EDC / eSource system to handle data collection and management for multi-site longitudinal clinical trials.

Refer to the specific open projects listed below for example EDC systems built with these modules. The more recent the trial the better the example.

The codebase continues to evolve over many years of conducting clinical trials for mostly NIH-funded clinical trials through the Harvard T Chan School of Public Health, the Botswana-Harvard AIDS Institute Partnership in Gaborone, Botswana and the London School of Hygiene and Tropical Medicine. Almost all trials were originally related to HIV/AIDS research.

More recent work with the RESPOND Africa Group formerly at the Liverpool School of Tropical Medicine and now with the University College London Institute for Global Health has expanded into Diabetes (DM), Hypertension (HTN) and models of integrating care in Africa (https://inteafrica.org) for the three main chronic conditions -- HIV/DM/HTN.

See also https://www.ucl.ac.uk/global-health/respond-africa

The implementations we develop with this framework are mostly eSource systems rather than the traditional EDCs. The clinicedc approach simplifies embedding cross-domain and cross-visit checks.

The projects listed below consist of a subset of trial-specific modules that make heavy use of modules in this framework.

Contacts

For further information go to https://github.com/erikvw.

JetBrains PyCharm Thanks to JetBrains for support with an opensource PyCharm IDE license.

Made with Django

Framework stack

python Django mysql
python 3.12+ Django 5.2+ mysql 8+

How we describe the CLINICEDC projects in our protocol documents

Here is a simple example of a data management section for a study protocol document: data_management_section

Projects that use clinicedc

Recent examples of clinicedc applications using this codebase:

INTECOMM Trial

Controlling chronic diseases in Africa: Development and evaluation of an integrated community-based management model for HIV, Diabetes and Hypertension in Tanzania and Uganda

https://github.com/intecomm-trial/intecomm-edc (2022-2025)

EFFECT Trial

Fluconazole plus flucytosine vs. fluconazole alone for cryptococcal antigen-positive patients identified through screening:

A phase III randomised controlled trial

https://github.com/effect-trial/effect-edc (2021- )

http://www.isrctn.com/ISRCTN30579828

META Trial (Phase III)

A randomised placebo-controlled double-blind phase III trial to determine the effects of metformin versus placebo on the incidence of diabetes in HIV-infected persons with pre-diabetes in Tanzania.

https://github.com/meta-trial/meta-edc (2021- )

(The same codebase is used for META Phase 2 and META Phase 3)

http://www.isrctn.com/ISRCTN77382043

Mapitio

Retrospective HIV/Diabetes/Hypertension Cohort (Tanzania)

https://github.com/mapitio/mapitio-edc (2020-2022)

MOCCA Trial

Integrated care for HIV and non-communicable diseases in Africa: a pilot study to inform a large-scale trial (MOCCA and MOCCA Extension Study)

https://github.com/mocca-trail/mocca-edc (2020-2022)

http://www.isrctn.com/ISRCTN71437522

INTE Africa Trial

Evaluating the integration of health services for chronic diseases in Africa

(32 sites in Uganda and Tanzania)

https://github.com/inte-africa-trial/inte-edc (2020-2022)

https://inteafrica.org

http://www.isrctn.com/ISRCTN43896688

META Trial (Phase II)

A randomised placebo-controlled double-blind phase II trial to determine the effects of metformin versus placebo on the incidence of diabetes in HIV-infected persons with pre-diabetes in Tanzania.

(3 sites in Tanzania)

https://github.com/meta-trial/meta2-edc (2019-2021)

http://www.isrctn.com/ISRCTN76157257

The Ambition Trial

High dose AMBISOME on a fluconazole backbone for cryptococcal meningitis induction therapy in sub-Saharan Africa

(7 sites in Botswana, Malawi, South Africa, Uganda, Zimbabwe)

https://github.com/ambition-trial/ambition-edc (2018-2021)

http://www.isrctn.com/ISRCTN72509687

Start with main repo ambition-edc

The Botswana Combination Prevention Project

(30 remote offline sites in Botswana)

https://github.com/botswana-combination-prevention-project (2013-2018)

https://clinicaltrials.gov/ct2/show/NCT01965470

https://www.ncbi.nlm.nih.gov/pubmed/?term=NCT01965470

https://aids.harvard.edu/tag/bcpp/

Start with main repo bcpp

Optional modules

edc-csf edc-csf pypi-edc-csf
edc-he edc-he pypi-edc-he
edc-microbiology edc-microbiology pypi-edc-microbiology
edc-microscopy edc-microscopy pypi-edc-microscopy
edc-mnsi edc-mnsi pypi-edc-mnsi
edc-phq9 edc-phq9 pypi-edc-phq9
edc-qol edc-qol pypi-edc-qol
edc-icecap-a edc-icecap-a pypi-edc-icecap-a
edc-retinopathy edc-retinopathy pypi-edc-retinopathy

Testing modules

clinicedc-tests clinicedc-tests pypi-clinicedc-tests
edc-test-settings edc-test-settings pypi-edc-test-settings

Env

uv venv
source .venv/bin/activate
uv sync --no-dev --no-sources --upgrade

Development server run

Assuming you have an EDC project using clinicedc ...

uv run --dev manage.py migrate --settings=my_edc.settings.debug
uv run --dev manage.py runserver

Non-dev server run

Assuming you have an EDC project using clinicedc ...

uv run --no-dev --no-sources manage.py migrate --settings=my_edc.settings.debug
uv run --no-dev --no-sources manage.py runserver

Tests

uv run --dev runtests.py

Lint and format

uvx ruff check

About

A framework for multisite longitudinal clinical trials built on Django

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages