ticker

matplotlib.ticker

Расположение и форматирование делений

Этот модуль содержит классы для полной настройки размещения и форматирования делений. Хотя локеры не знают о главных или второстепенных делениях, они используются классом Axis для поддержки размещения и форматирования главных и второстепенных делений. Предоставляются общие локеры и форматировщики делений, а также специализированные для конкретных областей.

Форматировщик по умолчанию

Форматировщик по умолчанию определяет, когда данные x, отображаемые на графике, представляют собой небольшой диапазон на фоне большого смещения. Чтобы уменьшить вероятность перекрытия меток делений, метки делений отображаются как смещения от фиксированного смещения. Например:

ax.plot(np.arange(2000, 2010), range(10))

будет иметь деления от 0 до 9 со смещением +2e3. Если этого не требуется, отключите использование смещения в форматировщике по умолчанию:

ax.get_xaxis().get_major_formatter().set_useOffset(False)

установите параметр rcParam axes.formatter.useoffset=False, чтобы отключить его глобально, или установите другой форматировщик.

Расположение делений

Класс Locator — это базовый класс для всех локеров делений. Локеры обрабатывают автоматическое масштабирование пределов отображения на основе пределов данных и выбор расположения делений. Полезным полуавтоматическим локером делений является MultipleLocator. Он инициализируется основанием, например, 10, и выбирает пределы осей и деления, кратные этому основанию.

Подклассы Locator, определённые здесь:

NullLocator

Отсутствие делений

FixedLocator

Расположение делений фиксировано

IndexLocator

Локер для графиков индексов (например, где x = range(len(y)))

LinearLocator

Деления с равными интервалами от мин до макс

LogLocator

Деления с логарифмическими интервалами от мин до макс

SymmetricalLogLocator

Локер для использования с нормализацией symlog, работает как LogLocator для части вне порога и добавляет 0, если внутри пределов

MultipleLocator

Деления и диапазон кратны основанию; целые или вещественные числа

OldAutoLocator

выбор MultipleLocator и динамическое переопределение его для интеллектуального размещения делений во время навигации

MaxNLocator

находит до максимального числа делений в удобных местах

AutoLocator

MaxNLocator с простыми значениями по умолчанию. Это локер делений по умолчанию для большинства графиков.

AutoMinorLocator

локер для второстепенных делений, когда ось линейная, а главные деления равномерно распределены. Он делит интервал главных делений на заданное количество второстепенных интервалов, по умолчанию 4 или 5 в зависимости от интервала главных делений.

LogitLocator

Локер для логарифмической шкалы.

Существует ряд локеров, специализированных для дат — см. модуль дат.

Вы можете определить свой собственный локер, унаследовав от Locator. Вы должны переопределить метод __call__, который возвращает последовательность расположений, и, вероятно, захотите переопределить метод autoscale для установки пределов отображения по пределу данных.

Если вы хотите переопределить локер по умолчанию, используйте один из вышеперечисленных или пользовательский локер и передайте его экземпляру оси x или y. Соответствующие методы:

ax.xaxis.set_major_locator( xmajorLocator )
ax.xaxis.set_minor_locator( xminorLocator )
ax.yaxis.set_major_locator( ymajorLocator )
ax.yaxis.set_minor_locator( yminorLocator )

Локер второстепенных делений по умолчанию — NullLocator, т.е. по умолчанию второстепенных делений нет.

Форматирование делений

Форматирование делений контролируется классами, унаследованными от Formatter. Форматировщик работает с одним значением деления и возвращает строку в ось.

NullFormatter

Нет меток на делениях

IndexFormatter

Устанавливает строки из списка меток

FixedFormatter

Устанавливает метки вручную

FuncFormatter

Пользовательская функция устанавливает метки

StrMethodFormatter

Использование метода строки format

FormatStrFormatter

Использование старого форматирования sprintf

ScalarFormatter

Форматировщик по умолчанию для скаляров: автоматически выбирает строку формата

LogFormatter

Форматировщик для логарифмических осей

LogFormatterExponent

Форматирование значений для логарифмической оси с использованием exponent = log_base(value).

LogFormatterMathtext

Форматирование значений для логарифмической оси с использованием exponent = log_base(value) с использованием математического текста.

LogFormatterSciNotation

Форматирование значений для логарифмической оси с использованием научной записи.

LogitFormatter

Форматировщик вероятностей.

EngFormatter

Форматирование меток в инженерной записи.

PercentFormatter

Форматирование меток в виде процентов

Вы можете вывести свой собственный форматировщик из базового класса Formatter, просто переопределив метод __call__. Класс форматировщика имеет доступ к отображению оси и пределам данных.

Для управления форматом меток главных и второстепенных делений используйте один из следующих методов:

ax.xaxis.set_major_formatter( xmajorFormatter )
ax.xaxis.set_minor_formatter( xminorFormatter )
ax.yaxis.set_major_formatter( ymajorFormatter )
ax.yaxis.set_minor_formatter( yminorFormatter )

См. Демонстрация главных и второстепенных делений для примера настройки главных и второстепенных делений. Для получения дополнительной информации и примеров использования локеров и форматировщиков дат см. модуль matplotlib.dates.

class matplotlib.ticker.TickHelper

Bases: object

axis = None

create_dummy_axis(**kwargs)

set_axis(axis)

set_bounds(vmin, vmax)

set_data_interval(vmin, vmax)

set_view_interval(vmin, vmax)

class matplotlib.ticker.Formatter

Базы: matplotlib.ticker.TickHelper

Создаёт строку на основе значения и позиции деления.

fix_minus(s)

Некоторые классы могут захотеть заменить дефис на соответствующий символ минуса (U+2212) для улучшения типографики. По умолчанию замена не выполняется.

Обратите внимание, если вы используете этот метод, например, в format_data() или вызываете его, вероятно, не следует использовать его для format_data_short(), так как панель инструментов использует его для интерактивного отображения координат, и сомнительно, что пользовательские интерфейсы разных платформ смогут правильно обработать этот символ Unicode. Поэтому на данный момент классы, которые переопределяют fix_minus(), должны иметь явное определение метода format_data_short().

format_data(value)

Возвращает полное строковое представление значения без указания позиции.

format_data_short(value)

Возвращает короткое строковое представление значения деления.

По умолчанию используется длинное представление, не зависящее от позиции.

get_offset()

locs = []

set_locs(locs)

class matplotlib.ticker.FixedFormatter(seq)

Базы: matplotlib.ticker.Formatter

Возвращает фиксированные строки для меток делений, основанные только на позиции, а не на значении.

Устанавливает последовательность строк, которые будут использованы в качестве меток.

get_offset()

set_offset_string(ofs)

class matplotlib.ticker.NullFormatter

Базы: matplotlib.ticker.Formatter

Всегда возвращает пустую строку.

class matplotlib.ticker.FuncFormatter(func)

Базы: matplotlib.ticker.Formatter

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

Функция должна принимать два входных параметра (значение деления x и позицию pos) и возвращать строку, содержащую соответствующую метку деления.

class matplotlib.ticker.FormatStrFormatter(fmt)

Базы: matplotlib.ticker.Formatter

Использует строку формата старого стиля (‘%’ оператор) для форматирования делений.

Строка формата должна содержать один формат переменной (%) в ней. Она будет применена к значению (а не к позиции) деления.

class matplotlib.ticker.StrMethodFormatter(fmt)

Базы: matplotlib.ticker.Formatter

Использует строку формата нового стиля (как используется в str.format()) для форматирования делений.

Поле, используемое для значения, должно быть помечено x, а поле, используемое для позиции, должно быть помечено pos.

class matplotlib.ticker.ScalarFormatter(useOffset=None, useMathText=None, useLocale=None)

Базы: matplotlib.ticker.Formatter

Форматирует значения делений как числа.

Значение деления интерпретируется как обычное число. Если useOffset==True и диапазон данных значительно меньше среднего значения данных, тогда определяется смещение, таким образом, чтобы метки делений были осмысленными. Научная запись используется для data < 10^-n или data >= 10^m, где n и m — пределы степеней, установленные с помощью set_powerlimits((n,m)). Значения по умолчанию для этих параметров контролируются параметром rc axes.formatter.limits.

fix_minus(s)

Заменяет дефисы символом минуса Unicode.

format_data(value)

Возвращает отформатированное строковое представление числа.

format_data_short(value)

Возвращает короткое отформатированное строковое представление числа.

get_offset()

Возвращает научную запись и смещение.

get_useLocale()

get_useMathText()

get_useOffset()

pprint_val(x)

set_locs(locs)

Устанавливает позиции делений.

set_powerlimits(lims)

Устанавливает пороговые значения размера для научной записи.

lims — это последовательность из двух элементов, содержащая степени 10, определяющие порог переключения. Числа ниже 10**lims[0] и выше 10**lims[1] будут отображаться в научной записи.

Например, formatter.set_powerlimits((-3, 4)) устанавливает значение по умолчанию до 2007 года, в котором научная запись используется для чисел меньше 1e-3 или больше 1e4.

См. также

Метод set_scientific()

set_scientific(b)

Включает или выключает научную запись.

См. также

Метод set_powerlimits()

set_useLocale(val)

set_useMathText(val)

set_useOffset(val)

useLocale

useMathText

useOffset

class matplotlib.ticker.LogFormatter(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None)

Основы: matplotlib.ticker.Formatter

Базовый класс для форматирования делений на логарифмической или симметрично-логарифмической шкале.

Его можно создать напрямую или унаследовать.

Параметры:

base : float, необязательно, по умолчанию: 10. Основание логарифма, используемое во всех вычислениях. labelOnlyBase : bool, необязательно, по умолчанию: False Если True, деления отмечаются только на целых степенях основания. Обычно True для основных делений и False для вспомогательных. minor_thresholds : (подмножество, всё), необязательно, по умолчанию: (1, 0.4) Если labelOnlyBase False, эти два числа управляют отображением делений, которые не являются целыми степенями основания; обычно это вспомогательные деления. Управляющим параметром является логарифм диапазона данных оси. В типичном случае, когда основание 10, это число декад, охватываемых осью, поэтому мы можем назвать его «numdec». Если numdec <= all, все вспомогательные деления будут помечены. Если all < numdec <= subset, тогда будет помечено только подмножество вспомогательных делений, чтобы избежать перегрузки. Если numdec > subset , тогда вспомогательные деления не будут помечены. linthresh : None или float, необязательно, по умолчанию: None Если используется симметрично-логарифмическая шкала, её параметр linthresh должен быть указан здесь.

Примечания

Метод set_locs необходимо вызвать, чтобы включить логику подмножества, управляемую параметром minor_thresholds.

В некоторых случаях, таких как цветовая шкала, нет различия между основными и вспомогательными делениями; расположение делений может быть задано вручную или с помощью локейтора, который устанавливает деления на целых степенях основания и в промежуточных местах. Для этой ситуации отключите логику minor_thresholds, используя minor_thresholds=(np.inf, np.inf), чтобы все деления были помечены.

Чтобы отключить отображение вспомогательных делений, когда «labelOnlyBase» False, используйте minor_thresholds=(0, 0). Это значение по умолчанию для стиля «классический».

Примеры

Чтобы пометить подмножество вспомогательных делений, когда пределы просмотра охватывают до 2 декад, и все деления при масштабировании до 0,5 декад или меньше, используйте minor_thresholds=(2, 0.5).

Чтобы пометить все вспомогательные деления, когда пределы просмотра охватывают до 1,5 декад, используйте minor_thresholds=(1.5, 1.5).

base(base)

Изменить base для меток.

Предупреждение

Должно всегда совпадать с основанием, используемым для LogLocator

format_data(value)

format_data_short(value)

Возвращает краткое форматированное строковое представление числа.

label_minor(labelOnlyBase)

Включает или отключает отображение вспомогательных делений.

Параметры:	labelOnlyBase : bool Если True, деления отмечаются только на целых степенях основания.

pprint_val(x, d)

set_locs(locs=None)

Использует пределы просмотра оси, чтобы управлять тем, какие деления будут помечены.

Параметр locs игнорируется в текущем алгоритме.

class matplotlib.ticker.LogFormatterExponent(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None)

Основы: matplotlib.ticker.LogFormatter

Форматирует значения для логарифмической оси, используя exponent = log_base(value).

class matplotlib.ticker.LogFormatterMathtext(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None)

Основы: matplotlib.ticker.LogFormatter

Форматирует значения для логарифмической оси, используя exponent = log_base(value).

class matplotlib.ticker.IndexFormatter(labels)

Основы: matplotlib.ticker.Formatter

Форматирует позицию x до ближайшей i-й метки, где i=int(x+0.5)

class matplotlib.ticker.LogFormatterSciNotation(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None)

Основы: matplotlib.ticker.LogFormatterMathtext

Форматирует значения в соответствии с научной записью на логарифмической оси

class matplotlib.ticker.LogitFormatter

Основы: matplotlib.ticker.Formatter

Форматировщик вероятностей (использующий математический текст).

format_data_short(value)

Возвращает краткое форматированное строковое представление числа

class matplotlib.ticker.EngFormatter(unit='', places=None, sep=' ')

Основы: matplotlib.ticker.Formatter

Форматирует значения оси, используя инженерные префиксы для представления степеней 1000, плюс указанное единица, например, 10 МГц вместо 1e7.

Параметры:

unit : str (по умолчанию: “”) Символ единицы, используемый для представления степеней 1000. Например, ‘Hz’ или ‘m’. places : int (по умолчанию: None) Точность отображения числа, заданная числом знаков после запятой (будет от одного до трех знаков перед запятой). Если None, форматирование использует формат с плавающей запятой ‘%g’, который отображает до 6 значащих цифр, т.е. эквивалентное значение для places варьируется от 0 до 5 (включительно). sep : str (по умолчанию: ” “) Разделитель, используемый между значением и префиксом/единицей. Например, мы получим ‘3.14 мВ’, если sep это ” ” (по умолчанию), и ‘3.14мВ’, если sep это “”. Помимо стандартного поведения, некоторые другие полезные варианты могут быть: sep="" для прямого добавления префикса/единицы к значению; sep="\N{THIN SPACE}" (U+2009); sep="\N{NARROW NO-BREAK SPACE}" (U+202F); sep="\N{NO-BREAK SPACE}" (U+00A0).

ENG_PREFIXES = {-24: 'y', -21: 'z', -18: 'a', -15: 'f', -12: 'p', -9: 'n', -6: 'μ', -3: 'm', 0: '', 3: 'k', 6: 'M', 9: 'G', 12: 'T', 15: 'P', 18: 'E', 21: 'Z', 24: 'Y'}

format_eng(num)

Форматирует число в инженерной записи, добавляя символ, представляющий степень 1000 исходного числа. Некоторые примеры:

>>> format_eng(0)       # for self.places = 0
'0'

>>> format_eng(1000000) # for self.places = 1
'1.0 M'

>>> format_eng("-1e-6") # for self.places = 2
u'-1.00 μ'

num может быть числовым значением или строкой, которая может быть преобразована в числовое значение с помощью float(num).

class matplotlib.ticker.PercentFormatter(xmax=100, decimals=None, symbol='%', is_latex=False)

Основы: matplotlib.ticker.Formatter

Форматирование чисел в виде процентов.

Как число преобразуется в процент, определяется параметром xmax. xmax — значение данных, соответствующее 100%. Проценты вычисляются как x / xmax * 100. Таким образом, если данные уже масштабированы в проценты, xmax будет 100. Другой распространённый случай, когда xmax равно 1.0.

symbol — строка, которая будет добавлена к метке. Она может быть None или пустой, чтобы указать, что символ не должен использоваться. Специальные символы LaTeX экранируются в symbol, когда включен режим latex, если только is_latex не равно True.

decimals — количество знаков после запятой. Если оно установлено в None (по умолчанию), число будет рассчитано автоматически.

convert_to_pct(x)

format_pct(x, display_range)

Форматирует число в виде процента с правильным количеством знаков после запятой и добавляет символ процента, если он есть.

Если self.decimals равно None, количество цифр после запятой устанавливается на основе display_range оси следующим образом:

Диапазон отображения	Десятичные знаки	Пример
>50	0	x = 34.5 => 35%
>5	1	x = 34.5 => 34,5%
>0,5	2	x = 34.5 => 34,50%
…	…	…

Этот метод не будет эффективным для очень малых или очень больших диапазонов осей. Предполагается, что значения на графике — это проценты, отображаемые в разумном масштабе.

symbol

Настроенный символ процента в виде строки.

Если LaTeX включен с помощью rcParams['text.usetex'], специальные символы {'#', '$', '%', '&', '~', '_', '^', '', '{', '}'} автоматически экранируются в строке.

class matplotlib.ticker.Locator

Основы: matplotlib.ticker.TickHelper

Определяет расположение делений;

Обратите внимание, что вы не должны использовать один и тот же локатор между различными Axis, так как локатор хранит ссылки на данные оси и пределы отображения.

MAXTICKS = 1000

autoscale()

Автоматически масштабировать пределы отображения

pan(numsteps)

Сдвинуть numticks (может быть положительным или отрицательным)

raise_if_exceeds(locs)

вызывает RuntimeError, если локатор пытается создать более MAXTICKS меток

refresh()

обновить внутреннюю информацию на основе текущих пределов

set_params(**kwargs)

Не делает ничего и выводит предупреждение. Любой класс локатора, не поддерживающий функцию set_params(), вызовет это.

tick_values(vmin, vmax)

Возвращает значения размещенных делений, заданные vmin и vmax.

Примечание

Чтобы получить расположение делений со значениями vmin и vmax, определенными автоматически для соответствующей axis, просто вызовите экземпляр локатора:

>>> print((type(loc)))
<type 'Locator'>
>>> print((loc()))
[1, 2, 3, 4]

view_limits(vmin, vmax)

выбрать масштаб для диапазона от vmin до vmax

Как правило, этот метод переопределяется подклассами для изменения поведения локатора.

zoom(direction)

Увеличить/уменьшить масштаб оси; если направление >0, увеличить масштаб, в противном случае уменьшить.

class matplotlib.ticker.IndexLocator(base, offset)

Основы: matplotlib.ticker.Locator

Размещает деление на каждом кратном определенному числу точек, напр. на каждой 5-й точке. Предполагается, что вы выполняете индексное построение, т.е. ось — 0, len(data). Это особенно полезно для меток по оси X.

размещение меток на i-ых точках данных, где (i-смещение)%база==0

set_params(base=None, offset=None)

Устанавливает параметры внутри локатора

tick_values(vmin, vmax)

class matplotlib.ticker.FixedLocator(locs, nbins=None)

Основы: matplotlib.ticker.Locator

Местоположение делений фиксировано. Если nbins не равно None, массив возможных положений будет подвыбирать, чтобы количество делений оставалось <= nbins +1. Подвыборка будет выполнена таким образом, чтобы включить наименьшее по абсолютной величине значение; например, если ноль включен в массив возможностей, то он гарантированно будет одной из выбранных меток.

set_params(nbins=None)

Устанавливает параметры внутри локатора.

tick_values(vmin, vmax)

Возвращает расположение делений.

Примечание

Поскольку значения фиксированы, vmin и vmax не используются в этом методе.

class matplotlib.ticker.NullLocator

Основы: matplotlib.ticker.Locator

Нет делений

tick_values(vmin, vmax)

Возвращает расположение делений.

Примечание

Поскольку значения Null, vmin и vmax не используются в этом методе.

class matplotlib.ticker.LinearLocator(numticks=None, presets=None)

Основы: matplotlib.ticker.Locator

Определяет расположение делений

В первый раз, когда эта функция вызывается, она попытается установить количество делений, чтобы получить красивое разделение по делениям. В дальнейшем количество делений будет фиксироваться, чтобы обеспечивалась хорошая работа при интерактивном навигации

Используйте предустановки для установки locs на основе lom. Словарь, сопоставляющий vmin, vmax->locs

set_params(numticks=None, presets=None)

Устанавливает параметры внутри локатора.

tick_values(vmin, vmax)

view_limits(vmin, vmax)

Попытаться выбрать пределы отображения разумно

class matplotlib.ticker.LogLocator(base=10.0, subs=(1.0, ), numdecs=4, numticks=None)

Основы: matplotlib.ticker.Locator

Определяет расположение делений для логарифмических осей

Размещает метки в позициях: subs[j] * base**i

Параметры:

subs : None, строка или последовательность float, необязательно, по умолчанию (1.0,) Указывает кратные целым степеням базы, на которых нужно разместить деления. По умолчанию деления размещаются только на целых степенях базы. Допустимые значения строк — 'auto' и 'all', оба используют алгоритм, основанный на пределах отображения оси, чтобы определить, нужно ли и как размещать деления между целыми степенями базы. С 'auto', деления размещаются только между целыми степенями; с 'all', целые степени включаются. Значение None эквивалентно 'auto'.

base(base)

установить основание логарифмического масштабирования (главная метка через base**i, i целое число)

nonsingular(vmin, vmax)

set_params(base=None, subs=None, numdecs=None, numticks=None)

Устанавливает параметры внутри локатора.

subs(subs)

установить дополнительные метки для логарифмического масштабирования через base**i*subs[j]

tick_values(vmin, vmax)

view_limits(vmin, vmax)

Попытаться выбрать пределы отображения разумно

class matplotlib.ticker.AutoLocator

Основы: matplotlib.ticker.MaxNLocator

class matplotlib.ticker.MultipleLocator(base=1.0)

Основывается на: matplotlib.ticker.Locator

Устанавливает метку на каждом целом числе, кратном основанию в интервале просмотра

set_params(base)

Устанавливает параметры в этом локаторе.

tick_values(vmin, vmax)

view_limits(dmin, dmax)

Устанавливает пределы просмотра на ближайшие кратные основанию, которые содержат данные

class matplotlib.ticker.MaxNLocator(*args, **kwargs)

Основывается на: matplotlib.ticker.Locator

Выбирает не более N интервалов в удобных местах.

Ключевые аргументы:

nbins

Максимальное количество интервалов; на одно меньше максимального количества меток. Если строка 'auto', количество интервалов будет автоматически определяться на основе длины оси.

steps

Последовательность удобных чисел, начиная с 1 и заканчивая 10; например, [1, 2, 4, 5, 10]

integer

Если True, метки будут принимать только целые значения, при условии, что найдено не менее min_n_ticks целых чисел в пределах пределов просмотра.

symmetric

Если True, автоматическое масштабирование приведет к диапазону, симметричному относительно нуля.

prune

[‘lower’ | ‘upper’ | ‘both’ | None] Удаляет крайние метки – полезно для стопки или связанных графиков, где верхняя метка одной оси перекрывает нижнюю метку оси выше нее, в основном, когда rcParams['axes.autolimit_mode'] 'round_numbers'. Если prune=='lower', будет удалена наименьшая метка. Если prune=='upper', будет удалена наибольшая метка. Если prune=='both', будут удалены наибольшая и наименьшая метки. Если prune==None, метки не будут удалены.

min_n_ticks

Расслабляет ограничения nbins и integer при необходимости, чтобы получить это минимальное количество меток.

bin_boundaries(vmin, vmax)

Устарело начиная с версии 2.0: Функция bin_boundaries была устарела в версии 2.0.

default_params = {'nbins': 10, 'steps': None, 'integer': False, 'symmetric': False, 'prune': None, 'min_n_ticks': 2}

set_params(**kwargs)

Устанавливает параметры в этом локаторе.

tick_values(vmin, vmax)

view_limits(dmin, dmax)

class matplotlib.ticker.AutoMinorLocator(n=None)

Основывается на: matplotlib.ticker.Locator

Динамически находит позиции вспомогательных меток на основе позиций основных меток. Масштаб должен быть линейным с равномерно расположенными основными метками.

n – количество подразделений интервала между основными метками; например, n=2 разместит одну вспомогательную метку посередине между основными метками.

Если n опущено или равно None, оно будет установлено в 5 или 4.

tick_values(vmin, vmax)

class matplotlib.ticker.SymmetricalLogLocator(transform=None, subs=None, linthresh=None, base=None)

Основывается на: matplotlib.ticker.Locator

Определяет позиции меток для симметричных логарифмических осей

размещает метки по местоположению = base**i*subs[j]

set_params(subs=None, numticks=None)

Устанавливает параметры в этом локаторе.

tick_values(vmin, vmax)

view_limits(vmin, vmax)

Попытка выбрать пределы просмотра разумно

class matplotlib.ticker.LogitLocator(minor=False)

Основывается на: matplotlib.ticker.Locator

Определяет позиции меток для осей logit

размещает метки по позициям logit

nonsingular(vmin, vmax)

set_params(minor=None)

Устанавливает параметры в этом локаторе.

tick_values(vmin, vmax)