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

: 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" (значения отметок остаются неизменными независимо от изменения размеров или поворота осей). Примечание: Указание значений xtick также установит свойство "xtickmode" в "manual".

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

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

См. также: xticklabels, yticks, zticks, rticks, thetaticks, 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.

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

: angle = xtickangle () ¶

: angle = xtickangle (hax) ¶

: xtickangle (angle) ¶

: xtickangle (hax, angle) ¶

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

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

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

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

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