unitConversion.C

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) 2024-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/>.
 
\*---------------------------------------------------------------------------*/
 
#include "unitConversion.H"
 
// * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
 
namespace Foam
{
    defineTypeNameAndDebug(unitConversion, 0);
}
 
 
const Foam::NamedEnum<Foam::unitConversion::dimlessUnitType, 2>
Foam::unitConversion::dimlessUnitTypeNames_
{
    "fraction",
    "angle"
};
 
 
namespace Foam
{
    const scalar unitConversion::smallExponent = rootSmall;
}
 
 
// * * * * * * * * * * * * * Private Member Functions  * * * * * * * * * * * //
 
bool Foam::unitConversion::compare
(
    const unitConversion& a,
    const unitConversion& b,
    const bool compareMultiplier
)
{
    if (a.any()) return true;
    if (b.any()) return true;
    if (a.none()) return false;
    if (b.none()) return false;
 
    // Check the dimensions are the same
    if (a.dimensions_ != b.dimensions_) return false;
 
    // Check the dimensionless units are the same
    for (int i = 0; i < unitConversion::nDimlessUnits; ++ i)
    {
        if
        (
            mag(a.exponents_[i] - b.exponents_[i])
          > unitConversion::smallExponent
        )
        {
            return false;
        }
    }
 
    // If specified, check the unit conversion factors are the same
    return !compareMultiplier || a.multiplier_ == b.multiplier_;
}
 
 
// * * * * * * * * * * * * * * * * Constructors  * * * * * * * * * * * * * * //
 
Foam::unitConversion::unitConversion
(
    const dimensionSet& dimensions,
    const scalar fraction,
    const scalar angle,
    const scalar multiplier
)
:
    dimensions_(dimensions),
    multiplier_(multiplier)
{
    exponents_[FRACTION] = fraction;
    exponents_[ANGLE] = angle;
}
 
 
Foam::unitConversion::unitConversion(const dimensionSet& dimensions)
:
    dimensions_(dimensions),
    multiplier_(1)
{
    exponents_[FRACTION] = 0;
    exponents_[ANGLE] = 0;
}
 
 
// * * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * //
 
void Foam::unitConversion::reset(const unitConversion& units)
{
    dimensions_.reset(units.dimensions_);
    for (int i = 0; i < unitConversion::nDimlessUnits; ++ i)
    {
        exponents_[i] = units.exponents_[i];
    }
    multiplier_ = units.multiplier_;
}
 
 
// * * * * * * * * * * * * * * * Friend Functions  * * * * * * * * * * * * * //
 
Foam::unitConversion Foam::pow(const unitConversion& units, const scalar exp)
{
    if (units.any()) return units;
    if (units.none()) return unitNone;
 
    return
        unitConversion
        (
            pow(units.dimensions_, exp),
            units.exponents_[0]*exp,
            units.exponents_[1]*exp,
            pow(units.multiplier_, exp)
        );
}
 
 
// * * * * * * * * * * * * * * * Friend Operators  * * * * * * * * * * * * * //
 
const Foam::unitConversion& Foam::operator+
(
    const unitConversion& a,
    const unitConversion& b
)
{
    if (a.any()) return b;
    if (b.any()) return a;
    if (a.none()) return unitNone;
    if (b.none()) return unitNone;
 
    if (!unitConversion::compare(a, b, true))
    {
        FatalErrorInFunction
            << "Different units for +" << endl
            << "     units : " << a << " + " << b << endl
            << abort(FatalError);
    }
 
    return a;
}
 
 
Foam::unitConversion Foam::operator*
(
    const unitConversion& a,
    const unitConversion& b
)
{
    if (a.any()) return a;
    if (b.any()) return b;
    if (a.none()) return unitNone;
    if (b.none()) return unitNone;
 
    return
        unitConversion
        (
            a.dimensions_*b.dimensions_,
            a.exponents_[0] + b.exponents_[0],
            a.exponents_[1] + b.exponents_[1],
            a.multiplier_*b.multiplier_
        );
}
 
 
Foam::unitConversion Foam::operator/
(
    const unitConversion& a,
    const unitConversion& b
)
{
    if (a.any()) return a;
    if (b.any()) return b;
    if (a.none()) return unitNone;
    if (b.none()) return unitNone;
 
    return
        unitConversion
        (
            a.dimensions_/b.dimensions_,
            a.exponents_[0] - b.exponents_[0],
            a.exponents_[1] - b.exponents_[1],
            a.multiplier_/b.multiplier_
        );
}
 
 
// ************************************************************************* //