# -*- coding: utf-8 -*-
# 版权所有 2019 深圳米筐科技有限公司（下称“米筐科技”）
#
# 除非遵守当前许可，否则不得使用本软件。
#
# * 非商业用途（非商业用途指个人出于非商业目的使用本软件，或者高校、研究所等非营利机构出于教育、科研等目的使用本软件）：
# 遵守 Apache License 2.0（下称“Apache 2.0 许可”），
# 您可以在以下位置获得 Apache 2.0 许可的副本：http://www.apache.org/licenses/LICENSE-2.0。
# 除非法律有要求或以书面形式达成协议，否则本软件分发时需保持当前许可“原样”不变，且不得附加任何条件。
#
# * 商业用途（商业用途指个人出于任何商业目的使用本软件，或者法人或其他组织出于任何目的使用本软件）：
# 未经米筐科技授权，任何个人不得出于任何商业目的使用本软件（包括但不限于向第三方提供、销售、出租、出借、转让本软件、
# 本软件的衍生产品、引用或借鉴了本软件功能或源代码的产品或服务），任何法人或其他组织不得出于任何目的使用本软件，
# 否则米筐科技有权追究相应的知识产权侵权责任。
# 在此前提下，对本软件的使用同样需要遵守 Apache 2.0 许可，Apache 2.0 许可与本许可冲突之处，以本许可为准。
# 详细的授权流程，请联系 public@ricequant.com 获取。
import datetime
import numpy as np
from rqalpha.utils.datetime_func import convert_int_to_datetime, convert_ms_int_to_datetime
[文档]class TickObject(object):
def __init__(self, instrument, tick_dict):
"""
Tick 对象
:param instrument: Instrument
:param tick_dict: dict
"""
self._instrument = instrument
self._tick_dict = tick_dict
@property
def order_book_id(self):
"""
[str] 标的代码
"""
return self._instrument.order_book_id
@property
def datetime(self):
"""
[datetime.datetime] 当前快照数据的时间戳
"""
try:
dt = self._tick_dict['datetime']
except (KeyError, ValueError):
return datetime.datetime.min
else:
if not isinstance(dt, datetime.datetime):
if dt > 10000000000000000: # ms
return convert_ms_int_to_datetime(dt)
else:
return convert_int_to_datetime(dt)
return dt
@property
def open(self):
"""
[float] 当日开盘价
"""
return self._tick_dict['open']
@property
def last(self):
"""
[float] 当前最新价
"""
try:
return self._tick_dict['last']
except KeyError:
# last 字段未必有（当日未发生成交），但一定有 prev_close（非新股的情况）
# 新股一定有 last，且 为 issue_price
return self.prev_close
@property
def high(self):
"""
[float] 截止到当前的最高价
"""
return self._tick_dict['high']
@property
def low(self):
"""
[float] 截止到当前的最低价
"""
return self._tick_dict['low']
@property
def prev_close(self):
"""
[float] 昨日收盘价
"""
try:
return self._tick_dict['prev_close']
except (KeyError, ValueError):
return 0
@property
def volume(self):
"""
[float] 截止到当前的成交量
"""
try:
return self._tick_dict['volume']
except (KeyError, ValueError):
return 0
@property
def total_turnover(self):
"""
[float] 截止到当前的成交额
"""
try:
return self._tick_dict['total_turnover']
except (KeyError, ValueError):
return 0
@property
def open_interest(self):
"""
[float] 截止到当前的持仓量（期货专用）
"""
try:
return self._tick_dict['open_interest']
except (KeyError, ValueError):
return 0
@property
def prev_settlement(self):
"""
[float] 昨日结算价（期货专用）
"""
try:
return self._tick_dict['prev_settlement']
except (KeyError, ValueError):
return 0
@property
def asks(self):
"""
[list] 卖出报盘价格，asks[0]代表盘口卖一档报盘价
"""
try:
return self._tick_dict['asks']
except (KeyError, ValueError):
return [0] * 5
@property
def ask_vols(self):
"""
[list] 卖出报盘数量，ask_vols[0]代表盘口卖一档报盘数量
"""
try:
return self._tick_dict['ask_vols']
except (KeyError, ValueError):
return [0] * 5
@property
def bids(self):
"""
[list] 买入报盘价格，bids[0]代表盘口买一档报盘价
"""
try:
return self._tick_dict['bids']
except (KeyError, ValueError):
return [0] * 5
@property
def bid_vols(self):
"""
[list] 买入报盘数量，bids_vols[0]代表盘口买一档报盘数量
"""
try:
return self._tick_dict['bid_vols']
except (KeyError, ValueError):
return [0] * 5
@property
def limit_up(self):
"""
[float] 涨停价
"""
try:
return self._tick_dict['limit_up']
except (KeyError, ValueError):
return 0
@property
def limit_down(self):
"""
[float] 跌停价
"""
try:
return self._tick_dict['limit_down']
except (KeyError, ValueError):
return 0
@property
def isnan(self):
return np.isnan(self.last)
def __repr__(self):
items = []
for name in dir(self):
if name.startswith("_"):
continue
items.append((name, getattr(self, name)))
return "Tick({0})".format(', '.join('{0}: {1}'.format(k, v) for k, v in items))
def __getitem__(self, key):
return getattr(self, key)