{"id":18276246,"url":"https://github.com/hilab-git/ife_ai","last_synced_at":"2025-04-09T04:17:24.679Z","repository":{"id":48725515,"uuid":"181796138","full_name":"HiLab-git/IFE_AI","owner":"HiLab-git","description":null,"archived":false,"fork":false,"pushed_at":"2023-02-09T05:44:14.000Z","size":221,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T22:34:02.518Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HiLab-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2019-04-17T01:42:44.000Z","updated_at":"2022-07-23T08:50:42.000Z","dependencies_parsed_at":"2024-12-22T18:28:49.464Z","dependency_job_id":"4db18efa-525f-4107-acc5-d2e2a714e7e9","html_url":"https://github.com/HiLab-git/IFE_AI","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/HiLab-git%2FIFE_AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiLab-git%2FIFE_AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiLab-git%2FIFE_AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HiLab-git%2FIFE_AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HiLab-git","download_url":"https://codeload.github.com/HiLab-git/IFE_AI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247974734,"owners_count":21026742,"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-05T12:15:33.212Z","updated_at":"2025-04-09T04:17:24.660Z","avatar_url":"https://github.com/HiLab-git.png","language":"Python","readme":"# Immunofixation Electrophoresis (IFE) Image Recognition based on Deep Learning\nThis repository provides source code for IFE image recognition in the following paper:\n\n* Honghua Hu, Wei Xu et al. \"Expert-level Immunofixation Electrophoresis (IFE) Image Recognition based on Explainable and Generalizable Deep Learning\". Clinical Chemistry, 69, no. 2 (2023): 130-139.\n\nBibTeX entry:\n\n    @article{Hu2023IFE,\n    author = {Honghua Hu and Wei Xu and Ting Jiang and Yuheng Cheng and Xiaoyan Tao and Wenna Liu and Meiling Jian and Kang Li and Guotai Wang},\n    title = {Expert-Level Immunofixation Electrophoresis Image Recognition based on Explainable and Generalizable Deep Learning},\n    year = {2023},\n    url = {https://doi.org/10.1093/clinchem/hvac190},\n    journal = {Clinical Chemistry},\n    volume = {69},\n    issue = {2},\n    pages = {130-139},\n    }\n    \n# Requirements\n* [Pytorch][torch_link] version \u003e=1.9.0\n* [PyMIC][pymic_link], a Pytorch-based toolkit for medical image computing. Version 0.2.5 is required. Install it by `pip install PYMIC==0.2.5`.\n* Som basic python packages such as Numpy, Pandas, scipy.\n* See `requirements.txt` for more details\n\n# Image and preprocess\nThe images in this study are from two different systems that have different image styles (see `data/data_a` and `data/data_b`, respectively). We preprocess the images to make them have the same arrangement and size. The following figures show images before and after preprocessing.\n\n![image_a](./data/example_a.png) \n![image_b](./data/example_b.png)\n\nTo play with a demo for image preprocessing, run the following command:\n\n```\npython preprocess.py\n```\n\n# Demo for inference\nTo use the pretrained model for inference, download the checkpoints from [Google Drive][model_link] and save them to `ckpts`. Note that in the oringal paper, each of the three networks (VGG16, ResNet18 and MobileNetv2) has five checkpoints based on 5-fold cross validation. Due to the Google Drive space limit, we only upload one checkpoint for each network for model ensemble. \nRun the following script for inference:\n\n```\npython demo_inference.py\n```\n\nBy defualt, it uses the image `data/data_a/20200824_1012358442.jpg` from group `a` as an example. You can set different image names, such as an image from group `b` by editing line 72:\n\n```\nimg_name, group  =\"data/data_b/9971568DTouch64.jpg\", \"b\" \n```\n\n[torch_link]:https://pytorch.org\n[pymic_link]:https://github.com/HiLab-git/PyMIC\n[model_link]:https://drive.google.com/drive/folders/1w6e5omz_CdiOyGSViUOtWedM9kXGVr7J?usp=sharing\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhilab-git%2Fife_ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhilab-git%2Fife_ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhilab-git%2Fife_ai/lists"}