Add
The Add mode allows to combine a structure with the original structure in such a way that both occupy the same domain. Adding structures commonly results in overlap between the original and the added structure.
Below the table of the available structures, the choice of Geometry Mode defines if the analytic data or the voxel geometry is used. The Material Mode defines the overlap behavior between the original and the added voxel structure if Voxel Geometry is selected. For the Analytic Geometry mode, the overlap behavior is given by the current structure. Finally, an Offset can be entered.
As default Geometry Mode, the Voxel Geometry is chosen. In this mode, the structures are added based on the voxel information alone. If analytic data was present in the geometry files before, this data is discarded.
As Material Mode you can choose between Material and Material ID, which defines the Material ID of the overlapping structure parts.
As seen for the Attach mode, the combined structure keeps the constituent material information from the original structure in case of same material IDs.
If Material is chosen, the Material ID of the overlap is defined through the given Overlap ID. Here, the material ID 06 with the color cyan is chosen.
If Material ID is chosen, there is no choice of Overlap ID. Instead, the Material ID of the overlap is computed by a bitwise OR operation on the ID numbers. In this mode, adding ID 02 and ID 04 leads to ID 06 (0010+0100=0110) and adding ID 01 and ID 01 leads to ID 01 (0001+0001=0001). Thus, in the example from above, there would is no separate Overlap Material ID, all solids have Material ID 01.
Know how! The color assigned to a Material ID can be changed later by selecting it through Settings → Color & Visibility Settings in the menu bar, its icon |
If the loaded structure contains analytic data, the Analytic Geometry (gad) mode becomes available. Here, the analytic objects are added, and the overlap rules are defined by the domain settings of the current structure (see GadGeo – Edit Domain in the GadGeo User Guide). This works only when the files of both structures (the chosen file and the current structure) contain analytic information. In the Analytic Geometry mode, the constituent materials from the currently loaded structure are used. This also holds if a Material ID appears in both structures.
In the Analytic Geometry mode, the domain of the added structure is determined by the domain settings of currently loaded structure. Thus, it is crucial in which order the structures are added. Consider the example from above, but this time the TwillWeave.gdt structure is loaded and the CurvedFibers.gdt is added to it. The resulting domain is smaller than before.
Important! This works only when the files of both structures (the chosen file and the current structure) contain analytic information. If the structure to add does not contain analytic data and you click Run, an error message will appear. ![]() |
At the bottom of the dialog, the user can define an offset for the position of the added structure. The default zero Offsets places the added structure starting at the (0, 0, 0) position of the original structure.
By setting non-zero Offsets in any of the three directions, a structure can be added to the original structure at any position in the given direction(s). If the offset forces the chosen structure to leave the domain of the current structure, the resulting structure will be enlarged.
For example, a woven mesh (TwillWeave.gdt) is added to the CurvedFibers.gdt (original structure) with an offset of 25 voxels in Z-direction and the Material Mode MaterialID. The combined structure shows the mesh embedded into the curved fibers.
With offsets of -50, -50, and 75, the mesh appears in the combined structure as follows:
With the same settings as before, but with the Geometry Mode Analytic Geometry chosen, the resulting structure will look like this: