SortPitch

class tools.sort.sort_methods_aligned.SortPitch(arguments: Namespace, loader_type: T.Literal['face', 'meta', 'all'] = 'meta', is_group: bool = False)

Bases: SortAlignedMetric

Sorting mechanism for sorting a face by pitch (down to up)

Attributes Summary

bin_names	The name of each created bin, if they exist, otherwise an empty list
binned	List of bins (list) containing the filenames belonging to the bin.
loader_type	The loader that this sorter uses
sorted_filelist	List of sorted filenames for given sorter in a single list.

Methods Summary

binning()	Create bins from 0 degrees to 180 degrees based on number of bins
score_image(filename, image, alignments)	Score a single image for sort method: "distance", "yaw", "pitch" or "size" and add the result to _result
sort()	Sort by metric score.

Attributes Documentation

Parameters:

• arguments (Namespace)

• loader_type (T.Literal['face', 'meta', 'all'])

• is_group (bool)

bin_names

The name of each created bin, if they exist, otherwise an empty list

binned

List of bins (list) containing the filenames belonging to the bin. The binning process is called when this property is first accessed

loader_type

The loader that this sorter uses

Type:

[“face”, “meta”, “all”]

sorted_filelist

List of sorted filenames for given sorter in a single list. The sort process is called when this property is first accessed

Methods Documentation

binning() → list[list[str]]

Create bins from 0 degrees to 180 degrees based on number of bins

Allocate item to bin when it is in range of one of the pre-allocated bins

Returns:

List of bins of filenames

Return type:

list

score_image(filename: str, image: np.ndarray | None, alignments: PNGAlignments | None) → None

Score a single image for sort method: “distance”, “yaw”, “pitch” or “size” and add the result to _result

Parameters:

• filename (str) – The filename of the currently processing image

• image (np.ndarray or None) – A face image loaded from disk or None

• alignments (dict or None) – The alignments dictionary for the aligned face or None

Return type:

None

sort() → None

Sort by metric score. Order in reverse for distance sort.

Return type:

None

binning() → list[list[str]]

Create bins from 0 degrees to 180 degrees based on number of bins

Allocate item to bin when it is in range of one of the pre-allocated bins

Returns:

List of bins of filenames

Return type:

list