hikyuu2/docs/source/base/other_utils.rst
2024-04-05 23:23:23 +08:00

222 lines
4.9 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. py:currentmodule:: hikyuu
.. highlight:: python
杂项或辅助
=============
函数
------
.. py:function:: select()
示例::
#选出涨停股
C = CLOSE()
x = select(C / REF(C, 1) - 1 >= 0.0995))
:param Indicator cond: 条件指标
:param Datetime start: 起始日期
:param Datetime end: 结束日期
:param bool print_out: 打印选中的股票
:rtype: 选中的股票列表
.. py:function:: get_log_level()
获取当前日志打印级别
:rtype: LOG_LEVEL
.. py:function:: set_log_level(level)
设置日志打印级别
:param LOG_LEVEL level: 指定的日志打印级别
.. py:function:: hku_save(var, filename)
序列化将hikyuu内建类型的变量如Stock、TradeManager等保存在指定的文件中格式为XML。
:param var: hikyuu内建类型的变量
:param str filename: 指定的文件名
.. py:function:: hku_load(filename)
将通过 hku_save 保存的变量读取到var中。
:param str filename: 待载入的序列化文件。
:return: 之前被序列化保存的文件
.. py:function:: roundUp(arg1[, arg2=0])
向上截取如10.1截取后为11
:param float arg1: 待处理数据
:param int arg2: 保留小数位数
:return: 处理过的数据
.. py:function:: roundDown(arg1[, arg2=0])
向下截取如10.1截取后为10
:param float arg1: 待处理数据
:param int arg2: 保留小数位数
:return: 处理过的数据
.. py:function:: getDateRange(start, end)
获取指定 [start, end) 日期时间范围的自然日日历日期列表,仅支持到日
:param Datetime start: 起始日期
:param Datetime end: 结束日期
:rtype: DatetimeList
.. py:function:: toPriceList(arg)
将Python的可迭代对象如 list、tuple 转化为 PriceList该函数实际已废弃可以不再使用
:param arg: 待转化的Python序列
:rtype: list
.. py:function:: set_global_context(stk, query)
设置全局的 context
:param Stock stk: 指定的全局Stock
:param Query query: 指定的查询条件
.. py:function:: get_global_context()
获取当前全局默认上下文
:rtype: KData
-----------
.. py:class:: Parameter
参数类
.. py:method:: get(self, name)
获取指定参数
:param str name: 参数名称
:return: 参数值
.. py:method:: set(self, name, value)
设置参数
:param str name: 参数名称
:param value: 参数值(仅支持 int | float | str | bool 类型)
.. py:class:: PriceList
价格序列其中价格使用double表示对应C++中的std::vector<double>。
.. py:method:: to_np(self)
仅在安装了numpy模块时生效转换为numpy.array
.. py:method:: to_df(self)
仅在安装了pandas模块时生效转换为pandas.DataFrame
.. py:class:: DatetimeList
日期序列对应C++中的std::vector<Datetime>
.. py:method:: append(self, datetime)
向列表末端加入元素
:param Datetime datetime: 待加入的元素
.. py:method:: to_np(self)
仅在安装了numpy模块时生效转换为numpy.array
.. py:method:: to_df(self)
仅在安装了pandas模块时生效转换为pandas.DataFrame
.. py:class:: StringList
字符串列表对应C++中的std::vector<String>
.. py:class:: KRecordList
C++ std::vector<KRecord>包装
.. py:method:: append(self, krecord)
向列表末端加入元素
:param KRecord krecord: 待加入的元素
.. py:method:: to_np(self)
仅在安装了numpy模块时生效转换为numpy.array
.. py:method:: to_df(self)
仅在安装了pandas模块时生效转换为pandas.DataFrame
.. py:class:: BlockList
C++ std::vector<Block>包装
.. py:class:: OstreamRedirect
重定向C++ std::cout、std::cerr至python。在非命令行方式下某些App无法显示C++ iostream的输出信息如Jupyter notebook。默认构造时只是指定是否需要重定向std::cout或std::cerr必须使用open方法或with语法才会启用重定向。
使用with示例
.. code-block:: python
with OstreamRedirect():
your_function() #被封装的C++函数其中使用了std::iostream输出
.. py:method:: init(self[, stdout=True, stderr=True])
:param bool stdout: 是否重定向C++ std::cout
:param bool stderr: 是否重定向C++ std::cerr
.. py:method:: open(self)
启用重定向
.. py:method:: close(self)
关闭重定向
枚举
-----------
.. py:class:: LOG_LEVEL
- DEBUG
- TRACE
- INFO
- WARN
- ERROR
- FATAL
- NO_PRINT