Skip to content

utils/correction module

correction

Functions

preprocessing_compute 

preprocessing_compute(input_image: np.ndarray) -> np.ndarray

Preprocess the input image for computation by reshaping and converting datatype.

Parameters:

Name Type Description Default
input_image np.ndarray

Input image array that can be either a grid (24, 3) or a general image.

 required

Returns:

Type Description
np.ndarray

Processed image data as a float32 numpy array.
Source code in color_correction/utils/correction.py 
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
def preprocessing_compute(input_image: np.ndarray) -> np.ndarray:
    """
    Preprocess the input image for computation by reshaping and converting datatype.

    Parameters
    ----------
    input_image : np.ndarray
        Input image array that can be either a grid (24, 3) or a general image.

    Returns
    -------
    np.ndarray
        Processed image data as a float32 numpy array.
    """
    if input_image.shape == (24, 3):
        # to handle grid image patches only
        image = input_image.astype(np.float32)
    else:
        image = input_image.reshape(-1, 3).astype(np.float32)
    return image

postprocessing_compute 

postprocessing_compute(original_shape: tuple, predict_image: np.ndarray) -> np.ndarray

Convert predicted image data back into its original shape and type.

Parameters:

Name Type Description Default
original_shape tuple

The original dimensions of the image. Should be 2 or (H, W, C).

 required
predict_image np.ndarray

The processed image data to be reshaped and clipped.

 required

Returns:

Type Description
np.ndarray

The final corrected image, reshaped to original dimensions and in uint8 format.
Source code in color_correction/utils/correction.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
def postprocessing_compute(
    original_shape: tuple,
    predict_image: np.ndarray,
) -> np.ndarray:
    """
    Convert predicted image data back into its original shape and type.

    Parameters
    ----------
    original_shape : tuple
        The original dimensions of the image. Should be 2 or (H, W, C).
    predict_image : np.ndarray
        The processed image data to be reshaped and clipped.

    Returns
    -------
    np.ndarray
        The final corrected image, reshaped to original dimensions and in uint8 format.
    """
    if len(original_shape) == 2:
        # to handle grid image patches only
        corrected_image = np.clip(predict_image, 0, 255).astype(np.uint8)
    else:
        h, w, c = original_shape
        corrected_image = (
            np.clip(predict_image, 0, 255).astype(np.uint8).reshape(h, w, c)
        )
    return corrected_image