Lattice.cxx

Go to the documentation of this file.

// $Id: Lattice.cxx,v 1.3 2001/03/28 19:08:06 bv Exp $
//
// Lattice
//
// Begin_Html<img src="../../pedestrians.gif" align=center>
// <a href="../source_warning.html">Warning for beginners</a>.<br>
// Also see <a href="../../root_crib/index.html">The ROOT Crib</a> and
// <a href="../index.html">The MINOS Class User Guide</a>End_Html
//
// N. West 03/2000
//
// Purpose:
//

#include "Lattice/Lattice.h"
#include "MessageService/MsgService.h"
 
//   Definition of static data members
//   *********************************

CVSID("$Id: Lattice.cxx,v 1.3 2001/03/28 19:08:06 bv Exp $");

// Definition of member functions (alphabetical order)
// ***************************************************

//.....................................................................

Lattice::Link* Lattice::ConnectLR(ID leftID,
                        ID rightID) {

//  Purpose:   Connect left and right IDs forcing a new link
//  Arguments:
//            leftID  in   left ID
//            rightID in   right ID
//  Return:   Connecting link.

//  Contact:   N. West


//  If necessary create nodes corresponding to IDs.

  if ( ! LatticeBase::leftNode(leftID)   
                               ) LatticeBase::newLeftNode(leftID);
  if ( ! LatticeBase::rightNode(rightID) 
                               ) LatticeBase::newRightNode(rightID);


//  Make the connection 

  return LatticeBase::connect( leftID, rightID );

}
//.....................................................................

Lattice::Link* Lattice::ConnectLR(ID leftID,
                                  Link* link,
                                  ID rightID) {

//  Purpose:   Connect left and right IDs reusing existing 
//             link if possible.
//  Arguments:
//            leftID in    left ID
//            link   in    link to be used. If =0 then reuse any
//                         link from either side or create if none.
//            rightID in   right ID
//  Return:   Connecting link.

//  Contact:   N. West


//  If necessary create nodes corresponding to IDs.

  LeftNode*  pLN   = LatticeBase::leftNode(leftID);
  LeftNode*  lNode = (pLN)? pLN : LatticeBase::newLeftNode(leftID);
                     
  RightNode* pRN   = LatticeBase::rightNode(rightID);
  RightNode* rNode = (pRN)? pRN : LatticeBase::newRightNode(rightID);


//  If user has not supplied a Link see if either node already 
//  has a Link we can reuse.

  if ( ! link ) {  
    const Links& links = lNode->links();
    if ( links.size() != 0 ) link = *links.begin();
  }
  if ( ! link ) {  
    const Links& links = rNode->links();
    if ( links.size() != 0 ) link = *links.begin();
  }


//  Make the connection (LatticeBase will create link if stll none).

  return LatticeBase::connect( leftID, link, rightID );

}
//.....................................................................

Lattice::Link* Lattice::Connect(ESide side,
                                ID nearID, 
                                ID farID) {

//  Purpose:   Starting from side connect near to far forcing a 
  //           new link
//  Arguments:
//            side    in   Start side (either kLeft or kRight)
//            nearID  in   ID of near side
//            farID   in   ID of far side
//  Return:   Connecting link.

//  Contact:   N. West


   return ( side == kLeft ) ? ConnectLR( nearID, farID ) 
                            : ConnectLR( farID,  nearID);

}

//.....................................................................

Lattice::Link* Lattice::Connect(ESide side, 
                                ID nearID, 
                                Link* link, 
                                ID farID) {

//  Purpose:   Starting from side connect near to far reusing existing 
//             link if possible.
//  Arguments:
//            side    in   Start side (either kLeft or kRight)
//            nearID  in   ID of near side
//            link    in   link to be used. If =0 then reuse any
//                         link from either side or create if none.
//            in  farID    ID of far side
//  Return:   Connecting link.

//  Contact:   N. West


   return ( side == kLeft ) ? ConnectLR( nearID, link, farID ) 
                            : ConnectLR( farID,  link, nearID);

}

//.....................................................................

void Lattice::GetAllIDs( ESide side, 
                         VectorID& ids ) const {

//  Purpose:   Get vector of all IDs.
//  Arguments:
//            side  in   Side whose IDs are required (either kLeft 
//                       or kRight).
//            ids   in   User supplied vector(contents ignored)
//                  out  Vector of all IDs.
//  Return:    n/a

//  Contact:   N. West

  if ( side == kLeft ) ids = LatticeBase::vLeftID();
  else                 ids = LatticeBase::vRightID();

}
//.....................................................................

void Lattice::GetNearIDs( ESide side, 
                          ID startFrom,
                          VectorID& ids ) const {

//  Purpose:   Get vector of IDs connected locally (i.e. on this side
//             of the lattice) to startForm.
//  Arguments:
//            side  in   Side of startFrom ID (either kLeft or kRight).
//            startFrom
//                  in   ID to start from. 
//            ids   in   User supplied vector(contents ignored)
//                  out  Vector of IDs connected locally to startFrom.
//  Return:    n/a

//  Contact:   N. West

  if ( side == kLeft ) ids = *LatticeBase::vLeftGivenLeft(startFrom);
  else                 ids = *LatticeBase::vRightGivenRight(startFrom);

}

//.....................................................................

void Lattice::GetFarIDs( ESide side, 
                         ID startFrom,
                         VectorID& ids ) const {

//  Purpose:   Get vector of IDs connected remotely (i.e. across the
//             lattice) to startForm.
//  Arguments:
//            side  in   Side of startFrom ID (either kLeft or kRight).
//            startFrom
//                  in   ID to start from. 
//            ids   in   User supplied vector(contents ignored)
//                  out  Vector of IDs connected remotely to startFrom.
//  Return:    

//  Contact:   N. West

  const VectorID* idsPtr;
  if ( side == kLeft ) idsPtr = LatticeBase::vRightGivenLeft(startFrom);
  else                 idsPtr = LatticeBase::vLeftGivenRight(startFrom);
  if ( idsPtr ) ids = *idsPtr;
  else          ids.clear();
}

//.....................................................................

Lattice::Lattice(const Text_t* lName,
                 const Text_t* rName,
                 Topology i /*=  LatticeBase::Default*/,
                 Topology j /*=  LatticeBase::Default*/,
                 Topology k /*=  LatticeBase::Default*/,
                 Topology l /*=  LatticeBase::Default*/) :
LatticeBase(i,j,k,l)

//  Purpose:   Constructor
//  Arguments: Lattice topology
//            
//  Return:    n/a

//  Contact:   N. West

  {
    fLeftName  = *lName;
    fRightName = *rName;

    MSG("Lat",Msg::kDebug) << "Creating lattice between " << lName
                     << " and " << rName << endl;
  }

//.....................................................................

Lattice::~Lattice() {}

//  Purpose:   Destructor
//  Arguments: n/a
//            
//  Return:    n/a

//  Contact:   N. West



// ********************************************************************

//.....................................................................


//  Purpose:   
//  Arguments:
//            
//  Return:    

//  Contact:   N. West

//.....................................................................

---