15.2.1.1 Настройка осей

Функция axis может быть использована для изменения пределов осей существующего графика и различных других свойств осей, таких как коэффициент масштаба и вид делений. По умолчанию функции высокого уровня построения графиков, такие как plot, сбрасывают свойства осей. Любая настройка свойств, например, вызовом axis, xlim, и т. д., должна происходить после построения графика или, как альтернатива, после вызова функции hold.

: axis ()

: axis ([x_lo x_hi])

: axis ([x_lo x_hi y_lo y_hi])

: axis ([x_lo x_hi y_lo y_hi z_lo z_hi])

: axis ([x_lo x_hi y_lo y_hi z_lo z_hi c_lo c_hi])

: axis (option)

: axis (option1, option2, …)

: axis (hax, …)

: limits = axis ()

Устанавливает пределы и вид осей.

Аргумент limits должен быть вектором из 2, 4, 6 или 8 элементов. Первый и второй элементы задают нижние и верхние пределы для оси x. Третий и четвёртый — для оси y, пятый и шестой — для оси z, а седьмой и восьмой — для оси цвета. Специальные значения -Inf и Inf могут быть использованы для указания того, что предел должен быть вычислен автоматически на основе данных на осях.

Без аргументов, axis включает автоматическое масштабирование.

С одним выходным аргументом, limits = axis возвращает текущие пределы осей.

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

Следующие опции управляют коэффициентом масштаба осей.

"square"

Принудительно устанавливает квадратный коэффициент масштаба осей.

"equal"

Принудительно устанавливает единичный масштаб по оси x равным единичному масштабу по осям y (и z).

"normal"

Восстанавливает коэффициент масштаба по умолчанию.

Следующие опции управляют интерпретацией пределов осей.

"auto"

"auto[xyz]"

"auto [xyz]"

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

"manual"

Закрепляет текущие пределы осей.

"tight"

Закрепляет оси на пределы данных.

"image"

Эквивалентно "tight" и "equal".

"vis3d"

Устанавливает режимы коэффициента масштаба на "manual" для поворота без растяжения.

Следующие опции влияют на отображение делений.

"tic"

"tic[xyz]"

"tic [xyz]"

Включает деления для всех осей или включает их для указанных осей и выключает для остальных.

"label"

"label[xyz]"

"label [xyz]"

Включает подписи делений для всех осей или включает их для указанных осей и выключает для остальных.

"nolabel"

Выключает подписи делений для всех осей.

Примечание: если для осей нет делений, то не может быть и подписей.

Следующие опции влияют на направление возрастания значений на осях.

"xy"

По умолчанию для оси y, большие значения находятся в верхней части.

"ij"

Обратная ось y, меньшие значения находятся в верхней части.

Следующие опции влияют на видимость осей.

"on"

Отобразить оси.

"off"

Скрыть оси.

Если первый аргумент hax — это дескриптор оси, то операции выполняются на этой оси, а не на текущей оси, возвращаемой gca.

Пример 1: установка пределов X/Y и принудительное задание квадратного коэффициента масштаба

axis ([1, 2, 3, 4], "square");

Пример 2: включение делений на всех осях, включение подписей делений только на оси y

axis ("tic", "labely");

См. также: xlim, ylim, zlim, caxis, daspect, pbaspect, box, grid.

Аналогично, пределы цветовой шкалы могут быть изменены с помощью функции caxis.

: caxis ([cmin cmax])

: caxis ("auto")

: caxis ("manual")

: caxis (hax, …)

: limits = caxis ()

Запрос или установка пределов оси цвета для графиков.

Аргумент limits должен быть вектором из 2 элементов, задающим нижние и верхние пределы для назначения первого и последнего значения в цветовой шкале. Значения данных вне этого диапазона обрезаются до первого и последнего элементов цветовой шкалы.

Если задана опция "auto", то применяются автоматические пределы цветовой шкалы. Автоматический алгоритм устанавливает cmin в минимальное значение данных и cmax в максимальное значение данных. Если задано "manual", то свойство "climmode" устанавливается в "manual", и числовые значения в свойстве "clim" используются для пределов.

Если первый аргумент hax — это дескриптор оси, то операции выполняются на этой оси, а не на текущей оси, возвращаемой gca.

При вызове без аргументов возвращаются текущие пределы оси цвета.

Примечание для программистов: ось цвета влияет на отображение графических объектов изображения, заливки и поверхности, но только если свойство "cdata" имеет индексированные данные и свойство "cdatamapping" установлено в "scaled". Графические объекты с истинным цветом cdata, или "direct" cdatamapping не затрагиваются.

См. также: colormap, axis.

Функции xlim, ylim, и zlim могут быть использованы для получения или установки отдельных пределов осей. Каждая из них имеет одинаковую форму.

: xlimits = xlim ()

: xmode = xlim ("mode")

: xlim ([x_lo x_hi])

: xlim ("auto")

: xlim ("manual")

: xlim (hax, …)

Запрос или установка пределов оси x для текущего графика.

При вызове без аргументов xlim возвращает пределы оси x текущего графика.

С входным запросом "mode", возвращает текущий режим вычисления предела x, который может быть "auto" или "manual".

Если передать вектор из 2 элементов [x_lo x_hi], пределы оси x устанавливаются на эти значения, а режим устанавливается на "manual". Специальные значения -Inf и Inf могут быть использованы для указания того, что либо нижний предел оси, либо верхний предел оси должны быть вычислены автоматически.

Текущий режим построения может быть изменён, используя "auto" или "manual" в качестве аргумента.

Если первый аргумент hax — это дескриптор оси, то операции выполняются на этой оси, а не на текущей оси, возвращаемой gca.

Примечание для программистов: функция xlim работает, изменяя свойства "xlim" и "xlimmode" объекта оси. Эти свойства можно напрямую проверить и изменить с помощью get/set.

См. также: ylim, zlim, axis, set, get, gca.

Функции xticks, yticks, zticks, rticks, и thetaticks могут быть использованы для получения или установки местоположения и режимов делений на соответствующей оси. Каждая из них имеет ту же форму, хотя опции режима в настоящее время недоступны для rticks, и thetaticks.

: tickval = xticks

: mode = xticks ("mode")

: xticks (tickval)

: xticks ("auto")

: xticks ("manual")

: … = xticks (hax, …)

Получение или установка значений делений на оси абсцисс текущей оси.

При вызове без аргумента возвращает текущие значения делений, как указано в свойстве "xtick" оси. Эти значения можно изменить, вызвав xticks с вектором значений делений. Примечание: возрастающий порядок не требуется.

При вызове с аргументом "mode", xticks возвращает текущее значение свойства оси "xtickmode". Это свойство можно изменить, вызвав xticks с "auto" (алгоритм определяет позиции делений) или "manual" (значения делений остаются неизменными независимо от изменения размера или поворота оси). Примечание: Указание значений xtick также установит свойство "xtickmode" в "manual".

Если первый аргумент hax является дескриптором оси, то операция выполняется на этой оси, а не на текущей оси, возвращаемой gca.

Запрос возвращаемого значения при вызове xticks для установки значения свойства приведет к ошибке.

См. также: xticklabels, yticks, zticks, rticks, thetaticks, get, set.

Функции xticklabels, yticklabels, и zticklabels могут быть использованы для получения или установки метки, присвоенной каждому значению деления, и режима маркировки на соответствующей оси. Каждая из них имеет тот же формат.

: tickval = xticklabels

: mode = xticklabels ("mode")

: xticklabels (tickval)

: xticklabels ("auto")

: xticklabels ("manual")

: … = xticklabels (hax, …)

Получение или установка меток делений на оси абсцисс текущей оси.

При вызове без аргумента возвращает массив строк текущих меток делений, как указано в свойстве "xticklabel" оси. Эти метки могут быть изменены путем вызова xticklabels с массивом строк. Примечание: вектор чисел будет сопоставлен с массивом строк. Если количество меток меньше текущего количества делений, к массиву будут добавлены пустые метки.

При вызове с аргументом "mode", xticklabels возвращает текущее значение свойства оси "xticklabelmode". Это свойство можно изменить, вызвав xticklabels с "auto" (алгоритм определяет метки делений) или "manual" (метки делений остаются неизменными). Примечание: Указание значений xticklabel также установит свойства "xticklabelmode" и "xticks" в "manual".

Если первый аргумент hax является дескриптором оси, то операция выполняется на этой оси, а не на текущей оси, возвращаемой gca.

Запрос возвращаемого значения при вызове xticklabels для установки значения свойства приведет к ошибке.

См. также: xticks, yticklabels, zticklabels, get, set.