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 возвращает текущие пределы осей.

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

Следующие параметры контролируют соотношение сторон осей.

"equal"

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

"square"

Принудительно устанавливает квадратное соотношение сторон осей.

"vis3d"

Устанавливает режимы соотношения сторон ("DataAspectRatio", "PlotBoxAspectRatio") в "manual" для поворота без растяжения.

"normal"

"fill"

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

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

"auto"

"auto[xyz]"

"auto [xyz]"

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

"manual"

Фиксирует текущие пределы осей.

"tight"

Фиксирует оси на пределы данных.

"image"

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

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

"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 () ¶

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

Аргумент пределы должен быть вектором из 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".

Если передана двумерная вектор [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, …) ¶

Получение или установка значений меток на оси X текущих осей.

При вызове без аргументов возвращаются текущие позиции меток, как указано в свойстве "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, …) ¶

Получение или установка меток на оси X текущих осей.

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

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

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

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

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

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

: angle = xtickangle () ¶

: angle = xtickangle (hax) ¶

: xtickangle (angle) ¶

: xtickangle (hax, angle) ¶

Получение или установка угла поворота меток на оси X текущих осей.

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

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

Примечание для программистов: запрос значения при установке указанного угла поворота приведет к ошибке.

См. также: ytickangle, ztickangle, get, set.