Свечной график. Описание класса Candle.

Одним из способов представления ценовой информации являются интервальные графики. Такие графики состоят из набора однотипных данных. Самым простым является линейный график, который строится по ценам закрытия интервалов. Куда более информативными являются серии, состоящие из композитных элементов, такие как бары и японские свечи. Эти типы полностью идентичны в наборе предоставляемой информации, единственное что их отличает – это способ графического отображения. Так же при помощи японских свечей можно отобразить, например, графики Renko и Heiken Ashi.  

Свеча представляет собой вертикально расположенный прямоугольник, вверх и вниз по центру, от которого выступают линии, именуемые тенями. По сути, каждая свеча является агрегатором информации о поведении цены за определенный интервал времени. К таковой относятся: 

1. время открытия свечи;
2. цена открытия;
3. минимальная цена;
4. максимальная цена;
5. цена закрытия; 
6. проторгованный объем;

В OsEngine данная сущность моделируется классом Candle, путь к файлу: OsEngine\project\OsEngine\Entity\Candle.cs

Рис. 1. Класс Candle в структуре проекта.

Разберем подробно состояние и поведение членов класса Candle.cs.

TimeStart – публичное свойство типа DateTime, временная метка, которая указывает на время начала свечи.

Open – общедоступное поле типа decimal. Хранит цену открытия свечи.

High – общедоступное поле типа decimal. Хранит наивысшую цену, достигнутую в свече.

Close – общедоступное поле типа decimal. Хранит цену закрытия свечи.

Low – общедоступное поле типа decimal. Хранит наименьшую цену, достигнутую в свече.

Volume – общедоступное поле типа decimal. Хранит объем, проторгованный в рамках свечи.

State – общедоступное поле типа CandleState. Содержит информацию о текущем состоянии свечи. Возможны следующие варианты:

1. Finished – свеча является завершенным объектом.
2. Started – объект создан и находится в процессе формирования.
3. None – состояние не определенно.

GetPoint – публичный метод, в качестве параметра принимает строку с типом запрашиваемых данных. Допустимы следующие строки: "Close","High","Low","Open","Median","Typical". Возвращает метод соответствующее значение свечи.

Trades – публичное свойство, возвращает список всех сделок, проторгованных в этой свече.

IsUp – публичное свойство типа bool, указывает, является ли свеча растущей. Если цена закрытия свечи больше цены открытия, возвращается истина. Иначе ложь.

IsDown – публичное свойство типа bool, указывает, является ли свеча падающей. Если цена закрытия свечи меньше цены открытия, возвращается истина. Иначе ложь.

IsDoji – публичное свойство типа bool, указывает, является ли свеча доджи. Если цена закрытия свечи равна цене открытия, возвращается истина. Иначе ложь.

ShadowTop – публичное свойство типа decimal, возвращает размер верхней тени свечи.

ShadowBottom – публичное свойство типа decimal, возвращает размер нижней тени свечи.

ShadowBody – публичное свойство типа decimal, возвращает размер всей свечи с учетом теней.

Body – публичное свойство типа decimal, возвращает размер тела свечи от открытия до закрытия.

BodyPercent – публичное свойство типа decimal, возвращает размер тела свечи в процентах по отношению к открытию.

Center – публичное свойство типа decimal, возвращает цену середины свечи.

Volatility – публичное свойство типа decimal, рассчитывает и возвращает значение волатильности свечи.

SetCandleFromString – общедоступный метод, принимает строку, содержащую данные по всем полям, парсит ее и инициализирует состояние объекта.

ToolTip – публичное свойство типа string, формирует строковое представление свечи для отображения в качестве всплывающей информации на графике при наведении курсора мыши на свечу.

StringToSave – публичное свойство типа string, формирует строковое представление свечи для дальнейшего размещения в хранилище.