{"id":15657914,"url":"https://github.com/koriavinash1/digitalhistopath","last_synced_at":"2025-10-05T04:26:21.474Z","repository":{"id":101326248,"uuid":"209698967","full_name":"koriavinash1/DigitalHistoPath","owner":"koriavinash1","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-28T17:58:32.000Z","size":382,"stargazers_count":24,"open_issues_count":17,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-30T22:25:15.478Z","etag":null,"topics":["camelyon","camelyon16","camelyon17","deep-learning","digestpath","digital-pathology","histopathology","paip","segmentation-models","uncertainty-quantification","whole-slide-imaging"],"latest_commit_sha":null,"homepage":"","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/koriavinash1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"ko_fi":"haranrk"}},"created_at":"2019-09-20T03:38:08.000Z","updated_at":"2024-12-20T07:24:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"2b935f37-2884-479b-96cd-baf2afbc1332","html_url":"https://github.com/koriavinash1/DigitalHistoPath","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/koriavinash1%2FDigitalHistoPath","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koriavinash1%2FDigitalHistoPath/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koriavinash1%2FDigitalHistoPath/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koriavinash1%2FDigitalHistoPath/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koriavinash1","download_url":"https://codeload.github.com/koriavinash1/DigitalHistoPath/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252534999,"owners_count":21763874,"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":["camelyon","camelyon16","camelyon17","deep-learning","digestpath","digital-pathology","histopathology","paip","segmentation-models","uncertainty-quantification","whole-slide-imaging"],"created_at":"2024-10-03T13:10:21.865Z","updated_at":"2025-10-05T04:26:16.422Z","avatar_url":"https://github.com/koriavinash1.png","language":"Jupyter Notebook","funding_links":["https://ko-fi.com/haranrk"],"categories":[],"sub_categories":[],"readme":"# DigitalHistoPath\n[![arXiv](https://img.shields.io/badge/arXiv-2001.00258-\u003cCOLOR\u003e.svg)](https://arxiv.org/abs/2001.00258)\n\nThis repository contains the code for the cancer analysis framework proposed in [the paper](https://www.nature.com/articles/s41598-021-90444-8) \"A Generalized Deep Learning Framework for Whole-Slide Image Segmentation and Analysis\"\n\n## Brief Overview of Framework \nThe framework consists of a segmentation algorithm optimized for histopathology tissue samples. A patch-based approach is utilized to break down the large size of these images.\n\nIt also has the code to empirically calculate the viable tumor burden. Viable tumor burden is the ratio of the viable tumor region to the whole tumor region. \n\nFor more details, you can refer to our paper.\n\nOur framework placed in several [grand-challenges](https://grand-challenge.org/challenges/):\n| Challenge Name      | Description                    |  Position |\n|---------------------|--------------------------------|-----------|\n| [PAIP 2019](https://paip2019.grand-challenge.org/) - Task 1  | Segmentation of Liver Cancer   | 3\u003csup\u003erd\u003c/sup\u003e       |\n| [PAIP 2019 ](https://paip2019.grand-challenge.org/) - Task 2  | Viable Tumor Burden Estimation | 2\u003csup\u003end\u003c/sup\u003e       |\n| [DigestPath 2019](https://digestpath2019.grand-challenge.org/Dataset/)     | Segmentation of Colon Cancer   | 4\u003csup\u003eth\u003c/sup\u003e       |\n\n## Instructions\nKindly note that this repository has been made available as it was at the time of writing our paper. You may have to modify hard-coded parameters present in the code (data locations, image sizes etc) for the scripts to work for you. Kindly write to us if you have any difficulty in doing so. \n\n### Training\nTraining is divided into two stages: \n1. Extraction of patches - Patch coordinates are extracted randomly and stored in text files\n1. Model training - The text files are used to train the models by generating the images on the fly\n\n\n#### Patch extraction\nThe `points_extractor.py` under `code_cm17/patch_extraction` is responsible for this.\n\n#### Model training\nRun the `trainer.py` file present under `code_cm17/trainer` to train the three models.\n\n### Inference\nEdit the `CONFIG` dictionary in `code_cm17/inference/predict.py` and run the script.\n\n## DigiPathAI\nWe packaged our inference pipeline into an full-fledged GUI application. Check it out [here](https://github.com/haranrk/DigiPathAI). It also contains our trained models for DigestPath and PAIP dataset.\n\n## Contact \n- Avinash Kori (koriavinash1@gmail.com)\n- Haran Rajkumar (haranrajkumar97@gmail.com)\n- Mahendra Khened (mahendrakhened@gmail.com)\n\n## Citation\nIf you find this reference implementation useful in your research, please consider citing:\n```\n@article{khened2020generalized,\n  title={A Generalized Deep Learning Framework for Whole-Slide Image Segmentation and Analysis},\n  author={Khened, Mahendra and Kori, Avinash and Rajkumar, Haran and Srinivasan, Balaji and Krishnamurthi, Ganapathy},\n  journal={arXiv preprint arXiv:2001.00258},\n  year={2020}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoriavinash1%2Fdigitalhistopath","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoriavinash1%2Fdigitalhistopath","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoriavinash1%2Fdigitalhistopath/lists"}