multiGrid2D.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_2D_H
#define MULTI_GRID_2D_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/multiScale.h"
#include "multiGrid/multiGridManagement2D.h"


namespace plb {
  
class MultiGrid2D;

class MultiGridPeriodicitySwitch2D {
  public:
    MultiGridPeriodicitySwitch2D(MultiGrid2D *block_);
    MultiGridPeriodicitySwitch2D(MultiGridPeriodicitySwitch2D const& rhs);
    MultiGridPeriodicitySwitch2D& operator=(MultiGridPeriodicitySwitch2D const& rhs);
    void swap(MultiGridPeriodicitySwitch2D& rhs);
    
    void toggle(int direction, bool periodicity);
    void toggleAll(bool periodicity);
 
    Array<bool,2> const& getPeriodicityArray() const;
    
  private:
    MultiGrid2D* block;
    Array<bool,2> periodicityArray;
    
};


class MultiGridStatSubscriber2D {
public:
    MultiGridStatSubscriber2D(MultiGrid2D* multiGrid_);
    MultiGridStatSubscriber2D(MultiGridStatSubscriber2D const& rhs);
        
    void swap(MultiGridStatSubscriber2D& rhs);
    MultiGridStatSubscriber2D& operator=(MultiGridStatSubscriber2D const& rhs);
    
    plint subscribeAverage(plint dimDx, plint dimDt);
    plint subscribeSum(plint dimDx, plint dimDt);
    plint subscribeMax(plint dimDx, plint dimDt);
    plint subscribeIntSum(plint dimDx, plint dimDt);
    void initialize();    
    
    std::vector<int> const& getDimensionsX() const;
    std::vector<int> const& getDimensionsT() const;
    
private:
    MultiGrid2D* multiGrid;
    std::vector<int> dimensionsX;
    std::vector<int> dimensionsT;
};

  
class MultiGrid2D : public Block2D
{
  public:
    MultiGrid2D( MultiGridManagement2D management, 
                 plint behaviorLevel_);
    // Copy constructor
    MultiGrid2D(const MultiGrid2D& rhs);
    MultiGrid2D(MultiGrid2D const& rhs, Box2D subDomain, bool crop);
    virtual ~MultiGrid2D();
    
    void swap(MultiGrid2D& rhs);
    
    virtual MultiBlock2D const& getComponent(plint level) const =0;
    virtual MultiBlock2D& getComponent(plint level)             =0;
    
    MultiGridManagement2D const& getMultiGridManagement() const;
    MultiGridManagement2D& getMultiGridManagement();
     
    plint getNx() const;
    plint getNy() const;
    
    virtual Box2D getBoundingBox() const;
    
    plint getReferenceLevel() const;
    plint getNumLevels() const;
    plint getBehaviorLevel() const;
    void setBehaviorLevel(plint behaviorLevel_);
    
    virtual void initialize();
    
    void executeInternalProcessors();
    void executeInternalProcessors(plint level);   

    void subscribeProcessor(plint level);
    
    BlockStatistics& getInternalStatistics();
    BlockStatistics const& getInternalStatistics() const;
    
    void reduceStatistics();
    void evaluateStatistics();
    void toggleInternalStatistics(bool statisticsOn_);
    bool isInternalStatisticsOn() const;
    
    MultiGridPeriodicitySwitch2D const& periodicity() const;
    MultiGridPeriodicitySwitch2D& periodicity();
    void signalPeriodicity();
    
    MultiGridStatSubscriber2D& internalStatSubscription();
    
    MultiScaleManager const& getScaleManager() const;

    virtual DataSerializer* getBlockSerializer (
            Box2D const& domain, IndexOrdering::OrderingT ordering ) const;
    virtual DataUnSerializer* getBlockUnSerializer (
            Box2D const& domain, IndexOrdering::OrderingT ordering );

    virtual int getBlockId () const =0;

  private:
    // reference level management
    MultiGridManagement2D management; 

    plint behaviorLevel;
    MultiGridPeriodicitySwitch2D periodicitySwitch;

    plint maxProcessorLevel;
    bool statisticsOn;
    
    MultiGridStatSubscriber2D statsSubscriber;
    BlockStatistics internalStatistics;
    
    // Used to easen the scale conversion in this class
    MultiScaleManager *scaleManager; 
};

// checkpointing for the multiGrid
void saveBinaryGrid(MultiGrid2D const& block, std::string fName, bool enforceUint=false);
void loadBinaryGrid(MultiGrid2D& block, std::string fName, bool enforceUint=false);


} // namespace plb

#endif  // MULTI_GRID_2D_H