# block excavate command

Syntax

block excavate <face-group s1 <slot s2 >> <range>

All blocks within the range are excavated. Excavated blocks are assigned a constitutive model and model properties the same as adjacent non-excavated blocks. However, the excavated blocks transmit no forces to the un-excavated grid. Only displacements are calculated in the excavated blocks to enable future filling. The blocks can be replaced later with the block fill command. This command can only be used with deformable blocks; use block delete for rigid blocks.

Excavated blocks may be plotted.

Excavated blocks are automatically joined together.

If the optional face-group keyword is used, the faces of blocks adjacent to the excavation are assigned to the group s1 (in slot s2, if supplied).