matrix_sparse/Matrix_SymComplexSparse.hxx

00001 // Copyright (C) 2001-2009 Vivien Mallet
00002 //
00003 // This file is part of the linear-algebra library Seldon,
00004 // http://seldon.sourceforge.net/.
00005 //
00006 // Seldon is free software; you can redistribute it and/or modify it under the
00007 // terms of the GNU Lesser General Public License as published by the Free
00008 // Software Foundation; either version 2.1 of the License, or (at your option)
00009 // any later version.
00010 //
00011 // Seldon is distributed in the hope that it will be useful, but WITHOUT ANY
00012 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00013 // FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
00014 // more details.
00015 //
00016 // You should have received a copy of the GNU Lesser General Public License
00017 // along with Seldon. If not, see http://www.gnu.org/licenses/.
00018 
00019 
00020 // To be included by Seldon.hxx
00021 
00022 #ifndef SELDON_FILE_MATRIX_SYMCOMPLEXSPARSE_HXX
00023 
00024 #include "../share/Common.hxx"
00025 #include "../share/Properties.hxx"
00026 #include "../share/Storage.hxx"
00027 #include "../share/Errors.hxx"
00028 #include "../share/Allocator.hxx"
00029 
00030 namespace Seldon
00031 {
00032 
00033 
00035 
00047   template <class T, class Prop, class Storage,
00048             class Allocator = SELDON_DEFAULT_ALLOCATOR<T> >
00049   class Matrix_SymComplexSparse: public Matrix_Base<T, Allocator>
00050   {
00051     // typedef declaration.
00052   public:
00053     typedef typename Allocator::value_type value_type;
00054     typedef typename Allocator::pointer pointer;
00055     typedef typename Allocator::const_pointer const_pointer;
00056     typedef typename Allocator::reference reference;
00057     typedef typename Allocator::const_reference const_reference;
00058     typedef complex<value_type> entry_type;
00059     typedef complex<value_type> access_type;
00060     typedef complex<value_type> const_access_type;
00061 
00062     // Attributes.
00063   protected:
00064     // Number of non-zero (stored) elements.
00065     int real_nz_;
00066     int imag_nz_;
00067     // Index (in data_) of first element stored for each row or column.
00068     int* real_ptr_;
00069     int* imag_ptr_;
00070     // Column or row index (in the matrix) each element.
00071     int* real_ind_;
00072     int* imag_ind_;
00073 
00074     // Data.
00075     T* real_data_;
00076     T* imag_data_;
00077 
00078     // Methods.
00079   public:
00080     // Constructors.
00081     Matrix_SymComplexSparse();
00082     Matrix_SymComplexSparse(int i, int j);
00083     Matrix_SymComplexSparse(int i, int j, int real_nz, int imag_nz);
00084     template <class Storage0, class Allocator0,
00085               class Storage1, class Allocator1,
00086               class Storage2, class Allocator2>
00087     Matrix_SymComplexSparse(int i, int j,
00088                             Vector<T, Storage0, Allocator0>& real_values,
00089                             Vector<int, Storage1, Allocator1>& real_ptr,
00090                             Vector<int, Storage2, Allocator2>& real_ind,
00091                             Vector<T, Storage0, Allocator0>& imag_values,
00092                             Vector<int, Storage1, Allocator1>& imag_ptr,
00093                             Vector<int, Storage2, Allocator2>& imag_ind);
00094     Matrix_SymComplexSparse(const Matrix_SymComplexSparse<T, Prop, Storage,
00095                             Allocator>& A);
00096 
00097     // Destructor.
00098     ~Matrix_SymComplexSparse();
00099     void Clear();
00100 
00101     // Memory management.
00102     template <class Storage0, class Allocator0,
00103               class Storage1, class Allocator1,
00104               class Storage2, class Allocator2>
00105     void SetData(int i, int j,
00106                  Vector<T, Storage0, Allocator0>& real_values,
00107                  Vector<int, Storage1, Allocator1>& real_ptr,
00108                  Vector<int, Storage2, Allocator2>& real_ind,
00109                  Vector<T, Storage0, Allocator0>& imag_values,
00110                  Vector<int, Storage1, Allocator1>& imag_ptr,
00111                  Vector<int, Storage2, Allocator2>& imag_ind);
00112     void SetData(int i, int j,
00113                  int real_nz, pointer real_values, int* real_ptr,
00114                  int* real_ind,
00115                  int imag_nz, pointer imag_values, int* imag_ptr,
00116                  int* imag_ind);
00117     void Nullify();
00118     void Copy(const Matrix_SymComplexSparse<T, Prop, Storage, Allocator>& A);
00119 
00120     // Basic methods.
00121     int GetDataSize() const;
00122     int* GetRealPtr() const;
00123     int* GetImagPtr() const;
00124     int* GetRealInd() const;
00125     int* GetImagInd() const;
00126     int GetRealPtrSize() const;
00127     int GetImagPtrSize() const;
00128     int GetRealIndSize() const;
00129     int GetImagIndSize() const;
00130     T* GetRealData() const;
00131     T* GetImagData() const;
00132 
00133     // Element acess and affectation.
00134     complex<value_type> operator() (int i, int j) const;
00135     complex<value_type>& Val(int i, int j);
00136     const complex<value_type>& Val(int i, int j) const;
00137     Matrix_SymComplexSparse<T, Prop, Storage, Allocator>&
00138     operator= (const Matrix_SymComplexSparse<T, Prop, Storage, Allocator>& A);
00139 
00140     // Convenient functions.
00141     void Print() const;
00142   };
00143 
00144 
00146   template <class T, class Prop, class Allocator>
00147   class Matrix<T, Prop, ColSymComplexSparse, Allocator>:
00148     public Matrix_SymComplexSparse<T, Prop, ColSymComplexSparse, Allocator>
00149   {
00150     // typedef declaration.
00151   public:
00152     typedef typename Allocator::value_type value_type;
00153     typedef Prop property;
00154     typedef ColSymComplexSparse storage;
00155     typedef Allocator allocator;
00156 
00157   public:
00158     Matrix()  throw();
00159     Matrix(int i, int j);
00160     Matrix(int i, int j, int real_nz, int imag_nz);
00161     template <class Storage0, class Allocator0,
00162               class Storage1, class Allocator1,
00163               class Storage2, class Allocator2>
00164     Matrix(int i, int j,
00165            Vector<T, Storage0, Allocator0>& real_values,
00166            Vector<int, Storage1, Allocator1>& real_ptr,
00167            Vector<int, Storage2, Allocator2>& real_ind,
00168            Vector<T, Storage0, Allocator0>& imag_values,
00169            Vector<int, Storage1, Allocator1>& imag_ptr,
00170            Vector<int, Storage2, Allocator2>& imag_ind);
00171   };
00172 
00173 
00175   template <class T, class Prop, class Allocator>
00176   class Matrix<T, Prop, RowSymComplexSparse, Allocator>:
00177     public Matrix_SymComplexSparse<T, Prop, RowSymComplexSparse, Allocator>
00178   {
00179     // typedef declaration.
00180   public:
00181     typedef typename Allocator::value_type value_type;
00182     typedef Prop property;
00183     typedef RowSymComplexSparse storage;
00184     typedef Allocator allocator;
00185 
00186   public:
00187     Matrix()  throw();
00188     Matrix(int i, int j);
00189     Matrix(int i, int j, int real_nz, int imag_nz);
00190     template <class Storage0, class Allocator0,
00191               class Storage1, class Allocator1,
00192               class Storage2, class Allocator2>
00193     Matrix(int i, int j,
00194            Vector<T, Storage0, Allocator0>& values,
00195            Vector<int, Storage1, Allocator1>& ptr,
00196            Vector<int, Storage2, Allocator2>& ind,
00197            Vector<T, Storage0, Allocator0>& imag_values,
00198            Vector<int, Storage1, Allocator1>& imag_ptr,
00199            Vector<int, Storage2, Allocator2>& imag_ind);
00200   };
00201 
00202 
00203 } // namespace Seldon.
00204 
00205 #define SELDON_FILE_MATRIX_SYMCOMPLEXSPARSE_HXX
00206 #endif