Array.hpp

/*
 * Array.hpp
 * 
 * Copyright 2018 Fernando Pujaico Rivera <fernando.pujaico.rivera@gmail.com>
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301, USA.
 * 
 */
 
#ifndef __PDS_ARRAY_HPP__
#define __PDS_ARRAY_HPP__
 
 
#include <string>
#include <Pds/Size>
#include <Pds/RegionRect>
#include <vector>
 
#include <iostream>
#include <fstream>
#include <sstream>      // std::stringstream
 
namespace Pds{
 
class Matrix;
class Vector;
 
template <typename Datum>
class Array
{
public:
    Datum **array;
    unsigned int nlin;
    unsigned int ncol;
    
public:
 
    Array(void);
    
    Array(unsigned int Nlin,unsigned int Ncol);
    
    Array(unsigned int Nlin,unsigned int Ncol,Datum val);
    
    Array(const Pds::Size &S);
 
    Array(const Pds::Size &S,Datum val);
    
    Array(const Pds::Array<Datum> &B);
 
    Array(const std::vector<Datum> &b);
 
    Array(const Pds::Matrix &B);
 
    ~Array(); 
 
public:
 
    Pds::Array<Datum>& operator = (const Pds::Array<Datum> &B);
    
    bool Copy(const Pds::Array<Datum> &B);
    
public:
 
    bool IsEmpty(void) const;
 
    bool IsNotSimilarTo(const Pds::Array<Datum> &B) const;
 
    bool IsNotSimilarTo(const Pds::Matrix &B) const;
 
 
public:
 
    bool FillRandC(double p1);
 
    bool FillRandI(unsigned int min,unsigned int max);
 
    bool Fill(Datum val);
public:
 
    Datum Sum(void) const;
 
public:
 
    unsigned int Nlin(void) const;
    
    unsigned int Ncol(void) const;
    
    unsigned int Nel(void) const;
    
    Pds::Size Size(void) const;
 
 
public:
 
    Datum Get(unsigned int lin,unsigned int col) const;
 
    bool Set(unsigned int lin,unsigned int col,Datum val);
 
    Datum Get(unsigned int id) const;
 
    const Datum &GetRaw(unsigned int lin,unsigned int col) const
    {
        return this->array[lin][col];
    }
 
 
    void SetRaw(unsigned int lin,unsigned int col,const Datum &val)
    {
        this->array[lin][col]=val;
    }
 
    Datum &In(unsigned int lin,unsigned int col);
 
    Datum &In(unsigned int id);
public:
 
    Pds::Vector HistogramIntNorm(const Pds::RegionRect &R,unsigned int min,unsigned int max) const;
 
    Pds::Vector HistogramIntNorm(unsigned int min=0,unsigned int max=255) const;
    
 
    Pds::RegionRect GetRegion(void) const;
 
public:
 
    Datum Max(unsigned int *id=NULL) const;
 
    Datum Min(unsigned int *id=NULL) const;
 
    Pds::Array<Datum> Scale(Datum minval,Datum maxval) const;
 
    Pds::Array<Datum> FilterMean3(void) const;
 
 
    Pds::Array<Datum> Resize(double factor) const;
 
public:
 
    static Datum** ArrayAllocate(const Pds::Matrix &A);
 
    static Datum** ArrayAllocate(const Pds::Array<Datum> &A);
 
    
    static Datum** ArrayAllocate(unsigned int Nlin,unsigned int Ncol,Datum val);
    
    static Datum** ArrayAllocate(unsigned int Nlin,unsigned int Ncol);
 
    static void ArrayRelease(Datum** &array,unsigned int Nlin);
 
    static Datum** ArrayReshape(const Pds::Array<Datum> &A,unsigned int Nlin,unsigned int Ncol);
 
    static Datum *ArrayToLineArray(Datum **array,unsigned int Nlin,unsigned int Ncol);
 
    static std::string ArrayToString(Datum **array,unsigned int Nlin,unsigned int Ncol);
 
    static Datum **ArrayFromString(const std::string &str,unsigned int &Nlin,unsigned int &Ncol);
 
    static Datum **ArrayColFromString(const std::string &str,unsigned int &Nlin,unsigned int &Ncol);
 
public:
 
    static bool ArrayWriteCsvFile(const std::string &filepath,Datum **array,unsigned int Nlin,unsigned int Ncol,char delimitador=',');
    
    
    static bool ArrayWriteCsvFile(  const std::string &filepath,
                                    std::vector<std::string> titles,
                                    Datum **array,
                                    unsigned int Nlin,
                                    unsigned int Ncol,
                                    char delimitador=',');
           
    static Datum** ArrayReadCsvFile(const std::string &filepath, 
                                    char delimitador,
                                    std::vector<std::string> &titles,
                                    unsigned int &Nlin,
                                    unsigned int &Ncol);
                                    
           
    static Datum** ArrayReadCsvFileWithoutTitles(   const std::string &filepath, 
                                                    char delimitador,
                                                    unsigned int &Nlin,
                                                    unsigned int &Ncol);
 
public:
 
    static bool ArrayWriteJsonInStream(  std::ofstream &myfile,
                                        Datum **array,
                                        unsigned int Nlin,
                                        unsigned int Ncol,
                                        const std::string &TagName,
                                        unsigned int ntabs=0);
 
    static std::string ArrayJsonToString(   Datum **array,
                                            unsigned int Nlin,
                                            unsigned int Ncol,
                                            const std::string &TagName,
                                            unsigned int ntab=0);
 
public:
 
    static bool ArrayWriteXmlInStream(  std::ofstream &myfile,
                                        Datum **array,
                                        unsigned int Nlin,
                                        unsigned int Ncol,
                                        const std::string &TagName);
    
    
    static bool ArrayWriteXmlInStringStream(std::stringstream &sstream,
                                            Datum **array,
                                            unsigned int Nlin,
                                            unsigned int Ncol,
                                            const std::string &TagName);
    
    static std::string ArrayXmlToString(Datum **array,
                                        unsigned int Nlin,
                                        unsigned int Ncol,
                                        const std::string &TagName);
                                        
    static Datum **ArrayXmlFromString(  const std::string &str,
                                        const std::string &TagName,
                                        unsigned int &Nlin,
                                        unsigned int &Ncol);
public:
 
    static bool ArraySaveInStream(std::ofstream &myfile,Datum **array,unsigned int Nlin,unsigned int Ncol);
 
    static Datum** ArrayLoadFromStream(std::ifstream &ifs,unsigned int Nlin,unsigned int Ncol);
 
    static Datum** ArrayLoadLineFromStream(std::ifstream &ifs,unsigned int &Nlin,unsigned int &Ncol);
    
    static bool ArraySave(const std::string &filepath,Datum **array,unsigned int Nlin,unsigned int Ncol);
 
    static Datum** ArrayLoad(const std::string &filepath,unsigned int& Nlin,unsigned int& Ncol);
 
    static Datum** ArrayColLoad(const std::string &filepath,unsigned int& Nlin,unsigned int& Ncol);
 
public:
 
    static bool ArrayWriteTexFile(  const std::string &filepath,
                                    const std::vector<std::string> &titles,
                                    const std::vector<std::string> &rowtitles,
                                    const std::string &caption,
                                    const std::string &label,
                                    Datum **array,
                                    unsigned int Nlin,
                                    unsigned int Ncol);
    
    static bool ArrayWriteTexFile(  const std::string &filepath,
                                    const std::vector<std::string> &titles,
                                    const std::string &caption,
                                    const std::string &label,
                                    Datum **array,
                                    unsigned int Nlin,
                                    unsigned int Ncol);
 
    static bool ArrayWriteTexFile(  const std::string &filepath,
                                    const std::string &caption,
                                    const std::string &label,
                                    Datum **array,
                                    unsigned int Nlin,
                                    unsigned int Ncol);
                                    
public:
 
    static bool ArrayWriteMatFile(FILE *fp,const char *pname,Datum **array,unsigned int Nlin,unsigned int Ncol);
 
    static bool ArrayWriteMatFile(FILE *fp,const char *pname,Datum **arrayr,Datum **arrayi,unsigned int Nlin,unsigned int Ncol);
public:
 
    static bool ArrayWriteBmpWithColormap(  Datum **array,
                                            unsigned int Nlin,
                                            unsigned int Ncol,
                                            const unsigned char colormap[256][3],
                                            const std::string &bmpfilepath);
 
   
    static bool ArrayWriteBmpWithColormap(  Datum **array,
                                            unsigned int Nlin,
                                            unsigned int Ncol,
                                            const Pds::Array<unsigned char> &Colormap,
                                            const std::string &bmpfilepath);
 
    static bool ArrayWriteBmp(  Datum **arrayr,
                                Datum **arrayg,
                                Datum **arrayb,
                                unsigned int Nlin,
                                unsigned int Ncol,
                                const std::string &bmpfilepath);
public:
 
    bool ExportBmpFile(const unsigned char colormap[256][3],const std::string &filepath) const;
 
    bool ExportBmpFile(const Pds::Array<unsigned char> &Colormap,const std::string &filepath) const;
public:
 
    static std::vector<Pds::Array<Datum>>  ImportBmpFile(const std::string &bmpfilepath);
 
    static Pds::Array<Datum> MeanSampleBlock( const std::vector<Pds::Array<Datum>> &Block);
public:
 
    void MakeEmpty(void);
 
    void Print(std::string str) const;
    
    void Print(void) const;
 
 
    bool Reshape(unsigned int Nlin,unsigned int Ncol);
 
 
    Pds::Matrix Centroids(const std::vector<Pds::Matrix> &Block) const;
 
    Pds::Matrix Centroids(const Pds::Matrix &X) const;
}; // Class Array
 
 
} // namespace Pds
 
 
 
#endif