ГОСТ Р ИСО/МЭК 26300—2010/Раздел 10

ГОСТ Р ИСО/МЭК 26300—2010 «Информационная технология. Формат Open Document для офисных приложений (OpenDocument) v1.0» — Раздел 10

10 Содержимое диаграмм

В этом разделе описано XML-представление содержимого диаграммы:

• введение в документы диаграмм;
• диаграмма;
• заголовок, подзаголовок и нижний колонтитул;
• легенда;
• область построения;
• стена;
• основание диаграммы;
• оси координат;
• ряды данных;
• категории;
• точка данных;
• среднее значение;
• индикатор ошибок;
• кривые регрессии.

10.1 Введение в документы диаграмм

Документы диаграмм всегда содержатся внутри других XML-документов. Существует два типа документов, в которых могут содержаться диаграммы:

• документы, которые не предоставляют данные для диаграммы, данные в диаграмме содержатся в элементе <table:table> внутри элемента <chart:chart>;
• документы, которые предоставляют данные для диаграммы, данные диаграммы могут содержаться в элементе <table:table> в родительском документе, например в электронной таблице или текстовом документе.

Данные диаграммы описываются атрибутом table:cell-range-address в элементе <chart:plot-area>. Элемент <chart:plot-area> представляет визуальный контейнер всего ряда данных в диаграмме.

10.2 Диаграмма

Элемент <chart:chart> представляет всю диаграмму, включая заголовки, легенду и графический объект, отображающий базовые данные, называемый областью построения. Данные, лежащие в основе диаграммы, представлены элементом таблицы. Этот элемент может также существовать для встроенных диаграмм, которые получают данные из документа-контейнера. В этом случае диаграмма может быть визуализирована без получения данных из контейнерного документа.

<define name="chart-chart">
    <element name="chart:chart">
        <ref name="chart-chart-attlist"/>
        <optional>
            <ref name="chart-title"/>
        </optional>
        <optional>
            <ref name="chart-subtitle"/>
        </optional>
        <optional>
            <ref name="chart-footer"/>
        </optional>
        <optional>
            <ref name="chart-legend"/>
        </optional>
            <ref name="chart-plot-area"/>
        <optional>
            <ref name="table-table"/>
        </optional>
    </element>
</define>

Класс

Атрибут chart:class определяет тип диаграммы. Тип диаграммы представлен токеном из пространства имен, означающим идентификатор, которому предшествует XML-префикс пространства имен, подобно любому имени атрибута или элемента в данной спецификации. Спецификацией определено несколько типов диаграмм в пространстве имен диаграммы (URN:urn:oasis:names:tc:opendocument:xmlns:chart:1.0). Также могут использоваться дополнительные типы диаграмм при условии использования другого пространства имен.

Тип диаграммы может быть указан более точно путем изменения свойств, которые могут быть добавлены к стилям диаграммы. Например, трехмерная горизонтальная гистограмма задана с помощью атрибута класса chart:bar путем добавления свойств трехмерности и горизонтального расположения в соответствующий стиль.

<define name="chart-chart-attlist" combine="interleave">
    <attribute name="chart:class">
        <ref name="namespacedToken"/>
    </attribute>
</define>

Предопределенные типы диаграмм:

• линейная (line) — точки каждого ряда данных соединены линиями;
• с областями (area) — область под рядом данных заполнена, а дополнительные ряды данных расположены ярусами;
• круговая (circle) — круговая диаграмма поделена на сегменты согласно относительным весам точек данных;
• кольцевая (ring) — каждый ряд данных представляет собой концентрические кольца, где каждое кольцо отображено так, будто оно является частью круговой диаграммы;
• диаграмма XY (scatter) — пара рядов данных, используемых для определения позиции каждой точки по осям X и Y;
• лепестковая (radar) — точки данных в полярной системе координат, где значение каждой точки определяет расстояние от центра диаграммы, причем точки данных серии соединены так, что формируют замкнутую линию вокруг центра;
• гистограмма (bar) — каждая точка данных изображена как полоса длиной, пропорциональной значению точки данных;
• биржевая (stock) — четыре ряда данных интерпретируются как значение при открытии биржи, минимальное значение, максимальное и значение при закрытии биржи;
• пузырьковая (bubble) — первые два или три ряда данных определяют позиции как в диаграмме XY, где размер области каждой точки определяется относительно значения в третьем ряду данных;
• поверхность (surface) — точки данных интерпретируются как табулированные данные, где каждое значение определяет высоту в определенном месте сетки, что на графике может быть отображено с помощью цветов для интервалов высот, путем создания цветовых карт подобно географическим картам;
• диаграмма Ганта (gannt) — пара рядов данных, которая используется для определения начальной и конечной позиции для горизонтальных полос.

Пример — В следующей таблице показаны примеры предопределенных типов диаграмм. Те диаграммы, которые используют один или два ряда данных, используют два ряда данных со значениями 1;2;3;4 и 1;4;9;16 и метки a;b;c;d. Те типы диаграмм, которые используют больше, чем два ряда данных (биржевая и пузырьковая), используют ряды данных 1;2;3;4 и их комбинации. Лепестковая диаграмма использует два ряда данных с пятью точками.

chart:line	chart:area	chart:circle
chart:ring	chart:scatter	chart:radar
chart:bar	chart:stock	chart:bubble
chart:surface	chart:gantt

Размер

Атрибуты svg:width и svg:height (см. раздел 9.2.15) определяют размер всей диаграммы. Если они опущены, размер диаграммы определяется размером окна, в котором будет отображена диаграмма.

<define name="chart-chart-attlist" combine="interleave">
    <ref name="common-draw-size-attlist"/>
</define>

Отображение строк и столбцов

Атрибуты chart:column-mapping и chart:row-mapping содержат, если задан, список индексов рядов данных. Числа определяют переупорядочение данных, которые поступают из документа-контейнера, предоставляющего данные для диаграммы. Нумерация начинается с 1. Упорядоченный по возрастанию список, начинающийся с 1, не вызовет никакого эффекта. Чтобы поменять два ряда, нужно поменять номера в списке. Например, для 1 3 2 4 меняются второй и третий ряды.

Атрибуты chart:column-mapping и chart:row-mapping не должны использоваться одновременно.

<define name="chart-chart-attlist" combine="interleave">
    <optional>
        <attribute name="chart:column-mapping">
            <ref name="string"/>
        </attribute>
    </optional>
</define>
<define name="chart-chart-attlist" combine="interleave">
    <optional>
        <attribute name="chart:row-mapping">
            <ref name="string"/>
        </attribute>
    </optional>
</define>

Имя стиля

Атрибут chart:style-name ссылается на стиль диаграммы (см. раздел 14.16).

В пределах стиля, применяемого к элементу <chart:chart>, могут использоваться свойства заполнения (описано в разделе 15.14) и свойства контурной линии (описано в разделе 15.13), а также свойство масштабирования текста, описанное в разделе 15.29.1.

<define name="chart-chart-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.3 Заголовок, подзаголовок и нижний колонтитул

10.3.1 Заголовок

Элемент <chart:title> представляет главный заголовок объекта в документе диаграммы. Этот элемент может содержать фиксированный текст или элемент <table:cell-address>, указывающий на текст, который должен быть отображен как заголовок. Этот элемент может быть подэлементом chart:axis (см. раздел 10.8). В этом случае заголовок будет отображен за пределами осей координат.

<define name="chart-title">
    <element name="chart:title">
        <ref name="chart-title-attlist"/>
        <optional>
            <ref name="text-p"/>
        </optional>
    </element>
</define>

Диапазон таблицы

Заголовок диаграммы может быть привязан к ячейке таблицы, поэтому текущее содержимое данной ячейки будет отображено в названии диаграммы.

<define name="chart-title-attlist" combine="interleave">
    <optional>
        <attribute name="table:cell-range">
            <ref name="cellAddress"/>
        </attribute>
    </optional>
</define>

Положение и размер

Общий атрибут расположения для графических объектов может использоваться в элементах <chart:title>.

<define name="chart-title-attlist" combine="interleave">
    <ref name="common-draw-position-attlist"/>
</define>

Имя стиля

Атрибут chart:style-name определяет стиль диаграммы для элемента <chart:title>. В данном стиле могут быть использованы свойства заполнения и обрамления. Они применяются к области, окружающей заголовок (см. разделы 15.14 и 15.13 для получения дополнительной информации). В дополнение к этому могут использоваться свойства текста. Они применяются непосредственно к тексту заголовка (см. раздел 15.4).

<define name="chart-title-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.3.2 Подзаголовок

Элемент <chart:subtitle> представляет подзаголовок, который может использоваться для отображения дополнительного заголовка к диаграмме.

Структура элемента <chart:subtitle> схожа со структурой элемента <chart:title>. С элементом <chart:subtitle> могут быть связаны те же атрибуты, что и с элементом <chart:title> (см. раздел 10.3.1 для получения дополнительной информации).

<define name="chart-subtitle">
    <element name="chart:subtitle">
        <ref name="chart-title-attlist"/>
        <optional>
            <ref name="text-p"/>
        </optional>
    </element>
</define>

10.3.3 Нижний колонтитул

Элемент <chart:footer> представляет нижний колонтитул под областью построения диаграммы.

Структура элемента подзаголовка та же, что и для элемента заголовка <chart:title> (см. раздел 10.3.1 для получения дополнительной информации).

<define name="chart-footer">
    <element name="chart:footer">
        <ref name="chart-title-attlist"/>
        <optional>
            <ref name="text-p"/>
        </optional>
    </element>
</define>

10.4 Легенда

Элемент <chart:legend> определяет, отображается ли легенда на диаграмме. Положение легенды может быть указано как относительное или как абсолютное. Размер легенды вычисляется автоматически и поэтому не может быть установлен через атрибут.

<define name="chart-legend">
    <element name="chart:legend">
        <ref name="chart-legend-attlist"/>
        <empty/>
    </element>
</define>

Размещение легенды

Легенда может быть помещена автоматически, рядом с областью построения или в одном из углов. Размещение определяется атрибутом chart:legend-position, который может принимать значения start, end, top, bottom для размещения легенды рядом с областью построения и top-start, bottom-start, top-end или bottom-end для размещения легенды в углах. Если легенда расположена рядом с областью построения в любом из четырех положений start, end, top bottom, дополнительный атрибут выравнивания chart:legend-align определяет, какая граница (start, end) или ось координат (center) легенды и области построения должна быть выровнены.

<define name="chart-legend-attlist" combine="interleave">
    <choice>
        <group>
            <attribute name="chart:legend-position">
                <choice>
                    <value>start</value>
                    <value>end</value>
                    <value>top</value>
                    <value>bottom</value>
                </choice>
            </attribute>
            <optional>
                <attribute name="chart:legend-align">
                    <choice>
                        <value>start</value>
                        <value>center</value>
                        <value>end</value>
                    </choice>
                </attribute>
            </optional>
        </group>
        <attribute name="chart:legend-position">
            <choice>
                <value>top-start</value>
                <value>bottom-start</value>
                <value>top-end</value>
                <value>bottom-end</value>
            </choice>
        </attribute>
        <empty/>
    </choice>
</define>

Пример — Если chart:legend-position="right", легенда будет размещена справа от области построения диаграммы. Значения chart:legend-align, равные start, center и end, приведут к положению легенды, как изображено зеленым, красным и синим квадратами соответственно.

Положение легенды может быть задано в абсолютных координатах, как для любого отображаемого объекта. Если доступны и положение рисунка, и опции размещения легенды, то размещение легенды имеет приоритет, и позиция будет определена автоматически.

<define name="chart-legend-attlist" combine="interleave">
    <ref name="common-draw-position-attlist"/>
</define>

Расширение легенды

Для размещения дополнительных пунктов легенда должна быть расширена. Атрибут style:legend-expansion определяет, в каком направлении расширяется легенда. Расширение легенды по wide и high вызывает расширение легенды по горизонтали и вертикали. Расширение balanced вызывает расширение в обоих направлениях. Значение расширения custom с числовым style:legend-expansion-aspect-ratio заставляет легенду расширяться таким образом, что соблюдается отношение между шириной и высотой.

<define name="chart-legend-attlist" combine="interleave">
    <choice>
        <attribute name="style:legend-expansion">
            <choice>
                <value>wide</value>
                <value>high</value>
                <value>balanced</value>
            </choice>
        </attribute>
        <group>
            <attribute name="style:legend-expansion">
                <value>custom</value>
            </attribute>
            <attribute name="style:legend-expansion-aspect-ratio">
                <ref name="double"/>
            </attribute>
        </group>
        <empty/>
    </choice>
</define>

Стиль легенды

Дополнительная информация о стиле легенды может быть задана через атрибут chart:style-name. В стиле могут устанавливаться свойства заполнения и обрамления. Они применимы к легенде (см. разделы 15.14 и 15.13 для получения дополнительной информации). В дополнение к этому, стиль может определить свойства текста. Они применимы к тексту внутри объекта легенды (см. раздел 15.4).

<define name="chart-legend-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.5 Область построения

Элемент <chart:plot-area> является контейнером для графических объектов, которые представляют данные диаграммы. Основное предназначение области построения — быть контейнером для элементов ряда, которые представляют единственный ряд данных и элементы координатной оси.

<define name="chart-plot-area">
    <element name="chart:plot-area">
        <ref name="chart-plot-area-attlist"/>
        <zeroOrMore>
            <ref name="dr3d-light"/>
        </zeroOrMore>
        <zeroOrMore>
            <ref name="chart-axis"/>
        </zeroOrMore>
        <zeroOrMore>
            <ref name="chart-series"/>
        </zeroOrMore>
        <optional>
            <ref name="chart-stock-gain-marker"/>
        </optional>
        <optional>
            <ref name="chart-stock-loss-marker"/>
        </optional>
        <optional>
            <ref name="chart-stock-range-line"/>
        </optional>
        <optional>
            <ref name="chart-wall"/>
        </optional>
        <optional>
            <ref name="chart-floor"/>
        </optional>
    </element>
</define>

Позиционирование области построения

Позиция и размер области построения определяются общими атрибутами положения и размера для отображаемых объектов. Если атрибуты положения и размера не указаны, то значения вычисляются визуализирующим приложением.

<define name="chart-plot-area-attlist" combine="interleave">
    <ref name="common-draw-position-attlist"/>
    <ref name="common-draw-size-attlist"/>
</define>

Стиль области построения

Атрибут chart:style-name, который установлен для элемента <chart:plot-area>, используется для всех элементов данных, содержащихся в области построения, если не определены дополнительные стили в одном из подэлементов. Эти элементы данных могут быть элементами <chart:series> и <chart:data-point>.

Если диаграмма является трехмерной, то к области построения могут быть применены трехмерные свойства сцены (см. разделы 15.22—15.26 для получения дополнительной информации).

<define name="chart-plot-area-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

Атрибуты данных области построения

Если диаграмма встроена в документ, в котором содержатся данные для диаграммы, атрибут table:cell-range-address отражает диапазоны, в которых находятся все данные для диаграммы. Заданный здесь диапазон интерпретируется диаграммой как последовательные ряды данных.

<define name="chart-plot-area-attlist" combine="interleave">
    <optional>
        <attribute name="table:cell-range-address">
            <ref name="cellRangeAddress"/>
        </attribute>
    </optional>
</define>

Если первая строка или столбец, или оба, содержат метки, то это задается атрибутом chart:data-source-has-labels.

<define name="chart-plot-area-attlist" combine="interleave">
    <optional>
        <attribute name="chart:data-source-has-labels" a:defaultValue="none">
            <choice>
                <value>none</value>
                <value>row</value>
                <value>column</value>
                <value>both</value>
            </choice>
        </attribute>
    </optional>
</define>

Свойство форматирования диаграммы chart:series-source, которое описано в разделе 15.34.1, определяет, каким образом расположены данные в таблице: по строкам или по столбцам.

10.5.1 Трехмерная область построения

Область построения может быть отображена как трехмерная сцена, как описано в разделе 9.4.1. Все трехмерные атрибуты, которые могут применяться к элементу <dr3d:scene>, включая атрибут dr3d:transform, могут применяться и к элементу <chart:plot-area>. Он представляет вращение сцены диаграммы, которая является трехмерной областью построения (см. раздел 9.4.1 для получения дополнительной информации). В дополнение к этому, элемент <chart:plot-area> может содержать элемент <dr3d:light>, как описано в разделе 9.4.2.

<define name="chart-plot-area-attlist" combine="interleave">
    <ref name="dr3d-scene-attlist"/>
    <ref name="common-dr3d-transform-attlist"/>
</define>

10.6 Стена

Элемент <chart:wall> может содержаться в элементе <chart:plot-area>. Он устанавливает стены диаграммы. Для двумерных диаграмм стена охватывает всю область построения. Для трехмерных диаграмм стена, как правило, состоит из двух перпендикулярных прямоугольников.

<define name="chart-wall">
    <element name="chart:wall">
        <ref name="chart-wall-attlist"/>
        <empty/>
    </element>
</define>

Ширина

Атрибут svg:width устанавливает ширину стены для трехмерных диаграмм.

<define name="chart-wall-attlist" combine="interleave">
    <optional>
        <attribute name="svg:width">
            <ref name="length"/>
        </attribute>
    </optional>
</define>

Стиль

Элемент <chart:wall> может иметь атрибут chart:style-name для дальнейшего определения стилей оформления, которые могут включать свойства заполнения и обрамления. Для получения более подробной информации см. разделы 15.14 и 15.13.

<define name="chart-wall-attlist" combine="interleave">
  <optional>
    <attribute name="chart:style-name">
    <ref name="styleNameRef"/>
    </attribute>
  </optional>
</define>

10.7 Основание диаграммы

Элемент <chart:floor> может содержаться в элементе <chart:plot-area>. Для трехмерных диаграмм элемент <chart:floor> представлен в качестве дополнения к элементу <chart:wall>.

<define name="chart-floor">
    <element name="chart:floor">
        <ref name="chart-floor-attlist"/>
        <empty/>
    </element>
</define>

Размер

Размер основания вычисляется на основе размера области построения, которая всегда представлена прямоугольником, служащим в качестве ограничения для трехмерной сцены. Атрибут svg:width может использоваться для установления ширины основания.

<define name="chart-floor-attlist" combine="interleave">
    <optional>
        <attribute name="svg:width">
            <ref name="length"/>
        </attribute>
    </optional>
</define>

Стиль

Элемент <chart:floor> может иметь атрибут chart:style-name для дальнейшего определения стилей оформления. К основанию диаграммы могут быть применены свойства заполнения и обрамления. Для получения более подробной информации см. разделы 15.14 и 15.13.

<define name="chart-floor-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.8 Оси координат

Элемент <chart:axis> в основном содержит данные стиля, в частности — информацию о масштабе. Данные диаграммы обычно структурированы следующим образом:

• несколько рядов данных, состоящих из названий, например названий компании;
• значения, например объем выпуска продукции компанией по годам;
• каждое значение в ряду данных принадлежит определенной категории, например году.

<define name="chart-axis">
    <element name="chart:axis">
        <ref name="chart-axis-attlist"/>
        <optional>
            <ref name="chart-title"/>
        </optional>
        <optional>
            <ref name="chart-categories"/>
        </optional>
        <zeroOrMore>
            <ref name="chart-grid"/>
        </zeroOrMore>
    </element>
</define>

Измерение

Атрибут chart:dimension определяет, вдоль какой реальной оси на диаграмме, отображаются значения шкалы текущей оси (значения какой шкалы будут отображаться для каждого измерения).

Диаграмма может содержать более одной оси одного и того же измерения. Например, может быть две оси y. Ряды данных могут быть привязаны к каждой из осей. Таким образом, данные могут группироваться по различным измерениям Чтобы привязать специальную ось координат к некоторому ряду данных, для координатной оси должен быть задан элемент <chart:series> с атрибутом chart:axis-name. Если с координатной осью не связан ни один ряд данных, она становится копией существующей оси того же измерения.

Позиция оси на диаграмме определяется визуализирующим приложением и зависит от типа диаграммы. На горизонтальных гистограммах при визуализации обычно отображается ось измерения x в нижней части области построения. Если имеется две оси измерения y, то при формировании изображения вторая ось может быть отображена в верхней части области построения.

<define name="chart-axis-attlist" combine="interleave">
    <attribute name="chart:dimension">
        <choice>
            <value>x</value>
            <value>y</value>
            <value>z</value>
        </choice>
    </attribute>
</define>

Наименование

Атрибут chart:name может использоваться для именования оси, таким образом на него можно ссылаться, например для ряда данных.

<define name="chart-axis-attlist" combine="interleave">
    <optional>
        <attribute name="chart:name">
            <ref name="string"/>
        </attribute>
    </optional>
</define>

Стиль

Атрибут chart:style-name может быть связан с осями. Свойство обрамления может применяться к осям (см. раздел 15.13). Эти свойства влияют на все линии координатной оси. Текстовые свойства также применимы к координатным осям (см. раздел 15.4). Эти свойства влияют на внешний вид всех объектов текстового типа. Также могут быть использованы свойства координатных осей, описанные в разделе 15.31.

Стиль диаграммы, на который ссылается атрибут chart:style-name может определять вид отображения данных, используемых для подписей осей. Для получения дополнительной информации см. раздел 14.1.

<define name="chart-axis-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

Пример — Гистограмма.

В этом примере две оси y. Одна из них имеет название primary-value. Ряды данных были прикреплены к этой именованной оси. Для второй оси нет прикрепленных данных, поэтому имя оси не было задано, и ось — просто копия первой.

<chart:chart chart:class="bar">
    <chart:title>
        <text:p>Title of my chart</text:p>
    </chart:title>
    <chart:plot-area>
        <chart:axis chart:dimension="x"
                    chart:axis-name="x"/>
        <chart:axis chart:dimension="y"
                    chart:axis-name="primary-value"/>
        <chart:axis chart:dimension="y"/>
        <chart:series chart:values-address="Sheet1.A1:.A7"
                    chart:attached-axis="primary-value"/>
    </chart:plot-area>
</chart:chart>

10.8.1 Координатная сетка

Элемент <chart:grid> может содержаться в элементе <chart:axis>. Он добавляет сетку для координатной оси.

<define name="chart-grid">
    <element name="chart:grid">
        <ref name="chart-grid-attlist"/>
    </element>
</define>

Класс

Атрибут chart:class определяет, используются ли основные или вспомогательные метки деления шкалы. Если используются основные линии сетки, метки деления являются их продолжением. Вспомогательные линии сетки не имеют меток деления.

<define name="chart-grid-attlist" combine="interleave">
    <optional>
        <attribute name="chart:class" a:defaultValue="major">
            <choice>
                <value>major</value>
                <value>minor</value>
            </choice>
        </attribute>
    </optional>
</define>

Имя стиля

Элемент <chart:grid> может иметь атрибут chart:style-name для дальнейшего определения стилей оформления. Свойства обрамления могут быть применены к координатной сетке, и влияние распространится на линии сетки. Для получения более детальной информации о свойствах обрамления см. раздел 15.13.

<define name="chart-grid-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.9 Ряды данных

Элемент <chart:series> используется для представления рядов данных на диаграмме. Если диаграмма требует больше входных данных, как, например, пузырьковая диаграмма и диаграмма ХУ, то подэлементы <chart:domain> должны быть определены таким образом, чтобы содержать преимущественно атрибуты cell-range-address соответствующих данных.

<define name="chart-series">
    <element name="chart:series">
        <ref name="chart-series-attlist"/>
        <zeroOrMore>
            <ref name="chart-domain"/>
        </zeroOrMore>
        <optional>
            <ref name="chart-mean-value"/>
        </optional>
        <optional>
            <ref name="chart-regression-curve"/>
        </optional>
        <optional>
            <ref name="chart-error-indicator"/>
        </optional>
        <zeroOrMore>
            <ref name="chart-data-point"/>
        </zeroOrMore>
    </element>
</define>

Диапазон ячеек

Атрибут chart:values-cell-range-address позволяет задать диапазон значений из данного ряда, которые должны быть отображены.

<define name="chart-series-attlist" combine="interleave">
    <optional>
        <attribute name="chart:values-cell-range-address">
            <ref name="cellRangeAddress"/>
        </attribute>
    </optional>
</define>

Атрибут chart:label-cell-address позволяет привязать некоторое имя для ряда данных.

<define name="chart-series-attlist" combine="interleave">
    <optional>
        <attribute name="chart:label-cell-address">
            <ref name="cellAddress"/>
        </attribute>
    </optional>
</define>

Класс

Атрибут chart:class может быть использован для установки типа диаграммы, который будет использован для визуализации данных элемента <chart:series>. Атрибут chart:class элемента <chart:series> переопределяет атрибут chart:class для всей диаграммы. Это позволяет создавать диаграммы с множественными субдиаграммами, например одномерная диаграмма с одним или несколькими рядами данных, отображенными в виде линий. Для более подробной информации о доступных классах диаграмм см. раздел 10.2.

<define name="chart-series-attlist" combine="interleave">
    <optional>
        <attribute name="chart:class">
            <ref name="namespacedToken"/>
        </attribute>
    </optional>
</define>

Привязка координатных осей

Атрибут chart:attached-axis может использоваться для привязки рядов данных к элементу <chart:axis>.

<define name="chart-series-attlist" combine="interleave">
    <optional>
        <attribute name="chart:attached-axis">
            <ref name="string"/>
        </attribute>
    </optional>
</define>

Имя стиля

Свойства стиля для рядов данных могут быть назначены при помощи атрибута chart:style-name. Свойства обрамления могут быть применены к элементу <chart:series>. Для получения более детальной информации о свойствах обрамления см. разделы 15.14 и 15.13. Текстовые свойства также применимы к тексту, описывающему ряды данных, расположенному ниже (см. раздел 15.4 для более получения подробной информации).

<define name="chart-series-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.9.1 Домен

Для пузырьковых и точечных диаграмм для элемента <chart:series> может быть задан один элемент <chart:domain> или более.

Для диаграмм ХУ один элемент <chart:domain> обязателен. Его атрибут cell-range-address ссылается на значения по координате х для диаграмм ХУ.

Для пузырьковых диаграмм два элемента <chart:domain> обязательны. Их атрибут cell-range-address ссылается на значения по координатам х и у для пузырьковых диаграмм.

Для обоих типов диаграмм должен быть по крайней мере один элемент <chart:series> с несколькими субэлементами <chart:domain>. Все остальные элементы <chart:series> могут не включать вышеперечисленного. В этом случае используется тот домен, который был указан первым.

<define name="chart-domain">
    <element name="chart:domain">
        <optional>
            <attribute name="table:cell-range-address">
                <ref name="cellRangeAddress"/>
            </attribute>
        </optional>
    </element>
</define>

10.10 Категории

Элемент <chart:categories> представляет диапазон адресов ячеек, содержащих подписи к категориям, имеющимbся в каждой последовательности.

Элемент может содержать атрибут table:cell-range-address, отмечающий область, из которой были взяты подписи к категориям. Если этот атрибут или элемент <chart:categories> пропущены, приложение использует атрибут chart:data-source-has-labels.

<define name="chart-categories">
    <element name="chart:categories">
        <optional>
            <attribute name="table:cell-range-address">
                <ref name="cellRangeAddress"/>
            </attribute>
        </optional>
    </element>
</define>

10.11 Точка данных

Если отдельная точка ряда данных требует особого отображения, то для применения необходимых свойств используется элемент <chart:data-point>.

<define name="chart-data-point">
    <element name="chart:data-point">
        <ref name="chart-data-point-attlist"/>
        <empty/>
    </element>
</define>

Повтор

Атрибут chart:repeated служит для упрощения в том случае, если несколько последовательных точек имеют одинаковые свойства. Например, нижеследующие XML-фрагменты имеют одинаковый смысл:

<chart:series chart:style-name="ch9">
    <chart:data-point/>
    <chart:data-point/>
    <chart:data-point/>
    <chart:data-point/>
</chart:series>

и

<chart:series chart:style-name="ch9">
    <chart:data-point chart:repeated="4"/>
</chart:series>

<define name="chart-data-point-attlist" combine="interleave">
    <optional>
        <attribute name="chart:repeated">
            <ref name="nonNegativeInteger"/>
        </attribute>
    </optional>
</define>

Стиль

Атрибут chart:style-name относится к стилю диаграммы. Свойства заполнения и обрамления применяются к каждой точке данных (см. разделы 15.14 и 15.13). Текстовые свойства также могут быть применены к подписи, расположенной непосредственно под значением (см. раздел 15.4).

<define name="chart-data-point-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>
 

10.12 Среднее значение

Свойства форматирования линии среднего значения содержатся в элементе <chart:mean-value>, который может являться частью элемента <chart:series>.

<define name="chart-mean-value">
    <element name="chart:mean-value">
        <ref name="chart-mean-value-attlist"/>
        <empty/>
    </element>
</define>

Имя стиля

Атрибут chart:style-name указывает на стиль диаграммы, содержащий свойства форматирования для линии среднего значения.

<define name="chart-mean-value-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.13 Индикатор ошибок

Свойства форматирования индикаторов ошибок содержатся в элементе <chart:error-indicator>, который может быть частью рядов данных.

<define name="chart-error-indicator">
    <element name="chart:error-indicator">
        <ref name="chart-error-indicator-attlist"/>
        <empty/>
    </element>
</define>

Имя стиля

Атрибут chart:style-name указывает на стиль диаграммы, содержащий свойства форматирования индикатора ошибок.

<define name="chart-error-indicator-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.14 Кривые регрессии

Свойства форматирования кривых регрессии содержатся в элементе <chart:regression-curve>, который может быть частью рядов данных.

<define name="chart-regression-curve">
    <element name="chart:regression-curve">
        <ref name="chart-regression-curve-attlist"/>
        <empty/>
    </element>
</define>

Имя стиля

Атрибут chart:style-name указывает на стиль диаграммы, содержащий свойства форматирования индикатора ошибок. Стиль диаграммы может, главным образом, содержать свойство «вид регрессии», описанное в разделе 15.35.1.

<define name="chart-regression-curve-attlist" combine="interleave">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

10.14.1 Метки биржевой диаграммы

Свойства биржевой диаграммы, как например, различные цвета заливки свечей или стили линий наибольшего и наименьшего значения (линия диапазона), находятся в отдельных элементах.

Свечи биржевых диаграмм, у которых значение закрытия располагаются выше, чем значение открытия, используют свойства форматирования элемента <chart:stock-gain-marker>, в то время как биржевые диаграммы, у которых значение закрытия располагаются ниже, чем значение открытия, используют свойства элемента chart:stock-loss-marker>.

<define name="chart-stock-gain-marker">
    <element name="chart:stock-gain-marker">
        <ref name="common-stock-marker-attlist"/>
    </element>
</define>
<define name="chart-stock-loss-marker">
    <element name="chart:stock-loss-marker">
        <ref name="common-stock-marker-attlist"/>
    </element>
</define>
<define name="chart-stock-range-line">
    <element name="chart:stock-range-line">
        <ref name="common-stock-marker-attlist"/>
    </element>
</define>

Имя стиля

Атрибут стиля диаграммы chart:style-name определяет свойства оформления меток биржевых диаграмм.

<define name="common-stock-marker-attlist">
    <optional>
        <attribute name="chart:style-name">
            <ref name="styleNameRef"/>
        </attribute>
    </optional>
</define>

Это произведение не охраняется авторским правом. В соответствии со статьёй 1259 Гражданского кодекса Российской Федерации не являются объектами авторских прав официальные документы государственных органов и органов местного самоуправления муниципальных образований, в том числе законы, другие нормативные акты, судебные решения, иные материалы законодательного, административного и судебного характера, официальные документы международных организаций, а также их официальные переводы; государственные символы и знаки (флаги, гербы, ордена, денежные знаки и тому подобное), а также символы и знаки муниципальных образований; произведения народного творчества (фольклор), не имеющие конкретных авторов; сообщения о событиях и фактах, имеющие исключительно информационный характер (сообщения о новостях дня, программы телепередач, расписания движения транспортных средств и тому подобное).