colour.phenomenons Package¶

Sub-Modules¶

Module Contents¶

colour.phenomenons.scattering_cross_section(wavelength, CO2_concentration=300, temperature=288.15, avogadro_constant=6.02214179e+23, n_s=<function air_refraction_index_Bodhaine1999 at 0x2adc48ef56e0>, F_air=<function F_air_Bodhaine1999 at 0x2adc48ef59b0>)¶

Returns the scattering cross section per molecule \(\sigma\) of dry air as function of wavelength \(\lambda\) in centimeters (cm) using given \(CO_2\) concentration in parts per million (ppm) and temperature \(T[K]\) in kelvin degrees following Van de Hulst (1957) method.

Parameters:	wavelength (numeric or array_like) – Wavelength \(\lambda\) in centimeters (cm). CO2_concentration (numeric or array_like, optional) – \(CO_2\) concentration in parts per million (ppm). temperature (numeric or array_like, optional) – Air temperature \(T[K]\) in kelvin degrees. avogadro_constant (numeric or array_like, optional) – Avogadro‘s number (molecules \(mol^{-1}\)). n_s (object) – Air refraction index \(n_s\) computation method. F_air (object) – \((6+3_p)/(6-7_p)\), the depolarisation term \(F(air)\) or King Factor computation method.
Returns:	Scattering cross section per molecule \(\sigma\) of dry air.
Return type:	numeric or ndarray

Warning

Unlike most objects of colour.phenomenons.rayleigh module, colour.phenomenons.rayleigh.scattering_cross_section() expects wavelength \(\lambda\) to be expressed in centimeters (cm).

Examples

>>> scattering_cross_section(555 * 10e-8)  
4.6613309...e-27

colour.phenomenons.rayleigh_optical_depth(wavelength, CO2_concentration=300, temperature=288.15, pressure=101325, latitude=0, altitude=0, avogadro_constant=6.02214179e+23, n_s=<function air_refraction_index_Bodhaine1999 at 0x2adc48ef56e0>, F_air=<function F_air_Bodhaine1999 at 0x2adc48ef59b0>)¶

Returns the rayleigh optical depth \(T_r(\lambda)\) as function of wavelength \(\lambda\) in centimeters (cm).

Parameters:	wavelength (numeric or array_like) – Wavelength \(\lambda\) in centimeters (cm). CO2_concentration (numeric or array_like, optional) – \(CO_2\) concentration in parts per million (ppm). temperature (numeric or array_like, optional) – Air temperature \(T[K]\) in kelvin degrees. pressure (numeric or array_like) – Surface pressure \(P\) of the measurement site. latitude (numeric or array_like, optional) – Latitude of the site in degrees. altitude (numeric or array_like, optional) – Altitude of the site in meters. avogadro_constant (numeric or array_like, optional) – Avogadro‘s number (molecules \(mol^{-1}\)). n_s (object) – Air refraction index \(n_s\) computation method. F_air (object) – \((6+3_p)/(6-7_p)\), the depolarisation term \(F(air)\) or King Factor computation method.
Returns:	Rayleigh optical depth \(T_r(\lambda)\).
Return type:	numeric or ndarray

Warning

Unlike most objects of colour.phenomenons.rayleigh module, colour.phenomenons.rayleigh.rayleigh_optical_depth() expects wavelength \(\lambda\) to be expressed in centimeters (cm).

Examples

>>> rayleigh_optical_depth(555 * 10e-8)  
0.1004070...

colour.phenomenons.rayleigh_scattering(wavelength, CO2_concentration=300, temperature=288.15, pressure=101325, latitude=0, altitude=0, avogadro_constant=6.02214179e+23, n_s=<function air_refraction_index_Bodhaine1999 at 0x2adc48ef56e0>, F_air=<function F_air_Bodhaine1999 at 0x2adc48ef59b0>)¶

Returns the rayleigh optical depth \(T_r(\lambda)\) as function of wavelength \(\lambda\) in centimeters (cm).

Parameters:	wavelength (numeric or array_like) – Wavelength \(\lambda\) in centimeters (cm). CO2_concentration (numeric or array_like, optional) – \(CO_2\) concentration in parts per million (ppm). temperature (numeric or array_like, optional) – Air temperature \(T[K]\) in kelvin degrees. pressure (numeric or array_like) – Surface pressure \(P\) of the measurement site. latitude (numeric or array_like, optional) – Latitude of the site in degrees. altitude (numeric or array_like, optional) – Altitude of the site in meters. avogadro_constant (numeric or array_like, optional) – Avogadro‘s number (molecules \(mol^{-1}\)). n_s (object) – Air refraction index \(n_s\) computation method. F_air (object) – \((6+3_p)/(6-7_p)\), the depolarisation term \(F(air)\) or King Factor computation method.
Returns:	Rayleigh optical depth \(T_r(\lambda)\).
Return type:	numeric or ndarray

Warning

Unlike most objects of colour.phenomenons.rayleigh module, colour.phenomenons.rayleigh.rayleigh_optical_depth() expects wavelength \(\lambda\) to be expressed in centimeters (cm).

Examples

>>> rayleigh_optical_depth(555 * 10e-8)  
0.1004070...

colour.phenomenons.rayleigh_scattering_spd(shape=SpectralShape(360, 830, 1), CO2_concentration=300, temperature=288.15, pressure=101325, latitude=0, altitude=0, avogadro_constant=6.02214179e+23, n_s=<function air_refraction_index_Bodhaine1999 at 0x2adc48ef56e0>, F_air=<function F_air_Bodhaine1999 at 0x2adc48ef59b0>)¶

Returns the rayleigh spectral power distribution for given spectral shape.

Parameters:	shape (SpectralShape, optional) – Spectral shape used to create the rayleigh scattering spectral power distribution. CO2_concentration (numeric or array_like, optional) – \(CO_2\) concentration in parts per million (ppm). temperature (numeric or array_like, optional) – Air temperature \(T[K]\) in kelvin degrees. pressure (numeric or array_like) – Surface pressure \(P\) of the measurement site. latitude (numeric or array_like, optional) – Latitude of the site in degrees. altitude (numeric or array_like, optional) – Altitude of the site in meters. avogadro_constant (numeric or array_like, optional) – Avogadro‘s number (molecules \(mol^{-1}\)). n_s (object) – Air refraction index \(n_s\) computation method. F_air (object) – \((6+3_p)/(6-7_p)\), the depolarisation term \(F(air)\) or King Factor computation method.
Returns:	Rayleigh optical depth spectral power distribution.
Return type:	SpectralPowerDistribution

Examples

>>> rayleigh_scattering_spd()  
<colour.colorimetry.spectrum.SpectralPowerDistribution object at 0x...>