|
1 | | -## Welcome to PyMIC Documentation |
| 1 | +## Welcome to PyMIC |
2 | 2 |
|
3 | | -This page is under construction, we will update it later. |
| 3 | +PyMIC is a pytorch-based toolkit for medical image computing with annotation-efficient deep learning. Despite that pytorch is a fantastic platform for deep learning, using it for medical image computing is not straightforward as medical images are often with high dimension and large volume, multiple modalities and difficulies in annotating. This toolkit is developed to facilitate medical image computing researchers so that training and testing deep learning models become easier. It is very friendly to researchers who are new to this area. Even without writing any code, you can use PyMIC commands to train and test a model by simply editing configuration files. PyMIC is developed to support learning with imperfect labels, including semi-supervised and weakly supervised learning, and learning with noisy annotations. |
| 4 | + |
| 5 | +Currently PyMIC supports 2D/3D medical image classification and segmentation, and it is still under development. It was originally developed for COVID-19 pneumonia lesion segmentation from CT images. |
4 | 6 |
|
5 | 7 | ### Features |
| 8 | +PyMIC provides flixible modules for medical image computing tasks including classification and segmentation. It currently provides the following functions: |
| 9 | +* Support for annotation-efficient image segmentation, especially for semi-supervised, weakly-supervised and noisy-label learning. |
| 10 | +* User friendly: For beginners, you only need to edit the configuration files for model training and inference, without writing code. For advanced users, you can customize different modules (networks, loss functions, training pipeline, etc) and easily integrate them into PyMIC. |
| 11 | +* Easy-to-use I/O interface to read and write different 2D and 3D images. |
| 12 | +* Various data pre-processing/transformation methods before sending a tensor into a network. |
| 13 | +* Implementation of typical neural networks for medical image segmentation. |
| 14 | +* Re-useable training and testing pipeline that can be transferred to different tasks. |
| 15 | +* Evaluation metrics for quantitative evaluation of your methods. |
6 | 16 |
|
7 | 17 | ### Installation |
| 18 | +Run the following command to install the current released version of PyMIC: |
8 | 19 |
|
9 | | -### Quick Start |
10 | | - |
11 | | -### Links |
12 | | -[API][api_link] |
13 | | - |
14 | | -[api_link]:API/index.html |
15 | | -### Markdown |
16 | | - |
17 | | -Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for |
18 | | - |
19 | | -```markdown |
20 | | -Syntax highlighted code block |
21 | | - |
22 | | -# Header 1 |
23 | | -## Header 2 |
24 | | -### Header 3 |
25 | | - |
26 | | -- Bulleted |
27 | | -- List |
28 | | - |
29 | | -1. Numbered |
30 | | -2. List |
31 | | - |
32 | | -**Bold** and _Italic_ and `Code` text |
33 | | - |
34 | | -[Link](url) and  |
| 20 | +```bash |
| 21 | +pip install PYMIC |
35 | 22 | ``` |
36 | 23 |
|
37 | | -For more details see [Basic writing and formatting syntax](https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax). |
| 24 | +Alternatively, you can download the source code for the latest version. Run the following command to compile and install: |
38 | 25 |
|
39 | | -### Jekyll Themes |
| 26 | +```bash |
| 27 | +python setup.py install |
| 28 | +``` |
40 | 29 |
|
41 | | -Your Pages site will use the layout and styles from the Jekyll theme you have selected in your [repository settings](https://github.com/HiLab-git/PyMIC/settings/pages). The name of this theme is saved in the Jekyll `_config.yml` configuration file. |
| 30 | +### Quick Start |
| 31 | +[PyMIC_examples][examples] provides some examples of starting to use PyMIC. At the beginning, you only need to edit the configuration files to select different datasets, networks and training methods for running the code. When you are more familiar with PyMIC, you can customize different modules in the PyMIC package. You can find both types of examples: |
42 | 32 |
|
43 | | -### Support or Contact |
| 33 | +[examples]: https://github.com/HiLab-git/PyMIC_examples |
44 | 34 |
|
45 | | -Having trouble with Pages? Check out our [documentation](https://docs.github.com/categories/github-pages-basics/) or [contact support](https://support.github.com/contact) and we’ll help you sort it out. |
0 commit comments