surfaceMeshInfo.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) 2011-2022 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/>.
 
Application
    surfaceMeshInfo
 
Description
    Miscellaneous information about surface meshes.
 
Usage
    \b surfaceMeshInfo surfaceFile [OPTION]
 
    Options:
      - \par -areas
        Report area for each face.
 
      - \par -scale <scale>
        Specify a scaling factor when reading files.
 
      - \par -xml
        Write output in XML format.
 
    Note:
        The filename extensions are used to determine the file format type.
 
        The XML-like output can be useful for extraction with other tools,
        but either output format can be easily extracted with a simple sed
        command:
        \verbatim
            surfaceMeshInfo surfaceFile -areas | \
                sed -ne '/areas/,/:/{ /:/!p }'
 
            surfaceMeshInfo surfaceFile -areas -xml | \
                sed -ne '/<areas/,/</{ /</!p }'
        \endverbatim
 
\*---------------------------------------------------------------------------*/
 
#include "argList.H"
#include "Time.H"
 
#include "UnsortedMeshedSurfaces.H"
 
using namespace Foam;
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
int main(int argc, char *argv[])
{
    writeInfoHeader = false;
 
    argList::addNote
    (
        "information about surface meshes"
    );
 
    argList::noParallel();
    argList::validArgs.append("surface file");
 
    argList::addOption
    (
        "scale",
        "factor",
        "geometry scaling factor - default is 1"
    );
    argList::addBoolOption
    (
        "areas",
        "display area of each face"
    );
    argList::addBoolOption
    (
        "xml",
        "write output in XML format"
    );
 
    argList args(argc, argv);
    Time runTime(args.rootPath(), args.caseName());
 
    const fileName importName = args[1];
 
    // check that reading is supported
    if (!UnsortedMeshedSurface<face>::canRead(importName, true))
    {
        return 1;
    }
 
    const bool writeXML = args.optionFound("xml");
    const bool writeAreas = args.optionFound("areas");
 
 
    // use UnsortedMeshedSurface, not MeshedSurface to maintain ordering
    UnsortedMeshedSurface<face> surf(importName);
 
    scalar scaling = 0;
    if (args.optionReadIfPresent("scale", scaling) && scaling > 0)
    {
        Info<< " -scale " << scaling << endl;
        surf.scalePoints(scaling);
    }
 
    scalar areaTotal = 0;
 
    if (writeXML)
    {
        Info<<"<?xml version='1.0' encoding='utf-8'?>" << nl
            <<"<surfaceMeshInfo>" << nl
            << "<npoints>" << surf.nPoints() << "</npoints>" << nl
            << "<nfaces>"  << surf.size() << "</nfaces>" << nl;
 
        if (writeAreas)
        {
            Info<<"<areas size='" << surf.size() << "'>" << nl;
        }
    }
    else
    {
        Info<< "nPoints   : " << surf.nPoints() << nl
            << "nFaces    : " << surf.size() << nl;
 
        if (writeAreas)
        {
            Info<< "areas     : " << nl;
        }
    }
 
    forAll(surf, facei)
    {
        const scalar fArea(surf[facei].mag(surf.points()));
        areaTotal += fArea;
 
        if (writeAreas)
        {
            Info<< fArea << nl;
        }
    }
 
    if (writeXML)
    {
        if (writeAreas)
        {
            Info<<"</areas>" << nl;
        }
 
        Info<< "<area>" << areaTotal << "</area>" << nl
            << "</surfaceMeshInfo>" << nl;
    }
    else
    {
        Info<< "area      : " << areaTotal << nl;
    }
 
    return 0;
}
 
// ************************************************************************* //