PNS::MEANDER_SKEW_PLACER Class Reference

MEANDER_SKEW_PLACER. More...

#include <pns_meander_skew_placer.h>

Inheritance diagram for PNS::MEANDER_SKEW_PLACER:

Public Types
enum	TUNING_STATUS { TOO_SHORT = 0 , TOO_LONG , TUNED }
	< Result of the length tuning operation More...

Public Member Functions
	MEANDER_SKEW_PLACER (ROUTER *aRouter)
	~MEANDER_SKEW_PLACER ()
bool	Start (const VECTOR2I &aP, ITEM *aStartItem) override
	Function Start() More...
bool	Move (const VECTOR2I &aP, ITEM *aEndItem) override
	Function Move() More...
const wxString	TuningInfo (EDA_UNITS aUnits) const override
	Return a string describing the status and length of the tuned traces. More...
virtual bool	FixRoute (const VECTOR2I &aP, ITEM *aEndItem, bool aForceFinish=false) override
	Function FixRoute() More...
bool	CommitPlacement () override
bool	AbortPlacement () override
bool	HasPlacedAnything () const override
NODE *	CurrentNode (bool aLoopsRemoved=false) const override
	Function CurrentNode() More...
const ITEM_SET	Traces () override
	Function Traces() More...
const VECTOR2I &	CurrentStart () const override
	Function CurrentStart() More...
const VECTOR2I &	CurrentEnd () const override
	Function CurrentEnd() More...
const std::vector< int >	CurrentNets () const override
	Function CurrentNets() More...
int	CurrentLayer () const override
	Function CurrentLayer() More...
virtual TUNING_STATUS	TuningStatus () const override
	Return the tuning status (too short, too long, etc.) of the trace(s) being tuned. More...
bool	CheckFit (MEANDER_SHAPE *aShape) override
	Checks if it's OK to place the shape aShape (i.e. More...
virtual void	AmplitudeStep (int aSign)
	Increase/decreases the current meandering amplitude by one step. More...
virtual void	SpacingStep (int aSign)
	Increase/decrease the current meandering spacing by one step. More...
virtual int	Clearance ()
	Return the clearance of the track(s) being length tuned. More...
virtual const MEANDER_SETTINGS &	MeanderSettings () const
	Return the current meandering configuration. More...
virtual void	UpdateSettings (const MEANDER_SETTINGS &aSettings)
int	GetTotalPadToDieLength (const LINE &aLine) const
virtual bool	UnfixRoute ()
virtual bool	ToggleVia (bool aEnabled)
	Function ToggleVia() More...
virtual bool	IsPlacingVia () const
	Function IsPlacingVia() More...
virtual bool	SetLayer (int aLayer)
	Function SetLayer() More...
virtual void	FlipPosture ()
	Function FlipPosture() More...
virtual void	UpdateSizes (const SIZES_SETTINGS &aSizes)
	Function UpdateSizes() More...
virtual void	SetOrthoMode (bool aOrthoMode)
	Function SetOrthoMode() More...
virtual void	GetModifiedNets (std::vector< int > &aNets) const
	Function GetModifiedNets. More...
ROUTER *	Router () const
	Return current router settings. More...
ROUTING_SETTINGS &	Settings () const
	Return the logger object, allowing to dump geometry to a file. More...
virtual LOGGER *	Logger ()
void	SetLogger (LOGGER *aLogger)
void	SetDebugDecorator (DEBUG_DECORATOR *aDecorator)
	Assign a debug decorator allowing this algo to draw extra graphics for visual debugging. More...
DEBUG_DECORATOR *	Dbg () const
const BOX2I &	VisibleViewArea () const

Protected Member Functions
bool	doMove (const VECTOR2I &aP, ITEM *aEndItem, long long int aTargetLength)
void	setWorld (NODE *aWorld)
void	cutTunedLine (const SHAPE_LINE_CHAIN &aOrigin, const VECTOR2I &aTuneStart, const VECTOR2I &aCursorPos, SHAPE_LINE_CHAIN &aPre, SHAPE_LINE_CHAIN &aTuned, SHAPE_LINE_CHAIN &aPost)
	Extract the part of a track to be meandered, depending on the starting point and the cursor position. More...
void	tuneLineLength (MEANDERED_LINE &aTuned, long long int aElongation)
	Take a set of meanders in aTuned and tunes their length to extend the original line length by aElongation. More...
int	compareWithTolerance (long long int aValue, long long int aExpected, long long int aTolerance=0) const
	Compare aValue against aExpected with given tolerance. More...
VECTOR2I	getSnappedStartPoint (LINKED_ITEM *aStartItem, VECTOR2I aStartPoint)
long long int	lineLength (const ITEM_SET &aLine, const SOLID *aStartPad, const SOLID *aEndPad) const
	Calculate the total length of the line represented by an item set (tracks and vias) More...

Protected Attributes
VECTOR2I	m_currentStart
	Current world state. More...
NODE *	m_currentNode
LINE	m_originLine
LINE	m_currentTrace
SHAPE_LINE_CHAIN	m_finalShape
MEANDERED_LINE	m_result
LINKED_ITEM *	m_initialSegment
	Total length added by pad to die size. More...
int	m_padToDieLength
long long int	m_lastLength
TUNING_STATUS	m_lastStatus
NODE *	m_world
	Width of the meandered trace(s). More...
int	m_currentWidth
	Meander settings. More...
MEANDER_SETTINGS	m_settings
	The current end point. More...
VECTOR2I	m_currentEnd
SOLID *	m_startPad_p
SOLID *	m_endPad_p
SOLID *	m_startPad_n
SOLID *	m_endPad_n
DEBUG_DECORATOR *	m_debugDecorator
ROUTER *	m_router
LOGGER *	m_logger

Private Member Functions
long long int	currentSkew () const
long long int	origPathLength () const override
	current routing start point (end of tail, beginning of head) More...

Private Attributes
DIFF_PAIR	m_originPair
ITEM_SET	m_tunedPath
ITEM_SET	m_tunedPathP
ITEM_SET	m_tunedPathN
long long int	m_coupledLength
int	m_padToDieP
int	m_padToDieN

Detailed Description

MEANDER_SKEW_PLACER.

Differential pair skew adjustment algorithm.

Definition at line 39 of file pns_meander_skew_placer.h.

Member Enumeration Documentation

TUNING_STATUS

enum PNS::MEANDER_PLACER_BASE::TUNING_STATUS

inherited

< Result of the length tuning operation

Enumerator
TOO_SHORT
TOO_LONG
TUNED

Definition at line 49 of file pns_meander_placer_base.h.

 {
 TOO_SHORT = 0,
 TOO_LONG,
 TUNED
 };

Constructor & Destructor Documentation

MEANDER_SKEW_PLACER()

PNS::MEANDER_SKEW_PLACER::MEANDER_SKEW_PLACER

(

ROUTER *

aRouter

)

Definition at line 35 of file pns_meander_skew_placer.cpp.

 :
 MEANDER_PLACER ( aRouter )
{
 // Init temporary variables (do not leave uninitialized members)
 m_coupledLength = 0;
 m_padToDieN = 0;
 m_padToDieP = 0;
}

References m_coupledLength, m_padToDieN, and m_padToDieP.

~MEANDER_SKEW_PLACER()

PNS::MEANDER_SKEW_PLACER::~MEANDER_SKEW_PLACER

(

)

Definition at line 45 of file pns_meander_skew_placer.cpp.

{
}

Member Function Documentation

AbortPlacement()

bool PNS::MEANDER_PLACER::AbortPlacement ( )

overridevirtualinherited

Reimplemented from PNS::PLACEMENT_ALGO.

Definition at line 213 of file pns_meander_placer.cpp.

{
 m_world->KillChildren();
 return true;
}

References PNS::NODE::KillChildren(), and PNS::MEANDER_PLACER_BASE::m_world.

AmplitudeStep()

void PNS::MEANDER_PLACER_BASE::AmplitudeStep ( int  aSign )

virtualinherited

Increase/decreases the current meandering amplitude by one step.

Parameters

aSign

direction (negative = decrease, positive = increase).

Definition at line 49 of file pns_meander_placer_base.cpp.

{
 int a = m_settings.m_maxAmplitude + aSign * m_settings.m_step;
 a = std::max( a, m_settings.m_minAmplitude );
 
 m_settings.m_maxAmplitude = a;
}

References PNS::MEANDER_SETTINGS::m_maxAmplitude, PNS::MEANDER_SETTINGS::m_minAmplitude, PNS::MEANDER_PLACER_BASE::m_settings, and PNS::MEANDER_SETTINGS::m_step.

CheckFit()

bool PNS::MEANDER_PLACER::CheckFit ( MEANDER_SHAPE *  aShape )

overridevirtualinherited

Checks if it's OK to place the shape aShape (i.e.

if it doesn't cause DRC violations or collide with other meanders).

Parameters

aShape

the shape to check.

Returns

true if the shape fits.

Reimplemented from PNS::MEANDER_PLACER_BASE.

Definition at line 236 of file pns_meander_placer.cpp.

{
 LINE l( m_originLine, aShape->CLine( 0 ) );
 
 if( m_currentNode->CheckColliding( &l ) )
 return false;
 
 int w = aShape->Width();
 int clearance = w + m_settings.m_spacing;
 
 return m_result.CheckSelfIntersections( aShape, clearance );
}

References PNS::NODE::CheckColliding(), PNS::MEANDERED_LINE::CheckSelfIntersections(), PNS::MEANDER_SHAPE::CLine(), PNS::MEANDER_PLACER::m_currentNode, PNS::MEANDER_PLACER::m_originLine, PNS::MEANDER_PLACER::m_result, PNS::MEANDER_PLACER_BASE::m_settings, PNS::MEANDER_SETTINGS::m_spacing, and PNS::MEANDER_SHAPE::Width().

Clearance()

int PNS::MEANDER_PLACER_BASE::Clearance ( )

virtualinherited

Return the clearance of the track(s) being length tuned.

Returns

clearance value in internal units

Definition at line 67 of file pns_meander_placer_base.cpp.

{
 // Assumption: All tracks are part of the same net class.
 // It shouldn't matter which track we pick. They should all have the same clearance if
 // they are part of the same net class. Therefore, pick the first one on the list.
 ITEM* itemToCheck = Traces().CItems().front().item;
 PNS::CONSTRAINT constraint;
 
 Router()->GetRuleResolver()->QueryConstraint( PNS::CONSTRAINT_TYPE::CT_CLEARANCE, itemToCheck,
 nullptr, CurrentLayer(), &constraint );
 
 wxCHECK_MSG( constraint.m_Value.HasMin(), m_currentWidth, wxT( "No minimum clearance?" ) );
 
 return constraint.m_Value.Min();
}

References PNS::ITEM_SET::CItems(), PNS::CT_CLEARANCE, PNS::PLACEMENT_ALGO::CurrentLayer(), PNS::ROUTER::GetRuleResolver(), MINOPTMAX< T >::HasMin(), PNS::MEANDER_PLACER_BASE::m_currentWidth, PNS::CONSTRAINT::m_Value, MINOPTMAX< T >::Min(), PNS::RULE_RESOLVER::QueryConstraint(), PNS::ALGO_BASE::Router(), and PNS::PLACEMENT_ALGO::Traces().

Referenced by PNS::MEANDER_SHAPE::spacing(), and PNS::MEANDER_PLACER_BASE::SpacingStep().

CommitPlacement()

bool PNS::MEANDER_PLACER::CommitPlacement ( )

overridevirtualinherited

Reimplemented from PNS::PLACEMENT_ALGO.

Definition at line 226 of file pns_meander_placer.cpp.

{
 if( m_currentNode )
 Router()->CommitRouting( m_currentNode );
 
 m_currentNode = nullptr;
 return true;
}

References PNS::ROUTER::CommitRouting(), PNS::MEANDER_PLACER::m_currentNode, and PNS::ALGO_BASE::Router().

Referenced by PNS::MEANDER_PLACER::FixRoute().

compareWithTolerance()

int PNS::MEANDER_PLACER_BASE::compareWithTolerance ( long long int  aValue, long long int  aExpected, long long int  aTolerance = 0  ) const

protectedinherited

Compare aValue against aExpected with given tolerance.

Definition at line 344 of file pns_meander_placer_base.cpp.

{
 if( aValue < aExpected - aTolerance )
 return -1;
 else if( aValue > aExpected + aTolerance )
 return 1;
 else
 return 0;
}

Referenced by PNS::MEANDER_PLACER::doMove(), and PNS::DP_MEANDER_PLACER::Move().

CurrentEnd()

const VECTOR2I & PNS::MEANDER_PLACER::CurrentEnd ( ) const

overridevirtualinherited

Function CurrentEnd()

Returns the current end of the line(s) being placed/tuned. It may not be equal to the cursor position due to collisions.

Implements PNS::PLACEMENT_ALGO.

Definition at line 261 of file pns_meander_placer.cpp.

{
 return m_currentEnd;
}

References PNS::MEANDER_PLACER_BASE::m_currentEnd.

CurrentLayer()

int PNS::MEANDER_PLACER::CurrentLayer ( ) const

overridevirtualinherited

Function CurrentLayer()

Returns the layer of currently routed track.

Implements PNS::PLACEMENT_ALGO.

Definition at line 266 of file pns_meander_placer.cpp.

{
 return m_initialSegment->Layers().Start();
}

References PNS::ITEM::Layers(), PNS::MEANDER_PLACER::m_initialSegment, and LAYER_RANGE::Start().

CurrentNets()

const std::vector< int > PNS::MEANDER_PLACER::CurrentNets ( ) const

inlineoverridevirtualinherited

Function CurrentNets()

Returns the net code(s) of currently routed track(s).

Implements PNS::PLACEMENT_ALGO.

Definition at line 83 of file pns_meander_placer.h.

 {
 return std::vector<int> (1, m_originLine.Net() );
 }

References PNS::MEANDER_PLACER::m_originLine, and PNS::ITEM::Net().

CurrentNode()

NODE * PNS::MEANDER_PLACER::CurrentNode ( bool  aLoopsRemoved = false ) const

overridevirtualinherited

Function CurrentNode()

Returns the most recent board state.

Implements PNS::PLACEMENT_ALGO.

Definition at line 52 of file pns_meander_placer.cpp.

{
 if( !m_currentNode )
 return m_world;
 
 return m_currentNode;
}

References PNS::MEANDER_PLACER::m_currentNode, and PNS::MEANDER_PLACER_BASE::m_world.

currentSkew()

long long int PNS::MEANDER_SKEW_PLACER::currentSkew ( ) const

private

Definition at line 133 of file pns_meander_skew_placer.cpp.

{
 return m_lastLength - m_coupledLength;
}

References m_coupledLength, and PNS::MEANDER_PLACER::m_lastLength.

CurrentStart()

const VECTOR2I & PNS::MEANDER_PLACER::CurrentStart ( ) const

overridevirtualinherited

Function CurrentStart()

Returns the current start of the line(s) being placed/tuned.

Implements PNS::PLACEMENT_ALGO.

Definition at line 256 of file pns_meander_placer.cpp.

{
 return m_currentStart;
}

References PNS::MEANDER_PLACER::m_currentStart.

cutTunedLine()

void PNS::MEANDER_PLACER_BASE::cutTunedLine ( const SHAPE_LINE_CHAIN &  aOrigin, const VECTOR2I &  aTuneStart, const VECTOR2I &  aCursorPos, SHAPE_LINE_CHAIN &  aPre, SHAPE_LINE_CHAIN &  aTuned, SHAPE_LINE_CHAIN &  aPost  )

protectedinherited

Extract the part of a track to be meandered, depending on the starting point and the cursor position.

Parameters

aOrigin	the original line.
aTuneStart	point where we start meandering (start click coordinates).
aCursorPos	current cursor position.
aPre	part before the beginning of meanders.
aTuned	part to be meandered.
aPost	part after the end of meanders.

Definition at line 90 of file pns_meander_placer_base.cpp.

{
 VECTOR2I cp ( aCursorPos );
 
 if( cp == aTuneStart ) // we don't like tuning segments with 0 length
 {
 int idx = aOrigin.FindSegment( cp );
 
 if( idx >= 0 )
 {
 const SEG& s = aOrigin.CSegment( idx );
 cp += ( s.B - s.A ).Resize( 2 );
 }
 else
 {
 cp += VECTOR2I( 2, 5 ); // some arbitrary value that is not 45 degrees oriented
 }
 }
 
 VECTOR2I n = aOrigin.NearestPoint( cp, false );
 VECTOR2I m = aOrigin.NearestPoint( aTuneStart, false );
 
 SHAPE_LINE_CHAIN l( aOrigin );
 l.Split( n );
 l.Split( m );
 
 int i_start = l.Find( m );
 int i_end = l.Find( n );
 
 if( i_start > i_end )
 {
 l = l.Reverse();
 i_start = l.Find( m );
 i_end = l.Find( n );
 }
 
 aPre = l.Slice( 0, i_start );
 aPost = l.Slice( i_end, -1 );
 aTuned = l.Slice( i_start, i_end );
 
 aTuned.Simplify();
}

References SEG::A, SEG::B, SHAPE_LINE_CHAIN::CSegment(), SHAPE_LINE_CHAIN::Find(), SHAPE_LINE_CHAIN::FindSegment(), SHAPE_LINE_CHAIN::NearestPoint(), SHAPE_LINE_CHAIN::Reverse(), SHAPE_LINE_CHAIN::Simplify(), SHAPE_LINE_CHAIN::Slice(), and SHAPE_LINE_CHAIN::Split().

Referenced by PNS::MEANDER_PLACER::doMove(), and PNS::DP_MEANDER_PLACER::Move().

Dbg()

DEBUG_DECORATOR * PNS::ALGO_BASE::Dbg ( ) const

inlineinherited

Definition at line 78 of file pns_algo_base.h.

 {
 return m_debugDecorator;
 }

References PNS::ALGO_BASE::m_debugDecorator.

Referenced by PNS::LINE_PLACER::buildInitialLine(), PNS::LINE_PLACER::clipAndCheckCollisions(), PNS::MEANDER_PLACER::doMove(), PNS::COMPONENT_DRAGGER::Drag(), PNS::DRAGGER::dragShove(), PNS::DRAGGER::dragWalkaround(), PNS::SHOVE::fixupViaCollisions(), PNS::LINE_PLACER::handlePullback(), PNS::LINE_PLACER::mergeHead(), PNS::DP_MEANDER_PLACER::Move(), Move(), PNS::SHOVE::onCollidingArc(), PNS::SHOVE::onCollidingLine(), PNS::SHOVE::onCollidingSegment(), PNS::SHOVE::onCollidingSolid(), PNS::SHOVE::onCollidingVia(), PNS::SHOVE::onReverseCollidingVia(), PNS::DRAGGER::optimizeAndUpdateDraggedLine(), PNS::LINE_PLACER::optimizeTailHeadTransition(), PNS::SHOVE::pushLineStack(), PNS::SHOVE::pushOrShoveVia(), PNS::LINE_PLACER::reduceTail(), PNS::LINE_PLACER::removeLoops(), PNS::SHOVE::replaceLine(), PNS::LINE_PLACER::rhShoveOnly(), PNS::LINE_PLACER::rhWalkBase(), PNS::LINE_PLACER::rhWalkOnly(), PNS::LINE_PLACER::routeStep(), PNS::SHOVE::runOptimizer(), PNS::SHOVE::shoveIteration(), PNS::SHOVE::ShoveLines(), PNS::SHOVE::shoveLineToHullSet(), PNS::SHOVE::shoveMainLoop(), PNS::SHOVE::ShoveMultiLines(), PNS::SHOVE::ShoveObstacleLine(), PNS::WALKAROUND::singleStep(), PNS::LINE_PLACER::splitHeadTail(), PNS::LINE_PLACER::Start(), PNS::DRAGGER::Start(), PNS::LINE_PLACER::Trace(), PNS::DRAGGER::tryWalkaround(), and PNS::SHOVE::unwindLineStack().

doMove()

bool PNS::MEANDER_PLACER::doMove ( const VECTOR2I &  aP, ITEM *  aEndItem, long long int  aTargetLength  )

protectedinherited

Definition at line 108 of file pns_meander_placer.cpp.

{
 SHAPE_LINE_CHAIN pre, tuned, post;
 
 if( m_currentNode )
 delete m_currentNode;
 
 m_currentNode = m_world->Branch();
 
 cutTunedLine( m_originLine.CLine(), m_currentStart, aP, pre, tuned, post );
 
 m_result = MEANDERED_LINE( this, false );
 m_result.SetWidth( m_originLine.Width() );
 m_result.SetBaselineOffset( 0 );
 
 for( int i = 0; i < tuned.SegmentCount(); i++ )
 {
 if( tuned.IsArcSegment( i ) )
 {
 ssize_t arcIndex = tuned.ArcIndex( i );
 m_result.AddArc( tuned.Arc( arcIndex ) );
 i = tuned.NextShape( i );
 
 // NextShape will return -1 if last shape
 if( i < 0 )
 i = tuned.SegmentCount();
 
 continue;
 }
 
 const SEG s = tuned.CSegment( i );
 m_result.AddCorner( s.A );
 m_result.MeanderSegment( s, s.Side( aP ) < 0 );
 m_result.AddCorner( s.B );
 }
 
 long long int lineLen = origPathLength();
 
 m_lastLength = lineLen;
 m_lastStatus = TUNED;
 
 if( compareWithTolerance( lineLen, aTargetLength, m_settings.m_lengthTolerance ) > 0 )
 {
 m_lastStatus = TOO_LONG;
 } else {
 m_lastLength = lineLen - tuned.Length();
 tuneLineLength( m_result, aTargetLength - lineLen );
 }
 
 for( const ITEM* item : m_tunedPath.CItems() )
 {
  if( const LINE* l = dyn_cast<const LINE*>( item ) )
 {
 PNS_DBG( Dbg(), AddItem, l, BLUE, 30000, wxT( "tuned-line" ) );
 }
 }
 
 if( m_lastStatus != TOO_LONG )
 {
 tuned.Clear();
 
 for( MEANDER_SHAPE* m : m_result.Meanders() )
 {
 if( m->Type() != MT_EMPTY )
 {
 tuned.Append ( m->CLine( 0 ) );
 }
 }
 
 m_lastLength += tuned.Length();
 
 int comp = compareWithTolerance( m_lastLength - aTargetLength, 0,
 m_settings.m_lengthTolerance );
 
 if( comp > 0 )
 m_lastStatus = TOO_LONG;
 else if( comp < 0 )
 m_lastStatus = TOO_SHORT;
 else
 m_lastStatus = TUNED;
 }
 
 m_finalShape.Clear();
 m_finalShape.Append( pre );
 m_finalShape.Append( tuned );
 m_finalShape.Append( post );
 m_finalShape.Simplify();
 
 return true;
}

References SEG::A, PNS::MEANDERED_LINE::AddArc(), PNS::MEANDERED_LINE::AddCorner(), SHAPE_LINE_CHAIN::Append(), SHAPE_LINE_CHAIN::Arc(), SHAPE_LINE_CHAIN::ArcIndex(), SEG::B, BLUE, PNS::NODE::Branch(), PNS::ITEM_SET::CItems(), SHAPE_LINE_CHAIN::Clear(), PNS::LINE::CLine(), PNS::MEANDER_PLACER_BASE::compareWithTolerance(), SHAPE_LINE_CHAIN::CSegment(), PNS::MEANDER_PLACER_BASE::cutTunedLine(), PNS::ALGO_BASE::Dbg(), SHAPE_LINE_CHAIN::IsArcSegment(), SHAPE_LINE_CHAIN::Length(), PNS::MEANDER_PLACER::m_currentNode, PNS::MEANDER_PLACER::m_currentStart, PNS::MEANDER_PLACER::m_finalShape, PNS::MEANDER_PLACER::m_lastLength, PNS::MEANDER_PLACER::m_lastStatus, PNS::MEANDER_SETTINGS::m_lengthTolerance, PNS::MEANDER_PLACER::m_originLine, PNS::MEANDER_PLACER::m_result, PNS::MEANDER_PLACER_BASE::m_settings, PNS::MEANDER_PLACER::m_tunedPath, PNS::MEANDER_PLACER_BASE::m_world, PNS::MEANDERED_LINE::Meanders(), PNS::MEANDERED_LINE::MeanderSegment(), PNS::MT_EMPTY, SHAPE_LINE_CHAIN::NextShape(), PNS::MEANDER_PLACER::origPathLength(), PNS_DBG, SHAPE_LINE_CHAIN::SegmentCount(), PNS::MEANDERED_LINE::SetBaselineOffset(), PNS::MEANDERED_LINE::SetWidth(), SEG::Side(), SHAPE_LINE_CHAIN::Simplify(), PNS::MEANDER_PLACER_BASE::TOO_LONG, PNS::MEANDER_PLACER_BASE::TOO_SHORT, PNS::MEANDER_PLACER_BASE::TUNED, PNS::MEANDER_PLACER_BASE::tuneLineLength(), and PNS::LINE::Width().

Referenced by PNS::MEANDER_PLACER::Move(), and Move().

FixRoute()

bool PNS::MEANDER_PLACER::FixRoute ( const VECTOR2I &  aP, ITEM *  aEndItem, bool  aForceFinish = false  )

overridevirtualinherited

Function FixRoute()

Commits the currently routed items to the parent node, taking aP as the final end point and aEndItem as the final anchor (if provided).

Returns

true, if route has been committed. May return false if the routing result is violating design rules - in such case, the track is only committed if Settings.CanViolateDRC() is on.

Implements PNS::PLACEMENT_ALGO.

Definition at line 200 of file pns_meander_placer.cpp.

{
 if( !m_currentNode )
 return false;
 
 m_currentTrace = LINE( m_originLine, m_finalShape );
 m_currentNode->Add( m_currentTrace );
 CommitPlacement();
 
 return true;
}

References PNS::NODE::Add(), PNS::MEANDER_PLACER::CommitPlacement(), PNS::MEANDER_PLACER::m_currentNode, PNS::MEANDER_PLACER::m_currentTrace, PNS::MEANDER_PLACER::m_finalShape, and PNS::MEANDER_PLACER::m_originLine.

FlipPosture()

virtual void PNS::PLACEMENT_ALGO::FlipPosture ( )

inlinevirtualinherited

Function FlipPosture()

Toggles the current posture (straight/diagonal) of the trace head.

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 167 of file pns_placement_algo.h.

 {
 }

GetModifiedNets()

virtual void PNS::PLACEMENT_ALGO::GetModifiedNets ( std::vector< int > &  aNets ) const

inlinevirtualinherited

Function GetModifiedNets.

Returns the net codes of all currently routed trace(s)

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 198 of file pns_placement_algo.h.

 {
 }

getSnappedStartPoint()

VECTOR2I PNS::MEANDER_PLACER_BASE::getSnappedStartPoint ( LINKED_ITEM *  aStartItem, VECTOR2I  aStartPoint  )

protectedinherited

Definition at line 356 of file pns_meander_placer_base.cpp.

{
 if( aStartItem->Kind() == ITEM::SEGMENT_T )
 {
 return static_cast<SEGMENT*>( aStartItem )->Seg().NearestPoint( aStartPoint );
 }
 else
 {
 wxASSERT( aStartItem->Kind() == ITEM::ARC_T );
 ARC* arc = static_cast<ARC*>( aStartItem );
 
 if( ( VECTOR2I( arc->Anchor( 0 ) - aStartPoint ) ).SquaredEuclideanNorm() <=
 ( VECTOR2I( arc->Anchor( 1 ) - aStartPoint ) ).SquaredEuclideanNorm() )
 {
 return arc->Anchor( 0 );
 }
 else
 {
 return arc->Anchor( 1 );
 }
 }
}

References PNS::ARC::Anchor(), PNS::ITEM::ARC_T, PNS::ITEM::Kind(), and PNS::ITEM::SEGMENT_T.

Referenced by PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), and Start().

GetTotalPadToDieLength()

int PNS::MEANDER_PLACER_BASE::GetTotalPadToDieLength ( const LINE &  aLine ) const

inherited

Definition at line 300 of file pns_meander_placer_base.cpp.

{
 int length = 0;
 JOINT start;
 JOINT end;
 
 m_world->FindLineEnds( aLine, start, end );
 
 // Extract the length of the pad to die for start and end pads
 for( auto& link : start.LinkList() )
 {
 if( const SOLID* solid = dynamic_cast<const SOLID*>( link.item ) )
 {
 // If there are overlapping pads, choose the first with a non-zero length
 if( solid->GetPadToDie() > 0 )
 {
 length += solid->GetPadToDie();
 break;
 }
 }
 }
 
 for( auto& link : end.LinkList() )
 {
 if( const SOLID* solid = dynamic_cast<const SOLID*>( link.item ) )
 {
 if( solid->GetPadToDie() > 0 )
 {
 length += solid->GetPadToDie();
 break;
 }
 }
 }
 
 return length;
}

References PNS::NODE::FindLineEnds(), PNS::JOINT::LinkList(), and PNS::MEANDER_PLACER_BASE::m_world.

HasPlacedAnything()

bool PNS::MEANDER_PLACER::HasPlacedAnything ( ) const

overridevirtualinherited

Reimplemented from PNS::PLACEMENT_ALGO.

Definition at line 220 of file pns_meander_placer.cpp.

{
 return m_currentTrace.SegmentCount() > 0;
}

References PNS::MEANDER_PLACER::m_currentTrace, and PNS::LINE::SegmentCount().

IsPlacingVia()

virtual bool PNS::PLACEMENT_ALGO::IsPlacingVia ( ) const

inlinevirtualinherited

Function IsPlacingVia()

Returns true if the placer is placing a via (or more vias).

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 104 of file pns_placement_algo.h.

 {
 return false;
 }

lineLength()

long long int PNS::MEANDER_PLACER_BASE::lineLength ( const ITEM_SET &  aLine, const SOLID *  aStartPad, const SOLID *  aEndPad  ) const

protectedinherited

Calculate the total length of the line represented by an item set (tracks and vias)

Parameters

aLine

Returns

Pointer to world to search colliding items.

If there is a start pad but the pad's layers do not overlap the first track layer, then there must be a fanout via on the line. If there isn't, we still need to have the via back to the pad, so count the distance in the line tuning

Definition at line 380 of file pns_meander_placer_base.cpp.

{
 long long int total = 0;
 
 if( aLine.Empty() )
 return 0;
 
 const ITEM* start_item = aLine[0];
 const ITEM* end_item = aLine[aLine.Size() - 1];
 bool start_via = false;
 bool end_via = false;
 
 
 start_via = aStartPad && ( !aStartPad->LayersOverlap( start_item ) );
 end_via = aEndPad && ( !aEndPad->LayersOverlap( end_item ) );
 
 for( int idx = 0; idx < aLine.Size(); idx++ )
 {
 const ITEM* item = aLine[idx];
 
 if( const LINE* l = dyn_cast<const LINE*>( item ) )
 {
 total += l->CLine().Length();
 }
 else if( item->OfKind( ITEM::VIA_T ) && idx > 0 && idx < aLine.Size() - 1 )
 {
 int layerPrev = aLine[idx - 1]->Layer();
 int layerNext = aLine[idx + 1]->Layer();
 
 if( layerPrev != layerNext )
 total += m_router->GetInterface()->StackupHeight( layerPrev, layerNext );
 }
 }
 
 if( start_via )
 {
 int layerPrev = aStartPad->Layer();
 int layerNext = start_item->Layer();
 
 total += m_router->GetInterface()->StackupHeight( layerPrev, layerNext );
 }
 
 if( end_via )
 {
 int layerPrev = end_item->Layer();
 int layerNext = aEndPad->Layer();
 
 total += m_router->GetInterface()->StackupHeight( layerPrev, layerNext );
 }
 
 return total;
}

References PNS::ITEM_SET::Empty(), PNS::ROUTER::GetInterface(), PNS::ITEM::Layer(), PNS::ITEM::LayersOverlap(), PNS::ALGO_BASE::m_router, PNS::ITEM::OfKind(), PNS::ITEM_SET::Size(), PNS::ROUTER_IFACE::StackupHeight(), and PNS::ITEM::VIA_T.

Referenced by PNS::DP_MEANDER_PLACER::origPathLength(), PNS::MEANDER_PLACER::origPathLength(), origPathLength(), and Start().

Logger()

LOGGER * PNS::ALGO_BASE::Logger ( )

virtualinherited

Reimplemented in PNS::SHOVE.

Definition at line 34 of file pns_algo_base.cpp.

{
 return nullptr;
}

Referenced by PNS::LINE_PLACER::rhShoveOnly(), PNS::LINE_PLACER::rhWalkBase(), PNS::DRAGGER::Start(), and PNS::DRAGGER::tryWalkaround().

MeanderSettings()

const MEANDER_SETTINGS & PNS::MEANDER_PLACER_BASE::MeanderSettings ( ) const

virtualinherited

Return the current meandering configuration.

Returns

the settings

Definition at line 338 of file pns_meander_placer_base.cpp.

{
 return m_settings;
}

References PNS::MEANDER_PLACER_BASE::m_settings.

Referenced by PNS::MEANDER_SHAPE::makeMiterShape(), LENGTH_TUNER_TOOL::meanderSettingsDialog(), PNS::MEANDER_SHAPE::MinAmplitude(), PNS::MEANDER_SHAPE::Settings(), and PNS::MEANDERED_LINE::Settings().

Move()

bool PNS::MEANDER_SKEW_PLACER::Move ( const VECTOR2I &  aP, ITEM *  aEndItem  )

overridevirtual

Function Move()

Moves the end of the currently routed primtive(s) to the point aP, taking aEndItem as the anchor (if not NULL). (unless NULL).

Reimplemented from PNS::MEANDER_PLACER.

Definition at line 139 of file pns_meander_skew_placer.cpp.

{
 for( const ITEM* item : m_tunedPathP.CItems() )
 {
 if( const LINE* l = dyn_cast<const LINE*>( item ) )
 PNS_DBG( Dbg(), AddItem, l, BLUE, 10000, wxT( "tuned-path-skew-p" ) );
 }
 
 for( const ITEM* item : m_tunedPathN.CItems() )
 {
 if( const LINE* l = dyn_cast<const LINE*>( item ) )
 PNS_DBG( Dbg(), AddItem, l, YELLOW, 10000, wxT( "tuned-path-skew-n" ) );
 }
 
 return doMove( aP, aEndItem, m_coupledLength + m_settings.m_targetSkew );
}

References BLUE, PNS::ITEM_SET::CItems(), PNS::ALGO_BASE::Dbg(), PNS::MEANDER_PLACER::doMove(), m_coupledLength, PNS::MEANDER_PLACER_BASE::m_settings, PNS::MEANDER_SETTINGS::m_targetSkew, m_tunedPathN, m_tunedPathP, PNS_DBG, and YELLOW.

origPathLength()

long long int PNS::MEANDER_SKEW_PLACER::origPathLength ( ) const

overrideprivatevirtual

current routing start point (end of tail, beginning of head)

Reimplemented from PNS::MEANDER_PLACER.

Definition at line 123 of file pns_meander_skew_placer.cpp.

{
 if ( m_originPair.NetP() == m_originLine.Net() )
 return m_padToDieP + lineLength( m_tunedPath, m_startPad_p, m_endPad_p );
 
 return m_padToDieN + lineLength( m_tunedPath, m_startPad_n, m_endPad_n );
 
}

References PNS::MEANDER_PLACER_BASE::lineLength(), PNS::MEANDER_PLACER_BASE::m_endPad_n, PNS::MEANDER_PLACER_BASE::m_endPad_p, PNS::MEANDER_PLACER::m_originLine, m_originPair, m_padToDieN, m_padToDieP, PNS::MEANDER_PLACER_BASE::m_startPad_n, PNS::MEANDER_PLACER_BASE::m_startPad_p, m_tunedPath, PNS::ITEM::Net(), and PNS::DIFF_PAIR::NetP().

Router()

ROUTER * PNS::ALGO_BASE::Router ( ) const

inlineinherited

Return current router settings.

Definition at line 54 of file pns_algo_base.h.

References PNS::ALGO_BASE::m_router.

Referenced by PNS::DIFF_PAIR_PLACER::attemptWalk(), PNS::MEANDER_PLACER_BASE::Clearance(), PNS::DIFF_PAIR_PLACER::CommitPlacement(), PNS::DP_MEANDER_PLACER::CommitPlacement(), PNS::LINE_PLACER::CommitPlacement(), PNS::MEANDER_PLACER::CommitPlacement(), PNS::COMPONENT_DRAGGER::FixRoute(), PNS::DRAGGER::FixRoute(), PNS::DIFF_PAIR_PLACER::initPlacement(), PNS::LINE_PLACER::initPlacement(), PNS::SHOVE::onCollidingSolid(), PNS::LINE_PLACER::rhWalkBase(), PNS::DIFF_PAIR_PLACER::Start(), PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), Start(), PNS::DRAGGER::Start(), and PNS::DRAGGER::tryWalkaround().

SetDebugDecorator()

void PNS::ALGO_BASE::SetDebugDecorator ( DEBUG_DECORATOR *  aDecorator )

inlineinherited

Assign a debug decorator allowing this algo to draw extra graphics for visual debugging.

Definition at line 73 of file pns_algo_base.h.

 {
 m_debugDecorator = aDecorator;
 }

References PNS::ALGO_BASE::m_debugDecorator.

Referenced by PNS::SHOVE::onCollidingSolid(), PNS::LINE_PLACER::rhWalkBase(), PNS::SHOVE::SHOVE(), and PNS::DRAGGER::tryWalkaround().

SetLayer()

virtual bool PNS::PLACEMENT_ALGO::SetLayer ( int  aLayer )

inlinevirtualinherited

Function SetLayer()

Sets the current routing layer.

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 114 of file pns_placement_algo.h.

 {
 return false;
 }

SetLogger()

void PNS::ALGO_BASE::SetLogger ( LOGGER *  aLogger )

inlineinherited

Definition at line 65 of file pns_algo_base.h.

 {
 m_logger = aLogger;
 }

References PNS::ALGO_BASE::m_logger.

Referenced by PNS::LINE_PLACER::rhWalkBase(), and PNS::DRAGGER::tryWalkaround().

SetOrthoMode()

virtual void PNS::PLACEMENT_ALGO::SetOrthoMode ( bool  aOrthoMode )

inlinevirtualinherited

Function SetOrthoMode()

Forces the router to place a straight 90/45 degree trace (with the end as near to the cursor as possible) instead of a standard 135 degree two-segment bend.

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 189 of file pns_placement_algo.h.

 {
 }

Settings()

ROUTING_SETTINGS & PNS::ALGO_BASE::Settings ( ) const

inherited

Return the logger object, allowing to dump geometry to a file.

Definition at line 28 of file pns_algo_base.cpp.

{
 return m_router->Settings();
}

References PNS::ALGO_BASE::m_router, and PNS::ROUTER::Settings().

Referenced by PNS::DIFF_PAIR_PLACER::attemptWalk(), PNS::LINE_PLACER::buildInitialLine(), PNS::LINE_PLACER::CommitPlacement(), PNS::DRAGGER::dragMarkObstacles(), PNS::DRAGGER::dragShove(), PNS::DRAGGER::dragWalkaround(), PNS::COMPONENT_DRAGGER::FixRoute(), PNS::DRAGGER::FixRoute(), PNS::DIFF_PAIR_PLACER::FixRoute(), PNS::LINE_PLACER::FixRoute(), PNS::LINE_PLACER::Move(), PNS::SHOVE::onCollidingSolid(), PNS::DRAGGER::optimizeAndUpdateDraggedLine(), PNS::DIFF_PAIR_PLACER::propagateDpHeadForces(), PNS::DRAGGER::propagateViaForces(), PNS::SHOVE::pushOrShoveVia(), PNS::LINE_PLACER::rhMarkObstacles(), PNS::LINE_PLACER::rhShoveOnly(), PNS::LINE_PLACER::rhWalkBase(), PNS::LINE_PLACER::rhWalkOnly(), PNS::DIFF_PAIR_PLACER::route(), PNS::LINE_PLACER::routeHead(), PNS::LINE_PLACER::routeStep(), PNS::SHOVE::runOptimizer(), PNS::SHOVE::shoveMainLoop(), PNS::LINE_PLACER::Start(), PNS::DRAGGER::Start(), PNS::DRAGGER::tryWalkaround(), and PNS::LINE_PLACER::UnfixRoute().

setWorld()

void PNS::MEANDER_PLACER::setWorld ( NODE *  aWorld )

protectedinherited

SpacingStep()

void PNS::MEANDER_PLACER_BASE::SpacingStep ( int  aSign )

virtualinherited

Increase/decrease the current meandering spacing by one step.

Parameters

aSign

direction (negative = decrease, positive = increase).

Definition at line 58 of file pns_meander_placer_base.cpp.

{
 int s = m_settings.m_spacing + aSign * m_settings.m_step;
 s = std::max( s, m_currentWidth + Clearance() );
 
 m_settings.m_spacing = s;
}

References PNS::MEANDER_PLACER_BASE::Clearance(), PNS::MEANDER_PLACER_BASE::m_currentWidth, PNS::MEANDER_PLACER_BASE::m_settings, PNS::MEANDER_SETTINGS::m_spacing, and PNS::MEANDER_SETTINGS::m_step.

Start()

bool PNS::MEANDER_SKEW_PLACER::Start ( const VECTOR2I &  aP, ITEM *  aStartItem  )

overridevirtual

Function Start()

Starts placement/drag operation at point aP, taking item aStartItem as anchor (unless NULL).

Reimplemented from PNS::MEANDER_PLACER.

Definition at line 50 of file pns_meander_skew_placer.cpp.

{
 if( !aStartItem || !aStartItem->OfKind( ITEM::SEGMENT_T | ITEM::ARC_T) )
 {
 Router()->SetFailureReason( _( "Please select a differential pair trace you want to tune." ) );
 return false;
 }
 
 m_initialSegment = static_cast<LINKED_ITEM*>( aStartItem );
 m_currentNode = nullptr;
 m_currentStart = getSnappedStartPoint( m_initialSegment, aP );
 
 m_world = Router()->GetWorld( )->Branch();
 m_originLine = m_world->AssembleLine( m_initialSegment );
 
 TOPOLOGY topo( m_world );
 m_tunedPath = topo.AssembleTrivialPath( m_initialSegment );
 
 if( !topo.AssembleDiffPair ( m_initialSegment, m_originPair ) )
 {
 Router()->SetFailureReason( _( "Unable to find complementary differential pair "
 "net for skew tuning. Make sure the names of the nets belonging "
 "to a differential pair end with either _N/_P or +/-." ) );
 return false;
 }
 
 if( m_originPair.Gap() < 0 )
 m_originPair.SetGap( Router()->Sizes().DiffPairGap() );
 
 if( !m_originPair.PLine().SegmentCount() ||
 !m_originPair.NLine().SegmentCount() )
 return false;
 
 m_tunedPathP = topo.AssembleTuningPath( m_originPair.PLine().GetLink( 0 ), &m_startPad_p, &m_endPad_p );
 
 m_padToDieP = 0;
 
 if( m_startPad_p )
 m_padToDieP += m_startPad_p->GetPadToDie();
 
 if( m_endPad_p )
 m_padToDieP += m_endPad_p->GetPadToDie();
 
 m_tunedPathN = topo.AssembleTuningPath( m_originPair.NLine().GetLink( 0 ), &m_startPad_n, &m_endPad_n );
 
 m_padToDieN = 0;
 
 if( m_startPad_n )
 m_padToDieN += m_startPad_n->GetPadToDie();
 
 if( m_endPad_n )
 m_padToDieN += m_endPad_n->GetPadToDie();
 
 m_world->Remove( m_originLine );
 
 m_currentWidth = m_originLine.Width();
 m_currentEnd = VECTOR2I( 0, 0 );
 
 if ( m_originPair.NetP() == m_originLine.Net() )
 {
 m_coupledLength = m_padToDieN + lineLength( m_tunedPathN, m_startPad_n, m_endPad_n );
 m_tunedPath = m_tunedPathP;
 }
 else
 {
 m_coupledLength = m_padToDieP + lineLength( m_tunedPathP, m_startPad_p, m_endPad_p );
 m_tunedPath = m_tunedPathN;
 }
 
 return true;
}

References _, PNS::ITEM::ARC_T, PNS::TOPOLOGY::AssembleDiffPair(), PNS::NODE::AssembleLine(), PNS::TOPOLOGY::AssembleTrivialPath(), PNS::TOPOLOGY::AssembleTuningPath(), PNS::NODE::Branch(), PNS::DIFF_PAIR::Gap(), PNS::LINK_HOLDER::GetLink(), PNS::SOLID::GetPadToDie(), PNS::MEANDER_PLACER_BASE::getSnappedStartPoint(), PNS::ROUTER::GetWorld(), PNS::MEANDER_PLACER_BASE::lineLength(), m_coupledLength, PNS::MEANDER_PLACER_BASE::m_currentEnd, PNS::MEANDER_PLACER::m_currentNode, PNS::MEANDER_PLACER::m_currentStart, PNS::MEANDER_PLACER_BASE::m_currentWidth, PNS::MEANDER_PLACER_BASE::m_endPad_n, PNS::MEANDER_PLACER_BASE::m_endPad_p, PNS::MEANDER_PLACER::m_initialSegment, PNS::MEANDER_PLACER::m_originLine, m_originPair, m_padToDieN, m_padToDieP, PNS::MEANDER_PLACER_BASE::m_startPad_n, PNS::MEANDER_PLACER_BASE::m_startPad_p, m_tunedPath, m_tunedPathN, m_tunedPathP, PNS::MEANDER_PLACER_BASE::m_world, PNS::ITEM::Net(), PNS::DIFF_PAIR::NetP(), PNS::DIFF_PAIR::NLine(), PNS::ITEM::OfKind(), PNS::DIFF_PAIR::PLine(), PNS::NODE::Remove(), PNS::ALGO_BASE::Router(), PNS::ITEM::SEGMENT_T, PNS::LINE::SegmentCount(), PNS::ROUTER::SetFailureReason(), PNS::DIFF_PAIR::SetGap(), and PNS::LINE::Width().

ToggleVia()

virtual bool PNS::PLACEMENT_ALGO::ToggleVia ( bool  aEnabled )

inlinevirtualinherited

Function ToggleVia()

Enables/disables a via at the end of currently routed trace.

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 94 of file pns_placement_algo.h.

 {
 return false;
 }

Traces()

const ITEM_SET PNS::MEANDER_PLACER::Traces ( )

overridevirtualinherited

Function Traces()

Returns all routed/tuned traces.

Implements PNS::PLACEMENT_ALGO.

Definition at line 250 of file pns_meander_placer.cpp.

{
 m_currentTrace = LINE( m_originLine, m_finalShape );
 return ITEM_SET( &m_currentTrace );
}

References PNS::MEANDER_PLACER::m_currentTrace, PNS::MEANDER_PLACER::m_finalShape, and PNS::MEANDER_PLACER::m_originLine.

tuneLineLength()

void PNS::MEANDER_PLACER_BASE::tuneLineLength ( MEANDERED_LINE &  aTuned, long long int  aElongation  )

protectedinherited

Take a set of meanders in aTuned and tunes their length to extend the original line length by aElongation.

Definition at line 202 of file pns_meander_placer_base.cpp.

{
 long long int maxElongation = 0;
 long long int minElongation = 0;
 bool finished = false;
 
 for( MEANDER_SHAPE* m : aTuned.Meanders() )
 {
 if( m->Type() != MT_CORNER && m->Type() != MT_ARC )
 {
 MEANDER_SHAPE end = *m;
 MEANDER_TYPE endType;
 
 if( m->Type() == MT_START || m->Type() == MT_SINGLE )
 endType = MT_SINGLE;
 else
 endType = MT_FINISH;
 
 end.SetType( endType );
 end.Recalculate();
 
 long long int maxEndElongation = end.CurrentLength() - end.BaselineLength();
 
 if( maxElongation + maxEndElongation > aElongation )
 {
 if( !finished )
 {
 m->SetType( endType );
 m->Recalculate();
 
 if( endType == MT_SINGLE )
 {
 // Check if we need to fit this meander
 long long int endMinElongation =
 ( m->MinTunableLength() - m->BaselineLength() );
 
 if( minElongation + endMinElongation >= aElongation )
 m->MakeEmpty();
 }
 
 finished = true;
 }
 else
 {
 m->MakeEmpty();
 }
 }
 
 maxElongation += m->CurrentLength() - m->BaselineLength();
 minElongation += m->MinTunableLength() - m->BaselineLength();
 }
 }
 
 long long int remainingElongation = aElongation;
 int meanderCount = 0;
 
 for( MEANDER_SHAPE* m : aTuned.Meanders() )
 {
 if( m->Type() != MT_CORNER && m->Type() != MT_ARC && m->Type() != MT_EMPTY )
 {
 remainingElongation -= m->CurrentLength() - m->BaselineLength();
 meanderCount++;
 }
 }
 
 long long int lenReductionLeft = -remainingElongation;
 int meandersLeft = meanderCount;
 
 if( lenReductionLeft < 0 || !meandersLeft )
 return;
 
 for( MEANDER_SHAPE* m : aTuned.Meanders() )
 {
 if( m->Type() != MT_CORNER && m->Type() != MT_ARC && m->Type() != MT_EMPTY )
 {
 long long int lenReductionHere = lenReductionLeft / meandersLeft;
 long long int initialLen = m->CurrentLength();
 int minAmpl = m->MinAmplitude();
 
 int amp = findAmplitudeForLength( m, initialLen - lenReductionHere, minAmpl,
 m->Amplitude() );
 
 if( amp < minAmpl )
 amp = minAmpl;
 
 m->SetTargetBaselineLength( m->BaselineLength() );
 m->Resize( amp );
 
 lenReductionLeft -= initialLen - m->CurrentLength();
 meandersLeft--;
 
 if( !meandersLeft )
 break;
 }
 }
}

References PNS::MEANDER_SHAPE::BaselineLength(), PNS::MEANDER_SHAPE::CurrentLength(), PNS::findAmplitudeForLength(), PNS::MEANDERED_LINE::Meanders(), PNS::MT_ARC, PNS::MT_CORNER, PNS::MT_EMPTY, PNS::MT_FINISH, PNS::MT_SINGLE, PNS::MT_START, PNS::MEANDER_SHAPE::Recalculate(), and PNS::MEANDER_SHAPE::SetType().

Referenced by PNS::MEANDER_PLACER::doMove(), and PNS::DP_MEANDER_PLACER::Move().

TuningInfo()

const wxString PNS::MEANDER_SKEW_PLACER::TuningInfo ( EDA_UNITS  aUnits ) const

overridevirtual

Return a string describing the status and length of the tuned traces.

Reimplemented from PNS::MEANDER_PLACER.

Definition at line 157 of file pns_meander_skew_placer.cpp.

{
 wxString status;
 
 switch( m_lastStatus )
 {
 case TOO_LONG:
 status = _( "Too long: skew " );
 break;
 case TOO_SHORT:
 status = _( "Too short: skew " );
 break;
 case TUNED:
 status = _( "Tuned: skew " );
 break;
 default:
 return _( "?" );
 }
 
 status += EDA_UNIT_UTILS::UI::MessageTextFromValue( pcbIUScale, aUnits, m_lastLength - m_coupledLength );
 status += wxT( "/" );
 status += EDA_UNIT_UTILS::UI::MessageTextFromValue( pcbIUScale, aUnits, m_settings.m_targetSkew );
 
 return status;
}

References _, m_coupledLength, PNS::MEANDER_PLACER::m_lastLength, PNS::MEANDER_PLACER::m_lastStatus, PNS::MEANDER_PLACER_BASE::m_settings, PNS::MEANDER_SETTINGS::m_targetSkew, EDA_UNIT_UTILS::UI::MessageTextFromValue(), pcbIUScale, PNS::MEANDER_PLACER_BASE::TOO_LONG, PNS::MEANDER_PLACER_BASE::TOO_SHORT, and PNS::MEANDER_PLACER_BASE::TUNED.

TuningStatus()

MEANDER_PLACER::TUNING_STATUS PNS::MEANDER_PLACER::TuningStatus ( ) const

overridevirtualinherited

Return the tuning status (too short, too long, etc.) of the trace(s) being tuned.

Implements PNS::MEANDER_PLACER_BASE.

Definition at line 299 of file pns_meander_placer.cpp.

{
 return m_lastStatus;
}

References PNS::MEANDER_PLACER::m_lastStatus.

UnfixRoute()

virtual bool PNS::PLACEMENT_ALGO::UnfixRoute ( )

inlinevirtualinherited

Reimplemented in PNS::LINE_PLACER.

Definition at line 81 of file pns_placement_algo.h.

{ return false; };

UpdateSettings()

void PNS::MEANDER_PLACER_BASE::UpdateSettings ( const MEANDER_SETTINGS &  aSettings )

virtualinherited

Definition at line 84 of file pns_meander_placer_base.cpp.

{
 m_settings = aSettings;
}

References PNS::MEANDER_PLACER_BASE::m_settings.

Referenced by LENGTH_TUNER_TOOL::meanderSettingsDialog(), and LENGTH_TUNER_TOOL::performTuning().

UpdateSizes()

virtual void PNS::PLACEMENT_ALGO::UpdateSizes ( const SIZES_SETTINGS &  aSizes )

inlinevirtualinherited

Function UpdateSizes()

Performs on-the-fly update of the width, via diameter & drill size from a settings class. Used to dynamically change these parameters as the track is routed.

Reimplemented in PNS::DIFF_PAIR_PLACER, and PNS::LINE_PLACER.

Definition at line 178 of file pns_placement_algo.h.

 {
 }

VisibleViewArea()

const BOX2I & PNS::ALGO_BASE::VisibleViewArea ( ) const

inherited

Definition at line 40 of file pns_algo_base.cpp.

{
 return m_router->VisibleViewArea();
}

References PNS::ALGO_BASE::m_router, and PNS::ROUTER::VisibleViewArea().

Referenced by PNS::DRAGGER::optimizeAndUpdateDraggedLine(), and PNS::SHOVE::runOptimizer().

Member Data Documentation

m_coupledLength

long long int PNS::MEANDER_SKEW_PLACER::m_coupledLength

private

Definition at line 62 of file pns_meander_skew_placer.h.

Referenced by currentSkew(), MEANDER_SKEW_PLACER(), Move(), Start(), and TuningInfo().

m_currentEnd

VECTOR2I PNS::MEANDER_PLACER_BASE::m_currentEnd

protectedinherited

Definition at line 164 of file pns_meander_placer_base.h.

Referenced by PNS::DP_MEANDER_PLACER::CurrentEnd(), PNS::MEANDER_PLACER::CurrentEnd(), PNS::MEANDER_PLACER::Start(), and Start().

m_currentNode

NODE* PNS::MEANDER_PLACER::m_currentNode

protectedinherited

Definition at line 111 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::CheckFit(), PNS::MEANDER_PLACER::CommitPlacement(), PNS::MEANDER_PLACER::CurrentNode(), PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::FixRoute(), PNS::MEANDER_PLACER::MEANDER_PLACER(), PNS::MEANDER_PLACER::Start(), and Start().

m_currentStart

VECTOR2I PNS::MEANDER_PLACER::m_currentStart

protectedinherited

Current world state.

Definition at line 108 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::CurrentStart(), PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::Start(), and Start().

m_currentTrace

LINE PNS::MEANDER_PLACER::m_currentTrace

protectedinherited

Definition at line 114 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::FixRoute(), PNS::MEANDER_PLACER::HasPlacedAnything(), and PNS::MEANDER_PLACER::Traces().

m_currentWidth

int PNS::MEANDER_PLACER_BASE::m_currentWidth

protectedinherited

Meander settings.

Definition at line 158 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::Clearance(), PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::MEANDER_PLACER_BASE::SpacingStep(), PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), and Start().

m_debugDecorator

DEBUG_DECORATOR* PNS::ALGO_BASE::m_debugDecorator

protectedinherited

Definition at line 86 of file pns_algo_base.h.

Referenced by PNS::ALGO_BASE::Dbg(), and PNS::ALGO_BASE::SetDebugDecorator().

m_endPad_n

SOLID* PNS::MEANDER_PLACER_BASE::m_endPad_n

protectedinherited

Definition at line 169 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::DP_MEANDER_PLACER::origPathLength(), PNS::MEANDER_PLACER::origPathLength(), origPathLength(), PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), and Start().

m_endPad_p

SOLID* PNS::MEANDER_PLACER_BASE::m_endPad_p

protectedinherited

Definition at line 167 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::DP_MEANDER_PLACER::origPathLength(), origPathLength(), PNS::DP_MEANDER_PLACER::Start(), and Start().

m_finalShape

SHAPE_LINE_CHAIN PNS::MEANDER_PLACER::m_finalShape

protectedinherited

Definition at line 117 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::FixRoute(), and PNS::MEANDER_PLACER::Traces().

m_initialSegment

LINKED_ITEM* PNS::MEANDER_PLACER::m_initialSegment

protectedinherited

Total length added by pad to die size.

Definition at line 119 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::CurrentLayer(), PNS::MEANDER_PLACER::MEANDER_PLACER(), PNS::MEANDER_PLACER::Start(), and Start().

m_lastLength

long long int PNS::MEANDER_PLACER::m_lastLength

protectedinherited

Definition at line 124 of file pns_meander_placer.h.

Referenced by currentSkew(), PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::MEANDER_PLACER(), PNS::MEANDER_PLACER::TuningInfo(), and TuningInfo().

m_lastStatus

TUNING_STATUS PNS::MEANDER_PLACER::m_lastStatus

protectedinherited

Definition at line 125 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::MEANDER_PLACER(), PNS::MEANDER_PLACER::TuningInfo(), TuningInfo(), and PNS::MEANDER_PLACER::TuningStatus().

m_logger

LOGGER* PNS::ALGO_BASE::m_logger

protectedinherited

Definition at line 88 of file pns_algo_base.h.

Referenced by PNS::ALGO_BASE::SetLogger().

m_originLine

LINE PNS::MEANDER_PLACER::m_originLine

protectedinherited

Definition at line 113 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::CheckFit(), PNS::MEANDER_PLACER::CurrentNets(), PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER::FixRoute(), origPathLength(), PNS::MEANDER_PLACER::Start(), Start(), and PNS::MEANDER_PLACER::Traces().

m_originPair

DIFF_PAIR PNS::MEANDER_SKEW_PLACER::m_originPair

private

Definition at line 59 of file pns_meander_skew_placer.h.

Referenced by origPathLength(), and Start().

m_padToDieLength

int PNS::MEANDER_PLACER::m_padToDieLength

protectedinherited

Definition at line 122 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::MEANDER_PLACER(), PNS::MEANDER_PLACER::origPathLength(), and PNS::MEANDER_PLACER::Start().

m_padToDieN

int PNS::MEANDER_SKEW_PLACER::m_padToDieN

private

Definition at line 64 of file pns_meander_skew_placer.h.

Referenced by MEANDER_SKEW_PLACER(), origPathLength(), and Start().

m_padToDieP

int PNS::MEANDER_SKEW_PLACER::m_padToDieP

private

Definition at line 63 of file pns_meander_skew_placer.h.

Referenced by MEANDER_SKEW_PLACER(), origPathLength(), and Start().

m_result

MEANDERED_LINE PNS::MEANDER_PLACER::m_result

protectedinherited

Definition at line 118 of file pns_meander_placer.h.

Referenced by PNS::MEANDER_PLACER::CheckFit(), and PNS::MEANDER_PLACER::doMove().

m_router

ROUTER* PNS::ALGO_BASE::m_router

protectedinherited

Definition at line 87 of file pns_algo_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::lineLength(), PNS::ALGO_BASE::Router(), PNS::ALGO_BASE::Settings(), PNS::DIFF_PAIR_PLACER::updateLeadingRatLine(), PNS::LINE_PLACER::updateLeadingRatLine(), and PNS::ALGO_BASE::VisibleViewArea().

m_settings

MEANDER_SETTINGS PNS::MEANDER_PLACER_BASE::m_settings

protectedinherited

The current end point.

Definition at line 161 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::AmplitudeStep(), PNS::DP_MEANDER_PLACER::CheckFit(), PNS::MEANDER_PLACER::CheckFit(), PNS::MEANDER_PLACER::doMove(), PNS::MEANDER_PLACER_BASE::MeanderSettings(), PNS::DP_MEANDER_PLACER::Move(), PNS::MEANDER_PLACER::Move(), Move(), PNS::MEANDER_PLACER_BASE::SpacingStep(), PNS::DP_MEANDER_PLACER::TuningInfo(), PNS::MEANDER_PLACER::TuningInfo(), TuningInfo(), and PNS::MEANDER_PLACER_BASE::UpdateSettings().

m_startPad_n

SOLID* PNS::MEANDER_PLACER_BASE::m_startPad_n

protectedinherited

Definition at line 168 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::DP_MEANDER_PLACER::origPathLength(), PNS::MEANDER_PLACER::origPathLength(), origPathLength(), PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), and Start().

m_startPad_p

SOLID* PNS::MEANDER_PLACER_BASE::m_startPad_p

protectedinherited

Definition at line 166 of file pns_meander_placer_base.h.

Referenced by PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::DP_MEANDER_PLACER::origPathLength(), origPathLength(), PNS::DP_MEANDER_PLACER::Start(), and Start().

m_tunedPath

ITEM_SET PNS::MEANDER_SKEW_PLACER::m_tunedPath

private

Definition at line 60 of file pns_meander_skew_placer.h.

Referenced by origPathLength(), and Start().

m_tunedPathN

ITEM_SET PNS::MEANDER_SKEW_PLACER::m_tunedPathN

private

Definition at line 60 of file pns_meander_skew_placer.h.

Referenced by Move(), and Start().

m_tunedPathP

ITEM_SET PNS::MEANDER_SKEW_PLACER::m_tunedPathP

private

Definition at line 60 of file pns_meander_skew_placer.h.

Referenced by Move(), and Start().

m_world

NODE* PNS::MEANDER_PLACER_BASE::m_world

protectedinherited

Width of the meandered trace(s).

Definition at line 155 of file pns_meander_placer_base.h.

Referenced by PNS::DP_MEANDER_PLACER::AbortPlacement(), PNS::MEANDER_PLACER::AbortPlacement(), PNS::DP_MEANDER_PLACER::CurrentNode(), PNS::MEANDER_PLACER::CurrentNode(), PNS::MEANDER_PLACER::doMove(), PNS::DP_MEANDER_PLACER::DP_MEANDER_PLACER(), PNS::MEANDER_PLACER_BASE::GetTotalPadToDieLength(), PNS::MEANDER_PLACER_BASE::MEANDER_PLACER_BASE(), PNS::DP_MEANDER_PLACER::Move(), PNS::DP_MEANDER_PLACER::Start(), PNS::MEANDER_PLACER::Start(), and Start().

---

The documentation for this class was generated from the following files:

• pns_meander_skew_placer.h
• pns_meander_skew_placer.cpp