atomicBlock3D.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 ATOMIC_BLOCK_3D_H
#define ATOMIC_BLOCK_3D_H

#include "core/globalDefs.h"
#include "core/blockIdentifiers.h"
#include "core/block3D.h"
#include "core/blockStatistics.h"
#include "core/geometry3D.h"
#include "atomicBlock/dataProcessorWrapper3D.h"
#include "atomicBlock/reductiveDataProcessorWrapper3D.h"
#include <algorithm>
#include <string>
#include <map>

namespace plb {

// Forward declarations
class AtomicBlock3D;
    
class StatSubscriber3D : public StatSubscriber {
public:
    StatSubscriber3D(AtomicBlock3D& block_);
    virtual plint subscribeAverage();
    virtual plint subscribeSum();
    virtual plint subscribeMax();
    virtual plint subscribeIntSum();
private:
    AtomicBlock3D& block;
};

struct BlockDataTransfer3D {
    virtual ~BlockDataTransfer3D() { }
    virtual plint staticCellSize() const =0;

    virtual void send(Box3D domain, std::vector<char>& buffer, modif::ModifT kind) const =0;
    virtual void receive(Box3D domain, std::vector<char> const& buffer, modif::ModifT kind) =0;
    virtual void receive( Box3D domain, std::vector<char> const& buffer,
                          modif::ModifT kind, std::map<int,std::string> const& foreignIds ) =0;
    virtual void attribute(Box3D toDomain, plint deltaX, plint deltaY, plint deltaZ,
                           AtomicBlock3D const& from, modif::ModifT kind) =0;
};

class AtomicBlock3D : public Block3D {
public:
    AtomicBlock3D(plint nx_, plint ny_, plint nz_);
    AtomicBlock3D(AtomicBlock3D const& rhs);
    virtual ~AtomicBlock3D();
    void swap(AtomicBlock3D& rhs);
    void initialize();
public:
    virtual Box3D getBoundingBox() const;
    plint getNx() const { return nx; }
    plint getNy() const { return ny; }
    plint getNz() const { return nz; }
    void executeInternalProcessors();
    void executeInternalProcessors(plint level);
    void integrateDataProcessor(DataProcessor3D* processor, plint level);
    void clearDataProcessors();
    void removeDataProcessors(int staticId);
    virtual BlockDataTransfer3D& getDataTransfer() =0;
    virtual BlockDataTransfer3D const& getDataTransfer() const =0;
    virtual DataSerializer* getBlockSerializer (
            Box3D const& domain, IndexOrdering::OrderingT ordering ) const;
    virtual DataUnSerializer* getBlockUnSerializer (
            Box3D const& domain, IndexOrdering::OrderingT ordering );
public:
    StatSubscriber& internalStatSubscription();
    void evaluateStatistics();
    BlockStatistics& getInternalStatistics();
    BlockStatistics const& getInternalStatistics() const;
public:
    void setLocation(Dot3D const& location_);
    Dot3D getLocation() const;
    void setFlag(bool value);
    bool getFlag() const;
private:
    typedef std::vector<std::vector<DataProcessor3D*> > DataProcessorVector;
private:
    void integrateDataProcessor (
                     DataProcessor3D* processor, plint level, DataProcessorVector& processors );
    void executeInternalProcessors(plint level, DataProcessorVector& processors);
    void copyDataProcessors(DataProcessorVector const& from, DataProcessorVector& to);
    void clearDataProcessors(DataProcessorVector& processors);
private:
    plint nx, ny, nz;
    Dot3D location;  
    bool  flag;      
    BlockStatistics internalStatistics;
    StatSubscriber3D statisticsSubscriber;
    DataProcessorVector explicitInternalProcessors;
    DataProcessorVector automaticInternalProcessors;
};

Dot3D computeRelativeDisplacement(AtomicBlock3D const& block1, AtomicBlock3D const& block2);

} // namespace plb

#endif  // ATOMIC_BLOCK_3D