CHAPTER 7

Geometry: STL and Primitive Surfaces

Import, transformation, motion and remeshing of surfaces that interact with particles.

7.1 STL module

The module Geometry › STL allows you to import STL files, view the list of active geometries, remove items, consult mesh information, apply transformations, set motion and enable force/torque measurement per body. The panel is organized into: import and access to Sketch Modeler; list of imported STLs; transformation and movement settings; and remeshing.

Figure 7.1 - STL Configuration Panel: import, open Sketch Modeler, list of imported STLs, Information / Remove/All buttons, Transformations and Motion expanders, force and torque measurement option, and STL remeshing.
Figure 7.1 - STL Configuration Panel: import, open Sketch Modeler, list of imported STLs, Information / Remove/All buttons, Transformations and Motion expanders, force and torque measurement option, and STL remeshing. Original Portuguese-interface capture.

7.2 Import STL

Click Import STL and select the file in the dialog. After import:

  • Check the name in the list of imported STLs;
  • Check the visual scale in viewport;
  • assign material to the corresponding wall, where applicable;
  • Use Information to review mesh data (no of triangles, size, scale, movement).
How to: import and position an STL - (1) In Geometry › STL, click on Import STL and select the file; (2) check the scale (if exported in mm, apply factor 0.001 in Transformations); (3) translate/rotate to position; (4) assign the wall material; (5) if it is a moving part, define the Movement; (6) click Apply Settings.

7.3 Remove STL

Use Remove to delete the selected item or All to clear the entire list. Removal also eliminates visualization and associated references (materials, motion, force measurement).

7.4 Transformations

The expander Transformations includes scale factor, translation X/Y/Z (in meters) and rotation X/Y/Z (in degrees). Use them to correct import scale, shift the origin and orient the geometry.

Attention to units - DEM is highly sensitive to scale. An STL exported in millimeters and applied without scale factor results in geometry a thousand times greater than expected. Always check the scale immediately after import.

7.5 Surface movement

The expander Movement prescribes the kinematics of geometry - it moves in an imposed way (it is not dragged by particles), but transmits force and momentum to the particles it touches. Several types are available; what each parameter does is detailed below the table.

TYPE TYPICAL APPLICATION
Stationary Fixed walls, bottom, container, gutters
Linear Piston, pusher plate, feeder
Rotary Drum, screw, paddles, agitator
Vibration Vibrating sieve, densimetric table
Belt / Conveyor Belt conveyor
Elevator Bucket elevator (closed loop)
Free-body 6-DOF Collection bucket, impact-actuated flap/door, force test rig — any part that must react to the physics instead of following a prescribed path (§7.11)

The table below details exactly what to set up in each model - what each field means and the expected unit:

MODEL FIELD TO CONFIGURE MEANING / UNIT
Stationary - (none) The geometry does not move; this is the default.
Linear Velocity vector v (vx, v y, v z) Direction and magnitude of translation [m/s]. For example: (0; −0.2; 0) moves down at 0.2 m/s.
Rotary Vector ω (ωx, ω y, ω z) Rotation axis (direction) and angular velocity (magnitude) [rad/s]. E.g. (0; 0; 2.09) ≈ 20 rpm in the XY plane.
Rotary Centre of rotation (cx, c y, c z) Point through which the spin axis passes [m]. Place on the actual axis of the drum.
Vibration Amplitude A Maximum displacement of oscillation [m].
Vibration Frequency f Number of cycles per second [Hz].
Vibration Vibration direction Vector that defines along which axis the surface oscillates.
Belt / Conveyor Belt speed Tangential speed of the mesh “skin” [m/s]; the geometry does not translate.
Elevator Centre A and Centre B The two drum centres (below and above) of the circuit [m].
Elevator Drum shaft Vector of the axis around which the arcs are drawn.
Elevator Radius Radius of the semicircular arcs connecting the straight sections [m].
Elevator Track speed Speed of the bucket along the closed circuit [m/s].
Free-body 6-DOF Mass, center of mass, inertia, initial velocities, axis locks, hinge Full Newtonian dynamics (gravity + contact) — see 7.11 for the parameter list.
Which motion to use — Drum/mixer/agitator → Rotary (set ω and the center). Belt conveyor → Belt (set the belt speed). Screen/sieve → Vibration (set amplitude, frequency and direction). Feeder/pusher → Linear (set the vector v). Bucket elevator → Elevator (set the two centers, axis, radius and speed). A part that must react to the impact of the material instead of following a prescribed path (collection bucket, flap/door, test rig) → Free-body 6-DOF (7.11). Combine any of the prescribed models with the ramp (7.6) to start and stop smoothly — the ramp does not apply to Free-body 6-DOF, which already starts at rest or at the configured initial velocity.
Unit of rotation - The angular velocity is in rad/s, not revolutions per minute. A drum at 20 rpm corresponds to ω ≈ 2.09 rad/s. Entering 20 in the field corresponds to ~191 rpm - common source of "explosion" at the beginning. Check the axis and center of rotation in preview in the viewport before running.

7.6 Acceleration ramp

The ramp smooths the start and end of motion, avoiding the numerical shock that would occur if geometry jumped from rest to full velocity in a single step (this would launch particles in contact and destabilize the case). The speed increases linearly from rest to full value along the ascent ramp, is maintained during the regime and optionally decays at the end. The ramp and motion-segment parameters:

PARAMETER WHAT IT DOES
Start time (t0) Time at which motion starts from rest. Before t₀, the geometry remains stationary.
Full speed time Duration of the acceleration ramp, from t₀ to 100% of v/ω. A larger value gives a smoother start.
Stop at end time If checked, motion decelerates and stops as the simulation end time approaches.
Duration of the descent ramp Time to slow down from 100% until rest (when shutdown is active).
How to Do - Rotary Drum with Smooth Start - (1) Under Motion, choose Rotary; (2) enter the axis in ω - e.g. (0, 0, 2,09) rotates in the XY plane to ~20 rpm - and the centre of rotation on the drum shaft; (3) under Ramp, leave Start time = 0 and Full speed time = 0,5–1,0 s; (4) click Apply Settings and check the direction of turning on preview before Run.
Amplitude and motion segments. Prescribed motion can be split into segments. Each segment sets its start time, amplitude and ramp duration. Amplitude multiplies the configured velocity: 1.0 uses the nominal value, 0.5 uses half and −1.0 reverses the direction. Use successive segments to accelerate, hold, decelerate, stop or reverse. Confirm the dialog and click Apply on the geometry panel. Free 6-DOF bodies do not use prescribed motion.

7.7 Measurement of force and torque

Option Measure force and torque of this STL enables body outputs, recorded on results/.../body_forces.csv. Use to evaluate torque in rotating drums and mills, load in chutes and liners, force on silo and hopper walls, and time variation of loads in mechanical designs.

7.8 STL remeshing

The panel STL Remeshing adjusts the triangle density of the selected mesh. Increasing density subdivides triangles preserving shape; decreasing it returns to the original mesh or to a less dense version, avoiding destructive simplification.

SITUATION RECOMMENDATION
Very coarse mesh Bad contact, particles can "jump" surfaces. Increase the density.
Very dense mesh High computational cost without physical benefit. Reduce the density.
Curved surfaces They need enough density to represent the curvature.
Details < particle radius They don't usually justify the cost of keeping them on the mesh.

7.9 Primitive surfaces

The module Geometry › Surfaces creates surfaces without need of STL file. Three types are available:

  • Box - rectangular box defined by min/max; can be container (particles are inside) or obstacle (particles are outside);
  • Cylinder - defined by two axis points, radius and optionally secondary radius (conical geometry) and lids;
  • Plane - defined by point, normal and size; there are presets for floor, ceiling and side walls. Normal is critical: determines the side on which particles interact.
Figure 7.2 - Surface panel: Type (Box/Cylinder/Plane), name, minimum/max parameters and container/obstacle selector. Container confines the particles (box, silo, reactor); Obstacle is a solid block that particles bypass.
Figure 7.2 - Surface panel: Type (Box/Cylinder/Plane), name, minimum/max parameters and container/obstacle selector. Container confines the particles (box, silo, reactor); Obstacle is a solid block that particles bypass. Original Portuguese-interface capture.
How to create a floor and container box - (1) In Geometry › Surfaces, choose the Type (e.g. box); (2) give a name(3) adjust Min/Max; (4) select Container (walls confine particles) or Obstacle; (5) define the Movement if the part is mobile; (6) click Add Surface. For a plane, enable STL edges and check the normal arrow - if it points the wrong way, reverse it.

7.10 Assignment of material to surfaces

Each surface (STL or primitive) must have one wall material associated, which defines the side of the pairwise interaction. Typical wall materials: carbon steel, rubber, ceramic liner, concrete. The actual behavior of contact depends on interaction (pair particle material × wall material), not only of isolated materials - see Chapter 10.

7.11 Free-body 6-DOF (Newtonian dynamics)

Unlike the models above — which prescribe the trajectory (the body follows exactly the configured velocity/rotation, no matter what touches it) —, the Free-body 6-DOF mode lets the STL move under the simulation's own physics: gravity and the contact forces/torques received from the particles accelerate it, exactly as a large particle would respond. It is the right model for a part that must react to the material instead of following an imposed path — a collection bucket that swings when struck, a flap that opens under load, a float, or a test rig used to measure impact force. Available for STL only (not for primitive Box/Cylinder/Planee).

Select Free-body 6-DOF in the same Motion Type selector (7.5). Three presets speed up the initial setup:

  • Free — 6 degrees of freedom — no axis locked; the body translates and rotates freely;
  • Fixed body — every axis locked (equivalent to Stationary, but inside the 6-DOF flow — useful for testing the setup before releasing degrees of freedom);
  • Rotation only around X/Y/Z — locks translation and the other two rotations, leaving the body free to spin about a single axis (e.g., a hinged door, a tipping gate).

For mass properties, Compute STL mass, center and inertia + material density automatically derives mass, center of mass, and the inertia tensor from mesh volume and material density. The mesh must be closed (watertight); for open meshes, repair the STL or enter values obtained from CAD/testing. Never copy mass or inertia from a different body.

Figure 7.3 — Free-body 6-DOF region: preset, mass properties, initial state, and inertia tensor.
Figure 7.3 — Free-body 6-DOF region: preset, mass properties, initial state, and inertia tensor. Original Portuguese-interface capture.
INTERFACE SECTIONWHAT IT DOESHOW TO SET IT
Quick setupFills the six Tx, Ty, Tz, Rx, Ry, and Rz locks.Select Free, Fixed, or rotation about X/Y/Z and click Apply preset. Then check the effective-DOF summary.
MassSets resistance to linear acceleration [kg].Use automatic calculation with a closed STL and correct density; edit manually only from reliable data.
World center of massThe X/Y/Z point [m] where translation is integrated and torque arms are measured.Use the calculated value; after repositioning the STL, recalculate or update the world coordinates.
Initial orientationRoll X, Pitch Y, and Yaw Z [degrees], converted to a quaternion.Enter the actual initial pose. Avoid applying the same rotation in both the STL transform and these fields without checking the preview.
Initial linear velocityWorld v₀ vector X/Y/Z [m/s].Leave zero to start from rest or enter the physical velocity at the initial instant.
Initial angular velocityBody-frame ω₀ vector X/Y/Z [rad/s].Leave zero to start from rest. Convert rpm to rad/s when necessary.
Inertia tensorIxx, Iyy, Izz, Ixy, Ixz, and Iyz [kg·m²] in the body frame.Prefer automatic calculation. The tensor must be symmetric and positive definite.
External force and torqueAdd constant world vectors [N] and [N·m] on top of gravity and contacts.Use zero when no known external load exists; do not use these fields to imitate a hinge.
Axis locksIndividually block Tx/Ty/Tz and Rx/Ry/Rz.Check only the degrees that must remain immobile. For a physical joint, use Physical hinge.
Physical hingeFixes a world pivot and allows rotation only about the axis vector.Enable it; enter a pivot X/Y/Z [m] on the real hinge line and a nonzero axis such as (0,0,1).
Hybrid driveControls linear or angular velocity with limited force/torque while other degrees remain dynamic.Set axis, target, gain, and maximum limit. Start with a moderate gain and verify that the controller does not dominate contacts.
Springs and dampersCreate a linear reaction about a rest position and/or angular reaction about a target orientation.Enable the group, copy the initial state as reference, and enter k and c by axis. Start conservatively and check stability.
Advanced elastic limitsApply a penalty beyond minimum/maximum position [m] or relative rotation [rad].Enable by axis and enter min., max., k, and c. k=0 creates no reaction; slight overshoot is expected.
Safe setup sequence — (1) select the moving STL; (2) choose Free 6-DOF body; (3) compute mass/center/inertia; (4) enter the initial state; (5) configure locks or hinge; (6) leave drives, springs, and limits disabled unless the case requires them; (7) click Apply Settings; (8) save and start a new Run.

7.11.1 Available free-body 6-DOF outputs

When the project contains at least one 6-DOF STL, the 6-DOF Bodies group appears in Results and reads free_body_dynamics.csv. The only quick series currently available are:

  • Center-of-mass position — X, Y, and Z [m];
  • Linear velocity — components and magnitude [m/s];
  • Orientation (quaternion) — W, X, Y, and Z;
  • Angular velocity — components and magnitude [rad/s];
  • Resultant force — components and magnitude [N];
  • Resultant torque — components and magnitude [N·m];
  • Mechanical power — instantaneous power [W].
Free bodies and simulation restart — like the Elevator, the Free-body 6-DOF configuration is locked from the checkpoint onward: changing it after the checkpoint was written blocks the restart, and it also cannot be changed in a pause-then-continue — only in a new Run. See Chapter 13.7.

7.12 STL colors and opacity

Use the geometry color swatch and opacity control to organize the view. Color and transparency are visual properties saved in the project; they do not assign material, friction or boundary conditions. Check physical assignments in the materials/interactions list.