]> Piment Noir Git Repositories - freqai-strategies.git/commitdiff
docs(quickadapter): update label weighting defaults
authorJérôme Benoit <jerome.benoit@piment-noir.org>
Fri, 19 Jun 2026 14:36:06 +0000 (16:36 +0200)
committerJérôme Benoit <jerome.benoit@piment-noir.org>
Fri, 19 Jun 2026 14:36:06 +0000 (16:36 +0200)
README.md
quickadapter/user_data/config-template.json

index c5caed7f24ddb995a4369b7e45b694f3a72f9880..522ed6301bd0bc203110dc885fd7d90a66d434b8 100644 (file)
--- a/README.md
+++ b/README.md
@@ -80,13 +80,13 @@ docker compose up -d --build
 | freqai.label_weighting.aggregation                             | `arithmetic_mean`             | enum {`arithmetic_mean`,`geometric_mean`,`harmonic_mean`,`quadratic_mean`,`weighted_median`,`softmax`}                                                 | Metric aggregation method for `combined` strategy. `arithmetic_mean`=(Σ(w·m)/Σ(w)), `geometric_mean`=(∏(m^w))^(1/Σw), `harmonic_mean`=Σ(w)/(Σ(w/m)), `quadratic_mean`=(Σ(w·m²)/Σ(w))^(1/2), `weighted_median`=Q₀.₅(m,w), `softmax`=Σ(m·s_i) where s_i=w_i·exp(m_i/T)/Σ(w_j·exp(m_j/T)).                                                                                                                                                                                                                                                                                  |
 | freqai.label_weighting.softmax_temperature                     | 1.0                           | float > 0                                                                                                                                              | Temperature T for `softmax` aggregation, controls distribution sharpness.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | freqai.label_weighting.fill_method                             | `zero`                        | enum {`zero`,`epsilon`,`gaussian`}                                                                                                                     | Off-pivot weighting scheme. `zero` hard-zeros off-pivot rows; `epsilon` applies a flat baseline `fill_epsilon * <fill_epsilon_baseline>(pivot_weights)`; `gaussian` applies heatmap-style decay around each pivot. Switching away from `zero` may require retuning tree-leaf regularization (`min_child_weight`, `lambda`) and resetting any prior Optuna study. Changing this parameter requires deleting trained models.                                                                                                                                               |
-| freqai.label_weighting.fill_epsilon                            | 0.001                         | float [0,1]                                                                                                                                            | Off-pivot fraction of the pivot baseline. Ignored when `fill_method != "epsilon"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| freqai.label_weighting.fill_epsilon                            | 0.000001                      | float [0,1]                                                                                                                                            | Off-pivot fraction of the pivot baseline. Ignored when `fill_method != "epsilon"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | freqai.label_weighting.fill_epsilon_baseline                   | `mean`                        | enum {`mean`,`median`}                                                                                                                                 | Pivot baseline statistic. `mean` tracks central tendency; `median` is robust against pivot-weight skew. Ignored when `fill_method != "epsilon"`.                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| freqai.label_weighting.fill_sigma_candles                      | 3.0                           | float >= 0.5                                                                                                                                           | Gaussian standard deviation in candles for `fill_method == "gaussian"`. Acts as the upper bound on per-pivot sigma when `fill_bandwidth == "knn"`. Lower bound 0.5 prevents severe underflow in the Gaussian tail. Ignored when `fill_method != "gaussian"`.                                                                                                                                                                                                                                                                                                             |
+| freqai.label_weighting.fill_sigma_candles                      | 10.0                          | float >= 0.5                                                                                                                                           | Gaussian standard deviation in candles for `fill_method == "gaussian"`. Acts as the upper bound on per-pivot sigma when `fill_bandwidth == "knn"`. Lower bound 0.5 prevents severe underflow in the Gaussian tail. Ignored when `fill_method != "gaussian"`.                                                                                                                                                                                                                                                                                                             |
 | freqai.label_weighting.fill_sigma_min_candles                  | 0.5                           | float >= 0.5                                                                                                                                           | Lower bound on per-pivot sigma in candles when `fill_bandwidth == "knn"`. Clipped to `fill_sigma_candles` when larger. Ignored when `fill_method != "gaussian"` or `fill_bandwidth != "knn"`.                                                                                                                                                                                                                                                                                                                                                                            |
 | freqai.label_weighting.fill_bandwidth                          | `fixed`                       | enum {`fixed`,`knn`}                                                                                                                                   | Per-pivot Gaussian bandwidth selector. `fixed` applies a constant `fill_sigma_candles` to every pivot (legacy behavior). `knn` adapts each pivot's sigma to local pivot density via `sigma_p = clip(fill_bandwidth_alpha * d_k(p), fill_sigma_min_candles, fill_sigma_candles)` where `d_k(p)` is the index distance to the `k`-th nearest pivot neighbor (Loftsgaarden & Quesenberry 1965; Silverman 1986, §5.2). Mitigates the crushing of weaker pivots by stronger neighbors in dense clusters. Ignored when `fill_method != "gaussian"`.                            |
 | freqai.label_weighting.fill_bandwidth_neighbors                | 1                             | int >= 1                                                                                                                                               | `k` for the k-nearest-neighbor bandwidth selector. Ignored when `fill_method != "gaussian"` or `fill_bandwidth != "knn"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| freqai.label_weighting.fill_bandwidth_alpha                    | 1.0                           | float > 0                                                                                                                                              | Multiplicative factor on the k-th neighbor distance. Smaller values produce sharper, more separated Gaussians; larger values approach the `fixed` behavior. Ignored when `fill_method != "gaussian"` or `fill_bandwidth != "knn"`.                                                                                                                                                                                                                                                                                                                                       |
+| freqai.label_weighting.fill_bandwidth_alpha                    | 0.5                           | float > 0                                                                                                                                              | Multiplicative factor on the k-th neighbor distance. Smaller values produce sharper, more separated Gaussians; larger values approach the `fixed` behavior. Ignored when `fill_method != "gaussian"` or `fill_bandwidth != "knn"`.                                                                                                                                                                                                                                                                                                                                       |
 | _Label pipeline_                                               |                               |                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | freqai.label_pipeline.standardization                          | `none`                        | enum {`none`,`zscore`,`robust`,`mmad`,`power_yj`}                                                                                                      | Standardization method applied to labels before normalization. `none`=w, `zscore`=(w-μ)/σ, `robust`=(w-median)/(Q₃-Q₁), `mmad`=(w-median)/(MAD·k), `power_yj`=YJ(w).                                                                                                                                                                                                                                                                                                                                                                                                     |
 | freqai.label_pipeline.robust_quantiles                         | [0.25, 0.75]                  | list[float] where 0 <= Q1 < Q3 <= 1                                                                                                                    | Quantile range for robust standardization, Q1 and Q3.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
index d105c6aa9908315d48ee29ca350e07f9f4c51bb9..110cc030b2de77da322ef2e29ee6fcad82652c02 100644 (file)
     "label_weighting": {
       "strategy": "none",
       "fill_method": "zero",
-      "fill_epsilon": 0.001,
+      "fill_epsilon": 0.000001,
       "fill_epsilon_baseline": "mean",
-      "fill_sigma_candles": 3.0
+      "fill_sigma_candles": 10.0,
+      "fill_sigma_min_candles": 0.5,
+      "fill_bandwidth_alpha": 0.5
       // Per-label format:
       // "default": {
       //   "strategy": "none"
       // "columns": {
       //   "&s-extrema": {
       //     "threshold_method": "isodata",
-      //     "keep_fraction": 0.015
+      //     "keep_fraction": 0.005
       //   }
       // }
     },