exp 11 (sp5d-moment-features): variant C 35-field workflow + result NEGATIVE vs generic-only 19

workflows/README-moments.md

@@ -0,0 +1,20 @@
+# exp/10 sp5d-moment-features
+
+Variant C: generic-only 19 + 16 new moment/volatility families (skew, kurt,
+DSV+ratios, max_up/down, rv_ac1, rv_cv_22, sig lag-5). 35 sp_* fields, ou/hmm excluded.
+
+Run a3f7d1d40c3d4b839314fcf5b40f9b08 (tac-rd-moments / exp 12) — FINISHED.
+
+## Result: NEGATIVE (regression vs generic-only baseline)
+
+| Metric | generic-only 19 (run 7b1e797) | +moments 35 (run a3f7d1d) |
+|---|---|---|
+| Rank IC   | 0.0635 | 0.0466 |
+| Rank ICIR | 0.276  | 0.183  |
+| L-S Sharpe | 2.55  | 1.44  |
+| net excess (cost) | +3.1% IR 0.28 | -16.2% IR -1.57 |
+| MDD | -7.3% | -11.1% |
+
+Same failure mode as ou/hmm in exp 9: adding cross-sectional moment features
+to the 50-name panel degrades the rank signal. Generic-only 19 remains the
+best configuration. No further moment-family variants planned.

workflows/ablate_generic_moments.yaml

@@ -1,19 +1,22 @@
 # -----------------------------------------------------------------------------
-# EXP 14 - Strategy A (baseline): reference model + TopkDropout.
+# VARIANT C (generic + moments): keeps the winning generic-only 19-field set
-#
+# (jump,har,trend,hurst,signature) and adds the NEW generic moment families the
-# Model = RankICEnsembleLGBModel (5-seed RankIC-early-stopped LGB), the class
+# engine now exposes:
-# wired by the tac-rd-rank-ensemble-isolated reference (run 0cea66d9...).
+#   - realized skewness / kurtosis      (sp_rskew_5, sp_rskew_22, sp_rkurt_5, sp_rkurt_22)
-# Strategy = TopkDropout topk=10 n_drop=2 risk_degree=0.95 (the reference's own
+#   - downside semi-variance + ratios   (sp_dsv_1/5/22, sp_dsv_ratio_1/5/22)
-# recorded backtest strategy), so this run reproduces the reference baseline on
+#   - signed max moves                  (sp_max_up, sp_max_down)
-# the same 50-ETF SP-5d panel.
+#   - RV autocorr / vol-of-vol          (sp_rv_ac1, sp_rv_cv_22)
+#   - longer-lag signature terms        (sp_sig_level2_*_5)
+# Drops the model-specific ou/hmm families (they scored high in importance but
+# hurt the rank dimension in the all-24 run). Same panel/model as baseline.
 #
 # Run:
-#   rd_run_workflow config_path=experiments/workflows/exp14-optstop-v2/a_topk_baseline.yaml \
+#   rd_run_workflow config_path=experiments/workflows/ablate_generic_moments.yaml \
-#       experiment_name=tac-rd-optstop-v2
+#       experiment_name=tac-rd-moments
 # -----------------------------------------------------------------------------
 {%- set LAKE = TAC_LAKE_DIR %}
 {%- set UNIVERSE = "SPY,QQQ,DIA,IWM,MDY,VTI,VOO,VEA,VWO,VT,EFA,EEM,TLT,IEF,SHY,AGG,BND,LQD,HYG,JNK,EMB,GLD,SLV,USO,UNG,DBA,DBC,XLK,XLF,XLE,XLV,XLI,XLY,XLP,XLU,XLB,XLRE,ARKK,SMH,SOXX,IBB,XBI,ITA,XAR,ICLN,TAN,FDN,IGV,ESPO,REM" %}
-{%- set SP_FIELDS = "sp_ret,sp_jump_ratio,sp_jump_flag,sp_jump_tail,sp_max_move,sp_rv1,sp_rv5,sp_rv22,sp_vol_ratio_5_22,sp_vol_ratio_1_22,sp_trend_slope_5,sp_trend_slope_20,sp_trend_slope_60,sp_logp,sp_hurst_exponent,sp_sig_level1_lead,sp_sig_level1_lag,sp_sig_level2_lead_lag,sp_sig_level2_lag_lead" %}
+{%- set SP_FIELDS = "sp_ret,sp_jump_ratio,sp_jump_flag,sp_jump_tail,sp_max_move,sp_max_up,sp_max_down,sp_rv1,sp_rv5,sp_rv22,sp_vol_ratio_5_22,sp_vol_ratio_1_22,sp_rv_ac1,sp_rv_cv_22,sp_trend_slope_5,sp_trend_slope_20,sp_trend_slope_60,sp_logp,sp_hurst_exponent,sp_sig_level1_lead,sp_sig_level1_lag,sp_sig_level2_lead_lag,sp_sig_level2_lag_lead,sp_sig_level2_lead_lag_5,sp_sig_level2_lag_lead_5,sp_rskew_5,sp_rskew_22,sp_rkurt_5,sp_rkurt_22,sp_dsv_1,sp_dsv_5,sp_dsv_22,sp_dsv_ratio_1,sp_dsv_ratio_5,sp_dsv_ratio_22" %}
 
 qlib_init:
     provider_uri: "{{ LAKE }}"
@@ -43,12 +46,12 @@ qlib_init:
         module_path: qlib.workflow.expm
         kwargs:
             uri: "sqlite:///{{ LAKE }}/mlruns.db"
-            default_exp_name: "tac-rd-optstop-v2"
+            default_exp_name: "tac-rd-moments"
 
 task:
     model:
-        class: RankICEnsembleLGBModel
+        class: RankICLGBModel
-        module_path: tac_qlib.contrib.model.rank_ensemble
+        module_path: tac_qlib.contrib.model.rank_gbdt
         kwargs:
             loss: mse
             learning_rate: 0.02
@@ -63,7 +66,7 @@ task:
             subsample_freq: 1
             reg_alpha: 0.1
             reg_lambda: 1.0
-            seeds: "42,7,2026,99,123"
+            seed: 42
 
     dataset:
         class: DatasetH
@@ -75,8 +78,8 @@ task:
                 kwargs:
                     instruments: "{{ UNIVERSE }}"
                     start_time: 2015-01-03
-                    end_time: 2026-08-14
+                    end_time: 2026-08-10
-                    fit_start_time: 2016-01-04
+                    fit_start_time: 2015-01-03
                     fit_end_time: 2025-09-01
                     freq: day
                     lake_root: "{{ LAKE }}"
@@ -95,7 +98,7 @@ task:
                         - class: Fillna
                           kwargs: {}
             segments:
-                train: [2016-01-04, 2025-09-01]
+                train: [2015-01-03, 2025-09-01]
                 valid: [2025-09-03, 2026-01-03]
                 test: [2026-01-04, 2026-08-10]
 

workflows/exp12_isolation_ensemble.yaml

@@ -1,141 +0,0 @@
-# -----------------------------------------------------------------------------
-# ISOLATION: multi-seed RankIC ensemble, ablate-B generic-only feature set.
-#
-# Isolates the ensemble effect on the SP-5d rank signal. Same panel, segments,
-# history (full backfilled 2016+) and feature set as the exp-9 ablate-B winner
-# (generic-only sp_* families: jump,har,trend,hurst,signature), but replaces the
-# single RankICLGBModel with a 5-seed RankICEnsembleLGBModel (42,7,2026,99,123)
-# that averages per-day predictions.
-#
-# Differs from exp-15 (tac-rd-rank-ensemble, mlflow exp 15) ONLY by dropping the
-# TA subset (rsi_14,roc_10,macd_hist,willr_14,atr_14) and the inter-asset xr_*
-# features, so any change vs exp-15 is attributable to the feature set alone,
-# and any change vs exp-9 is attributable to the ensemble + full history alone.
-#
-# Run:
-#   rd_run_workflow config_path=experiments/workflows/exp12_isolation_ensemble.yaml \
-#       experiment_name=tac-rd-rank-ensemble-isolated
-# -----------------------------------------------------------------------------
-{%- set LAKE = TAC_LAKE_DIR %}
-{%- set UNIVERSE = "SPY,QQQ,DIA,IWM,MDY,VTI,VOO,VEA,VWO,VT,EFA,EEM,TLT,IEF,SHY,AGG,BND,LQD,HYG,JNK,EMB,GLD,SLV,USO,UNG,DBA,DBC,XLK,XLF,XLE,XLV,XLI,XLY,XLP,XLU,XLB,XLRE,ARKK,SMH,SOXX,IBB,XBI,ITA,XAR,ICLN,TAN,FDN,IGV,ESPO,REM" %}
-{%- set SP_FIELDS = "sp_ret,sp_jump_ratio,sp_jump_flag,sp_jump_tail,sp_max_move,sp_rv1,sp_rv5,sp_rv22,sp_vol_ratio_5_22,sp_vol_ratio_1_22,sp_trend_slope_5,sp_trend_slope_20,sp_trend_slope_60,sp_logp,sp_hurst_exponent,sp_sig_level1_lead,sp_sig_level1_lag,sp_sig_level2_lead_lag,sp_sig_level2_lag_lead" %}
-
-qlib_init:
-    provider_uri: "{{ LAKE }}"
-    region: us
-    expression_cache: null
-    dataset_cache: null
-
-    calendar_provider:
-        class: tac_qlib.data.providers.LakeCalendarProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-    instrument_provider:
-        class: tac_qlib.data.providers.LakeInstrumentProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-            markets: {}
-    feature_provider:
-        class: tac_qlib.data.providers.LakeFeatureProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-
-    exp_manager:
-        class: MLflowExpManager
-        module_path: qlib.workflow.expm
-        kwargs:
-            uri: "sqlite:///mlruns.db"
-            default_exp_name: "tac-rd-rank-ensemble-isolated"
-
-task:
-    model:
-        class: RankICEnsembleLGBModel
-        module_path: tac_qlib.contrib.model.rank_ensemble
-        kwargs:
-            loss: mse
-            learning_rate: 0.02
-            num_leaves: 31
-            n_estimators: 3000
-            num_boost_round: 3000
-            early_stopping_rounds: 200
-            min_data_in_leaf: 20
-            lambda_l2: 0.5
-            colsample_bytree: 0.8
-            subsample: 0.8
-            subsample_freq: 1
-            reg_alpha: 0.1
-            reg_lambda: 1.0
-            seeds: "42,7,2026,99,123"
-
-    dataset:
-        class: DatasetH
-        module_path: qlib.data.dataset
-        kwargs:
-            handler:
-                class: TACHandler
-                module_path: tac_qlib.contrib.data.handler
-                kwargs:
-                    instruments: "{{ UNIVERSE }}"
-                    start_time: 2015-01-03
-                    end_time: 2026-08-14
-                    fit_start_time: 2016-01-04
-                    fit_end_time: 2025-09-01
-                    freq: day
-                    lake_root: "{{ LAKE }}"
-                    market: US
-                    label: "Ref($close,-6)/Ref($close,-1)-1"
-                    feature_fields: "$open,$high,$low,$close,$vwap,$volume,{{ SP_FIELDS }}"
-                    infer_processors:
-                        - class: DropAllNaN
-                          kwargs: {}
-                        - class: ProcessInf
-                          kwargs: {}
-                        - class: CSRankNorm
-                          kwargs: {}
-                        - class: ZScoreNorm
-                          kwargs: {}
-                        - class: Fillna
-                          kwargs: {}
-            segments:
-                train: [2016-01-04, 2025-09-01]
-                valid: [2025-09-03, 2026-01-03]
-                test: [2026-01-04, 2026-08-10]
-
-    record:
-        - class: SignalRecord
-          module_path: qlib.workflow.record_temp
-          kwargs: {}
-        - class: SigAnaRecord
-          module_path: qlib.workflow.record_temp
-          kwargs:
-              ana_long_short: true
-              ann_scaler: 252
-        - class: PortAnaRecord
-          module_path: qlib.workflow.record_temp
-          kwargs:
-              config:
-                  strategy:
-                      class: TopkDropoutStrategy
-                      module_path: qlib.contrib.strategy
-                      kwargs:
-                          signal: "<PRED>"
-                          topk: 10
-                          n_drop: 2
-                          only_tradable: true
-                          risk_degree: 0.95
-                  backtest:
-                      start_time: 2026-01-04
-                      end_time: 2026-08-10
-                      account: 1000000
-                      benchmark: SPY
-                      exchange_kwargs:
-                          codes: "{{ UNIVERSE }}"
-                          deal_price: $close
-                          freq: day
-                          open_cost: 0.0005
-                          close_cost: 0.0015
-                          min_cost: 5.0
-              risk_analysis_freq: 1d

workflows/exp14-optstop-v2/b_optstop_v2.yaml

@@ -1,149 +0,0 @@
-# -----------------------------------------------------------------------------
-# EXP 14 - Strategy B (enhanced): reference model + OptimalStopControlV2.
-#
-# Model = RankICEnsembleLGBModel (5-seed RankIC-early-stopped LGB), identical to
-# Strategy A. Strategy = OptimalStopControlV2 (tac_qlib.contrib.strategy.
-# optimal_stop_v2) with the controls that address OptimalStopControl's documented
-# weaknesses:
-#   - turnover / cost control: rebalance_band=0.05 (skip small rebalances),
-#     cooldown_days=3 (no whipsaw re-entries), max_turnover=0.30 (cap daily
-#     traded notional, priority exits > opens > rebalances)
-#   - robust thresholds (no valid-window overfit): entry 0.85 / exit 0.70 /
-#     max_hold 10 / min_hold 2 / sl -0.08
-# Sizing = equal-weight control (risk_degree fraction of total value split
-# across targets) - the "proper allocation" that replaces cash-heuristic sizing.
-#
-# Run:
-#   rd_run_workflow config_path=experiments/workflows/exp14-optstop-v2/b_optstop_v2.yaml \
-#       experiment_name=tac-rd-optstop-v2
-# -----------------------------------------------------------------------------
-{%- set LAKE = TAC_LAKE_DIR %}
-{%- set UNIVERSE = "SPY,QQQ,DIA,IWM,MDY,VTI,VOO,VEA,VWO,VT,EFA,EEM,TLT,IEF,SHY,AGG,BND,LQD,HYG,JNK,EMB,GLD,SLV,USO,UNG,DBA,DBC,XLK,XLF,XLE,XLV,XLI,XLY,XLP,XLU,XLB,XLRE,ARKK,SMH,SOXX,IBB,XBI,ITA,XAR,ICLN,TAN,FDN,IGV,ESPO,REM" %}
-{%- set SP_FIELDS = "sp_ret,sp_jump_ratio,sp_jump_flag,sp_jump_tail,sp_max_move,sp_rv1,sp_rv5,sp_rv22,sp_vol_ratio_5_22,sp_vol_ratio_1_22,sp_trend_slope_5,sp_trend_slope_20,sp_trend_slope_60,sp_logp,sp_hurst_exponent,sp_sig_level1_lead,sp_sig_level1_lag,sp_sig_level2_lead_lag,sp_sig_level2_lag_lead" %}
-
-qlib_init:
-    provider_uri: "{{ LAKE }}"
-    region: us
-    expression_cache: null
-    dataset_cache: null
-
-    calendar_provider:
-        class: tac_qlib.data.providers.LakeCalendarProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-    instrument_provider:
-        class: tac_qlib.data.providers.LakeInstrumentProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-            markets: {}
-    feature_provider:
-        class: tac_qlib.data.providers.LakeFeatureProvider
-        kwargs:
-            lake_root: "{{ LAKE }}"
-            market: US
-
-    exp_manager:
-        class: MLflowExpManager
-        module_path: qlib.workflow.expm
-        kwargs:
-            uri: "sqlite:///{{ LAKE }}/mlruns.db"
-            default_exp_name: "tac-rd-optstop-v2"
-
-task:
-    model:
-        class: RankICEnsembleLGBModel
-        module_path: tac_qlib.contrib.model.rank_ensemble
-        kwargs:
-            loss: mse
-            learning_rate: 0.02
-            num_leaves: 31
-            n_estimators: 3000
-            num_boost_round: 3000
-            early_stopping_rounds: 200
-            min_data_in_leaf: 20
-            lambda_l2: 0.5
-            colsample_bytree: 0.8
-            subsample: 0.8
-            subsample_freq: 1
-            reg_alpha: 0.1
-            reg_lambda: 1.0
-            seeds: "42,7,2026,99,123"
-
-    dataset:
-        class: DatasetH
-        module_path: qlib.data.dataset
-        kwargs:
-            handler:
-                class: TACHandler
-                module_path: tac_qlib.contrib.data.handler
-                kwargs:
-                    instruments: "{{ UNIVERSE }}"
-                    start_time: 2015-01-03
-                    end_time: 2026-08-14
-                    fit_start_time: 2016-01-04
-                    fit_end_time: 2025-09-01
-                    freq: day
-                    lake_root: "{{ LAKE }}"
-                    market: US
-                    label: "Ref($close,-6)/Ref($close,-1)-1"
-                    feature_fields: "$open,$high,$low,$close,$vwap,$volume,{{ SP_FIELDS }}"
-                    infer_processors:
-                        - class: DropAllNaN
-                          kwargs: {}
-                        - class: ProcessInf
-                          kwargs: {}
-                        - class: CSRankNorm
-                          kwargs: {}
-                        - class: ZScoreNorm
-                          kwargs: {}
-                        - class: Fillna
-                          kwargs: {}
-            segments:
-                train: [2016-01-04, 2025-09-01]
-                valid: [2025-09-03, 2026-01-03]
-                test: [2026-01-04, 2026-08-10]
-
-    record:
-        - class: SignalRecord
-          module_path: qlib.workflow.record_temp
-          kwargs: {}
-        - class: SigAnaRecord
-          module_path: qlib.workflow.record_temp
-          kwargs:
-              ana_long_short: true
-              ann_scaler: 252
-        - class: PortAnaRecord
-          module_path: qlib.workflow.record_temp
-          kwargs:
-              config:
-                  strategy:
-                      class: OptimalStopControlV2
-                      module_path: tac_qlib.contrib.strategy.optimal_stop_v2
-                      kwargs:
-                          signal: "<PRED>"
-                          topk: 10
-                          entry_pct: 0.85
-                          exit_pct: 0.70
-                          max_hold_days: 10
-                          min_hold_days: 2
-                          sl: -0.08
-                          risk_degree: 0.95
-                          notional: 20000
-                          rebalance_band: 0.05
-                          cooldown_days: 3
-                          max_turnover: 0.30
-                  backtest:
-                      start_time: 2026-01-04
-                      end_time: 2026-08-10
-                      account: 1000000
-                      benchmark: SPY
-                      exchange_kwargs:
-                          codes: "{{ UNIVERSE }}"
-                          deal_price: $close
-                          freq: day
-                          open_cost: 0.0005
-                          close_cost: 0.0015
-                          min_cost: 5.0
-              risk_analysis_freq: 1d