{"id":18365341,"url":"https://github.com/mit-lcp/hack-aotearoa","last_synced_at":"2025-07-09T07:08:40.610Z","repository":{"id":37620620,"uuid":"234229217","full_name":"MIT-LCP/hack-aotearoa","owner":"MIT-LCP","description":"Sample code for Hack Aotearoa 2023","archived":false,"fork":false,"pushed_at":"2024-06-17T23:17:06.000Z","size":498,"stargazers_count":9,"open_issues_count":2,"forks_count":6,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-15T19:51:17.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://hackaotearoa.co.nz/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MIT-LCP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-16T03:43:20.000Z","updated_at":"2023-11-14T18:37:25.000Z","dependencies_parsed_at":"2024-12-24T00:27:30.489Z","dependency_job_id":"080871fe-f3f1-431b-8bdc-8641f309f7fe","html_url":"https://github.com/MIT-LCP/hack-aotearoa","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MIT-LCP%2Fhack-aotearoa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MIT-LCP%2Fhack-aotearoa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MIT-LCP%2Fhack-aotearoa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MIT-LCP%2Fhack-aotearoa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MIT-LCP","download_url":"https://codeload.github.com/MIT-LCP/hack-aotearoa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248225656,"owners_count":21068078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T23:13:12.985Z","updated_at":"2025-04-10T13:18:18.066Z","avatar_url":"https://github.com/MIT-LCP.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hack Aotearoa 2023 (March 17th to March 19th 2023)\n\nThis repository contains resources for [Hack Aotearoa 2023](http://hackaotearoa.nz)\n\n## Contents\n\n1. Getting started\n2. Documentation\n3. Databases on BigQuery\n4. Analysing data with Google Colab\n5. Python notebooks that we prepared earlier\n6. An example in R\n7. Sample projects\n8. Miscellaneous resources!\n\n\n## 1. Getting started\n\nThe datasets are hosted on Google Cloud, which requires a Gmail account to manage permissions.\n\n1. Create a [Gmail account](https://www.google.com/gmail/about/), if you don't already have one. It will be used to manage your access to the resources.\n2. Complete the form at: https://uoaevents.eventsair.com/hack-aotearoa-2023/dua2023/Site/Register.\n\n## 2. Documentation\n\n- MIMIC Clinical Database: https://mimic.physionet.org/\n- eICU Collaborative Research Database: https://eicu-crd.mit.edu/\n- MIMIC Code Repository: https://github.com/MIT-LCP/mimic-code (code for reuse!)\n\n## 3. Databases on BigQuery\n\nBigQuery is a database system that makes it easy to explore data with Structured Query Language (\"SQL\"). There are several datasets on BigQuery available for you to explore, including `eicu_crd` (the eICU Collaborative Research Database) and `mimiciii_clinical` (the MIMIC-III Clinical Database).\n\nYou will also find \"derived\" databases, which include tables derived from the original data using the code in the [eICU](https://github.com/MIT-LCP/eicu-code) and [MIMIC](https://github.com/MIT-LCP/mimic-code) code repositories. These are helpful if you are looking for something like a sepsis cohort or first day vital signs.\n\n1. [Open BigQuery](https://console.cloud.google.com/bigquery?project=physionet-data).\n2. At the top of the console, select `hack-aotearoa` as the project. This indicates the account used for billing.\n\u003c!-- 3. \"Pin\" a project to the resources menu to view available datasets. In the Resources menu on the left, click \"Add data\", \"Pin a project\", then add the following project names: `physionet-data` and `hack-aotearoa`. --\u003e\n3. You should be able preview the data available on these projects using the graphical interface.\n4. Now try running a query. For example, try counting the number of rows in the demo eICU patient table:\n\n   ```SQL\n   SELECT count(*)\n   FROM `physionet-data.eicu_crd_demo.patient` \n   ```\n\n## 4. Analysing data with Google Colab\n\nPython is an increasingly popular programming language for analysing data. We will explore the data using Python notebooks, which allow code and text to be combined into executable documents. First, try opening a blank document using the link below:\n\n- [https://colab.research.google.com/](https://colab.research.google.com/)\n\n## 5. Python notebooks that we prepared earlier\n\nSeveral tutorials are provided below. Requirements for these notebooks are: (1) you have a Gmail account and (2) your Gmail address has been added to the appropriate Google Group by the workshop hosts.\n\nNotebook 1 (eICU): Exploring the patient table. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/01_explore_patients.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 2 (eICU): Severity of illness. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/02_severity_of_illness.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 3 (eICU): Summary statistics. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/03_summary_statistics.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 4 (eICU): Timeseries. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/04_timeseries.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 5 (eICU): Mortality prediction. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/05_mortality_prediction.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 6 (eICU): Acute kidney injury. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/06_aki_project.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 7 (eICU): Project work. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/07_project_work.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 8 (MIMIC): MIMIC-III tutorial. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/mimic-iii-tutorial.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 9 (MIMIC): Weekend effect on mortality. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/mimic-weekend-effect.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\nNotebook 10 (MIMIC): Mortality in septic patients. \u003ca href=\"https://colab.research.google.com/github/MIT-LCP/hack-aotearoa/blob/master/mortality_in_septic_patients.ipynb\" target=\"_parent\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/\u003e\u003c/a\u003e\n\n## 6. An example in R\n\nIf you prefer working in R, then you can connect to Google Cloud from your code in a similar way:\n\n- https://github.com/MIT-LCP/hack-aotearoa/blob/master/mimic-iii-los.rmd\n\n## 7. Sample projects\n\nThese papers and repositories may be helpful for reference. They are **not** perfect! Code may be untidy, poorly documented, buggy, outdated etc. Think about how they can be improved, adapted, etc. For example, you could:\n\n- replicate the study on a different dataset (e.g. MIMIC vs eICU)\n- improve the methodology\n\n1. The association between mortality among patients admitted to the intensive care unit on a weekend compared to a weekday\n\n- Python Notebook: https://github.com/MIT-LCP/bhi-bsn-challenge/blob/master/challenge-demo.ipynb\n- R Markdown Notebook: https://github.com/MIT-LCP/bhi-bsn-challenge/blob/master/rmarkdown_example_notebook.Rmd\n- More reading: https://physionet.org/content/bhi-2018-challenge/1.0/\n\n2. Predicting in-hospital mortality of intensive care patients using decision trees.\n\n- Python Notebook: https://github.com/MIT-LCP/2019_aarhus_critical_data/blob/master/tutorials/eicu/05-prediction.ipynb \n\n3. Comparison of methods for identifying patients with sepsis.\n\n- Code: https://github.com/alistairewj/sepsis3-mimic\n- Paper: https://www.ncbi.nlm.nih.gov/pubmed/29303796\n\n4. Evaluating the reproducibility of mortality prediction studies that use the MIMIC-III database. \n\n- Code: https://github.com/alistairewj/reproducibility-mimic/blob/master/notebooks/reproducibility.ipynb\n- Paper: http://proceedings.mlr.press/v68/johnson17a.html\n\n5. Optimising treatment of sepsis with reinforcement learning\n\n- Code: https://github.com/matthieukomorowski/AI_Clinician\n- Paper: https://www.nature.com/articles/s41591-018-0213-5\n\n6. Association of hypokalemia with an increased risk for medically treated arrhythmia\n\n- Code: https://github.com/nus-mornin-lab/PotassiumAA\n- Paper: https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0217432\n\n## 8. Resources\n\n- Tutorial on decision trees for mortality prediction: https://carpentries-incubator.github.io/machine-learning-trees-python/\n- Tutorial on responsible machine learning: https://carpentries-incubator.github.io/machine-learning-responsible-python/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-lcp%2Fhack-aotearoa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmit-lcp%2Fhack-aotearoa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-lcp%2Fhack-aotearoa/lists"}