3DEC
Welcome to the 3DEC 9.0 documentation.
New users should review the topics New User Guide and 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 |
c geometry |
|
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 |
c block |
|
c domain |
c socket |
c feblock |
c file |
c system |
|
c geometry |
c table |
|
c global |
c time |
|
c group |
||
c io |
||
c mail |
c version |
|
c math |
- 3DEC Modeling
- New User Guide
- 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
- Topographical Stresses
- Specifying Initial Pore Pressure
- Transferring Field Stresses to Model Stresses
- Reaching Equilibrium
- Loading and Sequential Modeling
- Working with Geometric Data
- Geometric Data
- Geometry Visualization
- Geometry Painting
- Geometric Filtering - Geometry Range Elements
- Geometry Data and Group Assignment
- Geometry Data: Examples
- Assign Group Names Based on Their Relationship to DXF Files
- Ignore Existing Groups — Build New Ones Based on Surfaces
- Partition Existing Groups Based on Surfaces
- Blocks below Surfaces become Separate Groups, Outside Groups Remain Unchanged
- Blocks above the Surfaces become a New Group, Everything below is Unchanged
- Blocks Intersecting Surfaces becomes Separate Groups
- Split Blocks below Surfaces
- Split Large Blocks Intersecting Surfaces
- 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
- 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
- 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
- Creep Analysis in 3DEC
- Creep Model Group
- Solving Creep Problems
- Input Instructions for Creep Modeling
- Creep Verification and Example Problems in 3DEC
- Maxwell/Kelvin/Burgers Model: Parallel-Plate Viscometer
- WIPP-Type Models: Parallel-Plate Viscometer
- Power Model: Cylindrical Cavity
- Power-Mohr Model: Cylindrical Cavity
- WIPP Model: Cylindrical Cavity
- Maxwell Model: Oedometer Test
- Kelvin Model: Oedometer Test
- WIPP-Drucker Model: Comparison with Drucker-Prager Model
- WIPP-Salt Model: Hydrostatic Compression Test
- WIPP-Salt Model: Shear Compression Test
- Burgers-Mohr/Power-Mohr Model: Loading/Unloading Compression Test
- WIPP-Drucker Model: Compression Test Showing Localization
- Creep Response of a Bedded Salt Formation
- Loaded Block - Burgers Model
- References
- 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-stabilitycommandblock applycommandblock apply-removecommandblock cellscommandblock copycommandblock createcommandblock cutcommandblock deletecommandblock densifycommandblock.dispblock dynamiccommandblock excavatecommandblock exportcommandblock fillcommandblock finite-elementcommandblock fixcommandblock fluidcommandblock fragmentcommandblock freecommandblock generatecommandblock groupcommandblock hidecommandblock historycommandblock importcommandblock initializecommandblock insitucommandblock joincommandblock join-by-contactcommandblock joint-planecommandblock listcommandblock makewallcommandblock mechanicalcommandblock merge-finishcommandblock merge-startcommandblock propertycommandblock relaxcommandblock skip-join-updatecommandblock thermalcommandblock to-flac3dcommandblock to-pfccommandblock to-udeccommandblock tolerancecommandblock tracecommandblock updatecommandblock vtkcommandblock watercommand
- block contact commands
block contact applycommandblock contact area-minimumcommandblock contact computecommandblock contact compute-stiffnesscommandblock contact delete-opencommandblock contact generate-subcontactscommandblock contact groupcommandblock contact group-subcontactcommandblock contact historycommandblock contact jmodelcommandblock contact joincommandblock contact listcommandblock contact local-stiffnesscommandblock contact material-tablecommandblock contact persistencecommandblock contact propertycommandblock contact property-distributioncommandblock contact record-shearcommandblock contact resetcommandblock contact tolerancecommandblock contact vertex-vertexcommand
- block face commands
- block gridpoint commands
- block zone commands
block zone cmodelcommandblock zone fluidcommandblock zone generatecommandblock zone generate-newcommandblock zone groupcommandblock zone initializecommandblock zone listcommandblock zone nodal-mixed-discretizationcommandblock zone propertycommandblock zone property-distributioncommandblock zone sizecommandblock zone thermalcommandblock zone volume-minimum-deletecommand
- fblock commands
- block commands
- FISH Functions
- block functions
block.areablock.atolblock.btolblock.contactlistblock.convergenceblock.ctolblock.damp.alphablock.damp.betablock.damp.globalblock.damp.localblock.densityblock.dsfblock.dt.fractionblock.dtolblock.eigenblock.etolblock.excavatedblock.extrablock.facelistblock.feb.elementlistblock.feb.facelistblock.findblock.fixblock.fluid.bulkblock.fluid.cohesionblock.fluid.densityblock.fluid.htcblock.fluid.specheatblock.fluid.tensionblock.fluid.thermcondblock.fluid.viscosityblock.fluid.vol.unbal.avblock.fluid.vol.unbal.maxblock.force.appblock.force.unbalblock.freefieldblock.fromindexblock.gas.alphablock.gas.bulkminblock.gas.constantblock.gas.densminblock.gplistblock.groupblock.group.removeblock.headblock.hiddenblock.idblock.indexblock.insideblock.isgroupblock.leaderblock.msnextblock.listblock.lfblock.massblock.mech.ratioblock.mech.ratio.avgblock.mech.ratio.maxblock.moiblock.moitensorblock.momentblock.nearblock.nextblock.numblock.posblock.proppant.conclimitblock.proppant.densityblock.proppant.grainsizeblock.proppant.grainsize.factorblock.proppant.modulusblock.proppant.permblock.proppant.perm.factorblock.regionblock.rigidblock.rvelblock.thermal.analytical.timeblock.thermal.conductivityblock.thermal.diffusivityblock.thermal.grid.n12block.thermal.grid.n23block.thermal.grid.numblock.thermal.grid.pointblock.thermal.grid.sourceblock.thermal.grid.strengthblock.thermal.grid.tstartblock.thermal.line.n12block.thermal.line.numblock.thermal.line.pointblock.thermal.line.sourceblock.thermal.line.strengthblock.thermal.line.tstartblock.thermal.pointblock.thermal.point.numblock.thermal.point.sourceblock.thermal.point.strengthblock.thermal.point.tstartblock.thermal.source.componentsblock.thermal.decay.fractionblock.thermal.source.fractionblock.thermal.source.numblock.unbalblock.velblock.volblock.wallblock.zonelist
- block.contact functions
block.contact.b1block.contact.b2block.contact.dfnidblock.contact.energy.fricblock.contact.energy.strain.compblock.contact.energy.strain.shearblock.contact.energy.strain.tensileblock.contact.energy.strain.totalblock.contact.excavatedblock.contact.extrablock.contact.fb1block.contact.fb2block.contact.fidblock.contact.findblock.contact.flowplaneblock.contact.fromindexblock.contact.groupblock.contact.group.removeblock.contact.headblock.contact.hiddenblock.contact.idblock.contact.indexblock.contact.isgroupblock.contact.jsetblock.contact.listblock.contact.nearblock.contact.nextblock.contact.normalblock.contact.numblock.contact.posblock.contact.subcontactlistblock.contact.type
- block.subcontact functions
block.subcontact.apiniblock.subcontact.areablock.subcontact.b1block.subcontact.b2block.subcontact.contactblock.subcontact.dfnidblock.subcontact.disp.normblock.subcontact.disp.shearblock.subcontact.disp.shear.maxblock.subcontact.edgegpblock.subcontact.energyblock.subcontact.energy.totalblock.subcontact.excavatedblock.subcontact.extrablock.subcontact.faceblock.subcontact.fidblock.subcontact.find- block.subcontact.flowplane.vertex
block.subcontact.flowplane.zoneblock.subcontact.force.normblock.subcontact.force.ppblock.subcontact.force.shearblock.subcontact.fromindexblock.subcontact.gpblock.subcontact.groupblock.subcontact.group.removeblock.subcontact.hiddenblock.subcontact.idblock.subcontact.indexblock.subcontact.isgroupblock.subcontact.listblock.subcontact.modelblock.subcontact.nearblock.subcontact.near.listblock.subcontact.nextblock.subcontact.numblock.subcontact.partnerblock.subcontact.posblock.subcontact.ppblock.subcontact.propblock.subcontact.sratioblock.subcontact.stateblock.subcontact.state.stringblock.subcontact.stress.normblock.subcontact.stress.shearblock.subcontact.typeblock.subcontact.vel.shear
- block.face functions
block.face.areablock.face.bfaceblock.face.excavatedblock.face.extrablock.face.fblockblock.face.fidblock.face.findblock.face.flowplaneblock.face.fos.kinematicblock.face.fromindexblock.face.gpblock.face.gplistblock.face.groupblock.face.group.removeblock.face.hiddenblock.face.hostblockblock.face.idblock.face.indexblock.face.isgroupblock.face.jsetblock.face.listblock.face.nextblock.face.ngpblock.face.normalblock.face.originalblock.face.planarblock.face.posblock.face.sregblock.face.zone
- block.gp functions
block.gp.convergenceblock.gp.bcblock.gp.bc.normblock.gp.bc.xblock.gp.bc.yblock.gp.bc.zblock.gp.dispblock.gp.dsfblock.gp.extrablock.gp.fblockblock.gp.findblock.gp.flowknotblock.gp.fluxblock.gp.flux.appblock.gp.force.appblock.gp.force.magblock.gp.force.reactionblock.gp.force.unbalblock.gp.fromindexblock.gp.gplinksblock.gp.groupblock.gp.group.removeblock.gp.hostblockblock.gp.idblock.gp.indexblock.gp.isgroupblock.gp.linkzonesblock.gp.listblock.gp.massblock.gp.mass.dynamicblock.gp.mass.thermalblock.gp.nearblock.gp.near.listblock.gp.nextblock.gp.numblock.gp.posblock.gp.ppblock.gp.ratioblock.gp.ratio.targetblock.gp.stiffnessblock.gp.tempblock.gp.velblock.gp.vel.app
- block.zone functions
block.zone.conditionblock.zone.containingblock.zone.dischargeblock.zone.dt.fractionblock.zone.excavatedblock.zone.extrablock.zone.face.areablock.zone.face.gpblock.zone.face.normalblock.zone.face.posblock.zone.findblock.zone.fromindexblock.zone.geo_metricblock.zone.gpblock.zone.groupblock.zone.group.removeblock.zone.hiddenblock.zone.hostblockblock.zone.isgroupblock.zone.joinblock.zone.listblock.zone.massblock.zone.modelblock.zone.nearblock.zone.nextblock.zone.nmdblock.zone.numblock.zone.plane.tractionblock.zone.posblock.zone.ppblock.zone.propblock.zone.prop.thermalblock.zone.strain.rotation.incblock.zone.strain.rotation.rateblock.zone.stateblock.zone.strain.incblock.zone.strain.rateblock.zone.strain.shear.incblock.zone.strain.shear.rateblock.zone.strain.totalblock.zone.strain.vol.incblock.zone.strain.vol.rateblock.zone.stressblock.zone.stress.effectiveblock.zone.stress.intblock.zone.stress.maxblock.zone.stress.minblock.zone.stress.prinblock.zone.stress.prin.dirblock.zone.vol
- block.fragment functions
- block.field functions
block.field.componentblock.field.effectiveblock.field.extrablock.field.getblock.field.get.gpblock.field.hide.excblock.field.indexblock.field.initblock.field.method.indexblock.field.method.nameblock.field.nameblock.field.powerblock.field.propblock.field.quantityblock.field.radius.ratioblock.field.resetblock.field.sourceblock.field.tol
- fblock functions
- block functions
- Commands
- FEBlock
- Flow
- Commands
- FISH Functions
- flowknot functions
flowknot.areaflowknot.bulkflowknot.extraflowknot.findflowknot.fix.fluidflowknot.fix.proppantflowknot.fix.thermalflowknot.flux.fluid.appflowknot.flux.thermalflowknot.flux.thermal.appflowknot.flux.thermal.unbalflowknot.fromindexflowknot.gas.bulkflowknot.gas.densityflowknot.groupflowknot.group.removeflowknot.headflowknot.htcflowknot.idflowknot.indexflowknot.isgroupflowknot.listflowknot.nearflowknot.nextflowknot.posflowknot.ppflowknot.propin.massflowknot.propin.volflowknot.stiffnessflowknot.tempflowknot.timestepflowknot.transflowknot.volflowknot.vol.unbalflowknot.vol.unbal.max
- flowplane functions
flowplane.areaflowplane.contactflowplane.extraflowplane.findflowplane.fromindexflowplane.groupflowplane.group.removeflowplane.headflowplane.idflowplane.indexflowplane.isgroupflowplane.listflowplane.local1flowplane.local2flowplane.nextflowplane.posflowplane.propflowplane.vertexlistflowplane.zonelist
- flowplane.vertex functions
flowplane.vertex.aperture.hydraulicflowplane.vertex.aperture.mechflowplane.vertex.areaflowplane.vertex.extraflowplane.vertex.findflowplane.vertex.flowplaneflowplane.vertex.fromindexflowplane.vertex.groupflowplane.vertex.group.removeflowplane.vertex.idflowplane.vertex.indexflowplane.vertex.isgroupflowplane.vertex.knotflowplane.vertex.listflowplane.vertex.local1flowplane.vertex.local2flowplane.vertex.nextflowplane.vertex.posflowplane.vertex.propertyflowplane.vertex.proppant.mconcflowplane.vertex.proppant.thickflowplane.vertex.proppant.vconcflowplane.vertex.subcontact1flowplane.vertex.subcontact2flowplane.vertex.viscflowplane.vertex.weight1flowplane.vertex.weight2
- flowplane.zone functions
flowplane.zone.areaflowplane.zone.dischargeflowplane.zone.extraflowplane.zone.findflowplane.zone.flowplaneflowplane.zone.fromindexflowplane.zone.groupflowplane.zone.group.removeflowplane.zone.idflowplane.zone.indexflowplane.zone.isgroupflowplane.zone.listflowplane.zone.nextflowplane.zone.posflowplane.zone.velocityflowplane.zone.vertex
- flowknot functions
- SEL (Structural Element)
- 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
- IMASS Option
- IMASS Model **
- Introduction
- IMASS Constitutive Model
- Single Residual Envelope Implementation (Similar To Cavehoek) In IMASS
- Sloss, an indicator for damage in IMASS
- Examples
- Properties In IMASS
- IMASS Model **
- C++ Option
- Thermal Option
- 3DEC Examples
- Tutorials
- Example Applications
- 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 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
- Supported Tunnel
- UCS Test with Fragmentation
- UCS Test with Voronoi Blocks
- Rockmass Integration
- Creep Response of a Bedded Salt Formation
- Reinforced Concrete Beam
- Uniaxial Compression and Extension Tests with Concrete Model
- Tunnel Excavation in a Bonded Block Model
- Lined Circular Tunnel in an Elastic Medium with Anisotropic Stresses
- 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
Command and FISH Maps
See the following to convert from Version 5.2 to Version 7.0:
Indexes
| Was this helpful? ... | Itasca Software © 2024, Itasca | Updated: Jun 15, 2025 |