Skip to content

Commit 85cf440

Browse files
committed
update README.md
1 parent d08c483 commit 85cf440

1 file changed

Lines changed: 16 additions & 4 deletions

File tree

README.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Fast Open Image Signal Processor (fast-openISP)
22

3-
As told by its name, fast-openISP is a **faster** re-implementation of the [openISP](https://github.com/cruxopen/openISP) project.
3+
As told by its name, fast-openISP is a **faster** (and bugs-fixed) re-implementation of the [openISP](https://github.com/cruxopen/openISP) project.
44

55
Compared to C-style code in the official openISP repo, fast-openISP uses pure matrix implementations based on Numpy, and increases processing speed **over 300 times**.
66

@@ -26,13 +26,25 @@ Here is the running time in my Ryzen 7 1700 8-core 3.00GHz machine with the 1920
2626
|End-to-end pipeline|2894.41s|8.48s |
2727

2828

29+
# Usage
30+
31+
Clone this repo and run
32+
33+
```
34+
python demo.py
35+
```
36+
37+
The ISP outputs will be saved to `./raw` directory.
38+
39+
The only required package for pipeline execution is `Numpy`. `opencv-python` and `scikit-image` are required for data IO.
40+
2941
# Algorithms
3042

31-
All modules in fast-openISP reproduce processing algorithms in openISP, except for EEH and BCC modules.
43+
All modules in fast-openISP reproduce [processing algorithms](https://github.com/cruxopen/openISP/blob/master/docs/Image%20Signal%20Processor.pdf) in openISP, except for EEH and BCC modules.
3244

3345
### EEH (edge enhancement)
3446

35-
The official openISP uses the difference between the original and the gaussian-filtered Y-channel arrays as the edge map approximation. In fast-openISP, however, we replace gaussian with the bilateral filter, which gets better estimation to the edges, and consequently reduces the artifact when the enhancement gain is large.
47+
The official openISP uses the subtraction between the original and the gaussian-filtered Y-channel arrays as the edge map approximation. In fast-openISP, however, we replace gaussian with the bilateral filter, which gets better estimation to the edges, and consequently reduces the artifact when the enhancement gain is large. Besides, the processing to pixels in the non-edge region has been slightly improved.
3648

3749
### BCC (brightness & contrast control)
3850

@@ -41,7 +53,7 @@ The official openISP enhances the image contrast by pixel-wise enlarge the diffe
4153

4254
# Parameters
4355

44-
Tunable module parameters in fast-openISP are differently named from those in openISP, but they are all self-explained, and no doubt you can easily tell the counterparts in two repos. All parameters are managed in a yaml configuration file, and one yaml for one camera.
56+
Tunable module parameters in fast-openISP are differently named from those in openISP, but they are all self-explained, and no doubt you can easily tell the counterparts in two repos. All parameters are managed in a yaml configuration file, and one yaml for one camera.
4557

4658
# Demo
4759

0 commit comments

Comments
 (0)