% Superclass for DAQ-compatible analysis routines
% Must accept Axes as an optional argument

classdef MyAnalysisRoutine < handle
    
    properties (Abstract, Access = public)
        
        % Raw data to be analyzed
        Data    MyTrace
    end
    
    properties (Abstract, GetAccess = public, SetAccess = protected)
        Axes
    end
    
    events
        NewProcessedData
    end
    
    methods (Access = public)
                
        % Triggered for transferring of the fit trace to DAQ
        function triggerNewProcessedData(this, varargin)
            EventData = MyNewDataEvent(varargin{:});
            notify(this, 'NewProcessedData', EventData);
        end
    end
    
    methods (Static, Access = public)
        
        % Method for validation of the compliance with this class, it is
        % useful when subclassig cannot be implemented, as in the case of
        % MATLAB apps (as of MATLAB 2019a).
        % Obj is either an object instance or the name of its class.
        function validate(Obj)
            if ischar(Obj)
                class_name = Obj;
            else
                class_name = class(Obj);
            end
            
            assert(ismember('Data', properties(class_name)), ...
                'Analysis routine must define ''Data'' property')
            assert(ismember('NewProcessedData', events(class_name)), ...
                'Analysis routine must define ''NewAnalysisTrace'' event')
            assert(nargin(class_name) == -1, ...
                'Analysis routine accept varargin input')
        end
    end
end