Skip to content

Commit 3b2e534

Browse files
committed
update readme
1 parent 0d82df7 commit 3b2e534

1 file changed

Lines changed: 25 additions & 16 deletions

File tree

README.md

Lines changed: 25 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,17 @@
11
# SimpleCRF
22
Matlab and Python wrap of Conditional Random Field (CRF) and fully connected (dense) CRF for 2D and 3D image segmentation, according to the following papers:
33

4-
[1] Yuri Boykov and Vladimir Kolmogorov, "An experimental comparison of min-cut/max-flow algorithms for energy minimization in vision", in IEEE TPAMI, 2004.
5-
6-
Pushmeet Kohli and Philip H.S. Torr. "Efficiently solving dynamic markov random fields using graph cuts", ICCV, 2005
4+
[1] Yuri Boykov and Vladimir Kolmogorov, "An experimental comparison of min-cut/max-flow algorithms for energy minimization in vision", IEEE TPAMI, 2004.
75

86
[2] Philipp Krähenbühl and Vladlen Koltun, "Efficient inference in fully connected crfs with gaussian edge potentials", in NIPS, 2011.
97

10-
[3] Kamnitsas et al. "Multi-scale 3D convolutional neural networks for lesion segmentation in brain MRI", in Proceeding of ISLES challenge, MICCAI, 2015.
8+
[3] Kamnitsas et al in "Efficient multi-scale 3D CNN with fully connected CRF for accurate brain lesion segmentation", Medical Image Analysis, 2017.
119

1210
![maxflow](./data/maxflow.png)
1311
![densecrf1](./data/densecrf1.png)
1412
![densecrf2](./data/densecrf2.png)
1513

16-
# Dependency
14+
### Dependency
1715
This repository depends on the following packages:
1816

1917
* Maxflow https://vision.cs.uwaterloo.ca/code/
@@ -22,7 +20,16 @@ This repository depends on the following packages:
2220

2321
* 3D Dense CRF https://github.com/deepmedic/dense3dCrf
2422

25-
# Examples
23+
### Installation
24+
1. Install with pip: [`pip install SimpleCRF`][https://github.com/taigw/SimpleCRF]
25+
26+
2. Alternatively, you can compile the source files by the following two steps:
27+
```bash
28+
python setup.py build
29+
python setup.py install
30+
```
31+
32+
### Examples
2633
Some demos of using this package are:
2734

2835
* `examples/demo_maxflow.py`: using maxflow for automatic and interactive segmentation of 2D and 3D images.
@@ -31,22 +38,24 @@ Some demos of using this package are:
3138

3239
* `examples/demo_densecrf3d.py`: using 3D dense CRF for 3D multi-modal image segmentation.
3340

34-
# Modules
35-
1, `maxflow` has four functions as follows. Note that the current version only supports binary segmentation.
41+
### Modules
42+
1. `maxflow` has four functions as follows. Note that the current version only supports binary segmentation.
43+
44+
* `maxflow.maxflow2d()` for 2D automatic segmentation.
45+
46+
* `maxflow.interactive_maxflow2d()` for 2D interactive segmentation.
3647

37-
* maxflow.maxflow2d() for 2D automatic segmentation.
48+
* `maxflow.maxflow3d()` for 3D automatic segmentation.
3849

39-
* maxflow.interactive_maxflow2d() for 2D interactive segmentation.
50+
* `maxflow.interactive_maxflow3d()` for 3D interactive segmentation.
4051

41-
* maxflow.maxflow3d() for 3D automatic segmentation.
52+
2. `denseCRF` has the following function. It can deal with multi-class segmentation, and only supports RGB images.
4253

43-
* maxflow.interactive_maxflow3d() for 3D interactive segmentation.
54+
* `denseCRF.densecrf()` for 2D automatic segmentation.
4455

45-
2, `denseCRF` has the following function. It can deal with multi-class segmentation, and only supports RGB images.
56+
3. `denseCRF3D` has the following function. It can deal with multi-class segmentation. The input channel number can be 1-5.
4657

47-
* denseCRF.densecrf() for 2D automatic segmentation.
58+
* `denseCRF3D.densecrf3d()` for 3D automatic segmentation.
4859

49-
2, `denseCRF3D` has the following function. It can deal with multi-class segmentation, and the input channel number can be 1-5.
5060

51-
* denseCRF3D.densecrf3d() for 3D automatic segmentation.
5261

0 commit comments

Comments
 (0)