matrix/Matrix_Symmetric.hxx

00001 // Copyright (C) 2001-2009 Vivien Mallet
00002 // Copyright (C) 2003-2009 Marc Duruflé
00003 //
00004 // This file is part of the linear-algebra library Seldon,
00005 // http://seldon.sourceforge.net/.
00006 //
00007 // Seldon is free software; you can redistribute it and/or modify it under the
00008 // terms of the GNU Lesser General Public License as published by the Free
00009 // Software Foundation; either version 2.1 of the License, or (at your option)
00010 // any later version.
00011 //
00012 // Seldon is distributed in the hope that it will be useful, but WITHOUT ANY
00013 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00014 // FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
00015 // more details.
00016 //
00017 // You should have received a copy of the GNU Lesser General Public License
00018 // along with Seldon. If not, see http://www.gnu.org/licenses/.
00019 
00020 
00021 // To be included by Seldon.hxx
00022 
00023 #ifndef SELDON_FILE_MATRIX_SYMMETRIC_HXX
00024 
00025 #include "../share/Common.hxx"
00026 #include "../share/Properties.hxx"
00027 #include "../share/Storage.hxx"
00028 #include "../share/Errors.hxx"
00029 #include "../share/Allocator.hxx"
00030 
00031 namespace Seldon
00032 {
00033 
00034 
00036   template <class T, class Prop, class Storage,
00037             class Allocator = SELDON_DEFAULT_ALLOCATOR<T> >
00038   class Matrix_Symmetric: public Matrix_Base<T, Allocator>
00039   {
00040     // typedef declaration.
00041   public:
00042     typedef typename Allocator::value_type value_type;
00043     typedef typename Allocator::pointer pointer;
00044     typedef typename Allocator::const_pointer const_pointer;
00045     typedef typename Allocator::reference reference;
00046     typedef typename Allocator::const_reference const_reference;
00047     typedef typename Allocator::value_type entry_type;
00048     typedef typename Allocator::value_type access_type;
00049     typedef typename Allocator::value_type const_access_type;
00050 
00051     // Attributes.
00052   protected:
00053     pointer* me_;
00054 
00055     // Methods.
00056   public:
00057     // Constructor.
00058     Matrix_Symmetric();
00059     Matrix_Symmetric(int i, int j);
00060     Matrix_Symmetric(const Matrix_Symmetric<T, Prop, Storage, Allocator>& A);
00061 
00062     // Destructor.
00063     ~Matrix_Symmetric();
00064     void Clear();
00065 
00066     // Basic methods.
00067     int GetDataSize() const;
00068 
00069     // Memory management.
00070     void Reallocate(int i, int j);
00071     void SetData(int i, int j, pointer data);
00072     void Nullify();
00073     void Resize(int i, int j);
00074 
00075     // Element access and affectation.
00076     value_type operator() (int i, int j);
00077     value_type operator() (int i, int j) const;
00078     const_reference Val(int i, int j) const;
00079     reference Val(int i, int j);
00080     reference operator[] (int i);
00081     const_reference operator[] (int i) const;
00082     Matrix_Symmetric<T, Prop, Storage, Allocator>&
00083     operator= (const Matrix_Symmetric<T, Prop, Storage, Allocator>& A);
00084     void Copy(const Matrix_Symmetric<T, Prop, Storage, Allocator>& A);
00085 
00086     // Convenient functions.
00087     void Zero();
00088     void SetIdentity();
00089     void Fill();
00090     template <class T0>
00091     void Fill(const T0& x);
00092     template <class T0>
00093     Matrix_Symmetric<T, Prop, Storage, Allocator>& operator= (const T0& x);
00094     void FillRand();
00095     void Print() const;
00096     void Print(int a, int b, int m, int n) const;
00097     void Print(int l) const;
00098 
00099     // Input/output functions.
00100     void Write(string FileName) const;
00101     void Write(ostream& FileStream) const;
00102     void WriteText(string FileName) const;
00103     void WriteText(ostream& FileStream) const;
00104     void Read(string FileName);
00105     void Read(istream& FileStream);
00106     void ReadText(string FileName);
00107     void ReadText(istream& FileStream);
00108 
00109   };
00110 
00111 
00113   template <class T, class Prop, class Allocator>
00114   class Matrix<T, Prop, ColSym, Allocator>:
00115     public Matrix_Symmetric<T, Prop, ColSym, Allocator>
00116   {
00117     // typedef declaration.
00118   public:
00119     typedef typename Allocator::value_type value_type;
00120     typedef Prop property;
00121     typedef ColSym storage;
00122     typedef Allocator allocator;
00123 
00124   public:
00125     Matrix()  throw();
00126     Matrix(int i, int j);
00127 
00128     template <class T0>
00129     Matrix<T, Prop, ColSym, Allocator>& operator= (const T0& x);
00130     template<class T0>
00131     Matrix<T, Prop, ColSym, Allocator>& operator*= (const T0& x);
00132 
00133   };
00134 
00135 
00137   template <class T, class Prop, class Allocator>
00138   class Matrix<T, Prop, RowSym, Allocator>:
00139     public Matrix_Symmetric<T, Prop, RowSym, Allocator>
00140   {
00141     // typedef declaration.
00142   public:
00143     typedef typename Allocator::value_type value_type;
00144     typedef Prop property;
00145     typedef RowSym storage;
00146     typedef Allocator allocator;
00147 
00148   public:
00149     Matrix()  throw();
00150     Matrix(int i, int j);
00151 
00152     template <class T0>
00153     Matrix<T, Prop, RowSym, Allocator>& operator= (const T0& x);
00154     template<class T0>
00155     Matrix<T, Prop, RowSym, Allocator>& operator*= (const T0& x);
00156 
00157   };
00158 
00159 
00160 } // namespace Seldon.
00161 
00162 #define SELDON_FILE_MATRIX_SYMMETRIC_HXX
00163 #endif