//===========================================================================
//  $Name:  $
//  $Id: ArtsNetMatrix.hh,v 1.1.1.1 2000/03/29 22:53:58 kkeys Exp $
//===========================================================================
//  CAIDA Copyright Notice
//
//  By accessing this software, arts++, you are duly informed
//  of and agree to be bound by the conditions described below in this
//  notice:
//
//  This software product, arts++, is developed by Daniel W. McRobb, and
//  copyrighted(C) 1998 by the University of California, San Diego
//  (UCSD), with all rights reserved.  UCSD administers the CAIDA grant,
//  NCR-9711092, under which part of this code was developed.
//
//  There is no charge for arts++ software. You can redistribute it
//  and/or modify it under the terms of the GNU General Public License,
//  v.  2 dated June 1991 which is incorporated by reference herein.
//  arts++ is distributed WITHOUT ANY WARRANTY, IMPLIED OR EXPRESS, OF
//  MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE or that the use
//  of it will not infringe on any third party's intellectual property
//  rights.
//
//  You should have received a copy of the GNU GPL along with arts++.
//  Copies can also be obtained from:
//
//    http://www.gnu.org/copyleft/gpl.html
//
//  or by writing to:
//
//    University of California, San Diego
//
//    SDSC/CAIDA
//    9500 Gilman Dr., MS-0505
//    La Jolla, CA 92093 - 0505  USA
//
//  Or contact:
//
//    info@caida.org
//===========================================================================

#ifndef _ARTSNETMATRIX_HH_
#define _ARTSNETMATRIX_HH_

extern "C" {
#include <sys/time.h>
#include "caida_t.h"
}

#include "Arts.hh"

//---------------------------------------------------------------------------
//  class ArtsNetMatrix : public Arts
//---------------------------------------------------------------------------
//  This class abstracts net matrix data.  Net matrix data contains
//  packet and byte counters for traffic sent from a source network/mask
//  to a destination network/mask.
//---------------------------------------------------------------------------
class ArtsNetMatrix : public Arts
{
public:
  //-------------------------------------------------------------------------
  //                             ArtsNetMatrix()
  //.........................................................................
  //  constructor
  //-------------------------------------------------------------------------
  ArtsNetMatrix();

  //-------------------------------------------------------------------------
  //                             ~ArtsNetMatrix()
  //.........................................................................
  //  destructor
  //-------------------------------------------------------------------------
  ~ArtsNetMatrix();

  //-------------------------------------------------------------------------
  //                  inline uint16_t SampleInterval() const                 
  //.........................................................................
  //  Returns the sampling ratio if the net matrix was built using packet
  //  sampling techniques.  Normally this value is 1, meaning we're working
  //  with complete data sets (for example, from Cisco flow-export).
  //-------------------------------------------------------------------------
  inline uint16_t SampleInterval() const
  {
    return(this->NetMatrixData()->SampleInterval());
  }

  //-------------------------------------------------------------------------
  //         inline uint16_t SampleInterval(uint16_t sampleInterval)         
  //.........................................................................
  //  Sets and returns the sampling ratio if the net matrix was built using
  //  packet sampling techniques.  Normally this value is 1, meaning we're
  //  working with complete data sets (for example, from Cisco flow-export).
  //-------------------------------------------------------------------------
  inline uint16_t SampleInterval(uint16_t sampleInterval)
  {
    return(this->NetMatrixData()->SampleInterval(sampleInterval));
  }

  //-------------------------------------------------------------------------
  //                      inline uint32_t Count() const                      
  //.........................................................................
  //  Returns the number of net matrix entries (cells) in an
  //  ArtsNetMatrix object.
  //-------------------------------------------------------------------------
  inline uint32_t Count() const
  {
    return(this->NetMatrixData()->Count());
  }

  //-------------------------------------------------------------------------
  //                  inline uint32_t Count(uint32_t count)                  
  //.........................................................................
  //  Sets and Returns the number of net matrix entries (cells) in an
  //  ArtsNetMatrix object.
  //-------------------------------------------------------------------------
  inline uint32_t Count(uint32_t count)
  {
    return(this->NetMatrixData()->Count(count));
  }

  //-------------------------------------------------------------------------
  //                    inline uint64_t TotalPkts() const
  //.........................................................................
  //  Returns the total packets of traffic in the ArtsNetMatrix object.
  //  The total is the sum of all traffic from each source to each
  //  destination.
  //-------------------------------------------------------------------------
  inline uint64_t TotalPkts() const
  {
    return(this->NetMatrixData()->TotalPkts());
  }

  //-------------------------------------------------------------------------
  //              inline uint64_t TotalPkts(uint64_t totalPkts)              
  //.........................................................................
  //  Sets and returns the total packets of traffic in the ArtsNetMatrixData
  //  object.  The total is the sum of all traffic from each source to each
  //  destination.
  //-------------------------------------------------------------------------
  inline uint64_t TotalPkts(uint64_t totalPkts)
  {
    return(this->NetMatrixData()->TotalPkts(totalPkts));
  }
  
  //-------------------------------------------------------------------------
  //                    inline uint64_t TotalBytes() const
  //.........................................................................
  //  Returns the total bytes of traffic in the ArtsNetMatrix object.
  //  The total is the sum of all traffic from each source to each
  //  destination.
  //-------------------------------------------------------------------------
  inline uint64_t TotalBytes() const
  {
    return(this->NetMatrixData()->TotalBytes());
  }

  //-------------------------------------------------------------------------
  //             inline uint64_t TotalBytes(uint64_t totalBytes)             
  //.........................................................................
  //  Sets and returns the total bytes of traffic in the ArtsNetMatrix
  //  object.  The total is the sum of all traffic from each source to each
  //  destination.
  //-------------------------------------------------------------------------
  inline uint64_t TotalBytes(uint64_t totalBytes)
  {
    return(this->NetMatrixData()->TotalBytes(totalBytes));
  }

  //-------------------------------------------------------------------------
  //          inline vector<ArtsNetMatrixEntry> & NetEntries() const
  //.........................................................................
  //  Return a reference to the vector of ArtsNetMatrixEntry objects.  Note
  //  that even though this member may be called from a const object, the
  //  returned reference is not const; the vector is mutable.
  //-------------------------------------------------------------------------
  inline vector<ArtsNetMatrixEntry> & NetEntries() const
  {
    return(this->NetMatrixData()->NetEntries());
  }
};


#endif  // _ARTSNETMATRIX_HH_