wall import command

Syntax

wall import keyword ... <range>

Primary keywords:

filename    from-geometry    group    id    name    skip-errors

Import a wall. Walls can be imported directly from files that are supported by the geometry logic (i.e., .stl or .dxf files: see the geometry import command) or from geometry objects directly. Wall importation is accomplished by stitching {vertex in 2D; edge in 3D} connected facets (i.e., {line segments in 2D; triangles in 3D}) starting with a seed facet. The seed facet is taken as the first {edge in 2D; polygon in 3D} that falls in the specified range unless the seed keyword is given. The surface must be manifold (i.e., no facets can interpenetrate or touch other facets) and orientable (i.e., the surface is {vertex connected in 2D; edge connected in 3D}). All facets must fall within the model domain.

Note

  • A model domain must be specified prior to wall importation.

  • While cycling, walls can only be created before cycle point 0 (i.e., when the timestep is calculated).

filename s

Name of the file from which to import. A temporary geometry set is created with the name s and the wall is imported from the geometry set. If an error occurs during the process, the geometry set remains for further scrutiny.

from-geometry s

Name of the geometry set from which to import. The following keywords may be provided:

clean

Delete the geometry set after wall importation if the operation is successful. If given with the nothrow keyword, the geometry set will be deleted regardless of whether or not all facets are imported.

keepid

Specify that the facet IDs will be set to the IDs of the geometry {edges in 2D; polygons in 3D}.

seed i

ID of the geometry {edge in 2D; polygon in 3D} with which to start the stitching process. This keyword can be used with the nothrow keyword to import from geometry sets where multiple meshes are present that are disjoint.

group s <slot slot > <facet> ...

Set name s to the group name at slot slot to the created wall or its constituent facets. If the slot keyword is not given, then the group name is set in Default. The optional facet keyword specifies that the group is assigned to the facets and not to the wall.

id id

Wall ID. If not specified, the wall ID is set to the next available ID.

name s

Name of the wall. If not specified, then the wall name is set to file name or the geometry set name.

skip-errors

Optional keyword indicating that the import will continue in spite of the detection of non-manifold conditions or points falling outside the model domain. The offending facets are ignored.

Usage Example

Here is an example of the use of the wall import command, by which the geometry of complex elements can be imported and included into the model.

model new
model domain extent -2 2

wall import filename 'gear.stl' skip-errors id 100
wall rotate axis 1 0 0 angle 90 point 0 0 0
wall group 'gear' range set id 100
../../../../../../_images/gear.png

Figure 1: An example of the use of the wall import command.

Visit the “Ribbon Blender” tutorial example to see an example of application of the wall import command.