multiGridManagement3D.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_MANAGEMENT_3D_H
#define MULTI_GRID_MANAGEMENT_3D_H

#include "core/globalDefs.h"
#include "core/geometry3D.h"
#include "multiGrid/multiScale.h"

namespace plb {

class MultiGridManagement3D {
public:
    MultiGridManagement3D(plint coarseNx, plint coarseNy, plint coarseNz, plint numLevels, plint referenceLevel=0);
    MultiGridManagement3D(Box3D coarseBoundingBox, plint numLevels, plint referenceLevel=0);
    
    MultiGridManagement3D(MultiGridManagement3D const& rhs, Box3D coarsestDomain);
    MultiGridManagement3D(MultiGridManagement3D const& rhs);
    ~MultiGridManagement3D();
    
    void swap(MultiGridManagement3D& rhs);
    
    std::vector<Box3D> const& getBulks(plint iLevel) const;
    std::vector<std::vector<Box3D> > const& getBulks() const;
    
    std::vector<Box3D> const& getUniqueBulks(plint iLevel) const;
    std::vector<std::vector<Box3D> > const& getUniqueBulks() const;
     
    Box3D getBoundingBox(plint level) const;
    
    void refine(plint level, Box3D domain);
    void coarsen(plint level, Box3D domain);
    
    std::vector<std::vector<plint> > const& getMpiProcesses() const;

    std::vector<std::vector<Box3D> > const& getCoarseInterface() const;
    std::vector<std::vector<Box3D> > const& getFineInterface() const;
    
    void trimDomain (plint whichLevel, Box3D& domain, bool* touches) const;

    plint getNumLevels() const;
    plint getReferenceLevel() const;
    
    void parallelizeX(std::vector<plint> const& finePositions);
    void parallelizeY(std::vector<plint> const& finePositions);
    void parallelizeZ(std::vector<plint> const& finePositions);
    
    void parallelize(std::vector<Box3D> parallelRegions, std::vector<plint> const& regionIDs);

    friend MultiGridManagement3D extractManagement(MultiGridManagement3D management, Box3D coarsestDomain, bool crop);
    
private:
    void initialize(Box3D const& level0_box);
    void parallelizeLevel(plint whichLevel, std::vector<Box3D> const& parallelRegions, 
                          std::vector<plint> const& regionIDs);

private:
    plint                                referenceLevel;
    std::vector<Box3D>                   boundingBoxes;
    std::vector<std::vector<plint> >     mpiProcess;

    std::vector<std::vector<Box3D> >     coarseGridInterfaces;

    std::vector<std::vector<Box3D> >     fineGridInterfaces;

    std::vector<std::vector<Box3D> >     bulks;
    
    std::vector<std::vector<Box3D> >     uniqueBulks;
    
    MultiScaleManager *scaleManager; 
    
};

MultiGridManagement3D extractManagement(MultiGridManagement3D management, Box3D coarsestDomain, bool crop=true);


} // namespace plb

#endif  // MULTI_GRID_MANAGEMENT_3D_H