Skip to content

Commit 5f03b43

Browse files
committed
Merge branch 'docs' into dev
2 parents 78f98a4 + 959fd60 commit 5f03b43

File tree

118 files changed

+4351
-1454
lines changed

Some content is hidden

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

118 files changed

+4351
-1454
lines changed

docs/source/api.rst

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,16 @@
11
API
22
===
33

4-
.. autosummary::
5-
:toctree: generated
4+
.. toctree::
5+
:maxdepth: 4
66

7-
lumache
7+
pymic.io
8+
pymic.layer
9+
pymic.loss
10+
pymic.net
11+
pymic.net_run
12+
pymic.net_run_nll
13+
pymic.net_run_ssl
14+
pymic.net_run_wsl
15+
pymic.transform
16+
pymic.util

docs/source/conf.py

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
# Configuration file for the Sphinx documentation builder.
22

33
# -- Project information
4+
import os
5+
import sys
6+
sys.path.insert(0, os.path.abspath('./../..'))
47

58
project = 'PyMIC'
69
copyright = '2021, HiLab'

docs/source/index.rst

Lines changed: 36 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,48 @@
11
Welcome to PyMIC's documentation!
22
===================================
33

4-
PyMIC is a pytorch-based toolkit for medical image computing with annotation-efficient deep learning.
5-
PyMIC is developed to support learning with imperfect labels, including semi-supervised and weakly supervised learning, and learning with noisy annotations.
4+
PyMIC is a pytorch-based toolkit for medical image computing with annotation-efficient
5+
deep learning. PyMIC is developed to support learning with imperfect labels, including
6+
semi-supervised and weakly supervised learning, and learning with noisy annotations.
67

7-
Check out the :doc:`usage` section for further information, including
8-
how to :ref:`installation` the project.
8+
Check out the :doc:`installation` section for install PyMIC, and go to the :doc:`usage`
9+
section for understanding modules for the segmentation pipeline designed in PyMIC.
10+
Please follow `PyMIC_examples <https://github.com/HiLab-git/PyMIC_examples/>`_
11+
to quickly start with using PyMIC.
912

1013
.. note::
1114

1215
This project is under active development. It will be updated later.
1316

14-
Contents
15-
--------
1617

1718
.. toctree::
19+
:maxdepth: 2
20+
:caption: Getting Started
21+
22+
installation
23+
usage
24+
api
25+
26+
Citation
27+
--------
28+
29+
If you use PyMIC for your research, please acknowledge it accordingly by citing our paper:
30+
31+
`G. Wang, X. Luo, R. Gu, S. Yang, Y. Qu, S. Zhai, Q. Zhao, K. Li, S. Zhang. (2022).
32+
PyMIC: A deep learning toolkit for annotation-efficient medical image segmentation.
33+
arXiv, 2208.09350. <http://arxiv.org/abs/2208.09350>`_
34+
35+
36+
BibTeX entry:
37+
38+
.. code-block:: none
1839
19-
usage
20-
api
40+
@article{Wang2022pymic,
41+
author = {Guotai Wang and Xiangde Luo and Ran Gu and Shuojue Yang and Yijie Qu and Shuwei Zhai and Qianfei Zhao and Kang Li and Shaoting Zhang},
42+
title = {{PyMIC: A deep learning toolkit for annotation-efficient medical image segmentation}},
43+
year = {2022},
44+
url = {http://arxiv.org/abs/2208.09350},
45+
journal = {arXiv},
46+
volume = {2208.09350},
47+
pages = {1-10},
48+
}

docs/source/installation.rst

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
Installation
2+
============
3+
4+
Install PyMIC using pip (e.g., within a `Python virtual environment <https://www.geeksforgeeks.org/python-virtual-environment/>`_):
5+
6+
.. code-block:: bash
7+
8+
pip install PYMIC
9+
10+
11+
Alternatively, you can download or clone the code from `GitHub <https://github.com/HiLab-git/PyMIC>`_ and install PyMIC by
12+
13+
.. code-block:: bash
14+
15+
git clone https://github.com/HiLab-git/PyMIC
16+
cd PyMIC
17+
python setup.py install
18+
19+
20+
PyMIC requires Python 3.6 (or higher) and depends on the following packages:
21+
22+
- `pandas <https://pandas.pydata.org/>`_
23+
- `h5py <https://www.h5py.org/>`_
24+
- `NumPy <https://numpy.org/>`_
25+
- `scikit-image <https://scikit-image.org/>`_
26+
- `SciPy <https://www.scipy.org/>`_
27+
- `SimpleITK <https://simpleitk.org/>`_

docs/source/modules.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
pymic
2+
=====
3+
4+
.. toctree::
5+
:maxdepth: 4
6+
7+
pymic

docs/source/pymic.io.rst

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
pymic.io package
2+
================
3+
4+
Submodules
5+
----------
6+
7+
pymic.io.h5\_dataset module
8+
---------------------------
9+
10+
.. automodule:: pymic.io.h5_dataset
11+
:members:
12+
:undoc-members:
13+
:show-inheritance:
14+
15+
pymic.io.image\_read\_write module
16+
----------------------------------
17+
18+
.. automodule:: pymic.io.image_read_write
19+
:members:
20+
:undoc-members:
21+
:show-inheritance:
22+
23+
pymic.io.nifty\_dataset module
24+
------------------------------
25+
26+
.. automodule:: pymic.io.nifty_dataset
27+
:members:
28+
:undoc-members:
29+
:show-inheritance:
30+
31+
Module contents
32+
---------------
33+
34+
.. automodule:: pymic.io
35+
:members:
36+
:undoc-members:
37+
:show-inheritance:

docs/source/pymic.layer.rst

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
pymic.layer package
2+
===================
3+
4+
Submodules
5+
----------
6+
7+
pymic.layer.activation module
8+
-----------------------------
9+
10+
.. automodule:: pymic.layer.activation
11+
:members:
12+
:undoc-members:
13+
:show-inheritance:
14+
15+
pymic.layer.convolution module
16+
------------------------------
17+
18+
.. automodule:: pymic.layer.convolution
19+
:members:
20+
:undoc-members:
21+
:show-inheritance:
22+
23+
pymic.layer.deconvolution module
24+
--------------------------------
25+
26+
.. automodule:: pymic.layer.deconvolution
27+
:members:
28+
:undoc-members:
29+
:show-inheritance:
30+
31+
pymic.layer.space2channel module
32+
--------------------------------
33+
34+
.. automodule:: pymic.layer.space2channel
35+
:members:
36+
:undoc-members:
37+
:show-inheritance:
38+
39+
Module contents
40+
---------------
41+
42+
.. automodule:: pymic.layer
43+
:members:
44+
:undoc-members:
45+
:show-inheritance:

docs/source/pymic.loss.cls.rst

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
pymic.loss.cls package
2+
======================
3+
4+
Submodules
5+
----------
6+
7+
pymic.loss.cls.basic module
8+
------------------------
9+
10+
.. automodule:: pymic.loss.cls.basic
11+
:members:
12+
:undoc-members:
13+
:show-inheritance:
14+
15+
pymic.loss.cls.util module
16+
--------------------------
17+
18+
.. automodule:: pymic.loss.cls.util
19+
:members:
20+
:undoc-members:
21+
:show-inheritance:
22+
23+
Module contents
24+
---------------
25+
26+
.. automodule:: pymic.loss.cls
27+
:members:
28+
:undoc-members:
29+
:show-inheritance:

docs/source/pymic.loss.rst

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
pymic.loss package
2+
==================
3+
4+
Subpackages
5+
-----------
6+
7+
.. toctree::
8+
:maxdepth: 4
9+
10+
pymic.loss.cls
11+
pymic.loss.seg
12+
13+
Submodules
14+
----------
15+
16+
pymic.loss.loss\_dict\_cls module
17+
---------------------------------
18+
19+
.. automodule:: pymic.loss.loss_dict_cls
20+
:members:
21+
:undoc-members:
22+
:show-inheritance:
23+
24+
pymic.loss.loss\_dict\_seg module
25+
---------------------------------
26+
27+
.. automodule:: pymic.loss.loss_dict_seg
28+
:members:
29+
:undoc-members:
30+
:show-inheritance:
31+
32+
Module contents
33+
---------------
34+
35+
.. automodule:: pymic.loss
36+
:members:
37+
:undoc-members:
38+
:show-inheritance:

docs/source/pymic.loss.seg.rst

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
pymic.loss.seg package
2+
======================
3+
4+
Submodules
5+
----------
6+
7+
pymic.loss.seg.abstract module
8+
------------------------
9+
10+
.. automodule:: pymic.loss.seg.abstract
11+
:members:
12+
:undoc-members:
13+
:show-inheritance:
14+
15+
pymic.loss.seg.ce module
16+
------------------------
17+
18+
.. automodule:: pymic.loss.seg.ce
19+
:members:
20+
:undoc-members:
21+
:show-inheritance:
22+
23+
pymic.loss.seg.combined module
24+
------------------------------
25+
26+
.. automodule:: pymic.loss.seg.combined
27+
:members:
28+
:undoc-members:
29+
:show-inheritance:
30+
31+
pymic.loss.seg.deep\_sup module
32+
-------------------------------
33+
34+
.. automodule:: pymic.loss.seg.deep_sup
35+
:members:
36+
:undoc-members:
37+
:show-inheritance:
38+
39+
pymic.loss.seg.dice module
40+
--------------------------
41+
42+
.. automodule:: pymic.loss.seg.dice
43+
:members:
44+
:undoc-members:
45+
:show-inheritance:
46+
47+
pymic.loss.seg.exp\_log module
48+
------------------------------
49+
50+
.. automodule:: pymic.loss.seg.exp_log
51+
:members:
52+
:undoc-members:
53+
:show-inheritance:
54+
55+
pymic.loss.seg.gatedcrf module
56+
------------------------------
57+
58+
.. automodule:: pymic.loss.seg.gatedcrf
59+
:members:
60+
:undoc-members:
61+
:show-inheritance:
62+
63+
pymic.loss.seg.mse module
64+
-------------------------
65+
66+
.. automodule:: pymic.loss.seg.mse
67+
:members:
68+
:undoc-members:
69+
:show-inheritance:
70+
71+
pymic.loss.seg.mumford\_shah module
72+
-----------------------------------
73+
74+
.. automodule:: pymic.loss.seg.mumford_shah
75+
:members:
76+
:undoc-members:
77+
:show-inheritance:
78+
79+
pymic.loss.seg.slsr module
80+
--------------------------
81+
82+
.. automodule:: pymic.loss.seg.slsr
83+
:members:
84+
:undoc-members:
85+
:show-inheritance:
86+
87+
pymic.loss.seg.ssl module
88+
-------------------------
89+
90+
.. automodule:: pymic.loss.seg.ssl
91+
:members:
92+
:undoc-members:
93+
:show-inheritance:
94+
95+
pymic.loss.seg.util module
96+
--------------------------
97+
98+
.. automodule:: pymic.loss.seg.util
99+
:members:
100+
:undoc-members:
101+
:show-inheritance:
102+
103+
Module contents
104+
---------------
105+
106+
.. automodule:: pymic.loss.seg
107+
:members:
108+
:undoc-members:
109+
:show-inheritance:

0 commit comments

Comments
 (0)