> ## Documentation Index
> Fetch the complete documentation index at: https://iyree.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Круговые диаграммы (Pie)

> Круговые и кольцевые диаграммы

![Пример Pie графика](https://mintcdn.com/iyree/k8VfyfyiOthBr5L4/assets/img/charts/pie/pie_example.png?fit=max\&auto=format\&n=k8VfyfyiOthBr5L4\&q=85\&s=8265054141f9a10ff9d69bc20d07cf6f)

Поддерживает как круговой (pie), так и кольцевой (donut) вид, а также иерархии с drill-down.

### Поля

**type** `"pie"` *required*

Тип графика

**display\_type** `enum` (default: pie)

Вид диаграммы

**Значения**

| Значение | Описание |
| - | - |
| `pie` | Круговая диаграмма (заполненная) |
| `donut` | Кольцевая диаграмма (с отверстием) |

**measure** `PieMeasure`

Основная мера. Используйте либо `measure`, либо `selectable_measure`.

**Структура PieMeasure**

**measure** `string` *required*

Имя меры из куба

**title** `string`

Заголовок

**data\_point\_actions** `DataPointActionDefinition[]`

Действия при клике на сектор

**Структура DataPointActionDefinition**

**id** `string` *required*

UUID действия

**key** `string` *required*

Ключ: `common:copy_value` | `common:view_raw_data` | `link:open` | `dashboard:drill_through` | `dashboard:another_dashboard_drill_through`

**title** `string` *required*

Текст в меню

**icon** `IconReference`

Иконка

**placement** `DataPointActionPlacement`

Настройки размещения в меню

**Структура DataPointActionPlacement**

**menu\_path** `string[]`

Путь в подменю, например `["Team", "More..."]`

**group** `DataPointActionPlacementGroup`

Группа действия (разделители между группами)

**order** `int`

Порядок в группе/подменю

**target\_page\_id** `string`

UUID целевой страницы (для drill\_through)

**target\_dashboard\_id** `string`

UUID целевого дашборда (для another\_dashboard\_drill\_through)

**filter\_mappings** `DrillThroughFilterMapping[]`

Маппинг фильтров

**url** `string`

URL для link:open

**open\_in** `enum`

`same_tab` | `new_tab` (для link:open)

**open\_in\_new\_tab** `boolean`

Открыть в новой вкладке (для another\_dashboard\_drill\_through)

```yaml theme={null}
measure:
  measure: sales.revenue
  title: Выручка
```

**selectable\_measure** `SingleSelectableField[PieMeasure]`

Выбираемая основная мера

**Структура**

```yaml theme={null}
selectable_measure:
  type: single
  hint: Выберите показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество
```

**dimension** `PieDimension`

Основное измерение (сегменты). Используйте либо `dimension`, либо `selectable_dimension`.

**Типы PieDimension**

### Простое измерение (PieBasicDimension)

**type** `"dimension"` (default: dimension)

Тип

**dimension** `CubeDimension` *required*

Измерение из куба

**Структура CubeDimension**

**Обычное измерение:**

```yaml theme={null}
kind: basic
value: products.category
```

**Временное измерение:**

```yaml theme={null}
kind: time
value:
  dimension: sales.created_at
  granularity: quarter
```

**title** `string`

Заголовок

***

### Иерархия измерений (drill-down)

**type** `"dimension_hierarchy"` *required*

Тип

**levels** `Pie2DimensionHierarchyLevel[]` *required*

Уровни иерархии

**Структура Pie2DimensionHierarchyLevel**

**member** `CubeDimension` *required*

Измерение уровня

**title** `string`

Заголовок уровня

```yaml theme={null}
levels:
  - member:
      kind: basic
      value: geography.region
    title: Регион
  - member:
      kind: basic
      value: geography.city
    title: Город
```

```yaml theme={null}
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
```

**selectable\_dimension** `SingleSelectableField[PieBasicDimension]`

Выбираемое основное измерение (только простые измерения, не иерархии)

**Структура**

```yaml theme={null}
selectable_dimension:
  type: single
  hint: Выберите разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: products.brand
      title: По брендам
```

**colors** `PieColorOptions`

Настройки цветов

**Структура PieColorOptions**

**palette\_name** `string` *required*

Имя цветовой палитры

**values** `Dict[string, string]`

HEX-цвета для конкретных значений измерения

```yaml theme={null}
colors:
  palette_name: custom
  values:
    "Электроника": "#3B82F6"
    "Одежда": "#10B981"
    "Продукты": "#F59E0B"
```

**label** `PieLabelOptions`

Настройки меток на секторах

**Структура PieLabelOptions**

**show** `boolean` *required*

Показать метки

**position** `enum` *required*

Позиция меток: `inside` | `outside`

**show\_values** `boolean`

Показать значения меры

**show\_percentages** `boolean`

Показать процент от общего

**show\_dimension\_values** `boolean`

Показать значение измерения (название категории)

**percentage\_threshold** `float`

Минимальный порог процента для отображения метки

```yaml theme={null}
label:
  show: true
  position: outside
  show_values: true
  show_percentages: true
  show_dimension_values: true
  percentage_threshold: 5.0
```

**legend** `PieLegendOptions`

Настройки легенды

**Структура PieLegendOptions**

**show** `boolean` *required*

Показать легенду

**type** `enum` *required*

Тип легенды: `compact` | `detailed`

**truncate\_item\_chars** `int`

Максимальное количество символов для обрезки названий элементов

```yaml theme={null}
legend:
  show: true
  type: detailed
  truncate_item_chars: 20
```

**sorting** `PieSorting`

Настройки сортировки секторов

**show\_totals** `boolean` (default: false)

Показать итоговое значение

**compare\_period\_enabled** `boolean` (default: false)

Сравнение периодов

### Примеры

```yaml Простая круговая theme={null}
type: pie
display_type: pie
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
```

```yaml Кольцевая (donut) с цветами theme={null}
type: pie
display_type: donut
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
colors:
  palette_name: categories
  values:
    "Электроника": "#3B82F6"
    "Одежда": "#10B981"
    "Продукты": "#F59E0B"
    "Прочее": "#9CA3AF"
label:
  show: true
  position: outside
  show_percentages: true
  show_dimension_values: true
legend:
  show: true
  type: detailed
```

```yaml С иерархией (drill-down) theme={null}
type: pie
display_type: pie
dimension:
  type: dimension_hierarchy
  levels:
    - member:
        kind: basic
        value: geography.region
      title: Регион
    - member:
        kind: basic
        value: geography.city
      title: Город
    - member:
        kind: basic
        value: stores.name
      title: Магазин
measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      key: "common:view_raw_data"
      title: "Исходные данные"
```

```yaml С выбираемыми полями theme={null}
type: pie
display_type: donut

selectable_dimension:
  type: single
  hint: Разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: products.brand
      title: По брендам
    - dimension:
        kind: basic
        value: managers.name
      title: По менеджерам

selectable_measure:
  type: single
  hint: Показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество
    - measure: orders.count
      title: Заказы

legend:
  show: true
  type: compact
```

```yaml С действиями (drill-through) theme={null}
type: pie
display_type: pie
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      key: "dashboard:drill_through"
      title: "Товары категории"
      target_page_id: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
      filter_mappings:
        - target_filter_id: "b2c3d4e5-6789-01bc-def0-234567890abc"
          sources:
            - type: data_point_dimension
              member_name: products.category
```

```yaml С итогами и сортировкой theme={null}
type: pie
display_type: donut
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
show_totals: true
label:
  show: true
  position: inside
  show_values: true
  show_percentages: false
  percentage_threshold: 3.0
legend:
  show: true
  type: detailed
  truncate_item_chars: 15
```

***

## См. также

> [card] [Иерархии измерений](../features/dimension-hierarchy)
>
> Drill-down в диаграммах

> [card] [Действия с данными](../features/data-point-actions)
>
> Клики и drill-through

> [card] [Выбираемые поля](../features/selectable-fields)
>
> Динамический выбор

***

← [Столбчатые диаграммы](./bar) | → [Динамические графики](./dynamic)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.