Zoltan2
Zoltan2_VectorAdapter.hpp
Go to the documentation of this file.
00001 // @HEADER
00002 //
00003 // ***********************************************************************
00004 //
00005 //   Zoltan2: A package of combinatorial algorithms for scientific computing
00006 //                  Copyright 2012 Sandia Corporation
00007 //
00008 // Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
00009 // the U.S. Government retains certain rights in this software.
00010 //
00011 // Redistribution and use in source and binary forms, with or without
00012 // modification, are permitted provided that the following conditions are
00013 // met:
00014 //
00015 // 1. Redistributions of source code must retain the above copyright
00016 // notice, this list of conditions and the following disclaimer.
00017 //
00018 // 2. Redistributions in binary form must reproduce the above copyright
00019 // notice, this list of conditions and the following disclaimer in the
00020 // documentation and/or other materials provided with the distribution.
00021 //
00022 // 3. Neither the name of the Corporation nor the names of the
00023 // contributors may be used to endorse or promote products derived from
00024 // this software without specific prior written permission.
00025 //
00026 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
00027 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00028 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
00029 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
00030 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
00031 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
00032 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
00033 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
00034 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
00035 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
00036 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00037 //
00038 // Questions? Contact Karen Devine      (kddevin@sandia.gov)
00039 //                    Erik Boman        (egboman@sandia.gov)
00040 //                    Siva Rajamanickam (srajama@sandia.gov)
00041 //
00042 // ***********************************************************************
00043 //
00044 // @HEADER
00045 
00051 #ifndef _ZOLTAN2_VECTORADAPTER_HPP_
00052 #define _ZOLTAN2_VECTORADAPTER_HPP_
00053 
00054 #include <Zoltan2_Adapter.hpp>
00055 
00056 namespace Zoltan2 {
00057 
00101 template <typename User>
00102   class VectorAdapter : public BaseAdapter<User> {
00103 private:
00104 
00105 public:
00106 
00107 #ifndef DOXYGEN_SHOULD_SKIP_THIS
00108   typedef typename InputTraits<User>::scalar_t scalar_t;
00109   typedef typename InputTraits<User>::lno_t    lno_t;
00110   typedef typename InputTraits<User>::gno_t    gno_t;
00111   typedef typename InputTraits<User>::zgid_t    zgid_t;
00112   typedef typename InputTraits<User>::part_t   part_t;
00113   typedef typename InputTraits<User>::node_t   node_t;
00114   typedef User user_t;
00115   typedef User userCoord_t;
00116 #endif
00117 
00120   virtual ~VectorAdapter() {};
00121 
00123   // The Adapter interface.
00125 
00126   enum BaseAdapterType adapterType() const {return VectorAdapterType;}
00127 
00129   // User's adapter interface:
00130   // The user must implement these methods in his VectorAdapter
00132 
00135   virtual int getNumEntriesPerID() const = 0;
00136 
00146   virtual void getEntriesView(const scalar_t *&elements, int &stride,
00147                               int idx = 0) const = 0;
00148 
00150   // Handy pseudonyms, since vectors are often used as coordinates
00151   // User should not implement these methods.
00153 
00154   inline int getDimension() const {return getNumEntriesPerID();}
00155 
00156   inline void getCoordinatesView(const scalar_t *&elements, int &stride,
00157                                  int idx = 0) const
00158   {
00159     getEntriesView(elements, stride, idx);
00160   }
00161 };
00162 
00163 
00164 }  //namespace Zoltan2
00165 
00166 #endif