Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.9%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: CEDARS-NLP
  • Language: Python
  • Default Branch: main
  • Homepage: https://cedars.io/
  • Size: 7.55 MB
Statistics
  • Stars: 6
  • Watchers: 2
  • Forks: 2
  • Open Issues: 59
  • Releases: 0
Created almost 3 years ago · Last pushed 11 months ago
Metadata Files
Readme Citation

README.md

Overview

Background

CEDARS (Clinical Event Detection and Recording System) is a computational paradigm for collection and aggregation of time-to-event data in retrospective clinical studies. Developed out of a practical need for a more efficient way to conduct medical research, it aims to systematize and accelerate the review of electronic health record (EHR) corpora to detect and characterize clinical events. Using CEDARS, human abstractors can work more efficently through the use of dedicated graphical user interface (GUI). the system also incorporates a customized data storage scheme and a natural language processing (NLP) pipeline. In its current iteration, CEDARS is available as an open-source Python package under GPL-3 license. The latest package and previous versions can be cloned from GitHub. Full documentation is available here. CEDARS can be used with or without its companion NLP package PINES. Please see the Terms of Use before using CEDARS. CEDARS is provided as-is with no guarantee whatsoever and users agree to be held responsible for compliance with their local government/institutional regulations.

General Requirements

  • Python 3.9 or later
  • Docker

Basic Concepts

CEDARS Workflow

Sentences with keywords or concepts of interest are presented to the end user one at a time and in chronological order. The user assesses each sentence, determining whether or not a clinical event is being reported. The whole note or report drawn from the EHR is available for review in the GUI. If no event is declared in the sentence, CEDARS presents the next sentence for the same patient (#1). If an event date is entered, CEDARS moves to the next unreviewed sentence before the event date. If there are no sentences left to review before the event, the GUI moves to the next patient (#2) and the process is repeated with the following record (#3 and #4), until all selected sentences have been reviewed.

In order for CEDARS to be sufficiently sensitive and not miss and unacceptable number of clinical events, the keyword/concept search query must be well thought and exhaustive. The performance of CEDARS will vary by medical area, since the extent of medical lexicon will vary substantially between event types.

Features

  • Automatic Detection of Key Events
  • Easy interface to upload and query medical data.
  • Project Statistics
  • Secure Login

Operational Schema

CEDARS Operational Schema

CEDARS is modular and all information for any given annotation project is stored in one MongoDB database. User credentials, original clinical notes, NLP annotations and patient-specific information are stored in dedicated collections. Once clinical notes have been uploaded, they are passed through the NLP pipeline. Currently only UDPipe is supported and integrated with CEDARS. If desired, the annotation pipeline can include negation and medical concept tagging by NegEx and UMLS respectively.

Multiple users can load the web GUI and annotate records at the same time. Once accessed, a given patient record is locked for the user.

Future Development

We are currently documenting the performance of CEDARS with a focus on oncology clinical research. At the present time, we wish to solidify the CEDARS user interface and ensure a smooth experience in multi-user settings. In the longer term, plug-in modules featuring enhanced query generation and adaptive learning will be integrated into the R workflow. Support for other NLP engines and extensive parallel processing are also desirable.

Please communicate with package author Simon Mantha, MD, MPH (smantha@cedars.io) if you want to discuss new features or using this software for your clinical research application.

Owner

  • Name: CEDARS-NLP
  • Login: CEDARS-NLP
  • Kind: organization

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: CEDARS
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Rohan
    family-names: Singh
    email: singhrohan@outlook.com
    affiliation: Memorial Sloan Kettering Cancer Center
    orcid: 'https://orcid.org/0009-0003-1326-7249'
  - given-names: Simon
    family-names: Mantha
    affiliation: Memorial Sloan Kettering
repository-code: 'https://github.com/CEDARS-NLP/CEDARS'
url: 'https://cedars.io'
abstract: >-
  CEDARS (Clinical Event Detection and Recording System) is
  a computational paradigm for collection and aggregation of
  time-to-event data in retrospective clinical studies.
  Developed out of a practical need for a more efficient way
  to conduct medical research, it aims to systematize and
  accelerate the review of electronic health record (EHR)
  corpora to detect and characterize clinical events. Using
  CEDARS, human abstractors can work more efficently through
  the use of dedicated graphical user interface (GUI). the
  system also incorporates a customized data storage scheme
  and a natural language processing (NLP) pipeline. In its
  current iteration, CEDARS is available as an open-source
  Python package under GPL-3 license. The latest package and
  previous versions can be cloned from GitHub. Full
  documentation is available here. CEDARS can be used with
  or without its companion NLP package PINES. Please see the
  Terms of Use before using CEDARS. CEDARS is provided as-is
  with no guarantee whatsoever and users agree to be held
  responsible for compliance with their local
  government/institutional regulations.
keywords:
  - nlp
  - clinical
  - EHR
  - annotation

GitHub Events

Total
  • Create event: 33
  • Issues event: 64
  • Watch event: 2
  • Delete event: 18
  • Member event: 1
  • Issue comment event: 4
  • Push event: 128
  • Pull request review event: 35
  • Pull request review comment event: 16
  • Pull request event: 61
Last Year
  • Create event: 33
  • Issues event: 64
  • Watch event: 2
  • Delete event: 18
  • Member event: 1
  • Issue comment event: 4
  • Push event: 128
  • Pull request review event: 35
  • Pull request review comment event: 16
  • Pull request event: 61

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 28
  • Total pull requests: 11
  • Average time to close issues: 6 months
  • Average time to close pull requests: 6 days
  • Total issue authors: 3
  • Total pull request authors: 4
  • Average comments per issue: 0.04
  • Average comments per pull request: 0.0
  • Merged pull requests: 7
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 25
  • Pull requests: 11
  • Average time to close issues: 5 months
  • Average time to close pull requests: 6 days
  • Issue authors: 2
  • Pull request authors: 4
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 7
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • simon-hans (73)
  • ygivenx (23)
  • Kayan1920 (9)
  • omid-jf (1)
Pull Request Authors
  • Kayan1920 (48)
  • ygivenx (14)
  • CVKuala (2)
  • adeineha (2)
  • simon-hans (2)
Top Labels
Issue Labels
bug (4) enhancement (2) good first issue (2) help wanted (2)
Pull Request Labels

Dependencies

.github/workflows/ci.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v2 composite
  • actions/upload-artifact v3 composite
  • py-cov-action/python-coverage-comment-action v3 composite
cedars/Dockerfile docker
  • python 3.9 build
docker-compose.yml docker
cedars/pyproject.toml pypi
  • flake8 ^6.1.0 develop
  • pylint ^2.17.4 develop
  • pytest ^7.4.0 develop
  • Flask ^2.3.2
  • Flask-Caching ^2.0.2
  • Flask-Login ^0.6.2
  • coverage ^7.3.0
  • en-core-sci-lg *
  • en-core-sci-md *
  • faker ^19.3.0
  • fastparquet ^2023.8.0
  • flask-pymongo ^2.3.0
  • flask-session ^0.5.0
  • jupyterlab ^4.0.2
  • loguru ^0.7.2
  • minio ^7.1.16
  • mkdocs ^1.5.3
  • mkdocstrings ^0.24.0
  • negspacy ^1.0.4
  • pandas ^2.0.2
  • pydantic ^1.9.0
  • python ^3.9
  • python-dotenv ^1.0.0
  • scispacy ^0.5.3
  • tdqm ^0.0.1
cedars/requirements.txt pypi
  • Flask ==2.3.2
  • Flask-Login ==0.6.2
  • Flask-Session ==0.5.0
  • Jinja2 ==3.1.2
  • Werkzeug ==2.3.3
  • faker *
  • fastparquet *
  • flask-caching ==2.0.2
  • flask-pymongo *
  • loguru ==0.7.2
  • minio ==7.1.16
  • pandas *
  • pylint ==2.17.4
  • pymongo ==4.4.0
  • pytest ==7.4.0
  • python-dateutil ==2.8.2
  • python-dotenv ==1.0.0
  • regex ==2023.6.3
  • scispacy ==0.5.2
  • spacy ==3.4.4
  • spacy-legacy ==3.0.12
  • spacy-loggers ==1.0.4
  • tokenizers ==0.13.3
  • urllib3 ==2.0.3