Фигуры
Существуют ситуации, когда необходимо отметить или выделить конкретные бары на графике, и когда обычный график с использованием plot может быть не оптимальным. Хотя это можно сделать, используя plot со style=plot.style_circles или style=plot.style_cross, обычно проще использовать функции аннотации plothape, plotchar и plotarrow.
Plotshape
Функция plotshape может отображать различные формы. В приведенном ниже скрипте над всеми зелеными полосами будет отображаться символ «X»:
Первый параметр data, используется как последовательность логических значений. Крестики нарисованы на каждом истинном (true) значении. На ложных (false) и na значениях ничего не рисуется. В качестве первого аргумента графической фигуры можно использовать ряд логических значений или чисел. Значение 0 или na считается ложным, любое другое значение — истинным.
Изменяя значение параметра style, можно изменять форму.
Доступные стили:
Имя формы | Форма | Форма с текстом |
---|---|---|
shape.xcross | ![]() |
![]() |
shape.cross | ![]() |
![]() |
shape.circle | ![]() |
![]() |
shape.triangleup | ![]() |
![]() |
shape.triangledown | ![]() |
![]() |
shape.flag | ![]() |
![]() |
shape.arrowup | ![]() |
![]() |
shape.arrowdown | ![]() |
![]() |
shape.square | ![]() |
![]() |
shape.diamond | ![]() |
![]() |
shape.labelup | ![]() |
![]() |
shape.labeldown | ![]() |
![]() |
По умолчанию фигуры plotshape рисуются над барами. Чтобы использовать другую позицию, используйте параметр location. Следующий скрипт рисует зеленый треугольник shape.triangleup над зелеными полосами и красный треугольник shape.triangledown под красными полосами:
Возможные значения параметра location:
- location.abovebar — над баром.
- location.belowbar — под баром.
- location.top— над пространством y скрипта.
- location.bottom— нижняя часть пространства y скрипта.
- location.absolute— любая позиция в пространстве y.
location.absolute может использоваться, когда необходимо более точно разместить фигуры в пространстве y скрипта. Затем первый параметр функции используется как координата y.
Пример графика 2 иллюстрирует, как можно определить цвет фигуры с помощью параметра color и выражений, которые будут вычислять цвет фигуры в зависимости от условий во время выполнения.
Например:
В данном примере первым параметром функции plotshape является true, что означает, что фигура отображается на каждом баре. Цвет рассчитывается по выражению color=data ? color.green : color.red.
Другие особенности функции plotshape:
- Установка имени отображаемой серии данных с помощью параметра title.
- Сдвинуть серию фигур влево / вправо с помощью параметра offset.
- Установить прозрачность фигур с помощью параметра transp.
- Используйте параметр text для отображения короткого текста над / под фигурой. Вы можете использовать \n для разделения текстовых строк.