blockLattice2D.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/>.
*/

#ifndef BLOCK_LATTICE_2D_H
#define BLOCK_LATTICE_2D_H

#include "core/globalDefs.h"
#include "core/plbDebug.h"
#include "core/cell.h"
#include "atomicBlock/dataField2D.h"
#include "core/blockLatticeBase2D.h"
#include "atomicBlock/atomicBlock2D.h"
#include "core/blockIdentifiers.h"
#include <vector>
#include <map>


namespace plb {

template<typename T, template<typename U> class Descriptor> struct Dynamics;
template<typename T, template<typename U> class Descriptor> class BlockLattice2D;


template<typename T, template<typename U> class Descriptor>
class BlockLatticeDataTransfer2D : public BlockDataTransfer2D {
public:
    BlockLatticeDataTransfer2D(BlockLattice2D<T,Descriptor>& lattice_);
    virtual plint staticCellSize() const;
    virtual void send(Box2D domain, std::vector<char>& buffer, modif::ModifT kind) const;
    virtual void receive(Box2D domain, std::vector<char> const& buffer, modif::ModifT kind);
    virtual void receive( Box2D domain, std::vector<char> const& buffer,
                          modif::ModifT kind, std::map<int,std::string> const& foreignIds );
    virtual void attribute(Box2D toDomain, plint deltaX, plint deltaY,
                           AtomicBlock2D const& from, modif::ModifT kind);
private:
    void send_static(Box2D domain, std::vector<char>& buffer) const;
    void send_dynamic(Box2D domain, std::vector<char>& buffer) const;
    void send_all(Box2D domain, std::vector<char>& buffer) const;

    void receive_static(Box2D domain, std::vector<char> const& buffer);
    void receive_dynamic(Box2D domain, std::vector<char> const& buffer);
    void receive_all(Box2D domain, std::vector<char> const& buffer);
    void receive_regenerate(Box2D domain, std::vector<char> const& buffer,
                            std::map<int,int> const& idIndirect = (std::map<int,int>()) );

    void attribute_static (
        Box2D toDomain, plint deltaX, plint deltaY,
        BlockLattice2D<T,Descriptor> const& from );
    void attribute_dynamic (
        Box2D toDomain, plint deltaX, plint deltaY,
        BlockLattice2D<T,Descriptor> const& from );
    void attribute_all (
        Box2D toDomain, plint deltaX, plint deltaY,
        BlockLattice2D<T,Descriptor> const& from );
    void attribute_regenerate (
        Box2D toDomain, plint deltaX, plint deltaY,
        BlockLattice2D<T,Descriptor> const& from );
private:
    BlockLattice2D<T,Descriptor>& lattice;
};


template<typename T, template<typename U> class Descriptor>
class BlockLattice2D : public BlockLatticeBase2D<T,Descriptor>,
                       public AtomicBlock2D
{
public:
    BlockLattice2D(plint nx_, plint ny_, Dynamics<T,Descriptor>* backgroundDynamics);
    ~BlockLattice2D();
    BlockLattice2D(BlockLattice2D<T,Descriptor> const& rhs);
    BlockLattice2D& operator=(BlockLattice2D<T,Descriptor> const& rhs);
    void swap(BlockLattice2D& rhs);
public:
    virtual Cell<T,Descriptor>& get(plint iX, plint iY) {
        PLB_PRECONDITION(iX<this->getNx());
        PLB_PRECONDITION(iY<this->getNy());
        return grid[iX][iY];
    }
    virtual Cell<T,Descriptor> const& get(plint iX, plint iY) const {
        PLB_PRECONDITION(iX<this->getNx());
        PLB_PRECONDITION(iY<this->getNy());
        return grid[iX][iY];
    }
    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();
    virtual BlockLatticeDataTransfer2D<T,Descriptor>& getDataTransfer();
    virtual BlockLatticeDataTransfer2D<T,Descriptor> const& getDataTransfer() const;
public:
    void attributeDynamics(plint iX, plint iY, Dynamics<T,Descriptor>* dynamics);
    Dynamics<T,Descriptor>& getBackgroundDynamics();
    Dynamics<T,Descriptor> const& getBackgroundDynamics() const;
    void bulkStream(Box2D domain);
    void boundaryStream(Box2D bound, Box2D domain);
    void bulkCollideAndStream(Box2D domain);
private:
    void linearBulkCollideAndStream(Box2D domain);
    void blockwiseBulkCollideAndStream(Box2D domain);
private:
    void allocateAndInitialize();
    void releaseMemory();
    void implementPeriodicity();
private:
    void periodicDomain(Box2D domain);
private:
    Dynamics<T,Descriptor>* backgroundDynamics;
    Cell<T,Descriptor>     *rawData;
    Cell<T,Descriptor>    **grid;
    BlockLatticeDataTransfer2D<T,Descriptor> dataTransfer;
public:
    static CachePolicy2D& cachePolicy();
template<typename T_, template<typename U_> class Descriptor_>
    friend class ExternalRhoJcollideAndStream2D;
};

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

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

template<typename T, template<typename U> class Descriptor>
double getStoredAverageVelocity(BlockLattice2D<T,Descriptor> const& blockLattice);

}  // namespace plb

#endif  // BLOCK_LATTICE_2D_H