ReadFieldsTemplates.C

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2011-2014 OpenFOAM Foundation
    Copyright (C) 2018-2023 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/>.
 
\*---------------------------------------------------------------------------*/
 
#include "ReadFields.H"
#include "HashSet.H"
#include "IOobjectList.H"
 
// * * * * * * * * * * * * * * * Global Functions  * * * * * * * * * * * * * //
 
template<class Type, template<class> class PatchField, class GeoMesh>
Foam::wordList Foam::ReadFields
(
    const typename GeoMesh::Mesh& mesh,
    const IOobjectList& objects,
    PtrList<GeometricField<Type, PatchField, GeoMesh>>& fields,
    const bool syncPar,
    const bool readOldTime
)
{
    typedef GeometricField<Type, PatchField, GeoMesh> GeoField;
 
    // Names of GeoField objects, sorted order.
    const wordList fieldNames(objects.sortedNames<GeoField>(syncPar));
 
    // Construct the fields - reading in consistent (master) order.
    fields.resize_null(fieldNames.size());
 
    label nFields = 0;
 
    for (const word& fieldName : fieldNames)
    {
        if (!nFields)
        {
            Info<< "Reading " << GeoField::typeName << ':';
        }
        Info<< ' ' << fieldName;
 
        const IOobject& io = *objects[fieldName];
 
        fields.set
        (
            nFields++,
            new GeoField
            (
                IOobject
                (
                    io.name(),
                    io.instance(),
                    io.local(),
                    io.db(),
                    IOobjectOption::MUST_READ,
                    IOobjectOption::AUTO_WRITE,
                    io.registerObject()
                ),
                mesh,
                readOldTime
            )
        );
    }
 
    if (nFields) Info<< endl;
 
    return fieldNames;
}
 
 
template<class GeoField, class Mesh>
Foam::wordList Foam::ReadFields
(
    const Mesh& mesh,
    const IOobjectList& objects,
    PtrList<GeoField>& fields,
    const bool syncPar
)
{
    // Names of GeoField objects, sorted order.
    const wordList fieldNames(objects.sortedNames<GeoField>(syncPar));
 
    // Construct the fields - reading in consistent (master) order.
    fields.resize_null(fieldNames.size());
 
    label nFields = 0;
 
    for (const word& fieldName : fieldNames)
    {
        if (!nFields)
        {
            Info<< "Reading " << GeoField::typeName << ':';
        }
        Info<< ' ' << fieldName;
 
        const IOobject& io = *objects[fieldName];
 
        fields.set
        (
            nFields++,
            new GeoField
            (
                IOobject
                (
                    io.name(),
                    io.instance(),
                    io.local(),
                    io.db(),
                    IOobjectOption::MUST_READ,
                    IOobjectOption::AUTO_WRITE,
                    io.registerObject()
                ),
                mesh
            )
        );
    }
 
    if (nFields) Info<< endl;
 
    return fieldNames;
}
 
 
template<class GeoField>
Foam::wordList Foam::ReadFields
(
    const IOobjectList& objects,
    PtrList<GeoField>& fields,
    const bool syncPar
)
{
    // Names of GeoField objects, sorted order.
    const wordList fieldNames(objects.sortedNames<GeoField>(syncPar));
 
    // Construct the fields - reading in consistent (master) order.
    fields.resize_null(fieldNames.size());
 
    label nFields = 0;
 
    for (const word& fieldName : fieldNames)
    {
        if (!nFields)
        {
            Info<< "Reading " << GeoField::typeName << ':';
        }
        Info<< ' ' << fieldName;
 
        const IOobject& io = *objects[fieldName];
 
        fields.set
        (
            nFields++,
            new GeoField
            (
                IOobject
                (
                    io.name(),
                    io.instance(),
                    io.local(),
                    io.db(),
                    IOobjectOption::MUST_READ,
                    IOobjectOption::AUTO_WRITE,
                    io.registerObject()
                )
            )
        );
    }
 
    if (nFields) Info<< endl;
 
    return fieldNames;
}
 
 
template<class GeoField>
void Foam::ReadFields
(
    const word& fieldName,
    const typename GeoField::Mesh& mesh,
    const wordList& timeNames,
    objectRegistry& fieldsCache
)
{
    // Unload times that are no longer used
    {
        wordHashSet unusedTimes(fieldsCache.toc());
        unusedTimes.erase(timeNames);
 
        //Info<< "Unloading times " << unusedTimes << endl;
 
        for (const word& timeName : unusedTimes)
        {
            objectRegistry& timeCache =
                fieldsCache.lookupObjectRef<objectRegistry>(timeName);
 
            fieldsCache.checkOut(timeCache);
        }
    }
 
 
    // Load any new fields
    for (const word& timeName : timeNames)
    {
        // Create if not found
        if (!fieldsCache.found(timeName))
        {
            //Info<< "Creating registry for time " << timeName << endl;
 
            // Create objectRegistry if not found
            objectRegistry* timeCachePtr = new objectRegistry
            (
                IOobject
                (
                    timeName,
                    timeName,
                    fieldsCache,
                    IOobjectOption::NO_READ,
                    IOobjectOption::NO_WRITE,
                    IOobjectOption::REGISTER
                )
            );
            timeCachePtr->store();
        }
 
        // Obtain cache for current time
        const objectRegistry& timeCache =
            fieldsCache.lookupObject<objectRegistry>(timeName);
 
        // Store field if not found
        if (!timeCache.found(fieldName))
        {
            //Info<< "Loading field " << fieldName
            //    << " for time " << timeName << endl;
 
            GeoField loadedFld
            (
                IOobject
                (
                    fieldName,
                    timeName,
                    mesh.thisDb(),
                    IOobjectOption::MUST_READ,
                    IOobjectOption::NO_WRITE,
                    IOobjectOption::NO_REGISTER
                ),
                mesh
            );
 
            // Transfer to timeCache (new objectRegistry and store flag)
            GeoField* fldPtr = new GeoField
            (
                IOobject
                (
                    fieldName,
                    timeName,
                    timeCache,
                    IOobjectOption::NO_READ,
                    IOobjectOption::NO_WRITE,
                    IOobjectOption::REGISTER
                ),
                loadedFld
            );
            fldPtr->store();
        }
    }
}
 
 
template<class GeoField>
void Foam::ReadFields
(
    const word& fieldName,
    const typename GeoField::Mesh& mesh,
    const wordList& timeNames,
    const word& registryName
)
{
    ReadFields<GeoField>
    (
        fieldName,
        mesh,
        timeNames,
        const_cast<objectRegistry&>
        (
            mesh.thisDb().subRegistry(registryName, true)
        )
    );
}
 
 
template<class GeoFieldType, class NameMatchPredicate>
void Foam::readFields
(
    const typename GeoFieldType::Mesh& mesh,
    const IOobjectList& objects,
    const NameMatchPredicate& selectedFields,
    DynamicList<regIOobject*>& storedObjects
)
{
    // GeoField objects, sorted order. Not synchronised.
    const UPtrList<const IOobject> fieldObjects
    (
        objects.csorted<GeoFieldType>(selectedFields)
    );
 
 
    // pre-extend reserve
    storedObjects.reserve(storedObjects.size() + fieldObjects.size());
 
    label nFields = 0;
 
    for (const IOobject& io : fieldObjects)
    {
        if (!nFields)
        {
            Info<< "    " << GeoFieldType::typeName << ':';
        }
        Info<< ' ' << io.name();
 
        GeoFieldType* fieldPtr = new GeoFieldType
        (
            IOobject
            (
                io.name(),
                io.instance(),
                io.local(),
                io.db(),
                IOobjectOption::MUST_READ,
                IOobjectOption::NO_WRITE,
                IOobjectOption::REGISTER
            ),
            mesh
        );
        fieldPtr->store();
        storedObjects.push_back(fieldPtr);
 
        ++nFields;
    }
 
    if (nFields) Info<< endl;
}
 
 
template<class UniformFieldType, class NameMatchPredicate>
void Foam::readUniformFields
(
    const IOobjectList& objects,
    const NameMatchPredicate& selectedFields,
    DynamicList<regIOobject*>& storedObjects,
    const bool syncPar
)
{
    // UniformField objects, sorted order, synchronised.
    const UPtrList<const IOobject> fieldObjects
    (
        objects.csorted<UniformFieldType>(selectedFields, syncPar)
    );
 
    // pre-extend reserve
    storedObjects.reserve(storedObjects.size() + fieldObjects.size());
 
    label nFields = 0;
 
    for (const IOobject& io : fieldObjects)
    {
        if (!nFields)
        {
            Info<< "    " << UniformFieldType::typeName << ':';
        }
        Info<< ' ' << io.name();
 
        UniformFieldType* fieldPtr = new UniformFieldType
        (
            IOobject
            (
                io.name(),
                io.instance(),
                io.local(),
                io.db(),
                IOobjectOption::MUST_READ,
                IOobjectOption::NO_WRITE,
                IOobjectOption::REGISTER
            )
        );
        fieldPtr->store();
        storedObjects.push_back(fieldPtr);
 
        ++nFields;
    }
 
    if (nFields) Info<< endl;
}
 
 
template<class GeoFieldType, class NameMatchPredicate>
void Foam::readFields
(
    const typename GeoFieldType::Mesh& mesh,
    const IOobjectList& objects,
    const NameMatchPredicate& selectedFields,
    LIFOStack<regIOobject*>& storedObjects
)
{
    DynamicList<regIOobject*> newObjects;
 
    readFields<GeoFieldType, NameMatchPredicate>
    (
        mesh,
        objects,
        selectedFields,
        newObjects
    );
 
    // Transcribe from list to stack
    for (regIOobject* fieldPtr : newObjects)
    {
        storedObjects.push(fieldPtr);
    }
}
 
 
template<class UniformFieldType, class NameMatchPredicate>
void Foam::readUniformFields
(
    const IOobjectList& objects,
    const NameMatchPredicate& selectedFields,
    LIFOStack<regIOobject*>& storedObjects,
    const bool syncPar
)
{
    DynamicList<regIOobject*> newObjects;
 
    readUniformFields<UniformFieldType, NameMatchPredicate>
    (
        objects,
        selectedFields,
        newObjects,
        syncPar
    );
 
    // Transcribe from list to stack
    for (regIOobject* fieldPtr : newObjects)
    {
        storedObjects.push(fieldPtr);
    }
}
 
 
// ************************************************************************* //