libera_utils.scene_id.calculate_cloud_fraction

libera_utils.scene_id.calculate_cloud_fraction(clear_area: float | ndarray[Any, dtype[floating]]) → float | ndarray[Any, dtype[floating]]

Calculate cloud fraction from clear sky area percentage.

Parameters:

clear_area (float or ndarray) – Clear area percentage (0-100)

Returns:

Cloud fraction percentage (0-100), calculated as 100 - clear_area

Return type:

float or ndarray

Raises:

ValueError – If clear_area contains values less than 0 or greater than 100

Examples

>>> calculate_cloud_fraction(30.0)
70.0
>>> calculate_cloud_fraction(np.array([10, 25, 90]))
array([90, 75, 10])