FLAC3D Modeling • Introduction

How Commands Work

This section is a general description of commands, how they are constructed, their parts, how they operate with one another, and the like. It focuses on commands singly — as they are issued in the Console pane. Processing multiple commands in an uninterrupted flow via data file is described in detail in the section on Data Files. Command reference information is found throughout this documentation. Refer to the Command and FISH Reference Summaries for specific commands; the topic Command Tools lists the multiple program facilities available for accessing reference information on commands and FISH functions.

Four general principles govern commands in the program.

  1. A command without a range will affect on all objects of the type it is designed to operate on.
  2. Commands are processed in the order given. Later commands overwrite previous ones.
  3. To restrict or “subset” a command’s operation, a range is required. The range is a filter composed of one or more criteria (including logical operators) that identifies the set of objects to be targeted in a command.
  4. Commands can be undone with the command program undo. This will cause all commands except the last (the undone command) to be rerun since the last restore. not sure UNDO rises to the level of being needed here, but this is a logical place for it.

Illustration

The four points above are illustrated with the following commands.

zone cmodel assign mohr-coulomb
zone cmodel assign elastic
zone cmodel assign hoek-brown range position-x 1 500
program undo

The first command assigns the mohr-coulomb constitutive model to all zones (point 1). The second command assigns the elastic model to all zones, overwriting the first command (point 2). The third command, on the other hand, assigns the Hoek-Brown model to zones with centroid \(x\)-components lying within the range \(x\) = 1 and \(x\) = 500 (point 3). This last command will partially overwrite the second command in that, after complete, only zones outside the range given will retain the elastic assignment. The fourth command will undo the third command. At this point, the model state is such that the first two commands have been executived, and all zones are assigned the elastic model.

The use of ranges and groups to refine the application of commands to targeted objects is further introduced in the next topic.

A full index of commands is available in the Command and FISH Reference Summaries.