...

FromFloat

Targets:
image
volume
Image Types:float32

Convert an image from floating point representation to the specified data type.

This transform is designed to convert images from a normalized floating-point representation (typically with values in the range [0, 1]) to other data types, scaling the values appropriately.

Arguments
dtype
uint8
uint8

The desired output data type. Only 'uint8' is supported. Default: 'uint8'.

max_value
float | None

The maximum value for the output dtype. If None, 255 for uint8.

p
float
1

Probability of applying the transform. Default: 1.0.

Examples
>>> import numpy as np
>>> import albumentations as A
>>> transform = A.FromFloat(dtype='uint8', max_value=None, p=1.0)
>>> image = np.random.rand(100, 100, 3).astype(np.float32)  # Float image in [0, 1] range
>>> result = transform(image=image)
>>> uint8_image = result['image']
>>> assert uint8_image.dtype == np.uint8
>>> assert uint8_image.min() >= 0 and uint8_image.max() <= 255
Notes
  • This is the inverse transform for ToFloat.
  • Input images are expected to be in floating point format with values in the range [0, 1].
  • Output is uint8 with values scaled to [0, 255].
  • The transform uses the from_float function internally, which ensures output values are within the valid range for the specified dtype.