panel_r_calculator.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2011 jean-pierre.charras
 * Copyright (C) 1992-2023 Kicad Developers, see AUTHORS.txt for contributors.
 *
 * 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, see <http://www.gnu.org/licenses/>.
 */
 
/* see
 * http://www.desmith.net/NMdS/Electronics/TraceWidth.html
 * http://www.ultracad.com/articles/pcbtemp.pdf
 * for more info
 */
 
#include <calculator_panels/panel_r_calculator.h>
#include <pcb_calculator_settings.h>
#include <string_utils.h>
#include <wx/msgdlg.h>
#include <eseries.h>
#include "resistor_substitution_utils.h"
 
#include <i18n_utility.h> // For _HKI definition in r_calculator_help.h
wxString r_calculator_help =
#include "r_calculator_help.h"
 
/* RES_EQUIV_CALC class considers resistor values from a limited range
 * and only combinations of up to 4 resistors, so target values less than 
 * parallel combination of minimum resistors or greater than serial combination
 * of maximum resistors cannot be reasonably looked for
 */
static const double min_target_value = static_cast<double>(RES_EQUIV_CALC_FIRST_VALUE) / 4;
static const double max_target_value = static_cast<double>(RES_EQUIV_CALC_LAST_VALUE) * 4;
 
extern double DoubleFromString( const wxString& TextValue );
 
PANEL_R_CALCULATOR::PANEL_R_CALCULATOR( wxWindow* parent, wxWindowID id, const wxPoint& pos,
                                        const wxSize& size, long style, const wxString& name ) :
        PANEL_R_CALCULATOR_BASE( parent, id, pos, size, style, name )
{
    m_reqResUnits->SetLabel( wxT( "kΩ" ) );
    m_exclude1Units->SetLabel( wxT( "kΩ" ) );
    m_exclude2Units->SetLabel( wxT( "kΩ" ) );
 
    wxSize minSize = m_ResRequired->GetMinSize();
    int    minWidth = m_ResRequired->GetTextExtent( wxT( "XXX.XXX" ) ).GetWidth();
 
    m_ResRequired->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
    m_ResExclude1->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
    m_ResExclude2->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
 
    minSize = m_ESeriesError2R->GetMinSize();
    minWidth = m_ESeriesError2R->GetTextExtent( wxT( "XX" ) + _( "Exact" ) ).GetWidth();
 
    m_ESeriesError2R->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
    m_ESeriesError3R->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
    m_ESeriesError4R->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
 
    // show markdown formula explanation in lower help panel
    wxString msg;
    ConvertMarkdown2Html( wxGetTranslation( r_calculator_help ), msg );
    m_panelESeriesHelp->SetPage( msg );
 
    // Needed on wxWidgets 3.0 to ensure sizers are correctly set
    GetSizer()->SetSizeHints( this );
}
 
 
PANEL_R_CALCULATOR::~PANEL_R_CALCULATOR()
{
}
 
 
void PANEL_R_CALCULATOR::ThemeChanged()
{
    // Update the HTML window with the help text
    m_panelESeriesHelp->ThemeChanged();
}
 
 
void PANEL_R_CALCULATOR::SaveSettings( PCB_CALCULATOR_SETTINGS* aCfg )
{
}
 
 
void PANEL_R_CALCULATOR::LoadSettings( PCB_CALCULATOR_SETTINGS* aCfg )
{
}
 
 
void PANEL_R_CALCULATOR::OnCalculateESeries( wxCommandEvent& event )
{
    double reqr = 1000 * DoubleFromString( m_ResRequired->GetValue() );
 
    if( std::isnan( reqr ) || reqr < min_target_value || reqr > max_target_value )
    {
        wxMessageBox( wxString::Format( _( "Incorrect required resistance value: %s" ),
                                        m_ResRequired->GetValue() ) );
        return;
    }
    
    wxBusyCursor busyCursor; // As long as this variable exists, the cursor will be 'busy'
 
    m_eSeries.NewCalc( reqr ); // assume all values available
    /*
     * Exclude itself. For the case, a value from the available series is found as required value,
     * the calculator assumes this value needs a replacement for the reason of being not available.
     * Two further exclude values can be entered to exclude and are skipped as not being available.
     * All values entered in KiloOhms are converted to Ohm for internal calculation
     */
    m_eSeries.Exclude( reqr );
    m_eSeries.Exclude( 1000 * DoubleFromString( m_ResExclude1->GetValue() ) );
    m_eSeries.Exclude( 1000 * DoubleFromString( m_ResExclude2->GetValue() ) );
 
    try
    {
        m_eSeries.Calculate();
    }
    catch( const std::exception& exc )
    {
        wxMessageBox( wxString::Format( "Internal error: %s", exc.what() ) );
        return;
    }
 
    auto showResult = [reqr]( const std::optional<RESISTANCE>& aResult, wxTextCtrl* aFormulaField,
                              wxTextCtrl* aErrorField )
    {
        wxString fs, es; // formula and error string
 
        if( aResult ) // if value is present
        {
            fs = aResult->name;
            double sol = aResult->value;
            double error = ( sol / reqr - 1 ) * 100; // relative error in percent
 
            if( std::abs( error ) < epsilon )
                es = _( "Exact" );
            else if( std::abs( error ) < 0.01 )
                es.Printf( "<%.2f", 0.01 );
            else
                es.Printf( "%+.2f", error );
        }
        else
        {
            fs = _( "Not worth using" );
            es = wxEmptyString;
        }
 
        aFormulaField->SetValue( fs );
        aErrorField->SetValue( es );
    };
 
    showResult( m_eSeries.GetResults()[RES_EQUIV_CALC::S2R], m_ESeries_Sol2R, m_ESeriesError2R );
    showResult( m_eSeries.GetResults()[RES_EQUIV_CALC::S3R], m_ESeries_Sol3R, m_ESeriesError3R );
    showResult( m_eSeries.GetResults()[RES_EQUIV_CALC::S4R], m_ESeries_Sol4R, m_ESeriesError4R );
}
 
 
void PANEL_R_CALCULATOR::OnESeriesSelection( wxCommandEvent& event )
{
    if( event.GetEventObject() == m_e1 )
        m_eSeries.SetSeries( ESERIES::E1 );
    else if( event.GetEventObject() == m_e3 )
        m_eSeries.SetSeries( ESERIES::E3 );
    else if( event.GetEventObject() == m_e12 )
        m_eSeries.SetSeries( ESERIES::E12 );
    else if( event.GetEventObject() == m_e24 )
        m_eSeries.SetSeries( ESERIES::E24 );
    else
        m_eSeries.SetSeries( ESERIES::E6 );
}