3DEC
Welcome to the 3DEC 7.0 documentation.
Users of previous versions of 3DEC may find the page 3DEC 7 for 3DEC 5.2 Users a good place to start before delving into this version’s commands and FISH.
New users should start here: Getting Started.
Base 3DEC Commands
The main commands used by 3DEC are encapsulated on the list below. Note these are a mix of 3DEC-specific commands and commands that are also commonly used by PFC and FLAC3D.
c block | c history |
c data | c model |
c dfn | c plot |
c domain | c program |
c fish | c project |
c flow | c sel |
c geometry | c structure |
c group | c table |
c | c trace |
See the Range Phrase Keyword Reference in the range (keyword) section for reference information on range construction.
FISH Functions
FISH functions used in 3DEC are presented below in groups. Common functions (ones also used by PFC and FLAC3D) appear on the left and 3DEC-specific functions appear on the right.
Common | 3DEC-specific | |
c dfn | process utilities | c block |
c domain | c socket | c feblock |
c file | c system | c fluid flow |
c geometry | c table | c sel |
c global | c time | |
c group | user data functions | |
c io | value type utilities | |
c mail | c version | |
c math |
- 3DEC Modeling
- Introduction
- Getting Started
- Problem Solving with 3DEC
- Approach and Project Setup
- Model Generation
- Zoning 3DEC Blocks
- Choice of Constitutive Model
- Material Properties
- Boundary Conditions
- Initial Conditions
- Uniform Stresses in an Unjointed Medium: No Gravity
- Stresses with Gradients in an Unjointed Medium: Uniform Material
- Stresses with Gradients in a Nonuniform Material
- Compaction within a Model with Nonuniform Zoning
- Initial Stresses following a Model Change
- Stresses in a Jointed Medium
- Specifying Initial Pore Pressure
- Transferring Field Stresses to Model Stresses
- Reaching Equilibrium
- Loading and Sequential Modeling
- Working with Geometric Data
- Working with FISH
- Exporting 3DEC models
- 3DEC Theory and Background
- Background — the 3D Distinct Element Method
- Constitutive Models in 3DEC
- Block Constitutive Models
- Zone Constitutive Models
- Creep Material Models
- Joint Constitutive Models
- Writing New Constitutive Models
- Structural Elements
- Introduction
- Rock Reinforcement
- Local Reinforcement at Joints (sel reinforcement command)
- Hybrid Bolts (sel hybrid command)
- Modeling Considerations
- References
- Fluid-Mechanical Interaction
- Introduction
- Pore Pressure and Effective Stress
- Matrix Fluid Flow
- Introduction
- 3DEC Fluid-Mechanical Formulation – Mathematical Description
- Numerical Formulation
- Properties and Units for Fluid Flow Analysis
- Porosity
- Fluid-Flow Boundary Conditions, Initial Conditions, Sources, and Sinks
- Calculation Modes for Fluid-Mechanical Interaction
- Verification Examples
- Joint Fluid Flow
- Introduction
- Joint Hydraulics and Parallel Plate Model for Incompressible Flow
- Hydromechanically Coupled Fluid-Flow Formulation in Rock Masses
- 3DEC Joint Model
- Calculation Modes and Commands for Fluid-Flow Analysis
- Leak-off
- Considerations for Model Optimization
- Representation of a Discrete Fracture Network (DFN) for Fluid Flow Simulations
- Geometrical and Topological Model of a Fractured Rock Mass
- Gas Flow
- Fluid Discharge and Velocity
- References
- Proppant
- Fluid Flow Properties and Units
- Factor-of-Safety Calculation
- Energy Calculation
- Introduction
- Energy Balance
- Calculation of Individual Energy Components
- References
- Isolated Block Stability Method
- Structural Finite Elements
- Element Formulation
- Element Implementation in 3DEC
- Contact Forces
- Application of Boundary Loads and Velocities
- Solution Algorithm
- Generation and Use of FE Blocks
- Shape Functions and Derivatives
- Commands and Keywords for Finite Element Blocks
- Verification: Cantilever Beam
- Example: Tunnel Liner
- Example of Creating a Finite Element Base Model of a Dam in 3DEC
- References
- 3DEC Commands and FISH
- Block
- Commands
- block commands
block analyze-stability
commandblock apply
commandblock apply-remove
commandblock cells
commandblock copy
commandblock create
commandblock cut
commandblock delete
commandblock densify
commandblock dynamic
commandblock excavate
commandblock export
commandblock fill
commandblock finite-element
commandblock fix
commandblock fluid
commandblock fragment
commandblock free
commandblock generate
commandblock group
commandblock hide
commandblock history
commandblock import
commandblock initialize
commandblock insitu
commandblock join
commandblock joint-plane
commandblock list
commandblock makewall
commandblock mechanical
commandblock merge-finish
commandblock merge-start
commandblock property
commandblock skip-join-update
commandblock thermal
commandblock to-flac3d
commandblock to-pfc
commandblock to-udec
commandblock tolerance
commandblock trace
commandblock update
commandblock vtk
commandblock water
command
- block contact commands
block contact apply
commandblock contact area-minimum
commandblock contact compute
commandblock contact delete-open
commandblock contact generate-subcontacts
commandblock contact group
commandblock contact group-subcontact
commandblock contact history
commandblock contact jmodel
commandblock contact join
commandblock contact list
commandblock contact local-stiffness
commandblock contact material-table
commandblock contact property
commandblock contact property-distribution
commandblock contact record-shear
commandblock contact reset
commandblock contact tolerance
command
- block face commands
- block gridpoint commands
- block zone commands
block zone cmodel
commandblock zone fluid
commandblock zone generate
commandblock zone generate-new
commandblock zone group
commandblock zone initialize
commandblock zone list
commandblock zone nodal-mixed-discretization
commandblock zone property
commandblock zone property-distribution
commandblock zone size
commandblock zone thermal
commandblock zone volume-minimum-delete
command
- fblock commands
- block commands
- FISH Functions
- block functions
block.area
block.atol
block.btol
block.contactlist
block.convergence
block.ctol
block.damp.alpha
block.damp.beta
block.damp.global
block.damp.local
block.density
block.disp
block.dsf
block.dt.fraction
block.dtol
block.eigen
block.etol
block.excavated
block.extra
block.facelist
block.feb.elementlist
block.feb.facelist
block.find
block.fix
block.fluid.bulk
block.fluid.cohesion
block.fluid.density
block.fluid.htc
block.fluid.specheat
block.fluid.thermcond
block.fluid.viscosity
block.fluid.vol.unbal.av
block.fluid.vol.unbal.max
block.force.app
block.force.unbal
block.freefield
block.fromindex
block.gas.alpha
block.gas.bulkmin
block.gas.constant
block.gas.densmin
block.gplist
block.group
block.group.remove
block.head
block.hidden
block.id
block.index
block.inside
block.isgroup
block.list
block.mass
block.master
block.mech.ratio
block.mech.ratio.avg
block.mech.ratio.max
block.moi
block.moitensor
block.moment
block.ms
block.msnext
block.near
block.next
block.num
block.pos
block.proppant.conclimit
block.proppant.density
block.proppant.grainsize
block.proppant.grainsize.factor
block.proppant.modulus
block.proppant.perm
block.proppant.perm.factor
block.region
block.rigid
block.rvel
block.thermal.conductivity
block.thermal.diffusivity
block.thermal.grid.n12
block.thermal.grid.n23
block.thermal.grid.num
block.thermal.grid.point
block.thermal.grid.source
block.thermal.grid.strength
block.thermal.grid.tstart
block.thermal.line.n12
block.thermal.line.num
block.thermal.line.point
block.thermal.line.source
block.thermal.line.strength
block.thermal.line.tstart
block.thermal.point
block.thermal.point.num
block.thermal.point.source
block.thermal.point.strength
block.thermal.point.tstart
block.thermal.source.components
block.thermal.decay.fraction
block.thermal.source.fraction
block.thermal.source.num
block.unbal
block.vel
block.vol
block.wall
block.zonelist
- block.contact functions
block.contact.b1
block.contact.b2
block.contact.dfnid
block.contact.energy.fric
block.contact.energy.strain.comp
block.contact.energy.strain.shear
block.contact.energy.strain.tensile
block.contact.energy.strain.total
block.contact.excavated
block.contact.extra
block.contact.fb1
block.contact.fb2
block.contact.fid
block.contact.find
block.contact.flowplane
block.contact.fromindex
block.contact.group
block.contact.group.remove
block.contact.head
block.contact.hidden
block.contact.id
block.contact.index
block.contact.isgroup
block.contact.jset
block.contact.list
block.contact.near
block.contact.next
block.contact.normal
block.contact.num
block.contact.pos
block.contact.subcontactlist
block.contact.type
- block.subcontact functions
block.subcontact.apini
block.subcontact.area
block.subcontact.b1
block.subcontact.b2
block.subcontact.contact
block.subcontact.dfnid
block.subcontact.disp.norm
block.subcontact.disp.shear
block.subcontact.disp.shear.max
block.subcontact.edgegp
block.subcontact.energy
block.subcontact.energy.total
block.subcontact.excavated
block.subcontact.extra
block.subcontact.face
block.subcontact.fid
block.subcontact.find
- block.subcontact.flowplane.vertex
block.subcontact.flowplane.zone
block.subcontact.force.norm
block.subcontact.force.pp
block.subcontact.force.shear
block.subcontact.fromindex
block.subcontact.gp
block.subcontact.group
block.subcontact.group.remove
block.subcontact.hidden
block.subcontact.id
block.subcontact.index
block.subcontact.isgroup
block.subcontact.list
block.subcontact.model
block.subcontact.near
block.subcontact.near.list
block.subcontact.next
block.subcontact.num
block.subcontact.partner
block.subcontact.pos
block.subcontact.pp
block.subcontact.prop
block.subcontact.sratio
block.subcontact.state
block.subcontact.state.string
block.subcontact.stress.norm
block.subcontact.stress.shear
block.subcontact.type
block.subcontact.vel.shear
- block.face functions
block.face.area
block.face.bface
block.face.excavated
block.face.extra
block.face.fblock
block.face.fid
block.face.find
block.face.flowplane
block.face.fos.kinematic
block.face.fromindex
block.face.gp
block.face.gplist
block.face.group
block.face.group.remove
block.face.hidden
block.face.hostblock
block.face.id
block.face.index
block.face.isgroup
block.face.jset
block.face.list
block.face.next
block.face.ngp
block.face.normal
block.face.original
block.face.planar
block.face.pos
block.face.sreg
block.face.zone
- block.gp functions
block.gp.convergence
block.gp.bc
block.gp.bc.norm
block.gp.bc.x
block.gp.bc.y
block.gp.bc.z
block.gp.disp
block.gp.dsf
block.gp.extra
block.gp.fblock
block.gp.find
block.gp.flowknot
block.gp.flux
block.gp.flux.app
block.gp.force.app
block.gp.force.reaction
block.gp.force.unbal
block.gp.fromindex
block.gp.gplinks
block.gp.group
block.gp.group.remove
block.gp.hostblock
block.gp.id
block.gp.index
block.gp.isgroup
block.gp.linkzones
block.gp.list
block.gp.mass
block.gp.mass.dynamic
block.gp.mass.thermal
block.gp.near
block.gp.near.list
block.gp.next
block.gp.num
block.gp.pos
block.gp.pp
block.gp.ratio
block.gp.ratio.target
block.gp.stiffness
block.gp.temp
block.gp.vel
block.gp.vel.app
- block.zone functions
block.zone.condition
block.zone.containing
block.zone.discharge
block.zone.dt.fraction
block.zone.excavated
block.zone.extra
block.zone.face.area
block.zone.face.gp
block.zone.face.normal
block.zone.face.pos
block.zone.find
block.zone.fromindex
block.zone.geo_metric
block.zone.gp
block.zone.group
block.zone.group.remove
block.zone.hidden
block.zone.hostblock
block.zone.isgroup
block.zone.join
block.zone.list
block.zone.mass
block.zone.model
block.zone.near
block.zone.next
block.zone.nmd
block.zone.num
block.zone.plane.traction
block.zone.pos
block.zone.pp
block.zone.prop
block.zone.prop.thermal
block.zone.strain.rotation.inc
block.zone.strain.rotation.rate
block.zone.state
block.zone.strain.inc
block.zone.strain.rate
block.zone.strain.shear.inc
block.zone.strain.shear.rate
block.zone.strain.total
block.zone.strain.vol.inc
block.zone.strain.vol.rate
block.zone.stress
block.zone.stress.effective
block.zone.stress.int
block.zone.stress.max
block.zone.stress.min
block.zone.stress.prin
block.zone.stress.prin.dir
block.zone.vol
- block.fragment functions
- block.field functions
block.field.component
block.field.effective
block.field.extra
block.field.get
block.field.get.gp
block.field.hide.exc
block.field.index
block.field.init
block.field.method.index
block.field.method.name
block.field.name
block.field.power
block.field.prop
block.field.quantity
block.field.radius.ratio
block.field.reset
block.field.source
block.field.tol
- fblock functions
- block functions
- Commands
- FEBlock
- Flow
- Commands
- FISH Functions
- flowknot functions
flowknot.area
flowknot.bulk
flowknot.extra
flowknot.find
flowknot.fix.fluid
flowknot.fix.proppant
flowknot.fix.thermal
flowknot.flux.fluid.app
flowknot.flux.thermal
flowknot.flux.thermal.app
flowknot.flux.thermal.unbal
flowknot.fromindex
flowknot.group
flowknot.group.remove
flowknot.head
flowknot.htc
flowknot.id
flowknot.index
flowknot.isgroup
flowknot.list
flowknot.near
flowknot.next
flowknot.pos
flowknot.pp
flowknot.propin.mass
flowknot.propin.vol
flowknot.stiffness
flowknot.temp
flowknot.timestep
flowknot.trans
flowknot.vol
flowknot.vol.unbal
flowknot.vol.unbal.max
- flowplane functions
flowplane.area
flowplane.contact
flowplane.extra
flowplane.find
flowplane.fromindex
flowplane.group
flowplane.group.remove
flowplane.head
flowplane.id
flowplane.index
flowplane.isgroup
flowplane.list
flowplane.local1
flowplane.local2
flowplane.next
flowplane.pos
flowplane.prop
flowplane.vertexlist
flowplane.zonelist
- flowplane.vertex functions
flowplane.vertex.aperture.hydraulic
flowplane.vertex.aperture.mech
flowplane.vertex.area
flowplane.vertex.extra
flowplane.vertex.find
flowplane.vertex.flowplane
flowplane.vertex.fromindex
flowplane.vertex.group
flowplane.vertex.group.remove
flowplane.vertex.id
flowplane.vertex.index
flowplane.vertex.isgroup
flowplane.vertex.knot
flowplane.vertex.list
flowplane.vertex.local1
flowplane.vertex.local2
flowplane.vertex.next
flowplane.vertex.pos
flowplane.vertex.property
flowplane.vertex.proppant.mconc
flowplane.vertex.proppant.thick
flowplane.vertex.proppant.vconc
flowplane.vertex.subcontact1
flowplane.vertex.subcontact2
flowplane.vertex.visc
flowplane.vertex.weight1
flowplane.vertex.weight2
- flowplane.zone functions
flowplane.zone.area
flowplane.zone.discharge
flowplane.zone.extra
flowplane.zone.find
flowplane.zone.flowplane
flowplane.zone.fromindex
flowplane.zone.group
flowplane.zone.group.remove
flowplane.zone.id
flowplane.zone.index
flowplane.zone.isgroup
flowplane.zone.list
flowplane.zone.next
flowplane.zone.pos
flowplane.zone.velocity
flowplane.zone.vertex
- flowknot functions
- SEL (Structural Element)
- Commands
- FISH Functions
- sel.hybrid functions
sel.hybrid.area
sel.hybrid.collection
sel.hybrid.dir
sel.hybrid.dowel.dis
sel.hybrid.dowel.force
sel.hybrid.dowel.group
sel.hybrid.dowel.group.remove
sel.hybrid.dowel.isgroup
sel.hybrid.dowel.length
sel.hybrid.dowel.norm
sel.hybrid.dowel.pos
sel.hybrid.dowel.sfactor
sel.hybrid.dowel.state
sel.hybrid.dowel.strain
sel.hybrid.dowellist
sel.hybrid.extra
sel.hybrid.find
sel.hybrid.force.axial
sel.hybrid.force.thermal
sel.hybrid.fromindex
sel.hybrid.group
sel.hybrid.group.remove
sel.hybrid.grout.cohesion
sel.hybrid.grout.friction
sel.hybrid.grout.perimeter
sel.hybrid.grout.stiffness
sel.hybrid.head
sel.hybrid.id
sel.hybrid.index
sel.hybrid.isgroup
sel.hybrid.length
sel.hybrid.list
sel.hybrid.material
sel.hybrid.material.num
sel.hybrid.next
sel.hybrid.node
sel.hybrid.pos
sel.hybrid.rupture.tension
sel.hybrid.state
sel.hybrid.strain.axial
sel.hybrid.stress.axial
sel.hybrid.yield.compression
sel.hybrid.yield.tension
sel.hybrid.young
- sel.node functions
sel.node.along
sel.node.attach
sel.node.bond
sel.node.collection
sel.node.dis
sel.node.extra
sel.node.find
sel.node.fix
sel.node.force
sel.node.force.app
sel.node.force.shear
sel.node.fromindex
sel.node.group
sel.node.group.remove
sel.node.head
sel.node.id
sel.node.index
sel.node.isgroup
sel.node.length
sel.node.list
sel.node.mass
sel.node.material
sel.node.matnum
sel.node.near
sel.node.next
sel.node.pos
sel.node.vel
- sel.reinforcement functions
sel.reinforcement.b1
sel.reinforcement.b2
sel.reinforcement.collection
sel.reinforcement.dir
sel.reinforcement.disp.axial
sel.reinforcement.disp.shear
sel.reinforcement.extra
sel.reinforcement.face1
sel.reinforcement.face2
sel.reinforcement.find
sel.reinforcement.force.axial
sel.reinforcement.force.shear
sel.reinforcement.fromindex
sel.reinforcement.group
sel.reinforcement.group.remove
sel.reinforcement.halflength
sel.reinforcement.id
sel.reinforcement.index
sel.reinforcement.isgroup
sel.reinforcement.list
sel.reinforcement.material.num
sel.reinforcement.next
sel.reinforcement.pos
sel.reinforcement.rupture.shear
sel.reinforcement.rupture.tension
sel.reinforcement.state
sel.reinforcement.stiffness.axial
sel.reinforcement.stiffness.shear
sel.reinforcement.strain.axial
sel.reinforcement.strain.shear
sel.reinforcement.yield.shear
sel.reinforcement.yield.tension
- sel.hybrid functions
- Block
- Options
- Thermal Option
- Numerical Thermal Formulation
- Analytical Thermal Formulation
- References
- Dynamic Analysis
- Damping
- Natural Modes of Oscillation
- Wave Transmission
- Partial Density Scaling for Dynamic Analysis
- Boundary Conditions
- Application of Dynamic Input
- Calculation of Natural Frequencies and Modes of Vibration
- Verification Examples
- C++ Option
- Thermal Option
- Examples
- Verification Problems & Example Applications
- Sliding Wedge
- Falling Wedge
- Block with a Slipping Crack under Cyclic Loading
- Cylindrical Hole in an Infinite Elastic Medium
- Cylindrical Hole in an Infinite Mohr-Coulomb Medium
- Rough Square Footing on a Cohesive Frictionless Material
- Stability of an Open Pit in a Jointed Rock Mass
- Assessment of Fault Slip Potential from Sill Pillar Mining
- Highway Loading of an Arch Bridge
- Hydraulic Fracture
- Hydraulic Fracture with DFN
- Excavation in a Saturated Soil
- Flying Buttress
- Flemish Wall
- Discrete Fracture Network (Advanced)
- Finite Element Dam
- Open Pit with Face Blocks
- Open Pit with Octree Blocking
- Sliding and Toppling Blocks
- Supported Tunnel
- UCS Test with Fragmentation
- UCS Test with Voronoi Blocks
- Rockmass Integration
- Lined Circular Tunnel in an Elastic Medium with Anisotropic Stresses
- Tutorial: Braced Support of a Vertical Excavation
- Example: Ring Support of a Jointed Tunnel
- Cable-Reinforced Beam
- Example: Pull-Test for a Grouted Cable Anchor
- Advancing Lined Tunnel (Slip at Liner-Soil Interface)
- Demonstration of Large-Strain Sliding
- Simple Test of Liner-Block Interface Behavior
- Liner-Reinforced Beam
- Structural Liner in Jointed Tunnel
- Example: Shear and tension test for rockbolt crossing a joint
- Verification Problems & Example Applications
- Index: 3DEC Commands
- Index: 3DEC FISH
- 3DEC 7.0 for 5.2 Users
Command and FISH Maps
See the following to convert from Version 5.2 to Version 7.0:
Was this helpful? ... | PFC © 2021, Itasca | Updated: Feb 25, 2024 |