removeMeshElements.cpp File Reference

Detailed Description

Remove mesh elements.

Author

Norihiro Watanabe

Date

2013/10/15

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 removeMeshElements.cpp.

#include <tclap/CmdLine.h>
#include <memory>
#include "BaseLib/MPI.h"
#include "InfoLib/GitInfo.h"
#include "MeshLib/Elements/Element.h"
#include "MeshLib/IO/readMeshFromFile.h"
#include "MeshLib/IO/writeMeshToFile.h"
#include "MeshLib/Mesh.h"
#include "MeshLib/MeshEnums.h"
#include "MeshLib/MeshSearch/ElementSearch.h"
#include "MeshLib/Node.h"
#include "MeshToolsLib/MeshEditing/RemoveMeshComponents.h"
#include "MeshToolsLib/MeshInformation.h"

Include dependency graph for removeMeshElements.cpp:

Go to the source code of this file.

Functions
template<typename PROPERTY_TYPE >
void	searchByPropertyValue (std::string const &property_name, std::vector< PROPERTY_TYPE > const &property_values, MeshLib::ElementSearch &searcher)
void	searchByPropertyRange (std::string const &property_name, double const &min_value, double const &max_value, bool const &outside, MeshLib::ElementSearch &searcher)
void	outputAABB (MeshLib::Mesh const &mesh)
int	main (int argc, char *argv[])

Function Documentation

main()

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

Definition at line 82 of file removeMeshElements.cpp.

{
    TCLAP::CmdLine cmd(
        "Removes mesh elements based on element type, element volume, scalar "
        "arrays, or bounding box . The documentation is available at "
        "https://docs.opengeosys.org/docs/tools/meshing/"
        "remove-mesh-elements.\n\n"
        "OpenGeoSys-6 software, version " +
            GitInfoLib::GitInfo::ogs_version +
            ".\n"
            "Copyright (c) 2012-2025, OpenGeoSys Community "
            "(http://www.opengeosys.org)",
        ' ', GitInfoLib::GitInfo::ogs_version);
 
    // Bounding box params
    TCLAP::SwitchArg invert_bounding_box_arg(
        "", "invert", "inverts the specified bounding box", false);
    cmd.add(invert_bounding_box_arg);
    TCLAP::ValueArg<double> zLargeArg(
        "", "z-max", "largest allowed extent in z-dimension", false,
        std::numeric_limits<double>::max(), "value");
    cmd.add(zLargeArg);
    TCLAP::ValueArg<double> zSmallArg(
        "", "z-min", "smallest allowed extent in z-dimension", false,
        -1 * std::numeric_limits<double>::max(), "value");
    cmd.add(zSmallArg);
    TCLAP::ValueArg<double> yLargeArg(
        "", "y-max", "largest allowed extent in y-dimension", false,
        std::numeric_limits<double>::max(), "value");
    cmd.add(yLargeArg);
    TCLAP::ValueArg<double> ySmallArg(
        "", "y-min", "smallest allowed extent in y-dimension", false,
        -1 * std::numeric_limits<double>::max(), "value");
    cmd.add(ySmallArg);
    TCLAP::ValueArg<double> xLargeArg(
        "", "x-max", "largest allowed extent in x-dimension", false,
        std::numeric_limits<double>::max(), "value");
    cmd.add(xLargeArg);
    TCLAP::ValueArg<double> xSmallArg(
        "", "x-min", "smallest allowed extent in x-dimension", false,
        -1 * std::numeric_limits<double>::max(), "value");
    cmd.add(xSmallArg);
 
    // Non-bounding-box params
    TCLAP::SwitchArg zveArg("z", "zero-volume", "remove zero volume elements",
                            false);
    cmd.add(zveArg);
 
    std::vector<std::string> allowed_ele_types{
        "point", "line", "tri", "quad", "hex", "prism", "tet", "pyramid"};
    TCLAP::ValuesConstraint<std::string> allowedVals{allowed_ele_types};
    TCLAP::MultiArg<std::string> eleTypeArg(
        "t", "element-type",
        "element type to be removed: point | line | tri | quad | hex | prism | "
        "tet | pyramid",
        false, &allowedVals);
    cmd.add(eleTypeArg);
 
    // scalar array params
    TCLAP::ValueArg<std::string> property_name_arg(
        "n", "property-name", "name of property in the mesh", false,
        "MaterialIDs", "string");
    cmd.add(property_name_arg);
 
    TCLAP::MultiArg<int> property_arg(
        "", "property-value", "value of selected property to be removed", false,
        "number");
    cmd.add(property_arg);
 
    TCLAP::ValueArg<double> min_property_arg(
        "", "min-value", "minimum value of range for selected property", false,
        0, "number");
    cmd.add(min_property_arg);
 
    TCLAP::ValueArg<double> max_property_arg(
        "", "max-value", "maximum value of range for selected property", false,
        0, "number");
    cmd.add(max_property_arg);
 
    TCLAP::SwitchArg outside_property_arg(
        "", "outside", "remove all elements outside the given property range");
    cmd.add(outside_property_arg);
 
    TCLAP::SwitchArg inside_property_arg(
        "", "inside", "remove all elements inside the given property range");
    cmd.add(inside_property_arg);
 
    // I/O params
    TCLAP::ValueArg<std::string> mesh_out(
        "o", "mesh-output-file",
        "the name of the file the mesh will be written to", true, "",
        "file name of output mesh");
    cmd.add(mesh_out);
    TCLAP::ValueArg<std::string> mesh_in(
        "i", "mesh-input-file",
        "the name of the file containing the input mesh", true, "",
        "file name of input mesh");
    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()));
    if (mesh == nullptr)
    {
        return EXIT_FAILURE;
    }
 
    INFO("Mesh read: {:d} nodes, {:d} elements.", mesh->getNumberOfNodes(),
         mesh->getNumberOfElements());
    MeshLib::ElementSearch searcher(*mesh);
 
    // search elements IDs to be removed
    if (zveArg.isSet())
    {
        INFO("{:d} zero volume elements found.", searcher.searchByContent());
    }
    if (eleTypeArg.isSet())
    {
        const std::vector<std::string> eleTypeNames = eleTypeArg.getValue();
        for (const auto& typeName : eleTypeNames)
        {
            const MeshLib::MeshElemType type =
                MeshLib::String2MeshElemType(typeName);
            if (type == MeshLib::MeshElemType::INVALID)
            {
                continue;
            }
            INFO("{:d} {:s} elements found.",
                 searcher.searchByElementType(type), typeName);
        }
    }
 
    if (property_name_arg.isSet() || property_arg.isSet() ||
        min_property_arg.isSet() || max_property_arg.isSet())
    {
        if ((property_arg.isSet() || min_property_arg.isSet() ||
             max_property_arg.isSet()) &&
            !property_name_arg.isSet())
        {
            ERR("Specify a property name for the value/range selected.");
            return EXIT_FAILURE;
        }
 
        if (property_name_arg.isSet() &&
            !((min_property_arg.isSet() && max_property_arg.isSet()) ||
              property_arg.isSet()))
        {
            ERR("Specify a value or range ('-min-value' and '-max_value') for "
                "the property selected.");
            return EXIT_FAILURE;
        }
 
        // name + value
        if (property_arg.isSet() && property_name_arg.isSet())
        {
            searchByPropertyValue(property_name_arg.getValue(),
                                  property_arg.getValue(), searcher);
        }
 
        // name + range
        if (property_name_arg.isSet() && min_property_arg.isSet() &&
            max_property_arg.isSet())
        {
            if ((!outside_property_arg.isSet() &&
                 !inside_property_arg.isSet()) ||
                (outside_property_arg.isSet() && inside_property_arg.isSet()))
            {
                ERR("Specify if the inside or the outside of the selected "
                    "range should be removed.");
                return EXIT_FAILURE;
            }
 
            bool const outside = outside_property_arg.isSet();
            searchByPropertyRange(
                property_name_arg.getValue(), min_property_arg.getValue(),
                max_property_arg.getValue(), outside, searcher);
        }
    }
 
    if (xSmallArg.isSet() || xLargeArg.isSet() || ySmallArg.isSet() ||
        yLargeArg.isSet() || zSmallArg.isSet() || zLargeArg.isSet())
    {
        outputAABB(*mesh);
        bool aabb_error(false);
        if (xSmallArg.getValue() >= xLargeArg.getValue())
        {
            ERR("Minimum x-extent larger than maximum x-extent.");
            aabb_error = true;
        }
        if (ySmallArg.getValue() >= yLargeArg.getValue())
        {
            ERR("Minimum y-extent larger than maximum y-extent.");
            aabb_error = true;
        }
        if (zSmallArg.getValue() >= zLargeArg.getValue())
        {
            ERR("Minimum z-extent larger than maximum z-extent.");
            aabb_error = true;
        }
        if (aabb_error)
        {
            return EXIT_FAILURE;
        }
 
        std::array<MathLib::Point3d, 2> extent(
            {{MathLib::Point3d(std::array<double, 3>{{xSmallArg.getValue(),
                                                      ySmallArg.getValue(),
                                                      zSmallArg.getValue()}}),
              MathLib::Point3d(std::array<double, 3>{
                  {xLargeArg.getValue(), yLargeArg.getValue(),
                   zLargeArg.getValue()}})}});
        INFO("{:d} elements found.",
             searcher.searchByBoundingBox(
                 GeoLib::AABB(extent.begin(), extent.end()),
                 invert_bounding_box_arg.getValue()));
    }
 
    // remove the elements and create a new mesh object.
    std::unique_ptr<MeshLib::Mesh const> new_mesh(MeshToolsLib::removeElements(
        *mesh, searcher.getSearchedElementIDs(), mesh->getName()));
 
    if (new_mesh == nullptr)
    {
        return EXIT_FAILURE;
    }
 
    // write into a file
    MeshLib::IO::writeMeshToFile(*new_mesh, mesh_out.getValue());
 
    return EXIT_SUCCESS;
}

References ERR(), MeshLib::ElementSearch::getSearchedElementIDs(), INFO(), MeshLib::INVALID, GitInfoLib::GitInfo::ogs_version, outputAABB(), MeshLib::IO::readMeshFromFile(), MeshToolsLib::removeElements(), MeshLib::ElementSearch::searchByBoundingBox(), MeshLib::ElementSearch::searchByContent(), MeshLib::ElementSearch::searchByElementType(), searchByPropertyRange(), searchByPropertyValue(), MeshLib::String2MeshElemType(), and MeshLib::IO::writeMeshToFile().

outputAABB()

void outputAABB

(

MeshLib::Mesh const &

mesh

)

Definition at line 71 of file removeMeshElements.cpp.

{
    const auto aabb(MeshToolsLib::MeshInformation::getBoundingBox(mesh));
    auto const [min, max] = aabb.getMinMaxPoints();
 
    INFO(
        "Bounding box of \"{:s}\" is\nx = [{:f},{:f}]\ny = [{:f},{:f}]\nz = "
        "[{:f},{:f}]",
        mesh.getName(), min.x(), max.x(), min.y(), max.y(), min.z(), max.z());
}

References MeshToolsLib::MeshInformation::getBoundingBox(), MeshLib::Mesh::getName(), and INFO().

Referenced by main().

searchByPropertyRange()

void searchByPropertyRange	(	std::string const &	property_name,
		double const &	min_value,
		double const &	max_value,
		bool const &	outside,
		MeshLib::ElementSearch &	searcher )

Definition at line 50 of file removeMeshElements.cpp.

{
    std::size_t n_marked_elements = searcher.searchByPropertyValueRange<double>(
        property_name, min_value, max_value, outside);
 
    if (n_marked_elements == 0)
    {
        n_marked_elements = searcher.searchByPropertyValueRange<int>(
            property_name, static_cast<int>(min_value),
            static_cast<int>(max_value), outside);
    }
 
    // add checks for other data types here (if n_marked_elements remains 0)
 
    INFO("{:d} elements in range [{:s}, {:s}] found.", n_marked_elements,
         std::to_string(min_value), std::to_string(max_value));
}

References INFO(), and MeshLib::ElementSearch::searchByPropertyValueRange().

Referenced by main().

searchByPropertyValue()

template<typename PROPERTY_TYPE >

void searchByPropertyValue	(	std::string const &	property_name,
		std::vector< PROPERTY_TYPE > const &	property_values,
		MeshLib::ElementSearch &	searcher )

Definition at line 31 of file removeMeshElements.cpp.

{
    for (auto const& property_value : property_values)
    {
        std::size_t n_marked_elements = searcher.searchByPropertyValue<double>(
            property_name, property_value);
        if (n_marked_elements == 0)
        {
            n_marked_elements = searcher.searchByPropertyValue<int>(
                property_name, property_value);
        }
 
        INFO("{:d} elements with property value {:s} found.", n_marked_elements,
             std::to_string(property_value));
    }
}

References INFO(), and MeshLib::ElementSearch::searchByPropertyValue().

Referenced by main().