Skip to content

Commit 52d7df5

Browse files
authored
Merge pull request #1034 from MIT-LCP/new_consol
MIMIC repo code consolidation
2 parents 6b07fe5 + 6a64145 commit 52d7df5

581 files changed

Lines changed: 20296 additions & 51 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 2 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,3 @@
1-
# Data files
2-
*.csv
3-
4-
# Picture files
5-
*.png
6-
71
# Byte-compiled / optimized / DLL files
82
__pycache__/
93
*.py[cod]
@@ -65,12 +59,5 @@ target/
6559
# OSX .DS_Store
6660
.DS_Store
6761

68-
# Jupyter Notebook checkpoints
69-
.ipynb_checkpoints/
70-
71-
# data files
72-
travisdata/
73-
74-
# R project files
75-
.Rproj
76-
.Rproj.user
62+
# PyCharm / JetBrains
63+
.idea

.travis.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,4 +21,4 @@ install:
2121
- pip install pytest --quiet
2222

2323
script:
24-
- 'pytest tests'
24+
- 'pytest mimic-iii/tests'

ISSUE_TEMPLATE.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
### Prerequisites
22

33
* [ ] Put an X between the brackets on this line if you have done all of the following:
4-
* Checked the online documentation: https://mimic.physionet.org/about/mimic/
4+
* Checked the online documentation: https://mimic.mit.edu/
55
* Checked that your issue isn't already addressed: https://github.com/MIT-LCP/mimic-code/issues?utf8=%E2%9C%93&q=
66

77
### Description
@@ -11,3 +11,6 @@ Description of the issue, including:
1111
* what you have tried
1212
* references to similar issues
1313
* queries demonstrating your question (if applicable)
14+
15+
### Labels
16+
* Please add one or more of these labels when creating an issue: ![](https://img.shields.io/github/labels/MIT-LCP/mimic-code/mimic-iv), ![](https://img.shields.io/github/labels/MIT-LCP/mimic-code/mimic-iii), ![](https://img.shields.io/github/labels/MIT-LCP/mimic-code/mimic-cxr). If your issue applies to more than one of these please feel free to select multiple labels as appropriate.

LICENSE

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
The MIT License (MIT)
1+
MIT License
22

3-
Copyright (c) 2015 MIT Laboratory for Computational Physiology
3+
Copyright (c) 2019 MIT Laboratory for Computational Physiology
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal
@@ -19,4 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
1919
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
2020
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
2121
SOFTWARE.
22-

README.md

Lines changed: 8 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,16 @@
1-
# MIMIC Code Repository [![Build Status](https://travis-ci.org/MIT-LCP/mimic-code.svg?branch=master)](https://travis-ci.org/MIT-LCP/mimic-code) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.821872.svg)](https://doi.org/10.5281/zenodo.821872) [![Join the chat at https://gitter.im/MIT-LCP/mimic-code](https://badges.gitter.im/MIT-LCP/mimic-code.svg)](https://gitter.im/MIT-LCP/mimic-code?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
1+
# MIMIC Code Repository [![Build Status](https://travis-ci.org/MIT-LCP/mimic-code.svg?branch=main)](https://travis-ci.org/MIT-LCP/mimic-code) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.821872.svg)](https://doi.org/10.5281/zenodo.821872)
22

3-
This is a repository of code shared by the research community. The repository is intended to be a central hub for sharing, refining, and reusing code used for analysis of the [MIMIC critical care database](https://mimic.physionet.org). To find out more about MIMIC, please see: https://mimic.physionet.org. Source code for the website is in the [mimic-website GitHub repository](https://github.com/MIT-LCP/mimic-website/).
3+
This is a repository of code shared by the research community. The repository is intended to be a central hub for sharing, refining, and reusing code used for analysis of the [MIMIC critical care database](https://mimic.mit.edu). To find out more about MIMIC, please see: https://mimic.mit.edu. Source code for the website is in the [mimic-website GitHub repository](https://github.com/MIT-LCP/mimic-website/).
44

55
You can read more about the code repository in the following open access paper: [The MIMIC Code Repository: enabling reproducibility in critical care research](https://doi.org/10.1093/jamia/ocx084).
66

7-
## Brief introduction
8-
9-
The repository consists of a number of Structured Query Language (SQL) scripts which build the MIMIC-III database in a number of systems and extract useful concepts from the raw data.
10-
Jupyter notebooks are also provided which detail analyses performed on MIMIC-III.
11-
12-
The repository is organized as follows:
13-
14-
* [benchmark](/benchmark) - Various speed tests for indices
15-
* [buildmimic](/buildmimic)\* - Scripts to build MIMIC-III in a relational database management system (RDMS), in particular [postgres](/buildmimic/postgres) is our RDMS of choice
16-
* [concepts](/concepts) - Useful views/summaries of the data in MIMIC-III, e.g. demographics, organ failure scores, severity of illness scores, durations of treatment, easier to analyze views, etc. The paper above describes these in detail, and a README in the subfolder lists concepts generated.
17-
* [notebooks](/notebooks) - A collection of R markdown and Jupyter notebooks which give examples of how to extract and analyze data
18-
* [notebooks/aline](/notebooks/aline) - An entire study reproduced in the MIMIC-III database - from cohort generation to hypothesis testing
19-
* [notebooks/aline-aws](/notebooks/aline-aws) - As above, [launchable immediately on AWS](#launch-mimic-iii-in-aws)
20-
* [tests](/tests) - You should always have tests!
21-
* [tutorials](/tutorials) - Similar to the notebooks folder, but focuses on explaining concepts to new users
22-
23-
\* A Makefile build system has been created to facilitate the building of the MIMIC database, and optionally contributed views from the community. Please refer to the [Makefile guide](https://github.com/MIT-LCP/mimic-code/blob/master/Makefile.md) for more details.
24-
257
## Cloud access
268

27-
The MIMIC-III database is now available on two major cloud platforms: Google Cloud Platform (GCP) and Amazon Web Services (AWS). To access the data on the cloud, simply add the relevant cloud identifier to your PhysioNet profile. Further instructions are available on [the MIMIC-III website](https://mimic.physionet.org/gettingstarted/cloud/).
28-
29-
Derived concepts can be immediately accessed by querying them directly on BigQuery under the `mimiciii_derived` dataset in the `physionet-data` project (see [cloud instructions for accessing MIMIC-III on the cloud](https://mimic.physionet.org/gettingstarted/cloud/)).
9+
The MIMIC database is now available on two major cloud platforms: Google Cloud Platform (GCP) and Amazon Web Services (AWS). To access the data on the cloud, simply add the relevant cloud identifier to your PhysioNet profile. Further instructions are available on [the MIMIC website](https://mimic.mit.edu/iv/access/cloud/).
3010

3111
### Launch MIMIC-III in AWS
3212

33-
Use the below Launch Stack button to deploy access to the MIMIC-III dataset into your AWS account. This will give you real-time access to the MIMIC-III data in your AWS account without having to download a copy of the MIMIC-III dataset. It will also deploy a Jupyter Notebook with access to the content of this GitHub repository in your AWS account. Prior to launching this, please login to the [MIMIC PhysioNet website](https://mimic.physionet.org/), [input your AWS account number](https://physionet.org/settings/cloud/), and [request access to the MIMIC-III Clinical Database on AWS](https://physionet.org/projects/mimiciii/1.4/request_access/2).
13+
MIMIC-III is available on AWS (and MIMIC-IV will be available in the future). Use the below Launch Stack button to deploy access to the MIMIC-III dataset into your AWS account. This will give you real-time access to the MIMIC-III data in your AWS account without having to download a copy of the MIMIC-III dataset. It will also deploy a Jupyter Notebook with access to the content of this GitHub repository in your AWS account. Prior to launching this, please login to the [MIMIC PhysioNet website](https://mimic.mit.edu/), [input your AWS account number](https://physionet.org/settings/cloud/), and [request access to the MIMIC-III Clinical Database on AWS](https://physionet.org/projects/mimiciii/1.4/request_access/2).
3414

3515
To start this deployment, click the Launch Stack button. On the first screen, the template link has already been specified, so just click next. On the second screen, provide a Stack name (letters and numbers) and click next, on the third screen, just click next. On the forth screen, at the bottom, there is a box that says **I acknowledge that AWS CloudFormation might create IAM resources.**. Check that box, and then click **Create**. Once the Stack has complete deploying, look at the **Outputs** tab of the AWS CloudFormation console for links to your Juypter Notebooks instance.
3616

@@ -45,9 +25,7 @@ To start this deployment, click the Launch Stack button. On the first screen, t
4525

4626
## Acknowledgement
4727

48-
If you use code or concepts available in this repository, we would be grateful if you would cite the above paper as follows:
49-
50-
> Johnson, Alistair EW, David J. Stone, Leo A. Celi, and Tom J. Pollard. "The MIMIC Code Repository: enabling reproducibility in critical care research." Journal of the American Medical Informatics Association (2017): ocx084.
28+
If you use code or concepts available in this repository, we would be grateful if you would add a citation as described on the website: [MIMIC-III citation](http://mimic.mit.edu//iii/about/acknowledgments/#mimic-iii-citation) , [MIMIC-IV citation](http://mimic.mit.edu/iv/overview/acknowledgments/#mimic-iv-citation)
5129

5230
If including a hyperlink to the code, we recommend you use the DOI from Zenodo rather than a GitHub URL: https://doi.org/10.5281/zenodo.821872
5331

@@ -59,12 +37,12 @@ Our team has worked hard to create and share the MIMIC dataset. We encourage you
5937
* Commit your changes to the forked repository.
6038
* Submit a pull request to the [MIMIC code repository](https://github.com/MIT-LCP/mimic-code), using the method described at: https://help.github.com/articles/using-pull-requests/
6139

62-
We encourage users to share concepts they have extracted by writing code which generates a materialized view. These materialized views can then be used by researchers around the world to speed up data extraction. For example, ventilation durations can be acquired by creating the ventdurations view in [concepts/durations/ventilation_durations.sql](https://github.com/MIT-LCP/mimic-code/blob/master/concepts/durations/ventilation_durations.sql).
40+
We encourage users to share concepts they have extracted by writing code which generates a materialized view. These materialized views can then be used by researchers around the world to speed up data extraction. For example, ventilation durations can be acquired by creating the ventdurations view in [concepts/durations/ventilation_durations.sql](https://github.com/MIT-LCP/mimic-code/tree/new_consol/mimic-iii/concepts/durations/ventilation_durations.sql).
6341

6442
### License
6543

66-
By committing your code to the [MIMIC Code Repository](https://github.com/mit-lcp/mimic-code) you agree to release the code under the [MIT License attached to the repository](https://github.com/mit-lcp/mimic-code/blob/master/LICENSE).
44+
By committing your code to the [MIMIC Code Repository](https://github.com/mit-lcp/mimic-code) you agree to release the code under the [MIT License attached to the repository](https://github.com/mit-lcp/mimic-code/blob/main/LICENSE).
6745

6846
### Coding style
6947

70-
Please refer to the [style guide](https://github.com/MIT-LCP/mimic-code/blob/master/styleguide.md) for guidelines on formatting your code for the repository.
48+
Please refer to the [style guide](https://github.com/MIT-LCP/mimic-code/blob/main/styleguide.md) for guidelines on formatting your code for the repository.

mimic-cxr/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# MIMIC-CXR
2+
3+
MIMIC-CXR is a publicly available database of chest x-rays with free-text radiology reports. You can read more about the dataset on [the PhysioNet project page](https://mimic.mit.edu//iv/modules/cxr/about/).
4+
5+
This repository is intended to support use of the data by providing code, documentation, and a central location for discussion (in the form of GitHub issues). Feedback and contributions are always welcome!

mimic-cxr/awesome-mimic-cxr.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Awesome MIMIC-CXR [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)
2+
3+
A curated list of MIMIC-CXR resources.
4+
5+
## Contributing
6+
7+
Please feel free to send in [pull requests](https://github.com/mit-lcp/mimic-cxr/pulls) to add links.
8+
9+
## Table of Contents
10+
11+
<!--
12+
- [Books](#books)
13+
- [Courses](#courses)
14+
- [Tutorials and Talks](#tutorials-and-talks)
15+
- [Resources for students](#resources-for-students)
16+
- [Blogs](#blogs)
17+
- [Links](#links)
18+
-->
19+
20+
- [Papers](#papers)
21+
- [Software](#software)
22+
- [Datasets](#datasets)
23+
24+
## Papers
25+
26+
## Software
27+
28+
## Datasets

0 commit comments

Comments
 (0)