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]"

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

"manual"

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

"tight"

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

"image"

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

"vis3d"

Установить режимы соотношения сторон осей на "manual" для вращения без растяжения.

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

"tic[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, …)

Запрос или установка значений делений на оси x текущей оси.

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

Если вызвана с аргументом "mode", xticks возвращает текущее значение свойства оси "xtickmode". Это свойство можно изменить, вызвав xticks с "auto" (алгоритм определяет позиции делений) или "manual" (значения делений остаются фиксированными независимо от изменения размера или вращения осей). Примечание: Установка значений делений x также устанавливает свойство "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.