Пакет: mlreportgen.dom
Таблица MATLAB
Преобразование MATLAB® таблица в таблицу DOM.
создает объект таблицы на основе указанной таблицы MATLAB. MLTableObj
= MATLABTable(table
)
создает объект таблицы и применяет заданный стиль таблицы. Определите стиль в шаблоне, используемом для создания отчета, содержащего эту таблицу.MLTableObj
= MATLABTable(table
,stylename
)
table
- таблица MATLABТаблица MATLAB.
Типы данных: double
stylename
- Стиль для применения к таблицеСтиль для применения к таблице, заданный как вектор символов.
BackgroundColor
- Цвет фона[]
(по умолчанию) | символьный вектор | строковый скалярЦвет фона, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS (см. https://www.crockford.com/wrrrld/color.html) или шестнадцатеричного значения RGB (truecolor) в форме #RRGGBB
.
Установка BackgroundColor
свойство добавляет соответствующее mlreportgen.dom.BackgroundColor
форматировать объект в Style
свойство. Установка BackgroundColor
свойство для пустого значения удаляет объект.
Пример: 'blue'
Пример: '#0000ff'
Body
- Тело таблицыmlreportgen.dom.TableBody
объектКонструктор таблицы создает объект тела таблицы и присваивает его этому свойству при построении формальной таблицы. Впоследствии вы не можете задать это свойство. Однако можно добавить содержимое к телу таблицы и задать его свойства с помощью этого свойства.
Border
- Тип границы для рисования'solid'
| 'single'
| 'dashed'
| 'none'
| ...Тип границы для рисования, заданный как одно из значений в таблице.
Значение границы | Описание | Поддерживаемые выходные типы |
---|---|---|
| Штриховая линия | Все типы выхода |
| Линия с чередующимися диагональными штрихами и точкой | Word |
| Штриховая линия с небольшой погрешностью между штрихами | Word |
| Пунктирная линия | Все типы выхода |
| Линия с чередующимися точками и штрихами | Word |
| Линия с чередующимися двойными точками и штрихом | Word |
| Двойная линия | Все типы выхода |
| Двойная волнистая линия | Word |
| 3-D эффект канавки линии | HTML и PDF |
| Нет линии The | HTML и PDF |
| 3-D эффектная линия | Все типы выхода |
| Нет линии The | Все типы выхода |
| 3-D эффектная линия | Все типы выхода |
| 3-D эффект обрезка линии | HTML и PDF |
| Одна линия | Word |
| Одна линия | HTML и PDF |
| Толстая линия | Word |
| Штриховая линия с чередующимися толстыми и тонкими штрихами с большим зазором | Word |
| Штриховая линия с чередующимися толстыми и тонкими штрихами со средним зазором | Word |
| Штриховая линия с чередующимися толстыми и тонкими штрихами с небольшим зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами со средним зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами, со средним зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами с небольшим зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами с большим зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами со средним зазором | Word |
| Штриховая линия с чередующимися тонкими и толстыми штрихами с небольшим зазором | Word |
| Рельефная линия эффекта | Word |
| Гравированная линия эффекта | Word |
| Тройная линия | Word |
| Волнистая линия | Word |
BorderCollapse
- Свернуть границы смежных ячеек в одну границу (только HTML)'on'
| 'off'
Значение 'on'
сворачивает границы соседних элементов в одну границу. Значение 'off'
сохраняет границы соседних элементов.
BorderColor
- Цвет границыЦвет границы, заданный как:
Имя цвета. Имя должно быть CSS- названия цвета. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричное значение RGB (truecolor) как #RRGGBB
. Для примера, #0000ff
- оттенок синего.
BorderWidth
- Ширина границы таблицыШирина границы таблицы, заданная в форме valueUnits
, где Units
- сокращение для модулей. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Children
- Дочерние элементы элемента документаДочерние элементы этого элемента документа, заданные как массив объектов DOM. Это свойство доступно только для чтения.
ColSep
- Стиль линии, разделяющей столбцыСтиль линии, разделяющей столбцы таблицы или раздела таблицы (заголовок, тело, нижний колонтитул), заданный mlreportgen.dom.ColSep
объект.
См. описание Border
свойство для описания возможных значений.
ColSepColor
- Цвет линий, разделяющих столбцыЦвет линий, разделяющих столбцы, задается как:
Имя цвета. Имя должно быть CSS- названия цвета. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричное значение RGB (truecolor) как #RRGGBB
. Для примера, #0000ff
- оттенок синего.
ColSepWidth
- Ширина линий, разделяющих столбцы таблицыШирина линий, разделяющих столбцы таблицы, в форме valueUnits
. Используйте одно из следующих сокращений для Units
:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Для примера для диафрагмы столбца из 3 точек установите ColSepWidth
свойство к '3pt'
.
ColSpecGroups
- Свойства группы столбцов в таблицеmlreportgen.dom.TableColSpecGroup
объектыМассив mlreportgen.dom.TableColSpecGroup
объекты, задающие ширину, выравнивание и другие свойства группы столбцов. Первый объект относится к первой группе столбцов, второй - ко второй группе и так далее. Укажите количество столбцов, принадлежащих каждой группе, используя Span
свойство TableColSpecGroup
объект. Для примера, если первый объект имеет диапазон 2, он применяется к первым двум столбцам. Если вторая группа имеет диапазон 3, она применяется к следующим трем столбцам и так далее.
CustomAttributes
- Пользовательские атрибуты для элемента документаmlreportgen.doc.CustomAttribute
объектыПользовательские атрибуты должны поддерживаться типом выхода документа, к которому добавлен этот элемент документа.
FlowDirection
- Направление потока столбца'ltr'
| 'rtl'
Направление потока столбца, заданное как:
'ltr'
- Поток слева направо (столбец 1 расположен слева в таблице).
'rtl'
- Поток справа налево (столбец 1 расположен справа в таблице).
Footer
- Нижний колонтитул для этой таблицыmlreportgen.dom.TableFooter
объектКонструктор таблицы создает объект нижнего колонтитула таблицы и присваивает его этому свойству при построении формальной таблицы. Впоследствии вы не можете задать это свойство. Однако можно добавить содержимое к телу таблицы и задать его свойства с помощью этого свойства.
HAlign
- Горизонтальное выравнивание этой таблицы'center'
| 'left'
| 'right'
Горизонтальное выравнивание этой таблицы, заданное как одно из следующих значений:
'center'
'left'
'right'
Примечание
Чтобы предотвратить переполнение больших таблиц в PDF- выход, установите Width
свойство.
Header
- Заголовок таблицыmlreportgen.dom.TableHeader
объектКонструктор таблицы создает объект заголовка таблицы и присваивает его этому свойству при построении формальной таблицы. Впоследствии вы не можете задать это свойство. Однако можно добавить содержимое к телу таблицы и задать его свойства с помощью этого свойства.
HeaderRule
- Горизонтальное правило для курсаmlreportgen.dom.HorizontalRule
объектГоризонтальное правило для заголовка, заданное как mlreportgen.dom.HorizontalRule
объект.
Id
- идентификатор для этого элемента документаИдентификатор для этого элемента документа, заданный как вектор символов или строковый скаляр. DOM генерирует уникальный идентификатор сеанса при создании элемента документа. Вы можете задать свой собственный идентификатор.
NCols
- Количество столбцовКоличество столбцов в виде целого числа.
OuterLeftMargin
- Левое поле (отступы) элемента документаЛевый углубление в форме valueUnits
. Units
- сокращение для модулей. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Parent
- Родительский элемент элемента документаРодительский элемент этого элемента документа, заданный как объект DOM. Это свойство доступно только для чтения.
RowNamesRule
- Включите правило для столбца с именами строкСвойство для включения правила в первом столбце, содержащем имена строк, заданное как логическое. Объект таблицы MATLAB должен определять имена строк.
RowSep
- Стиль линий, разделяющих строкиСтиль линии, разделяющей строки таблицы или раздела таблицы (заголовок, тело или нижний колонтитул).
См. описание Border
свойство для описания возможных значений.
RowSepColor
- Цвет диафрагмы строкМожно задать:
Имя цвета. Имя должно быть CSS- названия цвета. См. https://www.crockford.com/wrrrld/color.html.
Шестнадцатеричное значение RGB (truecolor) как #RRGGBB
. Для примера, #0000ff
- оттенок синего.
RowSepWidth
- Ширина диафрагмы строкШирина диафрагмы строк, заданная в форме valueUnits
где Units
- сокращение для модулей. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Style
- Формат таблицыМассив объектов формата (таких как Bold
объекты), которые задают формат для этой таблицы.
Это свойство переопределяет соответствующие форматы, заданные стилем таблицы стилей, заданным в StyleName
свойство.
StyleName
- Стиль в таблице стилей элементов документа или документаИмя стиля, заданное в таблице стилей документа или детали документа, к которой добавлена эта таблица.
Стиль, задающий внешний вид этой таблицы в выход документе, для форматов, не заданных Style
свойство.
Можно задать StyleName
свойство любого формального раздела таблицы. Настройка StyleName
переопределяет стиль, заданный самой формальной таблицей. Однако, если вы делаете это для документа Word, необходимо явным образом задать ширину каждого столбца в разделе, чтобы убедиться, что все разделы имеют одинаковую ширину. Word, в отличие от HTML и PDF, не имеет встроенной поддержки формальных таблиц. Для этого интерфейс DOM представляет формальную таблицу в виде трех таблиц, по одной для каждого раздела, встроенных в таблицу 3 на 1.
TableEntriesStyle
- Стиль, используемый для записей таблицыМассив ячеек из объектов формата, которые задают формат для записей таблицы.
TableEntriesInnerMargin
- Внутренний запас для записей таблицыВнутреннее поле является полем между содержимым камер таблицы и границами камер в форме valueUnits
где Units
- сокращение для модулей. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Tag
- тег для этого элемента документаТег для этого элемента документа, заданный как вектор символов или строковый скаляр.
DOM генерирует тег с уникальным сеансом как часть создания этого объекта. Сгенерированный тег имеет форму CLASS: ID, где CLASS является классом объекта, а ID является значением Id
свойство объекта. Определение собственного значения тега может помочь вам определить, где произошла проблема во время генерации документа.
Width
- Ширина таблицыПроцент (для примера, '100%'
) ширины страницы (минус поля для отчетов Word) или ряда единиц измерения, имеющих формат valueUnits
. Units
- сокращение для модулей. Это действительные сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Этот пример создает таблицу DOM из таблицы MATLAB с именами строк. Пример генерирует два отчета, которые включают таблицу DOM. В первом отчете столбец с именами строк таблицы не имеет метки. Во втором отчете столбец с именами строк имеет метку.
Составьте таблицу MATLAB, которая показывает возраст, вес и рост пациентов. Используйте RowNames
опция для идентификации каждой строки по последнему имени пациента.
LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'}; Age = [38;43;38;40;49]; Weight = [176;163;131;133;119]; Height = [71;69;64;67;64]; mltable = table(Age,Weight,Height,'RowNames',LastName)
mltable=5×3 table
Age Weight Height
___ ______ ______
Sanchez 38 176 71
Johnson 43 163 69
Lee 38 131 64
Diaz 40 133 67
Brown 49 119 64
Таблица MATLAB содержит пять строк и три столбца. Имена строк не являются частью таблицы. Они хранятся в свойстве таблицы.
Создайте mlreportgen.dom.MATLABTable
объект из MATLAB
таблица.
import mlreportgen.dom.*
mltableObj = MATLABTable(mltable);
Создайте документ и добавьте MATLABTable
объект документа. Закройте и просмотрите документ.
d = Document('MyMATLABTable1','docx'); append(d,mltableObj); close(d); rptview(d);
Вот таблица в сгенерированном отчете:
Таблица DOM является формальной таблицей, которая имеет заголовок и тело. Тело таблицы имеет пять строк и четыре столбца. Первый столбец состоит из имен строк таблицы MATLAB.
Сгенерируйте отчет снова, на этот раз с меткой для столбца с именами строк. Чтобы задать метку, замените пустой текст в первой записи строки заголовка таблицы текстом метки. Чтобы нарисовать линию под меткой, установите RowNamesRule
свойство MATLABTable
объект к true
.
LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'}; Age = [38;43;38;40;49]; Weight = [176;163;131;133;119]; Height = [71;69;64;67;64]; mltable = table(Age,Weight,Height,'RowNames',LastName); import mlreportgen.dom.* mltableObj = MATLABTable(mltable); th = mltableObj.Header; thentry11 = entry(th,1,1); thentry11.Children(1).Children(1).Content = 'Names'; mltableObj.RowNamesRule = true; d = Document('MyMATLABTable2','docx'); append(d,mltableObj); close(d); rptview(d);
Вот таблица в сгенерированном отчете:
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.