PlotCurve1.m

% -----------------------------------------------------------------
%  PlotCurve1.m
% -----------------------------------------------------------------
%  Programmer: Americo Cunha Jr
%
%  Originally programmed in: Aug 30, 2024
%           Last updated in: Sep 10, 2024
% -----------------------------------------------------------------
% This function plots a single curve time series data.
% 
% Input:
% time     - datetime vector
% data     - time series vector
% graphobj - struct containing graph configuration parameters
%
% Output:
% fig       - the handle to the created figure
% ----------------------------------------------------------------- 
function fig = PlotCurve1(time,data,graphobj)
    
    % Check number of arguments
    if nargin < 3
        error('Too few inputs.')
    elseif nargin > 3
        error('Too many inputs.')
    end

    % Check arguments for length compatibility
    if length(time) ~= length(data)
        error('time and data vectors must be the same length')
    end

    % Ensure time and data are row vectors
    if find(size(time) == max(size(time))) < 2
        time = time';
    end
    
    if find(size(data) == max(size(data))) < 2
        data = data';
    end
    
    % Create the figure
    fig = figure('Name',graphobj.gname,'NumberTitle','off');
    
    % Plot the data
    plot(time,data,'LineWidth',2,'Color',graphobj.linecolor);

    % Set font and box
    set(gcf,'color','white');
    set(gca,'position',[0.2 0.2 0.7 0.7]);
    set(gca,'Box','on');
    set(gca,'TickDir','out','TickLength',[.02 .02]);
    set(gca,'XMinorTick','off','YMinorTick','off');
    set(gca,'XGrid','off','YGrid','off');
    set(gca,'XColor',[.3 .3 .3],'YColor',[.3 .3 .3]);
    set(gca,'FontName','Helvetica');
    set(gca,'FontSize',18);
    box on
    grid on
    
    % Set axis limits
    xlim([min(time) max(time)] + calmonths([0 6]));

    if ( strcmp(graphobj.ymin,'auto') || strcmp(graphobj.ymax,'auto') )
        ylim('auto');
    else
        ylim([graphobj.ymin graphobj.ymax]);
    end
    
    % Set labels
    ylabel(graphobj.ylab, 'FontSize', 20, 'FontName', 'Helvetica');
    
    % Formatting the x-axis to show time in "month-year" format
    datetick('x', 'mmm yyyy', 'keepticks');

    % Rotate the x-axis labels for better readability
    xtickangle(45);

    % Set the title
    title(graphobj.gtitle, 'FontSize', 24, 'FontName', 'Helvetica');

    % Add logo image to the northwest part of the plot
    axes('Position', [0.22 0.75 0.15 0.15]);
    imshow('logo/D-FENSE.png');
    axis off;

    % Add author name outside the plot area, parallel to y-label
    if isfield(graphobj, 'signature') && ~isempty(graphobj.signature)
        annotation('textbox', [0.98, 0.2, 0.5, 0.5], 'String', ...
            graphobj.signature, 'FontSize', 12, ...
            'FontName', 'Helvetica', 'Color', [0.5 0.5 0.5], ...
            'Rotation', 90, 'HorizontalAlignment', 'center', ...
            'VerticalAlignment', 'bottom', 'EdgeColor', 'none');
    end


    % Save the plot as an EPS file if required
    if strcmp(graphobj.print, 'yes')
        print('-depsc2', [graphobj.gname, '.eps']);
        print('-dpng'  , [graphobj.gname, '.png']);
    end

    % Close the figure if requested
    if strcmp(graphobj.close, 'yes')
        close(fig);
    end
end
% -----------------------------------------------------------------