`Domain` Class Documentation

Constructors

Domain() – Default constructor
Domain(viennaps::Domain) – Deep copy from another domain
Domain(viennals::Domain) – Initialize from a single Level-Set
Domain(std::vector<viennals::Domain>) – Initialize from multiple Level-Sets
Domain(gridDelta, xExtent, yExtent = 0.0, boundary) – Rectangular grid initialization
Domain(bounds[], boundaryConditions[], gridDelta) – Bounding box initialization
Domain(const Setup &setup) – From preconfigured domain setup

Key Member Functions

Domain Setup

void setup(const Setup &setup);
void setup(NumericType gridDelta, NumericType xExtent, NumericType yExtent = 0.0, BoundaryType boundary);

Initialize or reconfigure the simulation domain.

Level-Set Management

// Insert single level-set and assign material
void insertNextLevelSetAsMaterial(viennals::Domain levelSet, Material material, bool wrap = true);
// Dubplicate the top level-set and assign material
void duplicateTopLevelSet(Material material);
// Remove top level-set
void removeTopLevelSet();
// Remove level-set at index
void removeLevelSet(unsigned int idx, bool removeWrapped = true);
// Remove all level-sets with given material
void removeMaterial(Material material);

Insert, duplicate, or remove Level-Sets. Materials have to be assigned during insertion.

Topology Operations

void removeStrayPoints();
void getNumberOfComponents() const;

Analyze and clean up surface topology in the domain.

Boolean Operations

void applyBooleanOperation(viennals::Domain levelSet, viennals::BooleanOperationEnum op);

Apply a Boolean operation (e.g., union, intersection) across all Level-Sets in the domain.

Cell-Set Generation

void generateCellSet(NumericType position, Material coverMaterial, bool isAboveSurface = false);

Convert Level-Set stack into a Cell-Set for volume process modeling.

Material Mapping

void setMaterial(unsigned int lsId, Material material);

Assign or update material information for Level-Sets.

Data Accessors

auto& getSurface() const;
auto& getLevelSets() const;
auto& getMaterialMap() const;
auto& getCellSet() const;
auto& getGrid() const;
auto getGridDelta() const;
auto& getSetup();
auto getBoundingBox() const;
auto getBoundaryConditions() const;
auto getMetaData() const;
auto getMaterialsInDomain() const; // returns std::set<Material>

Access the surface Level-Set, grid, bounding box, material map, and setup.

Output & Export

void saveLevelSetMesh(std::string fileName, int width = 1);
void saveSurfaceMesh(std::string fileName, bool addInterfaces = true,
                     double wrappingLayerEpsilon = 0.01, bool boolMaterials = false);
auto getSurfaceMesh(bool addInterfaces = false, double wrappingLayerEpsilon = 0.01,
                    bool boolMaterials = false);
auto getLevelSetMesh(int width = 1);
void saveVolumeMesh(std::string fileName, double wrappingEps = 1e-2) const;
void saveHullMesh(std::string fileName, double wrappingEps = 1e-2) const;
void saveLevelSets(std::string prefix) const;
void print() const;
void show() const;

Save surface or volume meshes in VTK formats or print domain state to stdout.

Utilities

void deepCopy(SmartPointer<Domain> other);
void clear();
void clearMetaData();

Clone another domain or clear all internal data.

Notes

Level-Sets inserted with wrap = true are merged with underlying layers.
Material IDs are stored under the "MaterialIds" label in exported meshes.
Cell-Sets are not automatically generated and must be explicitly created using generateCellSet.

Example Usage

using DomainType = viennaps::Domain<double, 3>;
auto domain = DomainType::New(1.0, 10.0, 10.0);
auto ls = viennals::Domain<double, 3>::New();
// setup ls...
domain->insertNextLevelSetAsMaterial(ls, Material::Si);
domain->saveSurfaceMesh("surface.vtp");

Domain Class Documentation