Phips commited on
Commit
eecef41
1 Parent(s): 9ac9cd4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +50 -3
README.md CHANGED
@@ -1,3 +1,50 @@
1
- ---
2
- license: cc-by-4.0
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: cc-by-4.0
3
+ pipeline_tag: image-to-image
4
+ tags:
5
+ - pytorch
6
+ ---
7
+
8
+ [Link to Github Release](https://github.com/Phhofm/models/releases/tag/Ludvae200)
9
+
10
+ # Ludvae200
11
+
12
+ Name: Ludvae200
13
+ License: CC BY 4.0
14
+ Author: Philip Hofmann
15
+ Network: [LUD-VAE](https://github.com/zhengdharia/LUD-VAE)
16
+ Scale: 1
17
+ Release Date: 25.03.2024
18
+ Purpose: 1x realistic noise degradation model
19
+ Iterations: 190'000
20
+ H_size: 64
21
+ n_channels: 3
22
+ dataloader_batch_size: 16
23
+ H_noise_level: 8
24
+ L_noise_level: 3
25
+ Dataset: [RealLR200](https://drive.google.com/drive/folders/1L2VsQYQRKhWJxe6yWZU9FgBWSgBCk6mz)
26
+ Number of train images: 200
27
+ OTF Training: No
28
+ Pretrained_Model_G: None
29
+
30
+ Description:
31
+ 1x realistic noise degradation model, trained on the [RealLR200](https://drive.google.com/drive/folders/1L2VsQYQRKhWJxe6yWZU9FgBWSgBCk6mz) dataset as found released on the [SeeSR](https://github.com/cswry/SeeSR) github repo.
32
+ Next to the ludvae200.pth model file, I provide a ludvae200.zip file which not only contains the code but also an inference script to run this model on the dataset of your choice.
33
+ Adapt the ludvae200_inference.py script accordingly by adjusting the file paths at the beginning section, to your input folder, output folder, the folder path holding the ludvae200.pth model, and a folder path where you want the text file to be generated. I made the textfile generation the same way as I did in [Kim's Dataset Destroyer](https://github.com/Kim2091/helpful-scripts/tree/main/Dataset%20Destroyer), which means you will have each image file logged with each of the values used to degrade that specific image file in the resulting text file, which will append only and never overwrite.
34
+
35
+ You can also adjust the strength settings inside the inference script file to fit to your needs. If you in general want less strong noise for example, you should adjust the temperature upper limit from 0.4 to 0.2 or go even lower.
36
+ So in line 96 change "temperature_strength = uniform(0.1,0.4)" to "temperature_strength = uniform(0.1,0.2)" just to give an example.
37
+
38
+ These values are defaulted to my needs of my last dataset degradation workflow I used, but feel free to adjust these values. You can also do the same as I did, temporarily using deterministic values with multiple runs to determine the min and max values of noise generation you deem suitable for your dataset needs.
39
+
40
+ An example of what this looked like for my last dataset workflow I used my model in:
41
+
42
+ Determining min and max values. Min value here is noise 1 temperature 0.1 which leads to visibly discernible noise, while max is simply the maximum degree of noise I would want my upscaling model trained on this dataset be able to handle from an input:
43
+
44
+ ![Ludvae200_range](https://github.com/Phhofm/models/assets/14755670/2cf53d9b-a601-4fea-9440-84c968a23e50)
45
+
46
+ Then simply three examples of what these settings will produce:
47
+
48
+ ![Ludvae200_example1](https://github.com/Phhofm/models/assets/14755670/ec81280a-777d-4e08-b2a5-65e5411f744c)
49
+ ![Ludvae200_example](https://github.com/Phhofm/models/assets/14755670/67b6178c-b5d3-43a2-b2e0-b6a3cfea6500)
50
+ ![Ludvae200_example2](https://github.com/Phhofm/models/assets/14755670/b0aba32a-e0fc-430b-aacf-7f1b160f2d0c)