Chris@49: // Copyright (C) 2008-2012 NICTA (www.nicta.com.au)
Chris@49: // Copyright (C) 2008-2012 Conrad Sanderson
Chris@49: // Copyright (C) 2009-2010 Ian Cullinan
Chris@49: // Copyright (C) 2012 Ryan Curtin
Chris@49: // Copyright (C) 2013 Szabolcs Horvat
Chris@49: // 
Chris@49: // This Source Code Form is subject to the terms of the Mozilla Public
Chris@49: // License, v. 2.0. If a copy of the MPL was not distributed with this
Chris@49: // file, You can obtain one at http://mozilla.org/MPL/2.0/.
Chris@49: 
Chris@49: 
Chris@49: //! \addtogroup diskio
Chris@49: //! @{
Chris@49: 
Chris@49: 
Chris@49: //! class for saving and loading matrices and fields
Chris@49: class diskio
Chris@49:   {
Chris@49:   public:
Chris@49:   
Chris@49:   template<typename eT> inline static std::string gen_txt_header(const Mat<eT>& x);
Chris@49:   template<typename eT> inline static std::string gen_bin_header(const Mat<eT>& x);
Chris@49:   
Chris@49:   template<typename eT> inline static std::string gen_bin_header(const SpMat<eT>& x);
Chris@49: 
Chris@49:   template<typename eT> inline static std::string gen_txt_header(const Cube<eT>& x);
Chris@49:   template<typename eT> inline static std::string gen_bin_header(const Cube<eT>& x);
Chris@49:   
Chris@49:   inline static file_type guess_file_type(std::istream& f);
Chris@49:   
Chris@49:   inline static char conv_to_hex_char(const u8 x);
Chris@49:   inline static void conv_to_hex(char* out, const u8 x);
Chris@49:   
Chris@49:   inline static std::string gen_tmp_name(const std::string& x);
Chris@49:   
Chris@49:   inline static bool safe_rename(const std::string& old_name, const std::string& new_name);
Chris@49:   
Chris@49:   template<typename eT> inline static bool convert_naninf(eT&              val, const std::string& token);
Chris@49:   template<typename  T> inline static bool convert_naninf(std::complex<T>& val, const std::string& token);
Chris@49:   
Chris@49:   //
Chris@49:   // matrix saving
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_raw_ascii  (const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_raw_binary (const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_arma_ascii (const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_csv_ascii  (const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_pgm_binary (const Mat<eT>&                x, const std::string& final_name);
Chris@49:   template<typename  T> inline static bool save_pgm_binary (const Mat< std::complex<T> >& x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_hdf5_binary(const Mat<eT>&                x, const std::string& final_name);
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_raw_ascii  (const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_raw_binary (const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_arma_ascii (const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_csv_ascii  (const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_pgm_binary (const Mat<eT>&                x, std::ostream& f);
Chris@49:   template<typename  T> inline static bool save_pgm_binary (const Mat< std::complex<T> >& x, std::ostream& f);
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // matrix loading
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_raw_ascii  (Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_raw_binary (Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_ascii (Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_csv_ascii  (Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_pgm_binary (Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename  T> inline static bool load_pgm_binary (Mat< std::complex<T> >& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_hdf5_binary(Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_auto_detect(Mat<eT>&                x, const std::string& name, std::string& err_msg);
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_raw_ascii  (Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_raw_binary (Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_ascii (Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_csv_ascii  (Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_pgm_binary (Mat<eT>&                x, std::istream& is, std::string& err_msg);
Chris@49:   template<typename  T> inline static bool load_pgm_binary (Mat< std::complex<T> >& x, std::istream& is, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_auto_detect(Mat<eT>&                x, std::istream& f,  std::string& err_msg);
Chris@49:   
Chris@49:   inline static void pnm_skip_comments(std::istream& f);
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // sparse matrix saving
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_coord_ascii(const SpMat<eT>& x, const std::string& final_name);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const SpMat<eT>& x, const std::string& final_name);
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_coord_ascii(const SpMat<eT>& x,                std::ostream& f);
Chris@49:   template<typename  T> inline static bool save_coord_ascii(const SpMat< std::complex<T> >& x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const SpMat<eT>& x,                std::ostream& f);
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // sparse matrix loading
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_coord_ascii(SpMat<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(SpMat<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_coord_ascii(SpMat<eT>& x,                std::istream& f, std::string& err_msg);
Chris@49:   template<typename  T> inline static bool load_coord_ascii(SpMat< std::complex<T> >& x, std::istream& f, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(SpMat<eT>& x,                std::istream& f, std::string& err_msg);
Chris@49:   
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // cube saving
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_raw_ascii  (const Cube<eT>& x, const std::string& name);
Chris@49:   template<typename eT> inline static bool save_raw_binary (const Cube<eT>& x, const std::string& name);
Chris@49:   template<typename eT> inline static bool save_arma_ascii (const Cube<eT>& x, const std::string& name);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const Cube<eT>& x, const std::string& name);
Chris@49:   template<typename eT> inline static bool save_hdf5_binary(const Cube<eT>& x, const std::string& name);
Chris@49:   
Chris@49:   template<typename eT> inline static bool save_raw_ascii  (const Cube<eT>& x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_raw_binary (const Cube<eT>& x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_arma_ascii (const Cube<eT>& x, std::ostream& f);
Chris@49:   template<typename eT> inline static bool save_arma_binary(const Cube<eT>& x, std::ostream& f);
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // cube loading
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_raw_ascii  (Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_raw_binary (Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_ascii (Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_hdf5_binary(Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_auto_detect(Cube<eT>& x, const std::string& name, std::string& err_msg);
Chris@49:   
Chris@49:   template<typename eT> inline static bool load_raw_ascii  (Cube<eT>& x, std::istream& f, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_raw_binary (Cube<eT>& x, std::istream& f, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_ascii (Cube<eT>& x, std::istream& f, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_arma_binary(Cube<eT>& x, std::istream& f, std::string& err_msg);
Chris@49:   template<typename eT> inline static bool load_auto_detect(Cube<eT>& x, std::istream& f, std::string& err_msg);
Chris@49:   
Chris@49:   
Chris@49:   //
Chris@49:   // field saving and loading
Chris@49:   
Chris@49:   template<typename T1> inline static bool save_arma_binary(const field<T1>& x, const std::string&  name);
Chris@49:   template<typename T1> inline static bool save_arma_binary(const field<T1>& x,       std::ostream& f);
Chris@49:   
Chris@49:   template<typename T1> inline static bool load_arma_binary(      field<T1>& x, const std::string&  name, std::string& err_msg);
Chris@49:   template<typename T1> inline static bool load_arma_binary(      field<T1>& x,       std::istream& f,    std::string& err_msg);
Chris@49:   
Chris@49:   template<typename T1> inline static bool load_auto_detect(      field<T1>& x, const std::string&  name, std::string& err_msg);
Chris@49:   template<typename T1> inline static bool load_auto_detect(      field<T1>& x,       std::istream& f,    std::string& err_msg);
Chris@49:   
Chris@49:   inline static bool save_std_string(const field<std::string>& x, const std::string&  name);
Chris@49:   inline static bool save_std_string(const field<std::string>& x,       std::ostream& f);
Chris@49:   
Chris@49:   inline static bool load_std_string(      field<std::string>& x, const std::string&  name, std::string& err_msg);
Chris@49:   inline static bool load_std_string(      field<std::string>& x,       std::istream& f,    std::string& err_msg);
Chris@49:   
Chris@49: 
Chris@49: 
Chris@49:   //
Chris@49:   // handling of PPM images by cubes
Chris@49: 
Chris@49:   template<typename T1> inline static bool save_ppm_binary(const Cube<T1>& x, const std::string&  final_name);
Chris@49:   template<typename T1> inline static bool save_ppm_binary(const Cube<T1>& x,       std::ostream& f);
Chris@49:   
Chris@49:   template<typename T1> inline static bool load_ppm_binary(      Cube<T1>& x, const std::string&  final_name, std::string& err_msg);
Chris@49:   template<typename T1> inline static bool load_ppm_binary(      Cube<T1>& x,       std::istream& f,          std::string& err_msg);
Chris@49: 
Chris@49: 
Chris@49:   //
Chris@49:   // handling of PPM images by fields
Chris@49: 
Chris@49:   template<typename T1> inline static bool save_ppm_binary(const field<T1>& x, const std::string&  final_name);
Chris@49:   template<typename T1> inline static bool save_ppm_binary(const field<T1>& x,       std::ostream& f);
Chris@49:   
Chris@49:   template<typename T1> inline static bool load_ppm_binary(      field<T1>& x, const std::string&  final_name, std::string& err_msg);
Chris@49:   template<typename T1> inline static bool load_ppm_binary(      field<T1>& x,       std::istream& f,          std::string& err_msg);
Chris@49:   
Chris@49: 
Chris@49: 
Chris@49:   };
Chris@49: 
Chris@49: 
Chris@49: 
Chris@49: //! @}