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": Зафиксировать текущие пределы осей.
"tickaligned": Зафиксировать пределы осей по ближайшим делениям.
"tight": Зафиксировать пределы осей по данным.
"padded": Зафиксировать пределы осей по данным, добавив поля шириной примерно 7% от диапазона данных.
"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 ()

Запросить или задать пределы цветовой оси графиков.

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

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

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

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

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

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

: xlimits = xlim ()

: xmode = xlim ("mode")

: xmethod = xlim ("method")

: xlim ([x_lo x_hi])

: xlim ("mode")

: xlim ("method")

: xlim (hax, …)

Запросить или задать пределы оси x текущего графика.

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

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

При запросе "method" возвращается текущий метод вычисления пределов x, равный "tickaligned", "tight" или "padded".

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

Текущий режим вычисления пределов "mode" может принимать одно из следующих значений:

"auto" (по умолчанию): Автоматически вычислять пределы на основе данных графика и текущего заданного метода вычисления пределов.
"manual": Фиксировать пределы осей на текущих значениях.

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

"tickaligned" (по умолчанию): Вычислять пределы, охватывающие все данные и выходящие за них до ближайшего деления.
"tight": Вычислять пределы, точно соответствующие диапазону данных.
"padded": Вычислять пределы, оставляя вокруг данных поле шириной примерно 7% от диапазона данных.

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

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

: ylimits = ylim ()

: ymode = ylim ("mode")

: ymethod = ylim ("method")

: ylim ([y_lo y_hi])

: ylim ("mode")

: ylim ("method")

: ylim (hax, …)

Запросить или задать пределы оси y текущего графика.

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

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

При запросе "method" возвращается текущий метод вычисления пределов y, равный "tickaligned", "tight" или "padded".

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

Текущий режим вычисления пределов "mode" может принимать одно из следующих значений:

"auto" (по умолчанию): Автоматически вычислять пределы на основе данных графика и текущего заданного метода вычисления пределов.
"manual": Фиксировать пределы осей на текущих значениях.

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

"tickaligned" (по умолчанию): Вычислять пределы, охватывающие все данные и выходящие за них до ближайшего деления.
"tight": Вычислять пределы, точно соответствующие диапазону данных.
"padded": Вычислять пределы, оставляя вокруг данных поле шириной примерно 7% от диапазона данных.

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

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

: zlimits = zlim ()

: zmode = zlim ("mode")

: zmethod = zlim ("method")

: zlim ([z_lo z_hi])

: zlim ("mode")

: zlim ("method")

: zlim (hax, …)

Запросить или задать пределы оси z текущего графика.

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

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

При запросе "method" возвращается текущий метод вычисления пределов z, равный "tickaligned", "tight" или "padded".

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

Текущий режим вычисления пределов "mode" может принимать одно из следующих значений:

"auto" (по умолчанию): Автоматически вычислять пределы на основе данных графика и текущего заданного метода вычисления пределов.
"manual": Фиксировать пределы осей на текущих значениях.

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

"tickaligned" (по умолчанию): Вычислять пределы, охватывающие все данные и выходящие за них до ближайшего деления.
"tight": Вычислять пределы, точно соответствующие диапазону данных.
"padded": Вычислять пределы, оставляя вокруг данных поле шириной примерно 7% от диапазона данных.

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

См. также: xlim, ylim, 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".

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

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

: tickval = yticks

: mode = yticks ("mode")

: yticks (tickval)

: yticks ("auto")

: yticks ("manual")

: … = yticks (hax, …)

Запросить или задать значения делений на оси y текущих осей.

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

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

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

См. также: yticklabels, xticks, zticks, rticks, thetaticks, get, set.

: tickval = zticks

: mode = zticks ("mode")

: zticks (tickval)

: zticks ("auto")

: zticks ("manual")

: … = zticks (hax, …)

Запросить или задать значения делений на оси z текущих осей.

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

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

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

См. также: zticklabels, xticks, yticks, rticks, thetaticks, get, set.

: tickval = rticks

: rticks (tickval)

: … = rticks (hax, …)

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

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

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

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

ПРИМЕЧАНИЕ: В Octave пока не реализованы объекты polaraxes. Поэтому невозможно запросить или задать "mode" для свойства "rtick", как это можно сделать с помощью соответствующих функций для осей x, y и z.

См. также: thetaticks, xticks, yticks, zticks, polar, get, set.

: tickval = thetaticks

: thetaticks (tickval)

: … = thetaticks (hax, …)

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

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

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

ПРИМЕЧАНИЕ: В Octave пока не реализованы объекты polaraxes. Поэтому невозможно запросить или задать "mode" для свойства "thetatick", как это можно сделать с помощью соответствующих функций для осей x, y и z.

См. также: rticks, xticks, yticks, zticks, polar, get, set.

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

: labels = 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".

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

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

: labels = yticklabels

: mode = yticklabels ("mode")

: yticklabels (tickval)

: yticklabels ("auto")

: yticklabels ("manual")

: … = yticklabels (hax, …)

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

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

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

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

См. также: yticks, xticklabels, zticklabels, get, set.

: labels = zticklabels

: mode = zticklabels ("mode")

: zticklabels (tickval)

: zticklabels ("auto")

: zticklabels ("manual")

: … = zticklabels (hax, …)

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

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

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

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

См. также: zticks, xticklabels, zticklabels, get, set.

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

: angle = xtickangle ()

: angle = xtickangle (hax)

: xtickangle (angle)

: xtickangle (hax, angle)

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

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

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

Примечания по программированию:

Свойство "XTickLabelRotation" в настоящее время не реализовано в Octave. Это свойство можно задавать и запрашивать, но оно не влияет на график.
Запрос возвращаемого значения одновременно с заданием угла поворота приведет к ошибке.

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

: angle = ytickangle ()

: angle = ytickangle (hax)

: ytickangle (angle)

: ytickangle (hax, angle)

Запрос или установка угла поворота подписей делений на оси y текущих осей.

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

Примечания по программированию:

Свойство "YTickLabelRotation" в настоящее время не реализовано в Octave. Это свойство можно задавать и запрашивать, но оно не влияет на график.
Запрос возвращаемого значения одновременно с заданием угла поворота приведет к ошибке.

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

: angle = ztickangle ()

: angle = ztickangle (hax)

: ztickangle (angle)

: ztickangle (hax, angle)

Запрос или установка угла поворота подписей делений на оси z текущих осей.

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

Примечания по программированию:

Свойство "ZTickLabelRotation" в настоящее время не реализовано в Octave. Это свойство можно задавать и запрашивать, но оно не влияет на график.
Запрос возвращаемого значения одновременно с заданием угла поворота приведет к ошибке.

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

© 1996–2026 The Octave Project Developers
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.
https://docs.octave.org/v9.4.0/Axis-Configuration.html