.n Текстовые диаграммы
.a
.d 23333
.s
*Текстовые диаграммы
Расширение позволяет встраивать в тексты статей текстовые столбиковые диаграммы одномерных массивов числовых данных. Использование расширения возможно при наличии файлов x_diag.api, x_diag.php, x_diag.txt, которые не входят в базовую комплектацию системы.
За реализацию действий по выводу текстовых диаграмм ответственна функция vdm() - вывод диаграммы массива.
Функции vdm передаются три параметра:
- массив числовых данных;
- порядок сортировки (0 или 1), по умолчанию - 0;
- число пикселей столбика максимального значения, по умолчанию - 300.
Вывод представляет собой таблицу, которая включает:
- столбец имён индексов массива;
- столбец числовых значений массива;
- столбец долей значений каждого элемента по отношению к их сумме (%);
- столбец долей значений каждого элемента по отношению к максимуму (%);
- столбец, заполненный столбиками относительной величины значений по отношению к максимуму.
Столбики синего цвета - значения меньше среднего арифметического, зелёного - больше среднего арифметического, красного - максимальное значение.
Данные таблицы-диаграммы могут быть упорядочены по убыванию значений.
''Разметка'/
/
@vdm(x,1)
/
''Вывод'/
@vdm(x,1)
Третий параметр функции позволяет изменить пропорции столбиков диаграммы.
''Разметка'/
/
@vdm(x,0,500)
/
''Вывод'/
@vdm(x,0,500)
Для функции vdm строить массив заранее не обязательно. Вместо массива можно просто передать строку со списком слов в формате ключ:значение, а функция сама преобразует её в массив.
''Разметка'/
/
@vdm("x1:300 x2:200 x3:400 x4:800 x5:500 x6:600 x7:250")
/
''Вывод'/
@vdm("x1:300 x2:200 x3:400 x4:800 x5:500 x6:600 x7:250")
Данные массива могут быть предварительно получены из секций структурированных файлов или из отдельных неструктурированных файлов. Подробнее см. !dok/mkz.s, !dok/msz.s.