cyclicTransform.H

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     | Website:  https://openfoam.org
    \\  /    A nd           | Copyright (C) 2020-2025 OpenFOAM Foundation
     \\/     M anipulation  |
-------------------------------------------------------------------------------
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::cyclicTransform
 
Description
    Cyclic plane transformation.
 
SourceFiles
    cyclicTransform.C
 
\*---------------------------------------------------------------------------*/
 
#ifndef cyclicTransform_H
#define cyclicTransform_H
 
#include "transformer.H"
#include "dictionary.H"
#include "NamedEnum.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
 
/*---------------------------------------------------------------------------*\
                       Class cyclicTransform Declaration
\*---------------------------------------------------------------------------*/
 
class cyclicTransform
{
public:
 
    enum transformTypes
    {
        UNSPECIFIED,        // Unspecified -> automatic transformation
        NONE,               // No transformation
        ROTATIONAL,         // Rotation around a coordinate axis
        TRANSLATIONAL       // Translation
    };
 
    static const NamedEnum<transformTypes, 4> transformTypeNames;
 
    static const wordList keywords;
 
 
private:
 
    // Private Data
 
        //- Type of transformation
        transformTypes transformType_;
 
        //- Axis of rotation
        vector rotationAxis_;
 
        //- Centre of rotation
        point rotationCentre_;
 
        //- Rotation angle
        scalar rotationAngle_;
 
        //- Separation vector
        vector separation_;
 
        //- Is the transformation specification complete, or do some parts of
        //  the above data still need to be computed from the patch geometry?
        bool transformComplete_;
 
        //- Generic transformer object
        transformer transform_;
 
 
    // Private Member Functions
 
        //- Re-calculate the transformer object from the other data if possible
        void update();
 
        //- Set the transform to that supplied. Return true if the
        //  transformations are compatible. Used for copying transformation
        //  data from the neighbour patch.
        bool set
        (
            const cyclicTransform& t,
            const scalar lengthScale,
            const scalar matchTolerance
        );
 
 
public:
 
    //- Runtime type information
    TypeName("cyclicTransform");
 
 
    // Constructors
 
        // Transformation set NONE
        cyclicTransform();
 
        // Transformation set as UNSPECIFIED or NONE
        cyclicTransform(const bool defaultIsNone);
 
        // Transformation read from dictionary
        cyclicTransform(const dictionary& dict, const bool defaultIsNone);
 
        //- Construct from coupled patch data. Copies from the supplied
        //  transform and neighbour transform. Suitable for
        //  geometrically dissimilar patches.
        cyclicTransform
        (
            const word& name,
            const vectorField& areas,
            const cyclicTransform& transform,
            const word& nbrName,
            const cyclicTransform& nbrTransform,
            const scalar matchTolerance,
            const bool global = false
        );
 
        //- Construct from coupled patch data. Copies from the supplied
        //  transform and neighbour transform, then tries to determine missing
        //  parts of the transformation automatically from the patch geometry.
        //  Suitable for geometrically similar patches only.
        cyclicTransform
        (
            const word& name,
            const pointField& ctrs,
            const vectorField& areas,
            const cyclicTransform& transform,
            const word& nbrName,
            const pointField& nbrCtrs,
            const vectorField& nbrAreas,
            const cyclicTransform& nbrTransform,
            const scalar matchTolerance,
            const bool global = false
        );
 
 
    // Destructor
    virtual ~cyclicTransform();
 
 
    // Member Functions
 
        // Access
 
            //- Type of transform
            transformTypes transformType() const
            {
                return transformType_;
            }
 
            //- Is the transform fully specified?
            bool transformComplete() const
            {
                return transformComplete_;
            }
 
            //- Return transformation between the coupled patches
            const transformer& transform() const
            {
                if (!transformComplete_)
                {
                    FatalErrorInFunction
                        << "The transformation has not been fully specified or "
                        << "calculated" << exit(FatalError);
                }
                return transform_;
            }
 
 
        //- Write the data to a dictionary
        void write(Ostream& os) const;
 
        //- Generate a string representation of the transform
        string str() const;
 
 
        // Global Operators
 
            friend cyclicTransform operator&
            (
                const transformer& t,
                const cyclicTransform& c
            );
 
            friend cyclicTransform inv(const cyclicTransform& c);
};
 
 
cyclicTransform operator&(const transformer& t, const cyclicTransform& c);
 
cyclicTransform inv(const cyclicTransform& c);
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
} // End namespace Foam
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#endif
 
// ************************************************************************* //