multiGridLattice2D.h

Go to the documentation of this file.

/* This file is part of the Palabos library.
 *
 * Copyright (C) 2011 FlowKit Sarl
 * Avenue de Chailly 23
 * 1012 Lausanne, Switzerland
 * E-mail contact: contact@flowkit.com
 *
 * The most recent release of Palabos can be downloaded at 
 * <http://www.palabos.org/>
 *
 * The library Palabos is free software: you can redistribute it and/or
 * modify it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * The library 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 Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

/* Main author: Daniel Lagrava
 **/

#ifndef MULTI_GRID_LATTICE_2D_H
#define MULTI_GRID_LATTICE_2D_H

#include "multiGrid/multiGrid2D.h"
#include "core/globalDefs.h"
#include "core/geometry2D.h"
#include "core/array.h"
#include "multiBlock/multiBlock2D.h"
#include "multiBlock/multiBlockManagement2D.h"
#include "multiBlock/blockCommunicator2D.h"
#include "multiBlock/combinedStatistics.h"
#include "core/block2D.h"
#include "core/blockStatistics.h"

#include "multiGrid/multiGridParameterManager.h"
#include "multiGrid/coarseGridProcessors2D.h"
#include "multiGrid/fineGridProcessors2D.h"
#include "multiGrid/gridRefinement.h"
#include "multiGrid/gridRefinementDynamics.h"
#include "multiGrid/multiGridGenerator2D.h"

#include <memory>

namespace plb {

template <typename T, template <typename U> class Descriptor>
class MultiGridLattice2D : public BlockLatticeBase2D< T,Descriptor >, public MultiGrid2D {

  public:
    MultiGridLattice2D(MultiGridManagement2D management,
                       std::vector<BlockCommunicator2D* > communicators_,
                       std::vector<CombinedStatistics*> combinedStatistics_, 
                       Dynamics<T,Descriptor>* backgroundDynamics, plint behaviorLevel,
                       FineGridInterfaceInstantiator<T,Descriptor> *fineGridInstantiator_,
                       CoarseGridInterfaceInstantiator<T,Descriptor> *coarseGridInstantiator_
                        );

    MultiGridLattice2D( MultiGridManagement2D management,
                       Dynamics<T,Descriptor>* backgroundDynamics, plint behaviorLevel,
                       FineGridInterfaceInstantiator<T,Descriptor> *fineGridInstantiator_,
                       CoarseGridInterfaceInstantiator<T,Descriptor> *coarseGridInstantiator_ 
                        );

    MultiGridLattice2D(MultiGridLattice2D<T,Descriptor> const& rhs);
    MultiGridLattice2D(MultiGridLattice2D<T,Descriptor> const& rhs, Box2D subDomain, bool crop=true);
    
    MultiGridLattice2D(MultiGrid2D const& rhs);
    MultiGridLattice2D(MultiGrid2D const& rhs, Box2D subDomain, bool crop=true);
    
    MultiGridLattice2D<T,Descriptor>& operator=(MultiGridLattice2D<T,Descriptor> const& rhs);
    ~MultiGridLattice2D();
    
    void initialize();
    
    std::auto_ptr<MultiBlockLattice2D<T,Descriptor> > convertToLevel(plint level) const;
    
    /* *** MultiGrid2D methods *** */
    int getBlockId () const;
    
    MultiBlockLattice2D<T,Descriptor>& getComponent(plint iBlock);
    const MultiBlockLattice2D<T,Descriptor>& getComponent(plint iBlock) const;
    
    /* **** BlockLatticeBase2D methods **** */
    
    virtual Cell<T,Descriptor>& get(plint iX, plint iY);
    virtual Cell<T,Descriptor> const& get(plint iX, plint iY) const;
    virtual void specifyStatisticsStatus (Box2D domain, bool status);
    virtual void collide(Box2D domain);
    virtual void collide();
    virtual void stream(Box2D domain);
    virtual void stream();              
    virtual void collideAndStream(Box2D domain);
    virtual void collideAndStream();    
    virtual void incrementTime();
    TimeCounter& getTimeCounter();
    TimeCounter const& getTimeCounter() const;
  private:
    void createInterfaces();
    void iterateMultiGrid(plint level);
    void eliminateStatisticsInOverlap();
  private:
    std::vector<MultiBlockLattice2D<T,Descriptor>*> lattices;
    // the objects to create the interfaces
    FineGridInterfaceInstantiator<T,Descriptor> *fineGridInstantiator;
    CoarseGridInterfaceInstantiator<T,Descriptor> *coarseGridInstantiator;
};

template<typename T, template<typename U> class Descriptor>
double getStoredAverageDensity(MultiGridLattice2D<T,Descriptor> const& multiGrid);

template<typename T, template<typename U> class Descriptor>
double getStoredAverageEnergy(MultiGridLattice2D<T,Descriptor> const& multiGrid);

template<typename T, template<typename U> class Descriptor>
double getStoredMaxVelocity(MultiGridLattice2D<T,Descriptor> const& multiGrid);

}// namespace plb

#endif