Colord.Spectrum¶

Fields¶

None

Methods¶

class	`new` ()
class	`planckian_new` (temperature)
class	`planckian_new_full` (temperature, start, end, resolution)
class	`sized_new` (reserved_size)
	`add_value` (data)
	`dup` ()
	`free` ()
	`get_data` ()
	`get_end` ()
	`get_id` ()
	`get_norm` ()
	`get_resolution` ()
	`get_size` ()
	`get_start` ()
	`get_value` (idx)
	`get_value_for_nm` (wavelength)
	`get_value_max` ()
	`get_value_min` ()
	`get_value_raw` (idx)
	`get_wavelength` (idx)
	`get_wavelength_cal` (c1, c2, c3)
	`limit_max` (value)
	`limit_min` (value)
	`multiply` (s2, resolution)
	`multiply_scalar` (value)
	`normalize` (wavelength, value)
	`normalize_max` (value)
	`resample` (start, end, resolution)
	`resample_to_size` (size)
	`set_data` (value)
	`set_end` (end)
	`set_id` (id)
	`set_norm` (norm)
	`set_start` (start)
	`set_value` (idx, data)
	`set_wavelength_cal` (c1, c2, c3)
	`subtract` (s2, resolution)
	`to_string` (max_width, max_height)

Details¶

class Colord.Spectrum¶

classmethod new()[source]¶

Returns:: A newly allocated Colord.Spectrum object
Return type:: Colord.Spectrum

Allocates a spectrum.

New in version 1.1.6.

classmethod planckian_new(temperature)[source]¶

Parameters:: temperature (float) – the temperature in Kelvin
Returns:: A newly allocated Colord.Spectrum object
Return type:: Colord.Spectrum

Allocates a Planckian spectrum at a specific temperature.

New in version 1.1.6.

classmethod planckian_new_full(temperature, start, end, resolution)[source]¶

Parameters:

temperature (float) – the temperature in Kelvin
start (float) – the new spectrum start
end (float) – the new spectrum end
resolution (float) – the resolution to use when resampling

Returns:

A newly allocated Colord.Spectrum object

Return type:

Colord.Spectrum

Allocates a Planckian spectrum at a specific temperature.

New in version 1.3.1.

classmethod sized_new(reserved_size)[source]¶

Parameters:: reserved_size (int) – the future size of the spectrum
Returns:: A newly allocated Colord.Spectrum object
Return type:: Colord.Spectrum

Allocates a spectrum with a preallocated size.

New in version 1.1.6.

add_value(data)[source]¶

Parameters:: data (float) –

Adds a value in nm to the spectrum.

New in version 1.1.6.

dup()[source]¶

Return type:: Colord.Spectrum

New in version 1.1.6.

free()[source]¶: Deallocates a color spectrum.

New in version 1.1.6.

get_data()[source]¶

Returns:: spectral data
Return type:: [float]

Gets the spectral data. NOTE: This is not normalized

New in version 1.1.6.

get_end()[source]¶

Returns:: the value in nm
Return type:: float

Gets the end value of the spectral data.

New in version 1.1.6.

get_id()[source]¶

Returns:: the textual ID of the sample
Return type:: str

Gets the spectral data.

New in version 1.1.6.

get_norm()[source]¶

Returns:: the value
Return type:: float

Gets the normalization value of the spectral data. NOTE: This affects every value in the spectrum.

New in version 1.1.6.

get_resolution()[source]¶

Returns:: the value
Return type:: float

Gets the divisor of the spectra, for instance a .

New in version 1.2.6.

get_size()[source]¶

Returns:: number of data items in this spectrum
Return type:: int

Gets the size of the spectrum data.

New in version 1.1.6.

get_start()[source]¶

Returns:: the value in nm
Return type:: float

Gets the start value of the spectral data.

New in version 1.1.6.

get_value(idx)[source]¶

Parameters:: idx (int) – an index into the data
Returns:: spectral data value, or -1 for invalid
Return type:: float

Gets the spectrum data at a specified index.

New in version 1.1.6.

get_value_for_nm(wavelength)[source]¶

Parameters:: wavelength (float) – the wavelength in nm
Returns:: the value for the wavelength
Return type:: float

Gets the value from the spectral data for a given wavelength.

New in version 1.1.6.

get_value_max()[source]¶

Return type:: float

Gets the largest normalised value in the spectrum.

New in version 1.3.1.

get_value_min()[source]¶

Return type:: float

Gets the smallest normalised value in the spectrum.

New in version 1.3.1.

get_value_raw(idx)[source]¶

Parameters:: idx (int) – an index into the data
Returns:: spectral data value, or -1 for invalid
Return type:: float

Gets the spectrum data at a specified index, without any normalization applied. Most people should use Colord.Spectrum.get_value() instead.

New in version 1.2.6.

get_wavelength(idx)[source]¶

Parameters:: idx (int) – an index into the data
Returns:: wavelenth value in nm, or -1 for invalid
Return type:: float

Gets the wavelenth that corresponds to the specified index.

New in version 1.1.6.

get_wavelength_cal(c1, c2, c3)[source]¶

Parameters:

c1 (float) – the 1st coefficient
c2 (float) – the 2nd coefficient
c3 (float) – the 3rd coefficient

Gets the calibration coefficients used to map pixel indexes to wavelengths.

New in version 1.3.1.

limit_max(value)[source]¶

Parameters:: value (float) – the threshold value to limit the spectrum

Ensures no values in the spectrum fall above a set limit. If they are found, set them to value.

New in version 1.3.1.

limit_min(value)[source]¶

Parameters:: value (float) – the threshold value to limit the spectrum

Ensures no values in the spectrum fall below a set limit. If they are found, set them to value.

New in version 1.3.1.

multiply(s2, resolution)[source]¶

Parameters:

s2 (Colord.Spectrum) – a Colord.Spectrum instance, possibly an absorption spectrum.
resolution (float) – the step size in nm

Returns:

a Colord.Spectrum instance

Return type:

Colord.Spectrum

Multiplies two spectra together.

New in version 1.1.6.

multiply_scalar(value)[source]¶

Parameters:: value (float) – a scalar value
Returns:: a Colord.Spectrum instance
Return type:: Colord.Spectrum

Multiplies a spectra with a scalar value.

New in version 1.3.5.

normalize(wavelength, value)[source]¶

Parameters:

wavelength (float) – the wavelength in nm
value (float) – the value to normalize to

Normalizes a spectrum to a specific value at a specific wavelength.

New in version 1.1.6.

normalize_max(value)[source]¶

Parameters:: value (float) – the value to normalize to

Normalizes a spectrum to a specific value at its maximum value.

New in version 1.2.6.

resample(start, end, resolution)[source]¶

Parameters:

start (float) – the new spectrum start
end (float) – the new spectrum end
resolution (float) – the resolution to use when resampling

Returns:

a Colord.Spectrum instance

Return type:

Colord.Spectrum

Resample a new spectrum with linear index to wavelength coefficients.

New in version 1.3.1.

resample_to_size(size)[source]¶

Parameters:: size (int) – the output spectrum size
Returns:: a Colord.Spectrum instance
Return type:: Colord.Spectrum

Resample a new spectrum with the desired number of points.

New in version 1.3.4.

set_data(value)[source]¶

Parameters:: value ([float]) – component value

Sets the spectrum data.

New in version 1.1.6.

set_end(end)[source]¶

Parameters:: end (float) – the end value of the spectral data

Set the end value of the spectal data in nm.

If there is already spectral data, the wavelength calibration will also be set automatically.

New in version 1.1.6.

set_id(id)[source]¶

Parameters:: id (str) – component id

Sets a spectrum id.

New in version 1.1.6.

set_norm(norm)[source]¶

Parameters:: norm (float) – the end value of the spectral data

Set the normalization value of the spectrum. NOTE: This affects every value in the spectrum.

New in version 1.1.6.

set_start(start)[source]¶

Parameters:: start (float) – the start value of the spectral data

Set the start value of the spectal data in nm.

New in version 1.1.6.

set_value(idx, data)[source]¶

Parameters:

idx (int) – an index into the data
data (float) – a data value

Overwrites the spectrum data at a specified index.

New in version 1.2.6.

set_wavelength_cal(c1, c2, c3)[source]¶

Parameters:

c1 (float) – the 1st coefficient
c2 (float) – the 2nd coefficient
c3 (float) – the 3rd coefficient

Sets the calibration coefficients used to map pixel indexes to wavelengths.

This function will set the ‘end’ wavelength automatically, potentially overwriting the value set by Colord.Spectrum.set_end().

New in version 1.3.1.

subtract(s2, resolution)[source]¶

Parameters:

s2 (Colord.Spectrum) – a Colord.Spectrum instance, e.g. a dark calibration
resolution (float) – the resolution to use when resampling

Returns:

a Colord.Spectrum instance

Return type:

Colord.Spectrum

Subtracts one spectral plot from another. If the spectra have the same start, end and the same number of data points they are not resampled.

New in version 1.3.1.

to_string(max_width, max_height)[source]¶

Parameters:

max_width (int) – the terminal width
max_height (int) – the terminal height

Returns:

a printable ASCII string

Return type:

str

Returns a graphical representation of the spectrum.

New in version 1.3.1.