hikyuu 2.1.3__cp312-none-win_amd64.whl → 2.1.5__cp312-none-win_amd64.whl

hikyuu/include/hikyuu/hikyuu.h

@@ -35,6 +35,19 @@ namespace hku {
 void HKU_API hikyuu_init(const string& config_file_name, bool ignore_preload = false,
                          const StrategyContext& context = StrategyContext({"all"}));
 
+/**
+ * @brief 尝试从 ini 文件获取配置参数
+ * @param config_file_name ini 文件名
+ * @param baseParam [out]
+ * @param blockParam [out]
+ * @param kdataParam [out]
+ * @param preloadParam [out]
+ * @param hkuParam [out]
+ */
+void HKU_API getConfigFromIni(const string& config_file_name, Parameter& baseParam,
+                              Parameter& blockParam, Parameter& kdataParam, Parameter& preloadParam,
+                              Parameter& hkuParam);
+
 /** @} */
 
 }  // namespace hku

hikyuu/include/hikyuu/indicator/crt/AMA.h

@@ -32,7 +32,7 @@ Indicator HKU_API AMA(const IndParam& n, const IndParam& fast_n, const IndParam&
 
 /**
  * 佩里.J 考夫曼（Perry J.Kaufman）自适应移动平均，参见《精明交易者》（2006年 广东经济出版社）
- * @param indicator 待计算的数据
+ * @param ind 待计算的数据
  * @param n 计算均值的周期窗口，必须为大于2的整数，默认为10天
  * @param fast_n 对应快速周期N，默认为2
  * @param slow_n 对应慢速EMA线的N值，默认为30，不过当超过60左右该指标会收敛不会有太大的影响

hikyuu/include/hikyuu/indicator/crt/CORR.h

@@ -18,7 +18,7 @@ namespace hku {
  * @param n 滚动窗口 （大于2或等于0），等于0时使用输入的ind实际长度。
  * @ingroup Indicator
  */
-Indicator HKU_API CORR(int n = 10);
 Indicator HKU_API CORR(const Indicator& ind1, const Indicator& ind2, int n = 10);
+Indicator HKU_API CORR(int n = 10);
 
 }  // namespace hku

hikyuu/include/hikyuu/indicator/crt/DMA.h

@@ -27,13 +27,7 @@ namespace hku {
  * @param a 动态系数
  * @ingroup Indicator
  */
-Indicator DMA(const Indicator& ind1, const Indicator& a);
-
-inline Indicator DMA(const Indicator& ind1, const Indicator& a) {
-    Indicator dma = a * ind1 + (1 - a) * REF(ind1, 1);
-    dma.name("DMA");
-    return dma;
-}
+Indicator HKU_API DMA(const Indicator& x, const Indicator& a);
 
 }  // namespace hku
 

hikyuu/include/hikyuu/indicator/crt/ICIR.h

@@ -16,6 +16,7 @@ namespace hku {
  * @brief 计算指定的因子相对于参考证券的 ICIR （实际为 RankIC）
  * @details IR:信息比率(Information Ratio,简称IR)=
  * IC的多周期均值/IC的标准方差，代表因子获取稳定Alpha的能力。
+ * @param ind 因子公式
  * @param stks 证券组合
  * @param query 查询条件
  * @param ref_stk 参照证券，默认 sh000300 沪深300

hikyuu/include/hikyuu/indicator/crt/SMA.h

@@ -34,7 +34,7 @@ Indicator HKU_API SMA(const IndParam& n, const IndParam& m);
  * <pre>
  * 用法：若Y=SMA(X,N,M) 则 Y=[M*X+(N-M)*Y')/N,其中Y'表示上一周期Y值
  * </pre>
- * @param data 待计算的数据
+ * @param ind 待计算的数据
  * @param n 计算均值的周期窗口，必须为大于0的整数
  * @param m 系数
  * @ingroup Indicator

hikyuu/include/hikyuu/indicator/crt/SPEARMAN.h

@@ -17,7 +17,7 @@ namespace hku {
  * @param n 滚动窗口(大于2 或 等于0)，等于0时，代表 n 实际使用 ind 的长度
  * @ingroup Indicator
  */
-Indicator HKU_API SPEARMAN(int n = 0);
 Indicator HKU_API SPEARMAN(const Indicator& ind1, const Indicator& ind2, int n = 0);
+Indicator HKU_API SPEARMAN(int n = 0);
 
 }  // namespace hku

hikyuu/include/hikyuu/indicator/imp/IDma.h

@@ -0,0 +1,47 @@
+/*
+ *  Copyright (c) 2024 hikyuu.org
+ *
+ *  Created on: 2024-09-09
+ *      Author: fasiondog
+ */
+
+#pragma once
+
+#include "../Indicator.h"
+
+namespace hku {
+
+/*
+ * 动态移动平均
+ * 用法：DMA(X,A),求X的动态移动平均。
+ * 算法：若Y=DMA(X,A) 则 Y=A*X+(1-A)*Y',其中Y'表示上一周期Y值。
+ * 例如：DMA(CLOSE,VOL/CAPITAL)表示求以换手率作平滑因子的平均价
+ */
+class IDma : public IndicatorImp {
+public:
+    IDma();
+    explicit IDma(const Indicator& ref_a);
+    virtual ~IDma();
+
+    virtual void _checkParam(const string& name) const override;
+    virtual void _calculate(const Indicator& data) override;
+    virtual IndicatorImpPtr _clone() override;
+
+private:
+    Indicator m_ref_a;
+
+//============================================
+// 序列化支持
+//============================================
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void serialize(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(IndicatorImp);
+        ar& BOOST_SERIALIZATION_NVP(m_ref_a);
+    }
+#endif
+};
+
+}

hikyuu/include/hikyuu/strategy/BrokerTradeManager.h

@@ -181,10 +181,9 @@ public:
 
     /**
      * 获取指定证券的空头持仓记录
-     * @param date 指定日期
      * @param stock 指定的证券
      */
-    virtual PositionRecord getShortPosition(const Stock&) const {
+    virtual PositionRecord getShortPosition(const Stock& stock) const {
         HKU_WARN("The subclass does not implement this method");
         return PositionRecord();
     }

hikyuu/include/hikyuu/strategy/Strategy.h

@@ -19,7 +19,7 @@
 namespace hku {
 
 /**
- * @ingroup Stratgy
+ * @ingroup Strategy
  * @{
  */
 
@@ -28,6 +28,7 @@ namespace hku {
  */
 class HKU_API Strategy {
     CLASS_LOGGER_IMP(Strategy)
+    PARAMETER_SUPPORT_WITH_CHECK
 
 public:
     Strategy();
@@ -37,6 +38,9 @@ public:
     explicit Strategy(const StrategyContext& context, const string& name = "Strategy",
                       const string& config_file = "");
 
+    Strategy(const Strategy&) = delete;
+    Strategy& operator=(const Strategy&) = delete;
+
     virtual ~Strategy();
 
     const string& name() const {
@@ -73,8 +77,7 @@ public:
     /**
      * 正确数据发生变化调用，即接收到相应行情数据变更
      * @note 通常用于调试。且只要收到行情采集消息就会触发，不受开、闭市时间限制
-     * @param stk 数据发生变化的 stock
-     * @param spot 接收到的具体数据
+     * @param changeFunc 回调函数
      */
     void onChange(std::function<void(const Stock&, const SpotRecord& spot)>&& changeFunc);
 
@@ -82,13 +85,14 @@ public:
      * 一批行情数据接受完毕后通知
      * @note 通常仅用于调试打印，该批行情数据中不一定含有上下文中包含的 stock
      *       且只要收到行情采集消息就会触发，不受开、闭市时间限制。
+     * @param recievedFucn 回调函数
      */
     void onReceivedSpot(std::function<void(const Datetime&)>&& recievedFucn);
 
     /**
      * 启动策略执行，必须在已注册相关处理函数后执行
      */
-    void start();
+    void start(bool autoRecieveSpot = true);
 
 private:
     string m_name;
@@ -106,6 +110,7 @@ private:
     TimeDelta m_run_daily_at_delta;
 
 private:
+    void _initParam();
     void _init();
     void _receivedSpot(const SpotRecord& spot);
     void _runDaily();
@@ -170,6 +175,12 @@ void HKU_API runInStrategy(const SYSPtr& sys, const Stock& stk, const KQuery& qu
 void HKU_API runInStrategy(const PFPtr& pf, const KQuery& query, int adjust_cycle,
                            const OrderBrokerPtr& broker, const TradeCostPtr& costfunc);
 
+/**
+ * 从 hikyuu 数据缓存服务器拉取更新最新的缓存数据
+ * @param addr 缓存服务地址，如: tcp://192.168.1.1:9201
+ * @param stklist 待更新的股票列表
+ * @param ktype 指定更新的K线类型
+ */
 void HKU_API getDataFromBufferServer(const std::string& addr, const StockList& stklist,
                                      const KQuery::KType& ktype);
 

hikyuu/include/hikyuu/trade_manage/OrderBrokerBase.h

@@ -134,6 +134,9 @@ public:
      * @param code 证券代码
      * @param price 卖出价格
      * @param num 卖出数量
+     * @param stoploss 新预期的止损价
+     * @param goalPrice 新预期的目标价位
+     * @param from 系统部件来源
      */
     virtual void _sell(Datetime datetime, const string& market, const string& code, price_t price,
                        double num, price_t stoploss, price_t goalPrice, SystemPart from) = 0;

hikyuu/include/hikyuu/trade_manage/TradeManagerBase.h

@@ -442,10 +442,9 @@ public:
 
     /**
      * 获取指定证券的空头持仓记录
-     * @param date 指定日期
      * @param stock 指定的证券
      */
-    virtual PositionRecord getShortPosition(const Stock&) const {
+    virtual PositionRecord getShortPosition(const Stock& stock) const {
         HKU_WARN("The subclass does not implement this method");
         return PositionRecord();
     }

hikyuu/include/hikyuu/trade_sys/allocatefunds/AllocateFundsBase.h

@@ -47,7 +47,6 @@ public:
      * @param date 指定日期
      * @param se_list 系统实例选择器选出的系统实例
      * @param running_list 当前运行中的系统实例
-     * @param ignore_list 忽略不进行调仓的运行中系统
      * @return 需延迟执行卖出操作的系统列表，其中权重为相应需卖出的数量
      */
     SystemWeightList adjustFunds(const Datetime& date, const SystemWeightList& se_list,

hikyuu/include/hikyuu/trade_sys/condition/ConditionBase.h

@@ -72,6 +72,7 @@ public:
     /**
      * 加入有效时间，在_calculate中调用
      * @param datetime 系统有效日期
+     * @param value 值
      */
     void _addValid(const Datetime& datetime, price_t value = 1.0);
 

hikyuu/include/hikyuu/trade_sys/portfolio/Portfolio.h

@@ -53,6 +53,7 @@ public:
      * @note
      * 由于各个组件可能存在参数变化的情况，无法自动感知判断是否需要重新计算，此时需要手工指定强制计算
      * @param query 查询条件
+     * @param adjust_cycle 调仓周期
      * @param force 是否强制重计算
      */
     void run(const KQuery& query, int adjust_cycle = 1, bool force = false);

hikyuu/include/hikyuu/trade_sys/selector/imp/FixedSelector.h

@@ -19,7 +19,7 @@ class FixedSelector : public SelectorBase {
 
 public:
     FixedSelector();
-    FixedSelector(double weight);
+    explicit FixedSelector(double weight);
     virtual ~FixedSelector();
 };
 

hikyuu/include/hikyuu/trade_sys/selector/imp/OperatorSelector.h

@@ -14,7 +14,7 @@ namespace hku {
 class HKU_API OperatorSelector : public SelectorBase {
 public:
     OperatorSelector();
-    OperatorSelector(const string& name);
+    explicit OperatorSelector(const string& name);
     OperatorSelector(const string& name, const SelectorPtr& se1, const SelectorPtr& se2);
     virtual ~OperatorSelector();
 
@@ -43,6 +43,7 @@ protected:
 protected:
     static void sortSystemWeightList(SystemWeightList& swlist);
 
+    void build();
     void cloneRebuild(const SelectorPtr& se1, const SelectorPtr& se2);
 
 protected:
@@ -63,11 +64,19 @@ private:
 #if HKU_SUPPORT_SERIALIZATION
     friend class boost::serialization::access;
     template <class Archive>
-    void serialize(Archive& ar, const unsigned int version) {
+    void save(Archive& ar, const unsigned int version) const {
         ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(SelectorBase);
         ar& BOOST_SERIALIZATION_NVP(m_se1);
         ar& BOOST_SERIALIZATION_NVP(m_se2);
     }
+
+    template <class Archive>
+    void load(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(SelectorBase);
+        ar& BOOST_SERIALIZATION_NVP(m_se1);
+        ar& BOOST_SERIALIZATION_NVP(m_se2);
+        build();
+    }
 #endif
 };
 

hikyuu/include/hikyuu/trade_sys/selector/imp/OperatorValueSelector.h

@@ -14,7 +14,7 @@ namespace hku {
 class HKU_API OperatorValueSelector : public SelectorBase {
 public:
     OperatorValueSelector();
-    OperatorValueSelector(const string& name);
+    explicit OperatorValueSelector(const string& name);
     OperatorValueSelector(const string& name, const SelectorPtr& se, double value);
     virtual ~OperatorValueSelector();
 
@@ -36,12 +36,29 @@ private:
     //============================================
 #if HKU_SUPPORT_SERIALIZATION
     friend class boost::serialization::access;
+    // template <class Archive>
+    // void serialize(Archive& ar, const unsigned int version) {
+    //     ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(SelectorBase);
+    //     ar& BOOST_SERIALIZATION_NVP(m_se);
+    //     ar& BOOST_SERIALIZATION_NVP(m_value);
+    // }
     template <class Archive>
-    void serialize(Archive& ar, const unsigned int version) {
+    void save(Archive& ar, const unsigned int version) const {
         ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(SelectorBase);
         ar& BOOST_SERIALIZATION_NVP(m_se);
         ar& BOOST_SERIALIZATION_NVP(m_value);
     }
+
+    template <class Archive>
+    void load(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_BASE_OBJECT_NVP(SelectorBase);
+        ar& BOOST_SERIALIZATION_NVP(m_se);
+        ar& BOOST_SERIALIZATION_NVP(m_value);
+        if (m_se) {
+            m_pro_sys_list = m_se->getProtoSystemList();
+        }
+    }
+
 #endif
 };
 

hikyuu/include/hikyuu/utilities/Parameter.h

@@ -365,7 +365,7 @@ public:                                                                     \
  * 子类需要实现重载以下虚函数接口:
  *    virtual void _checkParam(const string& name) const
  * 基类需要实现以下接口:
- *    void baseCheckParam(const string& name)
+ *    void baseCheckParam(const string& name) const
  *    void paramChanged()
  * 另：python 中一般不需要引出 paramChanged/checkParam/_checkParam，python
  * 类继承时可以自己在初始化时进行检查

hikyuu/include/hikyuu/utilities/TimerManager.h

@@ -196,7 +196,7 @@ public:
      * @param start_time 允许运行的起始时间
      * @param end_time 允许运行的结束时间
      * @param repeat_num 重复次数，必须大于0，等于std::numeric_limits<int>::max()时表示无限循环
-     * @param delay 间隔时间，需大于 TimeDelta(0)
+     * @param duration 间隔时间，需大于 TimeDelta(0)
      * @param f 待执行的延迟任务
      * @param args 任务具体参数
      * @return timer id
@@ -226,7 +226,7 @@ public:
      * @tparam F 任务类型
      * @tparam Args 任务参数
      * @param repeat_num 重复次数，必须大于0，等于std::numeric_limits<int>::max()时表示无限循环
-     * @param delay 间隔时间，需大于 TimeDelta(0)
+     * @param duration 间隔时间，需大于 TimeDelta(0)
      * @param f 待执行的延迟任务
      * @param args 任务具体参数
      * @return timer id

hikyuu/include/hikyuu/utilities/arithmetic.h

@@ -316,7 +316,7 @@ inline std::vector<std::string> split(const std::string &str, const std::string
 
 /**
  * byte 转 16 进制字符串, 如 "abcd" 转换为 "61626364"
- * @param in_byte 输入的 byte 数组
+ * @param bytes 输入的 byte 数组
  * @param in_len byte 数组长度
  */
 inline std::string byteToHexStr(const char *bytes, size_t in_len) {
@@ -345,7 +345,7 @@ inline std::string byteToHexStr(const char *bytes, size_t in_len) {
 
 /**
  * byte 转 16 进制字符串, 如 "abcd" 转换为 "61626364"
- * @param in_byte std::string 格式的输入
+ * @param bytes std::string 格式的输入
  */
 inline std::string byteToHexStr(const std::string &bytes) {
     return byteToHexStr(bytes.c_str(), bytes.size());
@@ -353,7 +353,7 @@ inline std::string byteToHexStr(const std::string &bytes) {
 
 /**
  * byte 转 16 进制字符串, 如 "abcd" 转换为 "0x61 0x62 0x63 0x64"
- * @param in_byte 输入的 byte 数组
+ * @param bytes 输入的 byte 数组
  * @param in_len byte 数组长度
  */
 inline std::string byteToHexStrForPrint(const char *bytes, size_t in_len) {
@@ -389,7 +389,7 @@ inline std::string byteToHexStrForPrint(const char *bytes, size_t in_len) {
 
 /**
  * byte 转 16 进制字符串, 如 "abcd" 转换为 "61626364"
- * @param in_byte 输入的 byte 数组
+ * @param bytes 输入的 byte 数组
  */
 inline std::string byteToHexStrForPrint(const std::string &bytes) {
     return byteToHexStrForPrint(bytes.c_str(), bytes.size());

hikyuu/include/hikyuu/utilities/base64.h

@@ -27,8 +27,7 @@ std::string HKU_UTILS_API base64_encode(unsigned char const* bytes_to_encode, si
 
 /**
  * 字符串编码为 base64
- * @param bytes_to_encode 内存起始地址
- * @param in_len 待计算的字节长度
+ * @param src 输入字符串
  * @note 通过 func(unsigned char *, unsigned int) 函数实现，而不是直接只提供 string_view
  * 版本的原因是：c++17 string_view 处理 nullptr 时，程序会直接挂掉，无异常
  */

hikyuu/include/hikyuu/utilities/mo/moFileReader.h

@@ -342,7 +342,7 @@ public:
     };
 
     /** \brief Reads a .mo-file
-     * \param[in] _filename The path to the file to load.
+     * \param[in] data The path to the file to load.
      * \return SUCCESS on success or one of the other error-codes in eErrorCode on error.
      *
      * This is the core-feature. This method loads the .mo-file and stores
@@ -357,7 +357,7 @@ public:
     }
 
     /** \brief Reads a .mo-file
-     * \param[in] _filename The path to the file to load.
+     * \param[in] filename The path to the file to load.
      * \return SUCCESS on success or one of the other error-codes in eErrorCode on error.
      *
      * This is the core-feature. This method loads the .mo-file and stores

hikyuu/include/hikyuu/utilities/node/NodeMessage.h

@@ -37,8 +37,6 @@ namespace hku {
  * 对消息进行解码，消息类型和消息体必须匹配
  * @tparam T 消息体类型
  * @param msg 消息
- * @param out 解码输出的消息
- * @exception yas::io_exception 消息解码失败
  * @exception NodeErrorCode 消息类型不匹配
  */
 inline json decodeMsg(nng_msg *msg) {
@@ -68,7 +66,7 @@ inline void encodeMsg(nng_msg *msg, const json &in) {
 
 /**
  * 构造错误消息响应
- * @param msg[out] 消息
+ * @param msg [out] 消息
  * @param errcode 错误码
  * @param errmsg 错误消息
  */

hikyuu/include/hikyuu/utilities/thread/MQStealThreadPool.h

@@ -47,10 +47,9 @@ public:
      * 构造函数，创建指定数量的线程
      * @param n 指定的线程数
      * @param until_empty 任务队列为空时，自动停止运行
-     * @param exit_thread_callback 工作线程结束时回调函数
      */
-    explicit MQStealThreadPool(size_t n, bool util_empty = true)
-    : m_done(false), m_worker_num(n), m_runnging_util_empty(util_empty) {
+    explicit MQStealThreadPool(size_t n, bool until_empty = true)
+    : m_done(false), m_worker_num(n), m_runnging_until_empty(until_empty) {
         try {
             m_interrupt_flags.resize(m_worker_num, nullptr);
             for (size_t i = 0; i < m_worker_num; i++) {
@@ -189,7 +188,7 @@ public:
         }
 
         // 指示各工作线程在未获取到工作任务时，停止运行
-        if (m_runnging_util_empty) {
+        if (m_runnging_until_empty) {
             while (true) {
                 bool can_quit = true;
                 for (size_t i = 0; i < m_worker_num; i++) {
@@ -234,9 +233,9 @@ public:
 
 private:
     typedef FuncWrapper task_type;
-    std::atomic_bool m_done;     // 线程池全局需终止指示
-    size_t m_worker_num;         // 工作线程数量
-    bool m_runnging_util_empty;  // 运行直到队列空时停止
+    std::atomic_bool m_done;      // 线程池全局需终止指示
+    size_t m_worker_num;          // 工作线程数量
+    bool m_runnging_until_empty;  // 运行直到队列空时停止
 
     std::vector<std::unique_ptr<MQStealQueue<task_type>>> m_queues;  // 线程任务队列
     std::vector<InterruptFlag*> m_interrupt_flags;                   // 线程终止标志

hikyuu/include/hikyuu/version.h

@@ -12,13 +12,13 @@
 #define HKU_VERSION_H
 
 // clang-format off
-#define HKU_VERSION "2.1.3"
+#define HKU_VERSION "2.1.5"
 #define HKU_VERSION_MAJOR 2
 #define HKU_VERSION_MINOR 1
-#define HKU_VERSION_ALTER 3
-#define HKU_VERSION_BUILD 202408272229
+#define HKU_VERSION_ALTER 5
+#define HKU_VERSION_BUILD 202409110733
 #define HKU_VERSION_MODE "RELEASE"
-#define HKU_VERSION_GIT "2.1.3 release.35fa3739 (RELEASE)"
+#define HKU_VERSION_GIT "2.1.5 release.6f6597d9 (RELEASE)"
 // clang-format on
 
 #endif /* HKU_VERSION_H */