график::
3D столбчатая диаграмма матричных данных
Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.
Live скрипты MATLAB поддерживают большую часть функциональности MuPAD, хотя существуют некоторые различия. Для получения дополнительной информации смотрите, Преобразовывают Notebook MuPAD в Live скрипты MATLAB.
Синтаксис
plot::Bars3d(A, <x = xmin .. xmax, y = ymin .. ymax>, <a = amin .. amax>,options) plot::Bars3d(L, <x = xmin .. xmax, y = ymin .. ymax>, <a = amin .. amax>,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. Каждый подсписок L представляет строку столбчатой диаграммы.
|
|
Имя горизонтальной переменной: идентификатор или индексируемый идентификатор. Это используется в качестве заголовка координатной оси в направлении x.
|
|
Область значений горизонтальной переменной:
|
|
Имя вертикальной переменной: идентификатор или индексируемый идентификатор. Это используется в качестве заголовка координатной оси в направлении y.
|
|
Область значений вертикальной переменной:
|
|
Параметр анимации, заданный как |