before new database

This commit is contained in:
Silas Oettinghaus
2026-07-13 19:59:57 +02:00
parent ef0a74cb7f
commit f421348e5b
15 changed files with 2682 additions and 487 deletions

View File

@@ -22,6 +22,7 @@ classdef FFE_test < IMDDTestCase
testCase.verifyEqual(ffe.dc_level_avg_bufferlength_a2, 0);
testCase.verifyEqual(ffe.dc_level_update_blocklength_a2, 0);
testCase.verifyEqual(ffe.dc_smoothing_a2, 0);
testCase.verifyEqual(ffe.dc_level_decision_mode_a2, "residual");
testCase.verifyEqual(ffe.dc_level_weights_a2, 0);
testCase.verifyEqual(ffe.dc_tracking_buffer_len, 1);
testCase.verifyEqual(ffe.ffe_update_buffer_len, 1);
@@ -174,6 +175,64 @@ classdef FFE_test < IMDDTestCase
testCase.verifyEqual(ffe.e_dc, 0.36, "AbsTol", 1e-12);
end
function ffeDcTrackingClassMatchesFullUnbufferedPath(testCase)
x = zeros(4, 1);
d = ones(4, 1);
settings = { ...
"sps", 1, ...
"order", 1, ...
"dc_tracking_mu", 0.1, ...
"dc_tracking_buffer_len", 1, ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms};
full = FFE(settings{:});
tracking = FFE_DCTracking(settings{:});
full.constellation = unique(d);
tracking.constellation = unique(d);
[y_full,d_hat_full] = full.equalize(x, d, 0, 1, numel(x), true, false);
[y_tracking,d_hat_tracking] = tracking.equalize(x, d, 0, 1, numel(x), true, false);
testCase.verifyEqual(y_tracking, y_full, "AbsTol", 1e-12);
testCase.verifyEqual(d_hat_tracking, d_hat_full, "AbsTol", 1e-12);
testCase.verifyEqual(tracking.e_dc, full.e_dc, "AbsTol", 1e-12);
testCase.verifyEqual(tracking.debug_struct.dc_tracking_est, ...
full.debug_struct.dc_tracking_est, "AbsTol", 1e-12);
end
function ffeDcTrackingClassMatchesFullBufferedPersistencePath(testCase)
x = zeros(4, 1);
d = ones(4, 1);
settings = { ...
"sps", 1, ...
"order", 1, ...
"dc_tracking_mu", 0.1, ...
"dc_tracking_adaptive_enabled", true, ...
"dc_tracking_persistence_gain", 1, ...
"dc_tracking_buffer_len", 2, ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms};
full = FFE(settings{:});
tracking = FFE_DCTracking(settings{:});
full.constellation = unique(d);
tracking.constellation = unique(d);
[y_full,d_hat_full] = full.equalize(x, d, 0, 1, numel(x), true, false);
[y_tracking,d_hat_tracking] = tracking.equalize(x, d, 0, 1, numel(x), true, false);
testCase.verifyEqual(y_tracking, y_full, "AbsTol", 1e-12);
testCase.verifyEqual(d_hat_tracking, d_hat_full, "AbsTol", 1e-12);
testCase.verifyEqual(tracking.e_dc, full.e_dc, "AbsTol", 1e-12);
testCase.verifyEqual(tracking.debug_struct.dc_tracking_mu_eff, ...
full.debug_struct.dc_tracking_mu_eff, "AbsTol", 1e-12);
testCase.verifyEqual(tracking.debug_struct.dc_tracking_est, ...
full.debug_struct.dc_tracking_est, "AbsTol", 1e-12);
end
function ffeBufferDelaysTapUpdateUntilBlockBoundary(testCase)
x = ones(4, 1);
d = ones(4, 1);
@@ -349,6 +408,118 @@ classdef FFE_test < IMDDTestCase
testCase.verifyEqual(y, [1; 3; 1; 3.5], "AbsTol", 1e-12);
end
function dcLevelAvgA2TrackedLevelsUseAdaptiveDecision(testCase)
x = [0.5; 2.5; 0.5; 2.5; 1.3];
d = [0; 2; 0; 2; 0];
ffe = FFE( ...
"sps", 1, ...
"order", 1, ...
"dc_level_avg_bufferlength_a2", 2, ...
"dc_level_update_blocklength_a2", 1, ...
"dc_level_decision_mode_a2", "tracked_levels", ...
"dc_level_weights_a2", 1, ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms);
ffe.e = 1;
ffe.constellation = [0; 2];
[y,d_hat] = ffe.equalize(x, d, 0, 1, numel(x), false, false);
testCase.verifyEqual(y, x, "AbsTol", 1e-12);
testCase.verifyEqual(d_hat, d, "AbsTol", 1e-12);
testCase.verifyEqual( ...
ffe.debug_struct.dc_level_decision_level, ...
[0, 2, 0.25, 2.25, 0.5], ...
"AbsTol", 1e-12);
end
function ffeA2ResidualClassSubtractsScalarWeightedResidual(testCase)
x = (1:4).';
d = zeros(4, 1);
ffe = FFE_A2Residual( ...
"sps", 1, ...
"order", 1, ...
"dc_level_avg_bufferlength_a2", 2, ...
"dc_level_weights_a2", 1, ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms);
ffe.e = 1;
ffe.constellation = 0;
[y,~] = ffe.equalize(x, d, 0, 1, numel(x), true, false);
testCase.verifyEqual(y, [1; 2; 1.5; 2.5], "AbsTol", 1e-12);
testCase.verifyEqual(ffe.debug_struct.dc_level_mpi_est, [0, 0, 1.5, 1.5], "AbsTol", 1e-12);
testCase.verifyEqual(ffe.debug_struct.dc_level_weight, [0, 0, 1, 1], "AbsTol", 1e-12);
testCase.verifyEqual(ffe.debug_struct.dc_level_valid_count, [0, 0, 2, 2]);
end
function ffeA2ResidualClassMatchesFullResidualPath(testCase)
x = [1; 3; 1; 4; 2; 5];
d = [0; 2; 0; 2; 0; 2];
settings = { ...
"sps", 1, ...
"order", 1, ...
"dc_level_avg_bufferlength_a2", 2, ...
"dc_level_update_blocklength_a2", 1, ...
"dc_level_weights_a2", [0.25, 0.75], ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms};
full = FFE(settings{:});
residual = FFE_A2Residual(settings{:});
full.e = 1;
residual.e = 1;
full.constellation = [0; 2];
residual.constellation = [0; 2];
[y_full,d_hat_full] = full.equalize(x, d, 0, 1, numel(x), true, false);
[y_residual,d_hat_residual] = residual.equalize(x, d, 0, 1, numel(x), true, false);
testCase.verifyEqual(y_residual, y_full, "AbsTol", 1e-12);
testCase.verifyEqual(d_hat_residual, d_hat_full, "AbsTol", 1e-12);
testCase.verifyEqual(residual.debug_struct.dc_level_mpi_est, ...
full.debug_struct.dc_level_mpi_est, "AbsTol", 1e-12);
testCase.verifyEqual(residual.debug_struct.dc_level_weight, ...
full.debug_struct.dc_level_weight, "AbsTol", 1e-12);
end
function dcLevelAvgA2RejectsUnknownDecisionMode(testCase)
testCase.verifyError(@() FFE("dc_level_decision_mode_a2", "unknown"), ...
"FFE:InvalidA2DecisionMode");
end
function ffeA2TrackedLevelsClassUsesAdaptiveDecision(testCase)
x = [0.5; 2.5; 0.5; 2.5; 1.3];
d = [0; 2; 0; 2; 0];
ffe = FFE_A2TrackedLevels( ...
"sps", 1, ...
"order", 1, ...
"dc_level_avg_bufferlength_a2", 2, ...
"dc_level_update_blocklength_a2", 1, ...
"dc_level_weights_a2", 1, ...
"save_debug", true, ...
"dd_mode", 0, ...
"adaption_technique", adaption_method.lms);
ffe.e = 1;
ffe.constellation = [0; 2];
[y,d_hat] = ffe.equalize(x, d, 0, 1, numel(x), false, false);
testCase.verifyEqual(y, x, "AbsTol", 1e-12);
testCase.verifyEqual(d_hat, d, "AbsTol", 1e-12);
testCase.verifyEqual( ...
ffe.debug_struct.dc_level_decision_level, ...
[0, 2, 0.25, 2.25, 0.5], ...
"AbsTol", 1e-12);
end
function dcLevelAvgA2WarnsWhenCombinedWithDcTracking(testCase)
testCase.verifyWarning(@() FFE( ...
"dc_level_avg_bufferlength_a2", 2, ...