`plot`::`Bars3d`

3D столбчатая диаграмма матричных данных

Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.

Live скрипты MATLAB поддерживают большую часть функциональности MuPAD, хотя существуют некоторые различия. Для получения дополнительной информации смотрите, Преобразуют Notebook MuPAD в Live скрипты MATLAB.

Синтаксис

plot::Bars3d(A, <x = x_min .. x_max, y = y_min .. y_max>, <a = a_min .. a_max>, options)
plot::Bars3d(L, <x = x_min .. x_max, y = y_min .. y_max>, <a = a_min .. a_max>, options)

Описание

plot::Bars3d(A) генерирует 3D столбчатую диаграмму с высотами панели, данными записями матричного A.

Строки матрицы построены вдоль координаты x, столбцов вдоль координаты y.

Различные строки могут рассматриваться как различные классы данных. Каждая строка имеет различный цвет, определенный атрибут Colors = _{[ c1, c2, ...]} с RGB или RGBa окрашивает _c1_C2 и т.д.

Самый простой способ получить универсальную форму, окрашивающую всех строк с цветным c должен задать атрибут Color = c.

Массивы/матрицы не должны быть индексированы от 1. Например,

A = array( `i_{min}` .. `i_{max}` , `j_{min}` .. `j_{max}` , [..data..])

дает к столбчатой диаграмме с _{imax - imin + 1} строки и _{jmax - jmin + 1} столбцы, простираясь от _xmin к _xmax в направлении x и от _ymin к _ymax в направлении y.

Если никакая область значений графика `x_{min}` .. `x_{max}`, `y_{min}` .. `y_{max}` задан, _{xmin = jmin - 1}, _{xmax = jmax}, _{ymin = imin - 1}, _{ymax = imax} используется.

Когда значения заданы списком списков L и никакая область значений графика `x_{min}` .. `x_{max}`, `y_{min}` .. `y_{max}` задан, _{xmin = 0}, _{xmax = m}, _{ymin = 0}, _{ymax = n} используется, где n является длиной L, и m является (общей) длиной подсписков в L. Все подсписки (“строки”) должны иметь ту же длину.

Атрибут BarStyle позволяет переключать стиль панелей между Boxes (панели), Lines (вертикальные линии), LinesPoints (вертикальные линии и точки), и Points(только точки). Смотрите Пример 1.

Атрибут Gap = _{[gx, gy]} или, эквивалентно, XGap = _gx, YGap = _gy позволяет вводить разрывы между смежными панелями. Значения _gx, _gy могут быть действительные численные значения между 0 и 1 или выражения параметра анимации a. Эти значения устанавливают часть пробела, зарезервированного для панели, которая не заполнена панелью.

С _{gx = 0}, _{gy = 0}, нет никаких разрывов. С _{gx = 0.5}, _{gy = 0.5}, разрывы между смежными панелями одного размера с панелями. С _{gx = 1}, _{gy = 1}, там панели становятся линиями.

Значения _gx, _gy больше, чем 1 обработаны как 1, отрицательные величины как 0.

Gap атрибут оказывает влияние только для BarStyle = Boxes.

Атрибут Ground = _z0 определяет значение z более низкой или верхней поверхности панелей. Матричные значения _{m > z0} отображены как панели, простирающиеся в направлении z от более низкой поверхности _z0 к верхней поверхности m. Матричные значения _{m < z0} отображены как панели, простирающиеся в направлении z от верхней поверхности _z0 вниз к более низкой поверхности m.

Параметр _z0 должно быть числовое действительное значение или выражение параметра анимации a.

Если атрибут Ground = _z0 не задан, значение по умолчанию _{z0 = 0} используется.

Атрибуты

Атрибут	Цель	Значение по умолчанию
`AffectViewingBox`	влияние объектов на `ViewingBox` из сцены	`TRUE`
`BarStyle`	стиль отображения столбиковых диаграмм	`Boxes`
`Color`	основной цвет
`Colors`	список цветов, чтобы использовать	[`RGB::Blue`, `RGB::Red`, `RGB::Green`, `RGB::MuPADGold`, `RGB::Orange`, `RGB::Cyan`, `RGB::Magenta`, `RGB::LimeGreen`, `RGB::CadmiumYellowLight`, `RGB::AlizarinCrimson`, `RGB::Aqua`, `RGB::Lavender`, `RGB::SeaGreen`, `RGB::AureolineYellow`, `RGB::Banana`, `RGB::Beige`, `RGB::YellowGreen`, `RGB::Wheat`, `RGB::IndianRed`, `RGB::Black`]
`Data`	(статистические) данные, чтобы построить
`Filled`	заполненные или прозрачные области и поверхности	`TRUE`
`Frames`	количество систем координат в анимации	50
`Gap`	разрывы между панелями столбчатой диаграммы	[0, 0]
`Ground`	baseValue	0
`Legend`	делает запись легенды
`LegendText`	короткий объяснительный текст для легенды
`LegendEntry`	добавить этот объект в легенду?	`FALSE`
`LineColor`	цвет линий	`RGB::Black.[0.25]`
`LineWidth`	ширина линий	0.35
`LineStyle`	тело, подчеркнутые штриховой линией или пунктирные линии?	`Solid`
`LinesVisible`	видимость линий	`TRUE`
`Name`	имя объекта графика (для браузера и легенды)
`ParameterEnd`	закончите значение параметра анимации
`ParameterName`	имя параметра анимации
`ParameterBegin`	начальное значение параметра анимации
`ParameterRange`	область значений параметра анимации
`PointSize`	размер точек	1.5
`PointStyle`	стиль презентации точек	`FilledCircles`
`TimeEnd`	время окончания анимации	10.0
`TimeBegin`	время начала анимации	0.0
`TimeRange`	оперативный промежуток анимации	0.0.. 10.0
`Title`	объектный заголовок
`TitleFont`	шрифт объектных заголовков	[`" sans-serif "`, 11]
`TitlePosition`	положение объектных заголовков
`TitleAlignment`	выравнивание по горизонтали заголовков w.r.t. их координаты	`Center`
`TitlePositionX`	положение объектных заголовков, x компонент
`TitlePositionY`	положение объектных заголовков, y компонент
`TitlePositionZ`	положение объектных заголовков, z компонент
`Visible`	видимость	`TRUE`
`VisibleAfter`	объект, видимый после этой временной стоимости
`VisibleBefore`	объект, видимый до этой временной стоимости
`VisibleFromTo`	объект, видимый в это время, располагается
`VisibleAfterEnd`	объект, видимый после его законченного времени анимации?	`TRUE`
`VisibleBeforeBegin`	объект, видимый перед его временем анимации, запускается?	`TRUE`
`XGap`	разрывы в направлении X между панелями столбчатой диаграммы	0
`XMax`	окончательное значение параметра “x”
`XMin`	начальное значение параметра “x”
`XName`	имя параметра “x”
`XRange`	область значений параметра “x”
`YGap`	разрывы в направлении Y между панелями столбчатой диаграммы	0
`YMax`	окончательное значение параметра “y”
`YMin`	начальное значение параметра “y”
`YName`	имя параметра “y”
`YRange`	область значений параметра “y”

Примеры

Пример 1

Мы создаем некоторые случайные матричные данные и строим их как столбчатую диаграмму:

A := matrix::random(5, 10, frandom) :
plot(plot::Bars3d(A, Gap = [0.4, 0.7]))

Мы создаем столбчатые диаграммы данных с различным BarStyle опции:

plot(plot::Scene3d(plot::Bars3d(A, BarStyle = Boxes)),
     plot::Scene3d(plot::Bars3d(A, BarStyle = Lines)),
     plot::Scene3d(plot::Bars3d(A, BarStyle = Points)),
     plot::Scene3d(plot::Bars3d(A, BarStyle = LinesPoints)),
     PointSize = 2.0*unit::mm, LineWidth = 0.5*unit::mm
):

delete A:

Пример 2

Мы демонстрируем расположение столбчатых диаграмм путем указывания диапазонов для x и координаты y. Следующие две столбчатых диаграммы построены в одной сцене. Они размещаются рядом друг с другом через подходящие области значений x:

A := matrix::random(5, 5, frandom):
plot(plot::Bars3d(A, x = 0 .. 0.9, y = 0 .. 1, 
                  BarStyle = LinesPoints),
     plot::Bars3d(A, x = 1.1 .. 2, y = 0 .. 1,
                  Gap = [0.3, 0.7])):

delete A:

Пример 3

Мы демонстрируем атрибуты Ground и Color:

A := matrix::random(5, 10, frandom):
plot(plot::Scene3d(plot::Bars3d(A, Ground = 0,
                                Color = RGB::Grey)),
     plot::Scene3d(plot::Bars3d(A, Ground = 0.5,
                                Color = RGB::Grey)),
     Layout = Horizontal):

В следующем вызове анимирован уровень земли. Обратите внимание на то, что в анимациях нужно указать диапазоны для координат y и x. Мы включаем прозрачную плоскость, визуализирующую уровень земли:

plot(plot::Bars3d(A, x = 0 .. 1, y = 0 .. 1, a = 0 .. PI,
                  Color = RGB::Grey, Gap = [0.5, 0.5], 
                  Ground = sin(a)),
     plot::Surface([x, y, sin(a) + 0.001],
                   x = 0 .. 1, y = 0 .. 1, a = 0 .. PI,
                   Mesh = [2, 2], Color = RGB::Blue.[0.5])):

delete A:

Параметры

`A`	Массив доменного типа `DOM_ARRAY` или матрица категории `Cat::Matrix` (например, типа `matrix` или `densematrix`) содержа действительные численные значения или выражения параметра анимации a. Строки/столбцы массива, соответственно матрица, соответствуют строкам/столбцам столбчатой диаграммы. `A` эквивалентно атрибуту `Data`.
`L`	Список списков действительных численных значений или выражений параметра анимации a. Каждый подсписок L представляет строку столбчатой диаграммы. `L` эквивалентно атрибуту `Data`.
`x`	Имя горизонтальной переменной: идентификатор или индексируемый идентификатор. Это используется в качестве заголовка координатной оси в направлении x. `x` эквивалентно атрибуту `XName`.
`_{xmin .. xmax}`	Область значений горизонтальной переменной: `_xmin_xmax` должно быть числовое действительное значение или выражения параметра анимации a. `_xmin` `_xmax` эквивалентно атрибуту `XRange`.
`y`	Имя вертикальной переменной: идентификатор или индексируемый идентификатор. Это используется в качестве заголовка координатной оси в направлении y. `y` эквивалентно атрибуту `YName`.
`_{ymin .. ymax}`	Область значений вертикальной переменной: `_ymin_ymax` должно быть числовое действительное значение или выражения параметра анимации a. `_ymin` `_ymax` эквивалентно атрибуту `YRange`.
`a`	Параметр анимации, заданный как `a` `_{= amin..amax}`, где `_amin` начальное значение параметров и `_amax` итоговое значение параметров.

Документация

`plot`::`Bars3d`

Синтаксис

Описание

Атрибуты

Примеры

Пример 1

Пример 2

Пример 3

Параметры

Смотрите также

Функции MuPAD

MuPAD графические примитивы

Документация Symbolic Math Toolbox

Поддержка