common/transline_calculations/microstrip.h

Go to the documentation of this file.

/*
 * Copyright (C) 2001 Gopal Narayanan <[email protected]>
 * Copyright (C) 2002 Claudio Girardi <[email protected]>
 * Copyright (C) 2005, 2006 Stefan Jahn <[email protected]>
 * Modified for Kicad: 2018 Jean-Pierre Charras <jp.charras at wanadoo.fr>
 * 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_MICROSTRIP_H
#define TRANSLINE_CALCULATIONS_MICROSTRIP_H
 
 
#include <algorithm>
 
#include <transline_calculations/transline_calculation_base.h>
 
 
class MICROSTRIP : public TRANSLINE_CALCULATION_BASE
{
    using TCP = TRANSLINE_PARAMETERS;
 
public:
    MICROSTRIP() :
            TRANSLINE_CALCULATION_BASE( { TCP::EPSILONR, TCP::H_T, TCP::H, TCP::PHYS_WIDTH, TCP::T, TCP::Z0,
                                          TCP::FREQUENCY, TCP::EPSILON_EFF, TCP::SKIN_DEPTH, TCP::SIGMA, TCP::ROUGH,
                                          TCP::TAND, TCP::PHYS_LEN, TCP::MUR, TCP::MURC, TCP::ANG_L,
                                          TCP::UNIT_PROP_DELAY, TCP::ATTEN_COND, TCP::ATTEN_DILECTRIC,
                                          TCP::DIELECTRIC_MODEL_SEL, TCP::EPSILONR_SPEC_FREQ,
                                          TCP::SOLDERMASK_PRESENT, TCP::SOLDERMASK_THICKNESS,
                                          TCP::SOLDERMASK_EPSILONR, TCP::SOLDERMASK_TAND } )
    {
    }
 
    friend class COUPLED_MICROSTRIP;

    void Analyse() override;

    bool Synthesize( SYNTHESIZE_OPTS aOpts ) override;

    double GetSoldermaskDeltaQ( double aWOverH, double aCOverH ) const override
    {
        if( aWOverH <= 0.0 || aCOverH <= 0.0 )
            return 0.0;
 
        const double q2Coated = WanHoorfarQ2( aWOverH, 1.0 + aCOverH );
        const double q2Base = WanHoorfarQ2( aWOverH, 1.0 );
        return std::max( 0.0, q2Coated - q2Base );
    }
 
private:
    void SetAnalysisResults() override;

    void SetSynthesisResults() override;

    double SynthesizeWidth() const;

    static double Z0_dispersion( double, double, double, double, double );

    static double Z0_homogeneous( double );

    static double delta_Z0_cover( double, double );

    static double filling_factor( double, double );

    static double delta_q_cover( double );

    static double delta_q_thickness( double, double );

    static double e_r_effective( double, double );

    static double delta_u_thickness( double, double, double );

    static double e_r_dispersion( double, double, double );

    double conductor_losses() const;

    double dielectric_losses() const;

    void microstrip_Z0();

    void dispersion();

    void attenuation();

    void mur_eff_ms();

    void line_angle();
 
    double Z0_0{ 0.0 };     
    double er_eff_0{ 0.0 }; 
    double mur_eff{ 0.0 };  
    double w_eff{ 0.0 };    
    double Z0_h_1{ 0.0 };   
};
 
 
#endif //TRANSLINE_CALCULATIONS_MICROSTRIP_H