ExtractSurface.cpp File Reference

Detailed Description

Extracts the surface from the given mesh.

Copyright

Copyright (c) 2012-2025, OpenGeoSys Community (http://www.opengeosys.org) Distributed under a Modified BSD License. See accompanying file LICENSE.txt or http://www.opengeosys.org/project/license

Definition in file ExtractSurface.cpp.

#include <tclap/CmdLine.h>
#include <algorithm>
#include <memory>
#include <string>
#include <vector>
#include "BaseLib/FileTools.h"
#include "BaseLib/MPI.h"
#include "BaseLib/StringTools.h"
#include "InfoLib/GitInfo.h"
#include "MeshLib/IO/VtkIO/VtuInterface.h"
#include "MeshLib/IO/readMeshFromFile.h"
#include "MeshLib/IO/writeMeshToFile.h"
#include "MeshLib/Mesh.h"
#include "MeshToolsLib/MeshSurfaceExtraction.h"

Include dependency graph for ExtractSurface.cpp:

Go to the source code of this file.

Functions
int	main (int argc, char *argv[])

Function Documentation

main()

int main	(	int	argc,
		char *	argv[] )

Definition at line 29 of file ExtractSurface.cpp.

{
    TCLAP::CmdLine cmd(
        "Extracts a 2D surface from a 3D input mesh by specifying a normal "
        "vector and an angle. (The surface normal (0, 0, 0) will extract the "
        "complete outer boundary of the 3D mesh.)\n"
        "An extensive documentation can be found at "
        "https://docs.opengeosys.org/docs/tools/meshing-submeshes/"
        "extract-surface\n"
        "OpenGeoSys-6 software, version " +
            GitInfoLib::GitInfo::ogs_version +
            ".\n"
            "Copyright (c) 2012-2025, OpenGeoSys Community "
            "(http://www.opengeosys.org)",
        ' ', GitInfoLib::GitInfo::ogs_version);
    TCLAP::SwitchArg use_ascii_arg("", "ascii-output",
                                   "If the switch is set use ascii instead of "
                                   "binary format for data in the vtu output.",
                                   false);
    cmd.add(use_ascii_arg);
    TCLAP::ValueArg<double> angle_arg(
        "a", "angle",
        "tolerated angle (in degrees) between given normal and "
        "element normal, (min = 0), (max = 360)",
        false, 90, "ANGLE");
    cmd.add(angle_arg);
    TCLAP::ValueArg<double> z("z", "z-component", "z component of the normal",
                              false, -1.0, "Z-COMPONENT");
    cmd.add(z);
    TCLAP::ValueArg<double> y("y", "y-component", "y component of the normal",
                              false, 0, "Y-COMPONENT");
    cmd.add(y);
    TCLAP::ValueArg<double> x("x", "x-component", "x component of the normal",
                              false, 0, "X-COMPONENT");
    cmd.add(x);
    TCLAP::ValueArg<std::string> mesh_out(
        "o", "mesh-output-file",
        "Output (.vtu). The name of the file the surface mesh should be "
        "written to",
        false, "", "OUTPUT_FILE");
    cmd.add(mesh_out);
    TCLAP::ValueArg<std::string> mesh_in(
        "i", "mesh-input-file",
        "Input (.vtu). The name of the file containing the input mesh", true,
        "", "INPUT_FILE");
    cmd.add(mesh_in);
    cmd.parse(argc, argv);
 
    BaseLib::MPI::Setup mpi_setup(argc, argv);
 
    std::unique_ptr<MeshLib::Mesh const> mesh(MeshLib::IO::readMeshFromFile(
        mesh_in.getValue(), true /* compute_element_neighbors */));
 
    if (!mesh)
    {
        ERR("Error reading mesh file.");
        return EXIT_FAILURE;
    }
 
    if (mesh->getDimension() != 3)
    {
        ERR("Surfaces can currently only be extracted from 3D meshes.");
        return EXIT_FAILURE;
    }
 
    INFO("Mesh read: {:d} nodes, {:d} elements.", mesh->getNumberOfNodes(),
         mesh->getNumberOfElements());
 
    // extract surface
    Eigen::Vector3d const dir({x.getValue(), y.getValue(), z.getValue()});
    double const angle(angle_arg.getValue());
    std::unique_ptr<MeshLib::Mesh> surface_mesh(
        MeshToolsLib::MeshSurfaceExtraction::getMeshSurface(
            *mesh, dir, angle, getBulkIDString(MeshLib::MeshItemType::Node),
            getBulkIDString(MeshLib::MeshItemType::Cell),
            getBulkIDString(MeshLib::MeshItemType::Face)));
 
    std::string out_fname(mesh_out.getValue());
    if (out_fname.empty())
    {
        out_fname = BaseLib::dropFileExtension(mesh_in.getValue()) + "_sfc.vtu";
    }
 
    auto const data_mode =
        use_ascii_arg.getValue() ? vtkXMLWriter::Ascii : vtkXMLWriter::Binary;
    MeshLib::IO::writeVtu(*surface_mesh, out_fname, data_mode);
 
    return EXIT_SUCCESS;
}

References MeshLib::Cell, BaseLib::dropFileExtension(), ERR(), MeshLib::Face, MeshToolsLib::MeshSurfaceExtraction::getMeshSurface(), INFO(), MeshLib::Node, GitInfoLib::GitInfo::ogs_version, MeshLib::IO::readMeshFromFile(), and MeshLib::IO::writeVtu().