/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2011-2016 OpenFOAM Foundation
    Copyright (C) 2020-2021 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM.

    OpenFOAM is free software: you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    OpenFOAM 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 General Public License
    for more details.

    You should have received a copy of the GNU General Public License
    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.

Class
    Foam::polyMeshAdder

Description
    Adds two meshes without using any polyMesh morphing.

    Gets faces to couple as faceCoupleInfo which is list of faces on both
    meshes. Returns map from last mesh addition.

SourceFiles
    polyMeshAdder.C

\*---------------------------------------------------------------------------*/

#ifndef Foam_polyMeshAdder_H
#define Foam_polyMeshAdder_H

#include "autoPtr.H"
#include "polyMesh.H"
#include "mapAddedPolyMesh.H"
#include "faceCoupleInfo.H"

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

namespace Foam
{

// Forward Declarations
class IOobject;
class polyTopoChange;

/*---------------------------------------------------------------------------*\
                        Class polyMeshAdder Declaration
\*---------------------------------------------------------------------------*/

class polyMeshAdder
{
    // Private Member Functions

        //- Index of patch in allPatches. Add if nonexisting.
        static label patchIndex
        (
            const polyPatch&,
            DynamicList<word>& allPatchNames,
            DynamicList<word>& allPatchTypes
        );

        //- Index of zone in all zones
        static label zoneIndex(const word&, DynamicList<word>&);

        static void mergePatchNames
        (
            const polyBoundaryMesh& patches0,
            const polyBoundaryMesh& patches1,

            DynamicList<word>& allPatchNames,
            DynamicList<word>& allPatchTypes,

            labelList& from1ToAllPatches,
            labelList& fromAllTo1Patches
        );

        static List<polyPatch*> combinePatches
        (
            const polyMesh& mesh0,
            const polyMesh& mesh1,
            const polyBoundaryMesh& allBoundaryMesh,
            const label nAllPatches,
            const labelList& fromAllTo1Patches,

            const label nInternalFaces,
            const labelList& nFaces,

            labelList& from0ToAllPatches,
            labelList& from1ToAllPatches
        );

        //- Determine order for internalFaces to be upper-triangular.
        //  Does not change order of external faces.
        static labelList getFaceOrder
        (
            const cellList& cells,
            const label nInternalFaces,
            const labelList& owner,
            const labelList& neighbour
        );

        //- Extends face f with split points. cutEdgeToPoints gives for every
        // edge the points introduced inbetween the endpoints.
        static void insertVertices
        (
            const EdgeMap<labelList>& cutEdgeToPoints,
            const Map<label>& meshToMaster,
            const labelList& masterToCutPoints,
            const face& masterFace,

            DynamicList<label>& workFace,
            face& f
        );

        //- Merges primitives of two meshes.
        static void mergePrimitives
        (
            const polyMesh& mesh0,
            const polyMesh& mesh1,
            const faceCoupleInfo& coupleInfo,

            const label nAllPatches,
            const labelList& fromAllTo1Patches,
            const labelList& from1ToAllPatches,

            pointField& allPoints,
            labelList& from0ToAllPoints,
            labelList& from1ToAllPoints,

            faceList& allFaces,
            labelList& allOwner,
            labelList& allNeighbour,
            label& nInternalFaces,
            labelList& nFacesPerPatch,
            label& nCells,

            labelList& from0ToAllFaces,
            labelList& from1ToAllFaces,
            labelList& from1ToAllCells
        );

        //- Merge point zones
        static void mergePointZones
        (
            const label nAllPoints,

            const pointZoneMesh& pz0,
            const pointZoneMesh& pz1,
            const labelList& from0ToAllPoints,
            const labelList& from1ToAllPoints,

            DynamicList<word>& zoneNames,
            labelList& from1ToAll,
            List<DynamicList<label>>& pzPoints
        );

        //- Merge face zones
        static void mergeFaceZones
        (
            const labelList& allOwner,

            const polyMesh& mesh0,
            const polyMesh& mesh1,
            const labelList& from0ToAllFaces,
            const labelList& from1ToAllFaces,
            const labelList& from1ToAllCells,

            DynamicList<word>& zoneNames,
            labelList& from1ToAll,
            List<DynamicList<label>>& fzFaces,
            List<DynamicList<bool>>& fzFlips
        );

        //- Merge cell zones
        static void mergeCellZones
        (
            const label nAllCells,

            const cellZoneMesh& cz0,
            const cellZoneMesh& cz1,
            const labelList& from1ToAllCells,

            DynamicList<word>& zoneNames,
            labelList& from1ToAll,
            List<DynamicList<label>>& czCells
        );

        //- Merge point/face/cell zone information
        static void mergeZones
        (
            const label nAllPoints,
            const labelList& allOwner,
            const label nAllCells,

            const polyMesh& mesh0,
            const polyMesh& mesh1,
            const labelList& from0ToAllPoints,
            const labelList& from0ToAllFaces,
            const labelList& from1ToAllPoints,
            const labelList& from1ToAllFaces,
            const labelList& from1ToAllCells,

            DynamicList<word>& pointZoneNames,
            List<DynamicList<label>>& pzPoints,

            DynamicList<word>& faceZoneNames,
            List<DynamicList<label>>& fzFaces,
            List<DynamicList<bool>>& fzFlips,

            DynamicList<word>& cellZoneNames,
            List<DynamicList<label>>& czCells
        );

        //- Create new zones and add to new mesh.
        static void addZones
        (
            const UList<word>& pointZoneNames,
            const List<DynamicList<label>>& pzPoints,

            const UList<word>& faceZoneNames,
            const List<DynamicList<label>>& fzFaces,
            const List<DynamicList<bool>>& fzFlips,

            const UList<word>& cellZoneNames,
            const List<DynamicList<label>>& czCells,

            polyMesh& mesh
        );


        //- Multi-mesh addition

            //- Find n'th processor patch going to nbrProci. Usually n=0 except
            //- for e.g. processorCyclic
            static label procPatchIndex
            (
                const polyBoundaryMesh& pbm,
                const label nbrProci,
                const label n
            );

            //- Determine shared points. Takes pairs of one-to-one patches
            //0 that are converted into internal faces
            static void compactPoints
            (
                const UPtrList<polyMesh>& meshes,
                const labelListList& localBoundaryFace,
                const labelListList& remoteFaceProc,
                const labelListList& remoteBoundaryFace,
                const labelListList& remoteFaceStart,
                const globalIndex& globalPoints,

                labelListList& pointProcAddressing,
                labelListList& localPoints
            );


public:

    // Member Functions


        //- Add two polyMeshes. Returns new polyMesh and map construct.
        static autoPtr<polyMesh> add
        (
            const IOobject& io,
            const polyMesh& mesh0,
            const polyMesh& mesh1,
            const faceCoupleInfo& coupleInfo,
            autoPtr<mapAddedPolyMesh>& mapPtr
        );

        //- Inplace add mesh to polyMesh. Returns map construct.
        static autoPtr<mapAddedPolyMesh> add
        (
            polyMesh& mesh0,
            const polyMesh& mesh1,
            const faceCoupleInfo& coupleInfo,
            const bool validBoundary = true
        );

        // Point merging

            //- Find topologically and geometrically shared points.
            //
            //  - should only be called for parallel correct mesh
            //    (since uses mesh.globalData)
            //  - returns Map from point to master point (all in mesh point
            //    labels) for any sets of points that need to be merged.
            static Map<label> findSharedPoints
            (
                const polyMesh&,
                const scalar mergeTol
            );

            //- Helper: Merge points.
            //
            //  - Gets map from point to destination point
            //  - Removes all points that don't map to themselves
            //  - Modifies all faces that use the points to be removed.
            static void mergePoints
            (
                const polyMesh&,
                const Map<label>& pointToMaster,
                polyTopoChange& meshMod
            );


        // Multi-mesh merging. Expects same patches (apart from processor
        // patches)

            //- Helper: find pairs of processor patches. Return number of
            //- non-processor patches
            static label procPatchPairs
            (
                const UPtrList<polyMesh>& meshes,
                List<DynamicList<label>>& localPatch,
                List<DynamicList<label>>& remoteMesh,
                List<DynamicList<label>>& remotePatch
            );

            //- Helper: expand list of coupled patches into pairs of coupled
            //- faces
            static void patchFacePairs
            (
                const UPtrList<polyMesh>& meshes,
                const List<DynamicList<label>>& localPatch,
                const List<DynamicList<label>>& remoteMesh,
                const List<DynamicList<label>>& remotePatch,
                labelListList& localBoundaryFace,
                labelListList& remoteFaceMesh,
                labelListList& remoteBoundaryFace
            );

            //- Add multiple meshes
            static void add
            (
                const UPtrList<polyMesh>& meshes,
                const UList<labelList>& patchMap,

                const labelListList& localBoundaryFace,
                const labelListList& remoteFaceMesh,
                const labelListList& remoteBoundaryFace,
                const labelListList& remoteFaceStart,

                const UList<labelList>& pointZoneMap,
                const UList<labelList>& faceZoneMap,
                const UList<labelList>& cellZoneMap,

                polyTopoChange& meshMod,
                labelListList& cellProcAddressing,
                labelListList& faceProcAddressing,
                labelListList& pointProcAddressing
            );
};


// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

} // End namespace Foam

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

#endif

// ************************************************************************* //