Many changes in DBHandler

new general processing structure
just before splitting off the projects folder from this repo

Functions/EQ_structures/dsp_runid.m

@@ -0,0 +1,137 @@
+function [output] = dsp_runid(run_id, options)
+
+arguments
+    run_id
+    options.append_to_db    = 0;
+    options.max_occurences  = 4;
+    options.parameters      = struct();
+    options.database_path
+    options.database_name
+    options.storage_path
+end
+
+% Initialize output structures
+output.ffe_package = {};
+output.mlse_package = {};
+output.vnle_package = {};
+output.dbtgt_package = {};
+output.dbenc_package = {};
+
+% Initialize database connection
+database    = DBHandler("pathToDB", [options.database_path, options.database_name], "type", "sqlite");
+dataTable   = queryRunid(run_id, database);
+fsym        = dataTable.symbolrate;
+M           = double(dataTable.pam_level);
+duob_mode   = db_mode(dataTable.db_mode);
+
+if database.checkIfRunExists('Results','run_id',run_id)
+    disp(['Already got at least one reulst for run id: ',num2str(run_id),' '])
+    return
+end
+
+
+% Handle Settings and argument replacement
+
+len_tr      = 4096*2;
+
+ffe_order  = [50, 5, 5];
+dfe_order   = [0, 0, 0];
+pf_ncoeffs  = 1;
+mu_ffe      = [0.0001, 0.0008, 0.001];
+mu_dfe      = 0.0004;
+mu_dc       = 0.00;
+
+use_ffe         = 1;
+use_vnle_mlse   = 1;
+use_dbtgt       = 1;
+use_dbenc   = 0;
+
+addProcessingResultToDatabase = 0;
+
+% Overwrite default parameters if given in options.parameters
+paramStruct = options.parameters;
+if ~isempty(paramStruct)
+    paramNames = fieldnames(paramStruct);
+    for i = 1:numel(paramNames)
+        thisName = paramNames{i};
+        thisValue = paramStruct.(thisName);
+        eval([thisName ' = thisValue;']);
+    end
+end
+
+% Configure equalizers
+eq_lin    = EQ("Ne",[50,0,0],"Nb",dfe_order,"training_length",len_tr,"training_loops",5,"dd_loops",5,"K",2,"DCmu",mu_dc,"DDmu",[mu_ffe mu_dfe],"DFEmu",0.005,"FFEmu",0,"plotfinal",0,"ideal_dfe",1);
+
+eq_    = EQ("Ne",ffe_order,"Nb",dfe_order,"training_length",len_tr,"training_loops",5,"dd_loops",5,"K",2,"DCmu",mu_dc,"DDmu",[mu_ffe mu_dfe],"DFEmu",0.005,"FFEmu",0,"plotfinal",0,"ideal_dfe",1);
+pf_    = Postfilter("ncoeff",pf_ncoeffs,"useBurg",1);
+mlse_  = MLSE_viterbi("duobinary_output",0,'M',M,'trellis_states',PAMmapper(M,0).levels);
+mlse_db_ = MLSE_viterbi("DIR",[1,1],"duobinary_output",0,"M",M,"trellis_states",PAMmapper(M,0).levels);
+eq_post = FFE("epochs_tr",5,"epochs_dd",5,"len_tr",4096*2,"mu_dd",1e-4,"mu_tr",0,"order",2001,"sps",1,"decide",0);
+% Duobinary signaling (db encoded)
+mlse_db_enc = MLSE_viterbi("DIR", [1,1], "duobinary_output", 0, "M", M, "trellis_states", PAMmapper(M,0).levels);
+eq_db_enc = EQ("Ne", ffe_order, "Nb", dfe_order, "training_length", len_tr, ...
+    "training_loops", 5, "dd_loops", 5, "K", 2, "DCmu", mu_dc, ...
+    "DDmu", [mu_ffe mu_dfe], "DFEmu", 0.005, "FFEmu", 0, "plotfinal", 0, "ideal_dfe", 1);
+
+
+% Load signal data
+[Tx_bits, Symbols, Scpe_cell, ~] = loadSignalData(dataTable, options);
+
+
+for r = 1:numel(Scpe_cell)
+    
+    % Preprocess signal
+    Scpe_sig = preprocessSignal(Scpe_cell{r}, Symbols, fsym);
+    
+    if duob_mode ~= db_mode.db_encoded
+        if use_ffe
+            ffe_results = ffe(eq_lin,M,Scpe_sig,Symbols,Tx_bits,...
+                "precode_mode",duob_mode,...
+                'showAnalysis',1,...
+                "postFFE",[],...
+                "eth_style_symbol_mapping",0);
+                output.ffe_package{r} = ffe_results;
+            if options.append_to_db
+                database.addProcessingResult(run_id, ffe_results.metrics, ffe_results.config);
+            end
+        end
+        
+        if use_vnle_mlse
+            [ffe_results, mlse_results] = vnle_postfilter_mlse(eq_, pf_, mlse_, M, Scpe_sig, Symbols, Tx_bits, ...
+                "precode_mode", duob_mode,...
+                'showAnalysis', 1, ...
+                "postFFE", [],...
+                "eth_style_symbol_mapping", 0);
+                output.mlse_package{r} = mlse_results;
+                output.vnle_package{r} = ffe_results;
+            if options.append_to_db
+                database.addProcessingResult(run_id, mlse_results.metrics, mlse_results.config);
+                database.addProcessingResult(run_id, ffe_results.metrics, ffe_results.config);
+            end
+        end
+        
+        if use_dbtgt
+            dbt_results = duobinary_target(eq_, mlse_db_, M, Scpe_sig, Symbols, Tx_bits, ...
+                "precode_mode", duob_mode, ...
+                'showAnalysis', 0,...
+                "postFFE", []);
+                output.dbtgt_package{r} = dbt_results;
+            if options.append_to_db
+                database.addProcessingResult(run_id, dbt_results.metrics, dbt_results.config);
+            end
+        end
+    end
+        
+    if duob_mode == db_mode.db_encoded
+        db_results = duobinary_signaling(eq_db_enc, mlse_db_enc, M, Scpe_sig, Symbols, Tx_bits, "precode_mode",duob_mode, "showAnalysis",0,"postFFE",[]);
+        output.dbenc_package{r} = db_results;
+        if options.append_to_db
+            database.addProcessingResult(run_id, db_results.metrics, db_results.config);
+        end
+    end
+
+
+end
+
+
+end