matplotlib.colors.makeMappingArray

matplotlib.colors.makeMappingArray(N, data, gamma=1.0) [source]

[Устаревшее] Создать одномерную таблицу поиска с N элементами.

Предполагается отображение \(f : [0, 1] \rightarrow [0, 1]\). Возвращаемые данные — массив из N значений \(y = f(x)\), где x сэмплируется равномерно из [0, 1].

По умолчанию (gamma = 1) x равномерно сэмплируется из [0, 1]. Фактор коррекции гамма \(\gamma\) искажает это равномерное сэмплирование с помощью \(x \rightarrow x^\gamma\).

Параметры:

Nint Количество элементов создаваемой таблицы поиска. Должно быть N >= 1. dataMx3 array-like or callable Определяет отображение \(f\). Если это массив Mx3, строки определяют значения (x, y0, y1). Значения x должны начинаться с x=0, заканчиваться x=1 и быть отсортированы по возрастанию. Значение между \(x_i\) и \(x_{i+1}\) отображается в диапазоне \(y^1_{i-1} \ldots y^0_i\) с помощью линейной интерполяции. В простом случае непрерывного отображения y, y0 и y1 совпадают. Два значения y позволяют задать нелинейные отображения. Например, пилообразная функция с периодом 0,2 и амплитудой 1: [(0, 1, 0), (0.2, 1, 0), (0.4, 1, 0), ..., [(1, 1, 0)] В особом случае N == 1, по соглашению, возвращаемое значение — y0 для x == 1. Если data — это вызываемый объект, он должен принимать и возвращать массивы NumPy: data(x : ndarray) -> ndarray и отображать значения между 0 - 1 на 0 - 1. gammafloat Фактор коррекции гамма для входного распределения x отображения. См. также https://en.wikipedia.org/wiki/Gamma_correction.

Возвращает:

lutarray Таблица поиска, где lut[x * (N-1)] даёт самое близкое значение для значений x между 0 и 1.

Примечания

Эта функция используется внутри для LinearSegmentedColormaps.

Устарело начиная с версии 3.2.