Skip to main content

Auto-Denoise

ci documentation pypi version gitter Code style: black

Auto-denoise (autoden) provides implementations for a small selection of unsupervised and self-supervised CNN denoising methods. These methods currently include:

  • Noise2Noise (N2N) - A self-supervised denoising method using pairs of images of the same object [1].
  • Noise2Void (N2V) - A self-supervised denoising method capable of working with a single image [2]. We have also implemented a later development of the method that can work with structured noise [3].
  • Deep Image Prior (DIP) - An unsupervised denoising/upsampling/deconvolution method that can also work with a single image [4].

We also provide example implementations of supervised denoising methods, and the tomography specific Noise2Inverse (N2I) method [5].

References:

  • [1] J. Lehtinen et al., “Noise2Noise: Learning Image Restoration without Clean Data,” in Proceedings of the 35th International Conference on Machine Learning, J. Dy and A. Krause, Eds., in Proceedings of Machine Learning Research, vol. 80. PMLR, 2018, pp. 2965–2974. https://proceedings.mlr.press/v80/lehtinen18a.html
  • [2] A. Krull, T.-O. Buchholz, and F. Jug, “Noise2Void - Learning Denoising From Single Noisy Images,” in 2019 IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR), IEEE, Jun. 2019, pp. 2124–2132. doi: 10.1109/CVPR.2019.00223.
  • [3] C. Broaddus, A. Krull, M. Weigert, U. Schmidt, and G. Myers, “Removing Structured Noise with Self-Supervised Blind-Spot Networks,” in 2020 IEEE 17th International Symposium on Biomedical Imaging (ISBI), IEEE, Apr. 2020, pp. 159–163. doi: 10.1109/ISBI45749.2020.9098336.
  • [4] V. Lempitsky, A. Vedaldi, and D. Ulyanov, “Deep Image Prior,” in 2018 IEEE/CVF Conference on Computer Vision and Pattern Recognition, IEEE, Jun. 2018, pp. 9446–9454. doi: 10.1109/CVPR.2018.00984.
  • [5] A. A. Hendriksen, D. M. Pelt, and K. J. Batenburg, "Noise2Inverse: Self-Supervised Deep Convolutional Denoising for Tomography," IEEE Transactions on Computational Imaging, vol. 6, pp. 1320–1335, 2020, doi: 10.1109/TCI.2020.3019647.

Getting Started

It takes just a few steps to setup Auto-Denoise on your machine.

Installing with conda

We recommend using Miniforge. Once installed miniforge, simply install autoden with:

conda install auto-denoise -c n-vigano

Installing from PyPI

Simply install with:

python -m pip install auto-denoise

If you are on jupyter, and don't have the rights to install packages system-wide, then you can install with:

! python -m pip install --user auto-denoise

Installing from source

To install Auto-Denoise, simply clone this github.com project with either:

git clone https://github.com/CEA-MetroCarac/auto-denoise.git auto-denoise

or:

git clone git@github.com:CEA-MetroCarac/auto-denoise.git auto-denoise

Then go to the cloned directory and run pip installer:

cd auto-denoise
pip install -e .

How to contribute

Contributions are always welcome. Please submit pull requests against the main branch.

If you have any issues, questions, or remarks, then please open an issue on github.com.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

auto_denoise-3.0.0.tar.gz (45.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

auto_denoise-3.0.0-py3-none-any.whl (57.6 kB view details)

Uploaded Python 3

File details

Details for the file auto_denoise-3.0.0.tar.gz.

File metadata

  • Download URL: auto_denoise-3.0.0.tar.gz
  • Upload date:
  • Size: 45.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.11

File hashes

Hashes for auto_denoise-3.0.0.tar.gz
Algorithm Hash digest
SHA256 63fe0b5f9b5a2c096705412b66372580562e205b025dbc6c2a622497e14ba0d4
MD5 dfe6b18a63a3e7b0bdc9ac6f5da0a5d5
BLAKE2b-256 fba858732f9468bfd0e098292b1f2d32d64be1dbea0ff946d6d556082e911c5f

See more details on using hashes here.

File details

Details for the file auto_denoise-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: auto_denoise-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 57.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.11

File hashes

Hashes for auto_denoise-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9619a8596a292ca5866741509e6ffe861256bcf5ea43fa4e9b2fb77f1425f7b9
MD5 e7c32c0789d1220f2a9eee96b8c5f63a
BLAKE2b-256 a017be5d49183b28ac37871c420702eb8989b804e156bfa5e9766d1bce72d779

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page