Warning, /documentation/digikam-doc/maintenance_tools/maintenance_quality.rst is written in an unsupported language. File is not indexed.

 .. meta::
    :description: digiKam Maintenance Tool to Sort Image by Quality
    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, quality, pick-label, deep-learning
 
 .. metadata-placeholder
 
    :authors: - digiKam Team
 
    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
 
 .. _maintenance_quality:
 
 Image Quality Sorter
 ====================
 
 .. contents::
 
 .. figure:: images/maintenance_quality_sorter.webp
     :alt:
     :align: center
 
     The digiKam Maintenance Options for Image Quality Sorter
 
 The tool will parse the items to determine the **Quality** and sort them with the **Pick Label** properties in database as:
 
    - The **Red** flag for **Rejected**.
 
    - The **Yellow** flag for **Pending**.
 
    - The **Green** flag for **Accepted**.
 
 The Image Quality Sorter assigns Pick Labels to items according to the default settings in :menuselection:`Settings --> Configure digiKam...` and the **Image Quality Sorter** settings panel, or a dedicated settings tuned in this view.
 
 The quality **score** to determine the **Pick Label** property can be evaluated by two ways: using four basic factors sabotaging the images (**Blur**, **Noise**, **Exposure**, and **Compression**), or using a **deep learning neural network engine**.
 
 The first one helps to determine whether images are distorted by the basic factors, however it demands some drawbacks as fine-tuning from the user’s side and it cannot work along the aesthetic image processing.
 
 The second one uses an artificial intelligence approach based on `this model <https://expertphotography.com/aesthetic-photography/>`_ to predict the score. As deep-learning is an end-to-end solution, it doesn’t require hyper-parameter settings, and make this feature easier to use.
 
 .. note::
 
     Since it is a time consuming process it's a good idea to check Work on all processor cores and restrict the job to certain albums or tags. 
 
 All the **Image Quality Sorter** settings is described in :ref:`the dedicated section <imgqsort_settings>` from **Setup Application** section.
 
 The **Scan Mode** settings allows to configure how the database information for the items from the selected collection will be processed. **Clean all and re-scan** reset all data and scan items from scratch, **Scan non-assigned only** will be faster to process non registered items with **Pick Labels**.
 
 While the image quality sorting process is under progress, notification on the bottom right of main windows will be visible to indicate the amount of items already done.
 
 .. figure:: images/maintenance_quality_process.webp
     :alt:
     :align: center
 
     The digiKam Image Quality Sorter Process Running in the Background
 
 The quality sorting results will appears in :ref:`the Labels view <labels_view>` from the right sidebar.
 
 .. figure:: images/maintenance_pick_labels.webp
     :alt:
     :align: center
 
     The digiKam Pick Labels from Left Sidebar
 
 .. important::
 
    To run properly, the process needs the deep-learning model to download at the first run of digiKam. See :ref:`the Quick Start section <quick_start>` for details.