manualInjection.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) 2025-2026 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 "manualInjection.H"
#include "LagrangianFields.H"
#include "addToRunTimeSelectionTable.H"
 
// * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
 
namespace Foam
{
namespace Lagrangian
{
    defineTypeNameAndDebug(manualInjection, 0);
    addToRunTimeSelectionTable(LagrangianModel, manualInjection, dictionary);
}
}
 
 
// * * * * * * * * * * * * * Private Member Functions  * * * * * * * * * * * //
 
void Foam::Lagrangian::manualInjection::readCoeffs(const dictionary& modelDict)
{
    const bool havePositions = modelDict.found("positions");
    const bool haveFile = modelDict.found("file");
    const bool haveUnits = modelDict.found("units");
 
    if (havePositions == haveFile)
    {
        FatalIOErrorInFunction(modelDict)
            << (haveFile ? "both keywords" : "neither keyword")
            << " positions " << (haveFile ? "and" : "nor")
            << " file defined in dictionary " << modelDict.name()
            << exit(FatalIOError);
    }
 
    if (havePositions && haveUnits)
    {
        FatalIOErrorInFunction(modelDict)
            << "both keywords positions and units defined in dictionary "
            << modelDict.name() << exit(FatalIOError);
    }
 
    if (havePositions)
    {
        positions_ = modelDict.lookup<List<point>>("positions", dimLength);
    }
 
    if (haveFile)
    {
        fileName_ = modelDict.lookup<fileName>("file");
 
        units_.readIfPresent("units", modelDict);
    }
 
    time_ =
        modelDict.lookupOrDefault<scalar>
        (
            "time",
            mesh().time().userUnits(),
            mesh().time().beginTime().value()
        );
}
 
 
// * * * * * * * * * * * * * * * * Constructors  * * * * * * * * * * * * * * //
 
Foam::Lagrangian::manualInjection::manualInjection
(
    const word& name,
    const LagrangianMesh& mesh,
    const dictionary& modelDict,
    const dictionary& stateDict
)
:
    LagrangianInjection(name, mesh),
    positions_(),
    fileName_(fileName::null),
    units_(dimLength),
    time_(NaN)
{
    readCoeffs(modelDict);
}
 
 
// * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * * //
 
Foam::LagrangianSubMesh Foam::Lagrangian::manualInjection::modify
(
    LagrangianMesh& mesh,
    const LagrangianSubMesh&
) const
{
    const scalar t1 = mesh.time().value();
    const scalar t0 = t1 - mesh.time().deltaT().value();
 
    if (!(t0 <= time_ && time_ < t1)) return mesh.subNone();
 
    // Read and unit convert the positions if specified in a file
    tmp<pointField> tpositions;
    if (fileName_ == fileName::null)
    {
        tpositions = tmp<pointField>(positions_);
    }
    else
    {
        tpositions =
            new pointField
            (
                GlobalIOField<point>
                (
                    IOobject
                    (
                        fileName_,
                        mesh.time().constant(),
                        mesh,
                        IOobject::MUST_READ,
                        IOobject::NO_WRITE
                    )
                )
            );
 
        units_.makeStandard(tpositions.ref());
    }
    const pointField& positions = tpositions();
 
    const label number = positions.size();
 
    scalarField fraction(number, (time_ - t0)/(t1 - t0));
 
    // Locate within the mesh
    barycentricField coordinates(number);
    labelField celli(number, -1), facei(number), faceTrii(number);
    const List<LagrangianMesh::location> locations =
        mesh.locate
        (
            positions,
            coordinates,
            celli,
            facei,
            faceTrii,
            fraction
        );
 
    // Check for any failures
    checkLocation(locations, positions);
 
    // Remove particles not on this process
    filter(coordinates, celli, facei, faceTrii, fraction);
 
    // Inject particles
    return
        mesh.inject
        (
            *this,
            coordinates,
            celli,
            facei,
            faceTrii,
            LagrangianMesh::fractionName,
            fraction
        );
}
 
 
bool Foam::Lagrangian::manualInjection::read(const dictionary& modelDict)
{
    if (LagrangianInjection::read(modelDict))
    {
        readCoeffs(modelDict);
        return true;
    }
    else
    {
        return false;
    }
}
 
 
// ************************************************************************* //