transline_calculation_base.h

Go to the documentation of this file.

/*
 * Copyright The 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 2
 * 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 package; see the file COPYING.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
 * Boston, MA 02110-1301, USA.
 */
 
#ifndef TRANSLINE_CALCULATIONS_TRANSLINE_CALCULATION_BASE_H
#define TRANSLINE_CALCULATIONS_TRANSLINE_CALCULATION_BASE_H
 
 
#include <cmath>
#include <unordered_map>
 

enum class TRANSLINE_PARAMETERS : int
{
    // The following parameters are accessible from the UI
    UNKNOWN_ID = -1,
    EPSILONR,                 // Dielectric constant
    TAND,                     // Dielectric Loss Tangent
    RHO,                      // Conductivity of conductor
    H,                        // Height of substrate
    H_T,                      // Height of top surface
    T,                        // Height of top conductor
    PHYS_WIDTH,               // Width of trace
    PHYS_DIAM_IN,             // Inner diameter of cable
    PHYS_S,                   // width of gap between line and ground
    PHYS_DIAM_OUT,            // Outer diameter of cable
    PHYS_LEN,                 // Length of cable
    ROUGH,                    // Surface roughness
    MUR,                      // Magnetic permeability of substrate
    MURC,                     // magnetic permeability of conductor
    FREQUENCY,                // Frequency of operation
    STRIPLINE_A,              // Stripline : distance from track to top plane
    TWISTEDPAIR_TWIST,        // Twists per length
    TWISTEDPAIR_EPSILONR_ENV, // Dielectric constant of environment
    Z0,                       // Characteristic impedance
    Z0_E,                     // Even-mode characteristic impedance
    Z0_O,                     // Odd-mode characteristic impedance
    ANG_L,                    // Electrical length in angle
    DUMMY_PRM,
 
    // The following parameters are generated by calculations
    SIGMA,                // Conductivity of the metal
    SKIN_DEPTH,           // Skin depth
    LOSS_DIELECTRIC,      // Loss in dielectric (dB)
    LOSS_CONDUCTOR,       // Loss in conductors (dB)
    CUTOFF_FREQUENCY,     // Cutoff frequency for higher order modes
    EPSILON_EFF,          // Effective dielectric constant
    EPSILON_EFF_EVEN,     // Even mode effective dielectric constant
    EPSILON_EFF_ODD,      // Odd mode effective dielectric constant
    UNIT_PROP_DELAY,      // The unit propagation delay (ps/cm)
    UNIT_PROP_DELAY_ODD,  // The odd mode unit propagation delay (ps/cm)
    UNIT_PROP_DELAY_EVEN, // The even mode unit propagation delay (ps/cm)
    ATTEN_COND,           // The attenuation of the conductor
    ATTEN_COND_EVEN,      // The even mode attenuation of the conductor
    ATTEN_COND_ODD,       // The odd mode attenuation of the conductor
    ATTEN_DILECTRIC,      // The attenuation of the dilectric
    ATTEN_DILECTRIC_EVEN, // The even mode attenuation of the dilectric
    ATTEN_DILECTRIC_ODD,  // The odd mode attenuation of the dilectric
    Z_DIFF,               // The differential impedance
    EXTRAS_COUNT
};
 

enum class SYNTHESIZE_OPTS
{
    DEFAULT,    // Use the default synthesis options for the calculation
    FIX_WIDTH,  // Fixes the width of a differential pair
    FIX_SPACING // Fixes the spacing of a differential pair
};
 

enum class TRANSLINE_STATUS
{
    OK,
    WARNING,
    TS_ERROR        // ERROR name is colliding with a define on Windows
};
 

class TRANSLINE_CALCULATION_BASE
{
public:
    TRANSLINE_CALCULATION_BASE( std::initializer_list<TRANSLINE_PARAMETERS> aParameters )
    {
        InitProperties( aParameters );
    }
 
    virtual ~TRANSLINE_CALCULATION_BASE() {}

    void SetParameter( const TRANSLINE_PARAMETERS aParam, const double aValue ) { m_parameters.at( aParam ) = aValue; }

    double GetParameter( const TRANSLINE_PARAMETERS aParam ) const { return m_parameters.at( aParam ); }

    double& GetParameterRef( const TRANSLINE_PARAMETERS aParam ) { return m_parameters[aParam]; }

    std::unordered_map<TRANSLINE_PARAMETERS, std::pair<double, TRANSLINE_STATUS>>& GetAnalysisResults();

    std::unordered_map<TRANSLINE_PARAMETERS, std::pair<double, TRANSLINE_STATUS>>& GetSynthesisResults();

    virtual void Analyse() = 0;

    virtual bool Synthesize( SYNTHESIZE_OPTS aOpts ) = 0;
 
protected:
    void InitProperties( const std::initializer_list<TRANSLINE_PARAMETERS>& aParams );

    virtual void SetAnalysisResults() = 0;

    virtual void SetSynthesisResults() = 0;

    void SetAnalysisResult( TRANSLINE_PARAMETERS aParam, const double aValue,
                            const TRANSLINE_STATUS aStatus = TRANSLINE_STATUS::OK );

    void SetSynthesisResult( TRANSLINE_PARAMETERS aParam, const double aValue,
                             const TRANSLINE_STATUS aStatus = TRANSLINE_STATUS::OK );

    bool MinimiseZ0Error1D( TRANSLINE_PARAMETERS aOptimise, TRANSLINE_PARAMETERS aMeasure,
                            bool aRecalculateLength = false );

    bool MinimiseZ0Error2D( TRANSLINE_PARAMETERS aParam1, TRANSLINE_PARAMETERS aParam2 );

    double SkinDepth() const;

    static double UnitPropagationDelay( double aEpsilonEff );

    static std::pair<double, double> EllipticIntegral( double arg );

    static double coth( const double x ) { return ( std::exp( 2.0 * x ) + 1.0 ) / ( std::exp( 2.0 * x ) - 1.0 ); }

    static double sech( const double x ) { return 2.0 / ( std::exp( x ) + std::exp( -x ) ); }

    std::unordered_map<TRANSLINE_PARAMETERS, double> m_parameters;

    std::unordered_map<TRANSLINE_PARAMETERS, std::pair<double, TRANSLINE_STATUS>> m_analysisStatus;

    std::unordered_map<TRANSLINE_PARAMETERS, std::pair<double, TRANSLINE_STATUS>> m_synthesisStatus;

    static constexpr double m_maxError{ 0.000001 };
};
 
#endif //TRANSLINE_CALCULATIONS_TRANSLINE_CALCULATION_BASE_H