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" используются в качестве пределов.

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

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

Примечание для программистов: цветовая ось влияет на отображение графических объектов типа 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% диапазона данных вокруг данных.

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

Примечание для программистов: функция 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, …) ¶

: 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% от диапазона данных вокруг данных.

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

Примечание для программистов: функция 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".

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

Запрос возвращаемого значения при вызове 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".

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

Запрос возвращаемого значения при вызове 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".

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

Запрос значения при вызове 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 с вектором значений делений. Примечание: порядок возрастания не требуется.

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

Запрос значения при вызове 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".

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

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

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

: labels = yticklabels ¶

: mode = yticklabels ("mode") ¶

: yticklabels (tickval) ¶

: yticklabels ("auto") ¶

: yticklabels ("manual") ¶

: … = yticklabels (hax, …) ¶

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

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

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

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

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

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

: labels = zticklabels ¶

: mode = zticklabels ("mode") ¶

: zticklabels (tickval) ¶

: zticklabels ("auto") ¶

: zticklabels ("manual") ¶

: … = zticklabels (hax, …) ¶

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

: angle = xtickangle () ¶

```

: angle = ztickangle () ¶

: angle = ztickangle (hax) ¶

: ztickangle (angle) ¶

: ztickangle (hax, angle) ¶

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

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

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

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

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

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