pns_topology.h

Go to the documentation of this file.

/*
 * KiRouter - a push-and-(sometimes-)shove PCB router
 *
 * Copyright (C) 2013-2015 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 * Author: Tomasz Wlostowski <[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, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef __PNS_TOPOLOGY_H
#define __PNS_TOPOLOGY_H
 
#include <vector>
#include <set>
 
#include "pns_itemset.h"
 
namespace PNS {
 
class NODE;
class SEGMENT;
class JOINT;
class ITEM;
class SOLID;
class DIFF_PAIR;
class ROUTER_IFACE;
class LINKED_ITEM;
class VIA;
 
class TOPOLOGY
{
public:
 
    struct CLUSTER
    {
        const ITEM* m_key = nullptr;
        std::vector<ITEM*> m_items;
    };
 
    typedef std::set<const JOINT*> JOINT_SET;
 
    TOPOLOGY( NODE* aNode ):
        m_world( aNode ) {};
 
    ~TOPOLOGY() {};
 
    bool SimplifyLine( LINE *aLine );
    ITEM* NearestUnconnectedItem( const JOINT* aStart, int* aAnchor = nullptr,
                                  int aKindMask = ITEM::ANY_T );
 
    bool NearestUnconnectedAnchorPoint( const LINE* aTrack, VECTOR2I& aPoint, PNS_LAYER_RANGE& aLayers,
                                        ITEM*& aItem );
    bool LeadingRatLine( const LINE* aTrack, SHAPE_LINE_CHAIN& aRatLine );
 
    const JOINT_SET ConnectedJoints( const JOINT* aStart );
    const ITEM_SET ConnectedItems( const JOINT* aStart, int aKindMask = ITEM::ANY_T );
    const ITEM_SET ConnectedItems( ITEM* aStart, int aKindMask = ITEM::ANY_T );
    int64_t ShortestConnectionLength( ITEM* aFrom, ITEM* aTo );

    const ITEM_SET AssembleTrivialPath( ITEM* aStart,
                                        std::pair<const JOINT*, const JOINT*>* aTerminalJoints = nullptr,
                                        bool aFollowLockedSegments = false );

    const ITEM_SET AssembleTuningPath( ROUTER_IFACE* aRouterIface, ITEM* aStart, SOLID** aStartPad = nullptr,
                                       SOLID** aEndPad = nullptr );
 
    const DIFF_PAIR AssembleDiffPair( SEGMENT* aStart );
 
    bool AssembleDiffPair( ITEM* aStart, DIFF_PAIR& aPair );
 
    const CLUSTER AssembleCluster( ITEM* aStart, int aLayer, double aAreaExpansionLimit = 0.0, NET_HANDLE aExcludedNet = nullptr );
 
private:
    const int DP_PARALLELITY_THRESHOLD = 5;
 
    struct PATH_RESULT
    {
        ITEM_SET    m_items;
        const JOINT* m_end;
        int         m_length;
 
        PATH_RESULT() : m_end( nullptr ), m_length( 0 ) {}
    };
 
    struct WALK_RESULT
    {
        ITEM_SET m_items;
        SOLID*   m_endPad;
        int64_t  m_length;
 
        WALK_RESULT() :
                m_endPad( nullptr ),
                m_length( -1 )
        {
        }
    };
 
    std::vector<LINE> findLinesFromVia( ROUTER_IFACE* aRouterIface, VIA* aVia, const std::set<ITEM*>& aVisited );
 
    WALK_RESULT walkTuningPath( ROUTER_IFACE* aRouterIface, LINE& aStartLine, bool aStartFromBack,
                                const std::set<ITEM*>& aVisited );
 
    PATH_RESULT followBranch( const JOINT* aStartJoint, LINKED_ITEM* aPrev,
                              std::set<ITEM*>& aVisited, bool aFollowLockedSegments );
 
    ITEM_SET followTrivialPath( LINE* aLine, const JOINT** aTerminalJointA,
                                const JOINT** aTerminalJointB,
                                bool aFollowLockedSegments = false );
 
    NODE *m_world;
};
 
}
 
#endif