Parameters¶
Complete reference for all LOWESS configuration options.
Quick Reference¶
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | NULL (auto) | [0, ∞) | Interpolation threshold | All |
| weight_function | "tricube" |
7 options | Distance kernel | All |
| robustness_method | "bisquare" |
3 options | Outlier weighting | All |
| zero_weight_fallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundary_policy | "extend" |
4 options | Edge handling | All |
| scaling_method | "mad" |
3 options | Scale estimation | All |
| auto_converge | NULL | tolerance | Early stopping | All |
| return_residuals | FALSE | logical | Include residuals | All |
| return_robustness_weights | FALSE | logical | Include weights | All |
| return_diagnostics | FALSE | logical | Include metrics | Batch, Streaming |
| confidence_intervals | NULL | (0, 1) | CI level | Batch |
| prediction_intervals | NULL | (0, 1) | PI level | Batch |
| cv_method | NULL | method | Auto-select fraction | Batch |
| chunk_size | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| merge_strategy | "average" |
4 options | Merge overlaps | Streaming |
| window_capacity | 1000 | [3, ∞) | Max window size | Online |
| min_points | 2 | [2, window] | Min before output | Online |
| update_mode | "incremental" |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | None (auto) | [0, ∞) | Interpolation threshold | All |
| weight_function | "tricube" |
7 options | Distance kernel | All |
| robustness_method | "bisquare" |
3 options | Outlier weighting | All |
| zero_weight_fallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundary_policy | "extend" |
4 options | Edge handling | All |
| scaling_method | "mad" |
3 options | Scale estimation | All |
| auto_converge | None | tolerance | Early stopping | All |
| return_residuals | False | bool | Include residuals | All |
| return_robustness_weights | False | bool | Include weights | All |
| return_diagnostics | False | bool | Include metrics | Batch, Streaming |
| confidence_intervals | None | (0, 1) | CI level | Batch |
| prediction_intervals | None | (0, 1) | PI level | Batch |
| cv_method | None | method | Auto-select fraction | Batch |
| chunk_size | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| merge_strategy | "average" |
4 options | Merge overlaps | Streaming |
| window_capacity | 1000 | [3, ∞) | Max window size | Online |
| min_points | 2 | [2, window] | Min before output | Online |
| update_mode | "incremental" |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | auto | [0, ∞) | Interpolation threshold | All |
| weight_function | Tricube |
7 options | Distance kernel | All |
| robustness_method | Bisquare |
3 options | Outlier weighting | All |
| zero_weight_fallback | UseLocalMean |
3 options | Zero-weight behavior | All |
| boundary_policy | Extend |
4 options | Edge handling | All |
| scaling_method | MAD |
3 options | Scale estimation | All |
| auto_converge | None | tolerance | Early stopping | All |
| return_residuals | false | bool | Include residuals | All |
| return_robustness_weights | false | bool | Include weights | All |
| return_diagnostics | false | bool | Include metrics | Batch, Streaming |
| confidence_intervals | None | (0, 1) | CI level | Batch |
| prediction_intervals | None | (0, 1) | PI level | Batch |
| cross_validate | None | method | Auto-select fraction | Batch |
| chunk_size | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| merge_strategy | Average |
4 options | Merge overlaps | Streaming |
| window_capacity | 1000 | [3, ∞) | Max window size | Online |
| min_points | 2 | [2, window] | Min before output | Online |
| update_mode | Incremental |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | nothing (auto) |
[0, ∞) | Interpolation threshold | All |
| weight_function | "tricube" |
7 options | Distance kernel | All |
| robustness_method | "bisquare" |
3 options | Outlier weighting | All |
| zero_weight_fallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundary_policy | "extend" |
4 options | Edge handling | All |
| scaling_method | "mad" |
3 options | Scale estimation | All |
| auto_converge | nothing |
tolerance | Early stopping | All |
| return_residuals | false |
bool | Include residuals | All |
| return_robustness_weights | false |
bool | Include weights | All |
| return_diagnostics | false |
bool | Include metrics | Batch, Streaming |
| confidence_intervals | nothing |
(0, 1) | CI level | Batch |
| prediction_intervals | nothing |
(0, 1) | PI level | Batch |
| cv_method | nothing |
method | Auto-select fraction | Batch |
| chunk_size | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| merge_strategy | "average" |
4 options | Merge overlaps | Streaming |
| window_capacity | 1000 | [3, ∞) | Max window size | Online |
| min_points | 2 | [2, window] | Min before output | Online |
| update_mode | "incremental" |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | auto | [0, ∞) | Interpolation threshold | All |
| weightFunction | "tricube" |
7 options | Distance kernel | All |
| robustnessMethod | "bisquare" |
3 options | Outlier weighting | All |
| zeroWeightFallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundaryPolicy | "extend" |
4 options | Edge handling | All |
| scalingMethod | "mad" |
3 options | Scale estimation | All |
| autoConverge | null | tolerance | Early stopping | All |
| returnResiduals | false | bool | Include residuals | All |
| returnRobustnessWeights | false | bool | Include weights | All |
| returnDiagnostics | false | bool | Include metrics | Batch, Streaming |
| confidenceIntervals | null | (0, 1) | CI level | Batch |
| predictionIntervals | null | (0, 1) | PI level | Batch |
| chunkSize | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| mergeStrategy | "average" |
4 options | Merge overlaps | Streaming |
| windowCapacity | 1000 | [3, ∞) | Max window size | Online |
| minPoints | 2 | [2, window] | Min before output | Online |
| updateMode | "incremental" |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | auto | [0, ∞) | Interpolation threshold | All |
| weightFunction | "tricube" |
7 options | Distance kernel | All |
| robustnessMethod | "bisquare" |
3 options | Outlier weighting | All |
| zeroWeightFallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundaryPolicy | "extend" |
4 options | Edge handling | All |
| scalingMethod | "mad" |
3 options | Scale estimation | All |
| autoConverge | null | tolerance | Early stopping | All |
| returnResiduals | false | bool | Include residuals | All |
| returnRobustnessWeights | false | bool | Include weights | All |
| returnDiagnostics | false | bool | Include metrics | Batch, Streaming |
| confidenceIntervals | null | (0, 1) | CI level | Batch |
| predictionIntervals | null | (0, 1) | PI level | Batch |
| chunkSize | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | 500 | [0, chunk) | Overlap between chunks | Streaming |
| mergeStrategy | "average" |
4 options | Merge overlaps | Streaming |
| windowCapacity | 1000 | [3, ∞) | Max window size | Online |
| minPoints | 2 | [2, window] | Min before output | Online |
| updateMode | "incremental" |
2 options | Update strategy | Online |
| Parameter | Default | Range/Options | Description | Adapter |
|---|---|---|---|---|
| fraction | 0.67 | (0, 1] | Smoothing span | All |
| iterations | 3 | [0, 1000] | Robustness iterations | All |
| delta | NAN (auto) | [0, ∞) | Interpolation threshold | All |
| weight_function | "tricube" |
7 options | Distance kernel | All |
| robustness_method | "bisquare" |
3 options | Outlier weighting | All |
| zero_weight_fallback | "use_local_mean" |
3 options | Zero-weight behavior | All |
| boundary_policy | "extend" |
4 options | Edge handling | All |
| scaling_method | "mad" |
3 options | Scale estimation | All |
| auto_converge | NAN | tolerance | Early stopping | All |
| return_residuals | false | bool | Include residuals | All |
| return_robustness_weights | false | bool | Include weights | All |
| return_diagnostics | false | bool | Include metrics | Batch, Streaming |
| confidence_intervals | NAN | (0, 1) | CI level | Batch |
| prediction_intervals | NAN | (0, 1) | PI level | Batch |
| chunk_size | 5000 | [10, ∞) | Points per chunk | Streaming |
| overlap | -1 (auto) | [0, chunk) | Overlap between chunks | Streaming |
| window_capacity | 1000 | [3, ∞) | Max window size | Online |
| min_points | 2 | [2, window] | Min before output | Online |
| update_mode | "full" |
2 options | Update strategy | Online |
Parameter Options Summary¶
| Parameter | Available Options |
|---|---|
| weight_function | "tricube", "epanechnikov", "gaussian", "biweight", "cosine", "triangle", "uniform" |
| robustness_method | "bisquare", "huber", "talwar" |
| zero_weight_fallback | "use_local_mean", "return_original", "return_none" |
| boundary_policy | "extend", "reflect", "zero", "no_boundary" |
| scaling_method | "mad", "mar", "mean" |
| merge_strategy | "average", "left", "right", "weighted" |
| update_mode | "incremental", "full" |
| Parameter | Available Options |
|---|---|
| weight_function | Tricube, Epanechnikov, Gaussian, Biweight, Cosine, Triangle, Uniform |
| robustness_method | Bisquare, Huber, Talwar |
| zero_weight_fallback | UseLocalMean, ReturnOriginal, ReturnNone |
| boundary_policy | Extend, Reflect, Zero, NoBoundary |
| scaling_method | MAD, MAR, Mean |
| merge_strategy | Average, Left, Right, Weighted |
| update_mode | Incremental, Full |
| Parameter | Available Options |
|---|---|
| weightFunction | "tricube", "epanechnikov", "gaussian", "biweight", "cosine", "triangle", "uniform" |
| robustnessMethod | "bisquare", "huber", "talwar" |
| zeroWeightFallback | "use_local_mean", "return_original", "return_none" |
| boundaryPolicy | "extend", "reflect", "zero", "no_boundary" |
| scalingMethod | "mad", "mar", "mean" |
| mergeStrategy | "average", "left", "right", "weighted" |
| updateMode | "incremental", "full" |
Core Parameters¶
fraction¶
The proportion of data used for each local fit. Most important parameter.
| Value | Effect | Use Case |
|---|---|---|
| 0.1–0.3 | Fine detail | Rapidly changing signals |
| 0.3–0.5 | Balanced | General purpose |
| 0.5–0.7 | Heavy smoothing | Noisy data |
| 0.7–1.0 | Very smooth | Trend extraction |
iterations¶
Number of robustness iterations for outlier resistance.
| Value | Effect | Performance |
|---|---|---|
| 0 | No robustness | Fastest |
| 1–3 | Moderate | Recommended |
| 4–6 | Strong | Contaminated data |
| 7+ | Very strong | Heavy outliers |
delta¶
Interpolation optimization threshold. Points within delta distance reuse the previous fit.
- Default: 1% of x-range (Batch), 0.0 (Streaming/Online)
- Effect: Higher values = faster but less accurate
weight_function¶
Distance weighting kernel for local fits.
| Kernel | Efficiency | Smoothness |
|---|---|---|
"tricube" |
0.998 | Very smooth |
"epanechnikov" |
1.000 | Smooth |
"gaussian" |
0.961 | Infinite |
"biweight" |
0.995 | Very smooth |
"cosine" |
0.999 | Smooth |
"triangle" |
0.989 | Moderate |
"uniform" |
0.943 | None |
| Kernel | Efficiency | Smoothness |
|---|---|---|
Tricube |
0.998 | Very smooth |
Epanechnikov |
1.000 | Smooth |
Gaussian |
0.961 | Infinite |
Biweight |
0.995 | Very smooth |
Cosine |
0.999 | Smooth |
Triangle |
0.989 | Moderate |
Uniform |
0.943 | None |
See Weight Functions for detailed comparison.
robustness_method¶
Method for downweighting outliers during iterative refinement.
| Method | Behavior | Use Case |
|---|---|---|
"bisquare" |
Smooth downweighting | General-purpose |
"huber" |
Linear beyond threshold | Moderate outliers |
"talwar" |
Hard threshold (0 or 1) | Extreme contamination |
| Method | Behavior | Use Case |
|---|---|---|
Bisquare |
Smooth downweighting | General-purpose |
Huber |
Linear beyond threshold | Moderate outliers |
Talwar |
Hard threshold (0 or 1) | Extreme contamination |
See Robustness for detailed comparison.
boundary_policy¶
Edge handling strategy to reduce boundary bias.
| Policy | Behavior | Use Case |
|---|---|---|
"extend" |
Pad with first/last values | Most cases (default) |
"reflect" |
Mirror data at boundaries | Periodic/symmetric data |
"zero" |
Pad with zeros | Data approaches zero |
"no_boundary" |
No padding | Original Cleveland behavior |
| Policy | Behavior | Use Case |
|---|---|---|
Extend |
Pad with first/last values | Most cases (default) |
Reflect |
Mirror data at boundaries | Periodic/symmetric data |
Zero |
Pad with zeros | Data approaches zero |
NoBoundary |
No padding | Original Cleveland behavior |
For example:
scaling_method¶
Method for estimating residual scale during robustness iterations.
| Method | Description | Robustness |
|---|---|---|
"mad" |
Median Absolute Deviation | Very robust |
"mar" |
Mean Absolute Residual | Less robust, faster |
"mean" |
Mean Absolute Residual | Less robust, faster |
| Method | Description | Robustness |
|---|---|---|
MAD |
Median Absolute Deviation | Very robust |
MAR |
Mean Absolute Residual | Less robust, faster |
Mean |
Mean Absolute Residual | Less robust, faster |
For example:
zero_weight_fallback¶
Behavior when all neighborhood weights are zero.
| Option | Behavior |
|---|---|
"use_local_mean" |
Use mean of neighborhood (default) |
"return_original" |
Return original y value |
"return_none" |
Return NaN |
| Option | Behavior |
|---|---|
UseLocalMean |
Use mean of neighborhood (default) |
ReturnOriginal |
Return original y value |
ReturnNone |
Return NaN |
For example:
auto_converge¶
Enable early stopping when robustness weights stabilize.
Output Options¶
return_residuals¶
Include residuals (y - smoothed) in the output.
return_diagnostics¶
Include fit quality metrics (Batch and Streaming only).
| Metric | Description |
|---|---|
rmse |
Root Mean Square Error |
mae |
Mean Absolute Error |
r_squared |
R² coefficient |
residual_sd |
Residual standard deviation |
effective_df |
Effective degrees of freedom |
aic |
Akaike Information Criterion |
aicc |
Corrected AIC |
return_robustness_weights¶
Include final robustness weights (useful for outlier detection).
confidence_intervals / prediction_intervals¶
Request uncertainty estimates (Batch only).
See Intervals for detailed usage.
CV Methods¶
cv_method¶
Selection strategy for automated parameter tuning.
| Method | Description | Speed |
|---|---|---|
"kfold" |
K-Fold Cross-Validation | Fast |
"loocv" |
Leave-One-Out Cross-Validation | Slow |
Adapter Parameters¶
chunk_size¶
Points per chunk in Streaming mode.
overlap¶
Overlap between chunks in Streaming mode.
merge_strategy¶
Method for merging overlapping chunks.
| Strategy | Description | Robustness |
|---|---|---|
"average" |
Average of overlapping chunks | Fastest, least robust |
"left" |
Left chunk | Fastest, least robust |
"right" |
Right chunk | Fastest, least robust |
"weighted" |
Weighted average of overlapping chunks | Most robust |
| Strategy | Description | Robustness |
|---|---|---|
Average |
Average of overlapping chunks | Fastest, least robust |
Left |
Left chunk | Fastest, least robust |
Right |
Right chunk | Fastest, least robust |
Weighted |
Weighted average of overlapping chunks | Most robust |
For example:
window_capacity¶
Maximum points held in memory for Online mode.
min_points¶
Minimum points required before Online filter starts producing outputs.
update_mode¶
Optimization strategy for Online mode updates.
| Mode | Description | Speed |
|---|---|---|
full |
Full update | Slow |
partial |
Partial update | Fast |
| Mode | Description | Speed |
|---|---|---|
Full |
Full update | Slow |
Partial |
Partial update | Fast |
For example: