diff --git a/CHANGELOG.md b/CHANGELOG.md index 0322f6e..6130890 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,11 +5,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] -### Added -- [Random color training option](https://github.com/faceshiftlabs/DeepFaceLab/tree/feature/random-color) -- [MS-SSIM loss training option](https://github.com/faceshiftlabs/DeepFaceLab/tree/feature/ms-ssim-loss-2) ### In Progress +- [MS-SSIM loss training option](https://github.com/faceshiftlabs/DeepFaceLab/tree/feature/ms-ssim-loss-2) - [Freezeable layers (encoder/decoder/etc.)](https://github.com/faceshiftlabs/DeepFaceLab/tree/feature/freezable-weights) +- [GAN stability improvements](https://github.com/faceshiftlabs/DeepFaceLab/tree/feature/gan-updates) + +## [1.2.0] - 2020-03-17 +### Added +- [Random color training option](doc/features/random-color/README.md) ## [1.1.5] - 2020-03-16 ### Fixed @@ -42,7 +45,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Reset stale master branch to [seranus/DeepFaceLab](https://github.com/seranus/DeepFaceLab), 21 commits ahead of [iperov/DeepFaceLab](https://github.com/iperov/DeepFaceLab) ([compare](https://github.com/iperov/DeepFaceLab/compare/4818183...seranus:3f5ae05)) -[Unreleased]: https://github.com/olivierlacan/keep-a-changelog/compare/v1.1.5...HEAD +[Unreleased]: https://github.com/olivierlacan/keep-a-changelog/compare/v1.2.0...HEAD +[1.2.0]: https://github.com/faceshiftlabs/DeepFaceLab/compare/v1.1.5...v1.2.0 [1.1.5]: https://github.com/faceshiftlabs/DeepFaceLab/compare/v1.1.4...v1.1.5 [1.1.4]: https://github.com/faceshiftlabs/DeepFaceLab/compare/v1.1.3...v1.1.4 [1.1.3]: https://github.com/faceshiftlabs/DeepFaceLab/compare/v1.1.2...v1.1.3 diff --git a/doc/features/random-color/README.md b/doc/features/random-color/README.md new file mode 100644 index 0000000..8d8298c --- /dev/null +++ b/doc/features/random-color/README.md @@ -0,0 +1,22 @@ +# Random Color option + +Helps train the model to generalize perceptual color and lightness, and improves color transfer between src and dst. + +- [DESCRIPTION](#description) +- [USAGE](#usage) + +![](example.jpeg) + +## DESCRIPTION + +Converts images to [CIE L\*a\*b* colorspace](https://en.wikipedia.org/wiki/CIELAB_color_space), +and then randomly rotates around the `L*` axis. While the perceptual lightness stays constant, only the `a*` and `b*` +color channels are modified. After rotation, converts back to BGR (blue/green/red) colorspace. + +If visualized using the [CIE L\*a\*b* cylindical model](https://en.wikipedia.org/wiki/CIELAB_color_space#Cylindrical_model), +this is a random rotation of `h°` (hue angle, angle of the hue in the CIELAB color wheel), +maintaining the same `C*` (chroma, relative saturation). + +## USAGE + +`[n] Random color ( y/n ?:help ) : y` diff --git a/doc/features/random-color/example.jpeg b/doc/features/random-color/example.jpeg new file mode 100644 index 0000000..2a69632 Binary files /dev/null and b/doc/features/random-color/example.jpeg differ