Skip to content

Commit 2d485c1

Browse files
committed
Remove the filters2, filters3 and filters5.
Too many filters will cause confusion for user too choose, only retain filters with better comprehensive evaluation quality. Signed-off-by: Liang <xiaoxia.liang@intel.com>
1 parent 36a694e commit 2d485c1

31 files changed

Lines changed: 28 additions & 86 deletions

README.md

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -29,15 +29,15 @@ Evaluating the quality of the RAISR can be done in different ways.
2929

3030
**Sharpest output**
3131
```
32-
./ffmpeg -i /input_files/input.mp4 -vf "raisr=threadcount=20:passes=2:filterfolder=filters5" -pix_fmt yuv420p /output_files/out.yuv
32+
./ffmpeg -i /input_files/input.mp4 -vf "raisr=threadcount=20:passes=2:filterfolder=filters4" -pix_fmt yuv420p /output_files/out.yuv
3333
```
3434
**Fastest Performance ( second pass disabled )**
3535
```
3636
./ffmpeg -i /input_files/input.mp4 -vf "raisr=threadcount=20:filterfolder=filters1" -pix_fmt yuv420p /output_files/out.yuv
3737
```
38-
**Medium sharpness**
38+
**Denoised output**
3939
```
40-
./ffmpeg -i /input_files/input.mp4 -vf "raisr=threadcount=20:passes=2:filterfolder=filters3" -pix_fmt yuv420p /output_files/out.yuv
40+
./ffmpeg -i /input_files/input.mp4 -vf "raisr=threadcount=20:passes=2:mode=2:filterfolder=filters6_denoise_and_upscale" -pix_fmt yuv420p /output_files/out.yuv
4141
```
4242
2. A source video or image can be downscaled by 2x, then passed through the RAISR filter which upscales by 2x
4343
```
@@ -85,17 +85,31 @@ Changes the number of software threads used in the algorithm. Values 1..120 wil
8585
### filterfolder
8686
Allowable values: (Any folder path containing the 4 required filter files: Qfactor_cohbin_2_8/10, Qfactor_strbin_2_8/10, filterbin_2_8/10, config), default (“filters1”)
8787

88-
Changing the way RAISR is trained (using different parameters and datasets) can alter the way RAISR's ML-based algorithms do upscale. For the current release, 5 filters have been provided: filters1, filters2, filters3, filters4 and filters5. Each filter has been generated with varying amounts of complexity and sharpness. For filters4 the 1st and 2nd pass filters both trained on sharpened HR as reference, for other filters only 2nd pass filters trained on shaprpened HR as reference
89-
and you can find the training informantion in filternotes.txt of each filters folder.
90-
91-
If doing a single pass ( passes=1 ), it is suggested to use filters1 or filters4. With passes=2 the 5 filters are described as:
92-
| filter name | filter complexity | sharpness |
93-
| ----------- | ----------------- | ----------- |
94-
| filters1 | 864x2 | high |
95-
| filters2 | 864x2 | low |
96-
| filters3 | 864x2 | medium |
97-
| filters4 | 864x2 | high |
98-
| filters5 | 32000x2 | high |
88+
Changing the way RAISR is trained (using different parameters and datasets) can alter the way RAISR's ML-based algorithms do upscale. For the current release, provides 3 filters for 2x upscaling and 2 filters for 1.5x upscaling. And for each filter you can find the training informantion in filternotes.txt of each filter folder.
89+
#### 2x upscaling filters
90+
The filters1, filters 4 and filters6_denoise_and_upscale are working on 2x upscaling.
91+
92+
##### filters1
93+
For 8bit the filters1 has both 1pass and 2pass filters, for 10bit only has 1pass filter.
94+
The 1pass filters is only for 2x upscaling not sharpening or denoising effect. The 2pass filters has 2x upscaling and sharpening effect.
95+
96+
##### filters4
97+
For 8bit/10bit has both 1pass and 2pass filters.
98+
The 1pass filters has 2x upscaling and sharpening effect and 2pass has more sharpening effect than 1pass.
99+
100+
##### filters6_denoise_and_upscale
101+
For 8bit/10bit has both 1pass and 2pass filters.
102+
The 1pass is only working denoise and 2pass is working on 2x upscaling and with sharpening effect. So it needs to set `passes=2` and `mode=2` to do 2x upscale and will get denosing and sharpening effect on 2x upscaling output.
103+
104+
#### 1.5x upscaling filters
105+
The filters15_1pass_denoise_and_upscale and filters15_2pass_denoise_and_upscale are working on 1.5x upscaling.
106+
107+
##### filters15_1pass_denoise_and_upscale
108+
The filter only has 1pass and the output will get 1.5x upscaling and denosing and sharpening effect.
109+
110+
##### filters15_2pass_denoise_and_upscale
111+
For 8bit/10bit has both 1pass and 2pass filters.
112+
The 1pass is only working on denosing and 2pass is working on 1.5x upscaling and with sharpening effect. So it needs to set `passes=2` and `mode=2` to do 1.5x upscale and will get denosing and sharpening effect on 1.5x upscaling output.
99113

100114
Please see the examples under the "Evaluating the Quality" section above where we suggest 3 command lines based upon preference.
101115
Note that for second pass to work, the filter folder must contain 3 additional files: Qfactor_cohbin_2_8/10_2, Qfactor_strbin_2_8/10_2, filterbin_2_8/10_2

filters2/Qfactor_cohbin_2_10

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_cohbin_2_10_2

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_cohbin_2_8

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_cohbin_2_8_2

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_strbin_2_10

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_strbin_2_10_2

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_strbin_2_8

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/Qfactor_strbin_2_8_2

Lines changed: 0 additions & 2 deletions
This file was deleted.

filters2/config

Lines changed: 0 additions & 1 deletion
This file was deleted.

0 commit comments

Comments
 (0)