sim_plot_tab.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2016-2023 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * @author Tomasz Wlostowski <[email protected]>
 * @author Maciej Suminski <[email protected]>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, you may find one here:
 * https://www.gnu.org/licenses/gpl-3.0.html
 * or you may search the http://www.gnu.org website for the version 3 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */
 
#ifndef __SIM_PLOT_PANEL_H
#define __SIM_PLOT_PANEL_H
 
#include "sim_types.h"
#include <map>
#include <limits>
#include <widgets/mathplot.h>
#include <wx/colour.h>
#include <wx/sizer.h>
#include "sim_tab.h"
#include "sim_plot_colors.h"
 
class SIMULATOR_FRAME;
class SIM_PLOT_TAB;
class TRACE;

 

class CURSOR : public mpInfoLayer
{
public:
    CURSOR( TRACE* aTrace, SIM_PLOT_TAB* aPlotTab ) :
            mpInfoLayer( wxRect( 0, 0, DRAG_MARGIN, DRAG_MARGIN ), wxTRANSPARENT_BRUSH ),
            m_trace( aTrace ),
            m_updateRequired( true ),
            m_updateRef( false ),
            m_coords( 0.0, 0.0 ),
            m_window( nullptr ),
            m_sweepIndex( 0 ),
            m_snapToNearest( false ),
            m_snapTargetY( 0.0 )
    {
    }
 
    void Plot( wxDC& aDC, mpWindow& aWindow ) override;
 
    void SetX( int aX )
    {
        m_reference.x = 0;
        m_updateRef = true;
        Move( wxPoint( aX, 0 ) );
    }
 
    void Update()
    {
        m_updateRequired = true;
    }
 
    bool Inside( const wxPoint& aPoint ) const override;
 
    void Move( wxPoint aDelta ) override;
 
    void UpdateReference() override;
 
    bool OnDoubleClick( const wxPoint& aPoint, mpWindow& aWindow ) override;
 
    const wxRealPoint& GetCoords() const
    {
        return m_coords;
    }
 
    void SetCoordX( double aValue );
 
private:
    void doSetCoordX( double aValue );
 
    wxString getID();
 
private:
    TRACE*       m_trace;
    bool         m_updateRequired;
    bool         m_updateRef;
    wxRealPoint  m_coords;
    mpWindow*    m_window;
    int          m_sweepIndex;
    bool         m_snapToNearest;
    double       m_snapTargetY;
 
    static constexpr int DRAG_MARGIN = 10;
};
 
 
class TRACE : public mpFXYVector
{
public:
    TRACE( const wxString& aName, SIM_TRACE_TYPE aType ) :
           mpFXYVector( aName ),
           m_type( aType ),
           m_isMultiRun( false )
    {
        SetContinuity( true );
        ShowName( false );
        SetName( aName );
    }
 
    void SetName( const wxString& aName ) override
    {
        for( auto& [ idx, cursor ] : m_cursors )
        {
            if( cursor )
                cursor->SetName( aName );
        }
 
        mpFXYVector::SetName( aName );
 
        if( m_type & SPT_AC_GAIN )
            m_displayName = aName + _( " (gain)" );
        else if( m_type & SPT_AC_PHASE )
            m_displayName = aName + _( " (phase)" );
        else
            m_displayName = aName;
    }

    void SetData( const std::vector<double>& aX, const std::vector<double>& aY ) override
    {
        for( auto& [ idx, cursor ] : m_cursors )
        {
            if( cursor )
                cursor->Update();
        }
 
        mpFXYVector::SetData( aX, aY );
    }
 
    const std::vector<double>& GetDataX() const { return m_xs; }
    const std::vector<double>& GetDataY() const { return m_ys; }
 
    bool HasCursor( int aCursorId ) { return m_cursors[ aCursorId ] != nullptr; }
 
    void SetCursor( int aCursorId, CURSOR* aCursor ) { m_cursors[ aCursorId ] = aCursor; }
    CURSOR* GetCursor( int aCursorId ) { return m_cursors[ aCursorId ]; }
    std::map<int, CURSOR*>& GetCursors() { return m_cursors; }
 
    SIM_TRACE_TYPE GetType() const { return m_type; }
 
    void SetTraceColour( const wxColour& aColour ) { m_traceColour = aColour; }
    wxColour GetTraceColour() const { return m_traceColour; }
 
    void SetIsMultiRun( bool aIsMultiRun ) { m_isMultiRun = aIsMultiRun; }
    bool IsMultiRun() const { return m_isMultiRun; }
 
    void SetMultiRunLabels( const std::vector<wxString>& aLabels ) { m_multiRunLabels = aLabels; }
    const std::vector<wxString>& GetMultiRunLabels() const { return m_multiRunLabels; }
 
protected:
    std::map<int, CURSOR*> m_cursors;       // No ownership; the mpWindow owns the CURSORs
    SIM_TRACE_TYPE         m_type;
    wxColour               m_traceColour;
    bool                   m_isMultiRun;
    std::vector<wxString>  m_multiRunLabels;
};
 
 
class SIM_PLOT_TAB : public SIM_TAB
{
public:
    SIM_PLOT_TAB( const wxString& aSimCommand, wxWindow* parent );
 
    virtual ~SIM_PLOT_TAB();
 
    void ApplyPreferences( const SIM_PREFERENCES& aPrefs ) override
    {
        m_plotWin->SetMouseWheelActions( convertMouseWheelActions( aPrefs.mouse_wheel_actions ) );
    }
 
    wxString GetLabelX() const
    {
        return m_axis_x ? m_axis_x->GetName() : wxString( wxS( "" ) );
    }
 
    wxString GetLabelY1() const
    {
        return m_axis_y1 ? m_axis_y1->GetName() : wxString( wxS( "" ) );
    }
 
    wxString GetLabelY2() const
    {
        return m_axis_y2 ? m_axis_y2->GetName() : wxString( wxS( "" ) );
    }
 
    wxString GetLabelY3() const
    {
        return m_axis_y3 ? m_axis_y3->GetName() : wxString( wxS( "" ) );
    }
 
    bool GetY1Scale( double* aMin, double* aMax ) const
    {
        if( m_axis_y1 )
            return m_axis_y1->GetAxisMinMax( aMin, aMax );
 
        return false;
    }
 
    bool GetY2Scale( double* aMin, double* aMax ) const
    {
        if( m_axis_y2 )
            return m_axis_y2->GetAxisMinMax( aMin, aMax );
 
        return false;
    }
 
    bool GetY3Scale( double* aMin, double* aMax ) const
    {
        if( m_axis_y3 )
            return m_axis_y3->GetAxisMinMax( aMin, aMax );
 
        return false;
    }
 
    void SetY1Scale( bool aLock, double aMin, double aMax );
    void SetY2Scale( bool aLock, double aMin, double aMax );
    void SetY3Scale( bool aLock, double aMin, double aMax );
 
    wxString GetUnitsX() const;
    wxString GetUnitsY1() const;
    wxString GetUnitsY2() const;
    wxString GetUnitsY3() const;
 
    const std::map<wxString, TRACE*>& GetTraces() const
    {
        return m_traces;
    }
 
    TRACE* GetTrace( const wxString& aVecName, int aType ) const
    {
        auto trace = m_traces.find( getTraceId( aVecName, aType ) );
 
        return trace == m_traces.end() ? nullptr : trace->second;
    }
 
    void ShowGrid( bool aEnable )
    {
        if( m_axis_x )
            m_axis_x->SetTicks( !aEnable );
 
        if( m_axis_y1 )
            m_axis_y1->SetTicks( !aEnable );
 
        if( m_axis_y2 )
            m_axis_y2->SetTicks( !aEnable );
 
        if( m_axis_y3 )
            m_axis_y3->SetTicks( !aEnable );
 
        m_plotWin->UpdateAll();
    }
 
    bool IsGridShown() const
    {
        if( !m_axis_x || !m_axis_y1 )
            return false;
 
        return !m_axis_x->GetTicks();
    }
 
    void ShowLegend( bool aEnable )
    {
        m_legend->SetVisible( aEnable );
        m_plotWin->UpdateAll();
    }
 
    bool IsLegendShown() const
    {
        return m_legend->IsVisible();
    }
 
    wxPoint GetLegendPosition() const
    {
        return m_legend->GetPosition();
    }
 
    void SetLegendPosition( const wxPoint& aPosition )
    {
        m_legend->Move( aPosition );
        m_legend->UpdateReference();
        m_LastLegendPosition = aPosition;
    }

    void SetDottedSecondary( bool aEnable )
    {
        m_dotted_cp = aEnable;
 
        for( const auto& [ name, trace ] : m_traces )
            UpdateTraceStyle( trace );
 
        m_plotWin->UpdateAll();
    }
 
    bool GetDottedSecondary() const
    {
        return m_dotted_cp;
    }

    void EnableCursor( TRACE* aTrace, int aCursorId, const wxString& aSignalName );
    void DisableCursor( TRACE* aTrace, int aCursorId );

    void ResetScales( bool aIncludeX );

    void UpdateTraceStyle( TRACE* trace );

    void UpdatePlotColors();
 
    void OnLanguageChanged() override;

    mpWindow* GetPlotWin() const { return m_plotWin; }
 
    TRACE* GetOrAddTrace( const wxString& aVectorName, int aType );
 
    void SetTraceData( TRACE* aTrace, std::vector<double>& aX, std::vector<double>& aY,
                       int aSweepCount, size_t aSweepSize, bool aIsMultiRun = false,
                       const std::vector<wxString>& aMultiRunLabels = {} );
 
    bool DeleteTrace( const wxString& aVectorName, int aTraceType );
    void DeleteTrace( TRACE* aTrace );
 
    std::vector<std::pair<wxString, wxString>>& Measurements() { return m_measurements; }
 
    void EnsureThirdYAxisExists();
 
public:
    wxPoint m_LastLegendPosition;
 
private:
    static mpWindow::MouseWheelActionSet
    convertMouseWheelActions( const SIM_MOUSE_WHEEL_ACTION_SET& s )
    {
        static_assert( static_cast<unsigned>( mpWindow::MouseWheelAction::COUNT )
                               == static_cast<unsigned>( SIM_MOUSE_WHEEL_ACTION::COUNT ),
                       "mpWindow::MouseWheelAction enum must match SIM_MOUSE_WHEEL_ACTION" );
 
        using A = mpWindow::MouseWheelAction;
        mpWindow::MouseWheelActionSet m;
        m.verticalUnmodified = static_cast<A>( s.vertical_unmodified );
        m.verticalWithCtrl   = static_cast<A>( s.vertical_with_ctrl );
        m.verticalWithShift  = static_cast<A>( s.vertical_with_shift );
        m.verticalWithAlt    = static_cast<A>( s.vertical_with_alt );
        m.horizontal         = static_cast<A>( s.horizontal );
 
        return m;
    }
 
    wxString getTraceId( const wxString& aVectorName, int aType ) const
    {
        return wxString::Format( wxS( "%s%d" ), aVectorName, aType & SPT_Y_AXIS_MASK );
    }

    void prepareDCAxes( int aNewTraceType );

    void updateAxes( int aNewTraceType = SIM_TRACE_TYPE::SPT_UNKNOWN );
 
    void UpdateAxisVisibility();
 
private:
    SIM_PLOT_COLORS              m_colors;
    std::map<wxString, wxColour> m_sessionTraceColors;
 
    // Top-level plot window
    mpWindow*                    m_plotWin;
    wxBoxSizer*                  m_sizer;
 
    // Traces to be plotted
    std::map<wxString, TRACE*>   m_traces;
 
    mpScaleXBase*                m_axis_x;
    mpScaleY*                    m_axis_y1;
    mpScaleY*                    m_axis_y2;
    mpScaleY*                    m_axis_y3;
    mpInfoLegend*                m_legend;
 
    bool                         m_dotted_cp;
 
    // Measurements (and their format strings)
    std::vector<std::pair<wxString, wxString>> m_measurements;
};
 
wxDECLARE_EVENT( EVT_SIM_CURSOR_UPDATE, wxCommandEvent );
 
#endif