colour.RGB_colourspace_volume_coverage_MonteCarlo

colour.RGB_colourspace_volume_coverage_MonteCarlo(colourspace, coverage_sampler, samples=10000000.0, random_generator=<function random_triplet_generator>, random_state=None)[source]

Returns given RGB colourspace percentage coverage of an arbitrary volume.

Parameters
  • colourspace (RGB_Colourspace) – RGB colourspace to compute the volume coverage percentage.

  • coverage_sampler (object) – Python object responsible for checking the volume coverage.

  • samples (numeric, optional) – Samples count.

  • random_generator (generator, optional) – Random triplet generator providing the random samples.

  • random_state (RandomState, optional) – Mersenne Twister pseudo-random number generator to use in the random number generator.

Returns

Percentage coverage of volume.

Return type

float

Examples

>>> from colour.models import sRGB_COLOURSPACE as sRGB
>>> prng = np.random.RandomState(2)
>>> RGB_colourspace_volume_coverage_MonteCarlo(
...     sRGB, is_within_pointer_gamut, 10e3, random_state=prng)
... 
81...