Harmonic Regression

This page documents the structured harmonic baseline used to model periodic TE components directly from angular position and operating-condition context.

Harmonic regression baseline for TE prediction over angular position.

class scripts.models.harmonic_regression.HarmonicRegression(input_size, output_size=1, harmonic_order=12, coefficient_mode='static')

Structured harmonic regressor for periodic TE components.

Parameters:

• input_size (int)

• output_size (int)

• harmonic_order (int)

• coefficient_mode (str)

__init__(input_size, output_size=1, harmonic_order=12, coefficient_mode='static')

Initialize the harmonic regression baseline.

Parameters:

• input_size (int) – Total input feature count including angular position and operating-condition features.

• output_size (int) – Regression target count. The current implementation supports scalar TE output only.

• harmonic_order (int) – Highest harmonic order used in the Fourier-style expansion of the angular position.

• coefficient_mode (str) – Coefficient parameterization mode. Supported values are static and linear_conditioned.

Return type:

None

build_harmonic_feature_tensor(angular_position_deg)

Build the harmonic basis evaluated at the given angular positions.

Parameters:

angular_position_deg (Tensor) – Angular position tensor in degrees with shape (batch_size, 1).

Returns:

Harmonic design matrix containing the bias term plus sine and cosine features for each configured harmonic order.

Return type:

torch.Tensor

resolve_coefficient_tensor(normalized_condition_tensor)

Resolve the harmonic coefficient tensor for each batch item.

Parameters:

normalized_condition_tensor (Tensor) – Normalized operating-condition feature tensor excluding the raw angle column.

Returns:

Batch-aligned coefficient tensor used to weight the harmonic basis.

Return type:

torch.Tensor

forward_with_input_context(input_tensor, normalized_input_tensor)

Predict TE using raw angle context plus normalized conditions.

Parameters:

• input_tensor (Tensor) – Raw input tensor whose first column is the physical angular position in degrees.

• normalized_input_tensor (Tensor) – Normalized input tensor used for the conditioning features.

Returns:

Scalar TE prediction tensor with shape (batch_size, 1).

Return type:

torch.Tensor