User’s Guide Contents - 1

TABLE OF CONTENTS

1 INTRODUCTION
1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.2 Comparison with Other Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
1.3 General Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
1.3.1 Basic Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
1.3.2 Optional Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
1.4 Summary of Updates from Version 5.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
1.4.1 Improved Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
1.4.2 Support for Bonded Block Modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
1.4.3 Matrix Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
1.4.4 Proppant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
1.4.5 Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
1.4.6 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
1.5 Fields of Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 - 11
1.6 Guide to the 3DEC Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 - 12
1.7 Itasca Consulting Group Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 - 17
1.8 User Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 - 18
1.9 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 - 19

2 GETTING STARTED
2.1 Installation and Start-up Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
2.1.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
2.1.2 Installation of 3DEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
2.1.3 Components of 3DEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.1.4 Utility Software and Graphics Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.1.5 Memory Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.1.6 Version Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2.1.7 Start-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2.1.8 Program Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2.1.9 Running 3DEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2.1.10 Installation Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

3DEC Version 5.2

Contents - 2 User’s Guide

2.2 A Simple Tutorial – Use of Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 10

2.2.1 Application Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 10
2.2.2 Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 11
2.2.3 Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 12
2.2.4 Creating a Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 13
2.2.5 Creating the Joint Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 17
2.2.6 Creating the Wedge Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 20
2.2.7 Boundary Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 21
2.2.8 Gravity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 22
2.2.9 Material Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 22
2.2.10 Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 23
2.2.11 Plot Image Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 24
2.2.12 Save Initial State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 25
2.2.13 Reduce Joint Friction and Solve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 26
2.2.14 Cross Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 27
2.2.15 Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 29
2.3 Nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 30
2.4 The 3DEC Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 33
2.5 Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 36
2.6 Mechanics of Using 3DEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 38
2.6.1 Model Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 40
2.6.2 Assigning Material Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 43
2.6.2.1 Block Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 43
2.6.2.2 Joint Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 46
2.6.3 Applying Boundary and Initial Conditions . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 47
2.6.4 Stepping to Initial Equilibrium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 49
2.6.5 Performing Alterations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 51
2.6.6 Saving/Restoring Problem State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 54
2.6.7 Summary of Commands for Simple Analyses . . . . . . . . . . . . . . . . . . . . . . 2 - 56
2.7 Sign Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 58
2.8 Systems of Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 60
2.9 Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 61
2.10 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 63

3DEC Version 5.2

User’s Guide Contents - 3

3 PROBLEM SOLVING WITH 3DEC

3.1 General Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.1.1 Step 1: Define the Objectives for the Model Analysis . . . . . . . . . . . . . . . 3-3
3.1.2 Step 2: Create a Conceptual Picture of the Physical System . . . . . . . . . . 3-3
3.1.3 Step 3: Construct and Run Simple Idealized Models . . . . . . . . . . . . . . . . 3-4
3.1.4 Step 4: Assemble Problem-Specific Data . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.1.5 Step 5: Prepare a Series of Detailed Model Runs . . . . . . . . . . . . . . . . . . . 3-4
3.1.6 Step 6: Perform the Model Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.1.7 Step 7: Present Results for Interpretation . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.2 Model Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
3.2.1 Fitting the 3DEC Model to a Problem Region . . . . . . . . . . . . . . . . . . . . . . 3-6
3.2.2 Joint Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 12
3.2.3 Creating Internal Boundary Shapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 17
3.2.3.1 Tunnel Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 18
3.2.3.2 POLYHEDRON cube . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 19
3.2.4 Selecting the Coordinate System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 22
3.2.5 Orientation of Geologic Features to the Model Axes . . . . . . . . . . . . . . . . 3 - 23
3.2.6 Choice of Model Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 24
3.2.7 Incorporation of Discontinuities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 24
3.3 Selection of Deformable versus Rigid Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 27
3.3.1 Poisson’s Effect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 27
3.3.2 Zoning for Deformable Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 32
3.4 Boundary Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 33
3.4.1 Stress Boundary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 33
3.4.1.1 Applied Stress Gradient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 34
3.4.1.2 Changing Boundary Stresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 35
3.4.1.3 Checking the Boundary Condition . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 36
3.4.1.4 Cautions and Advice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 36
3.4.2 Displacement Boundary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 39
3.4.3 Real Boundaries – Choosing the Right Type . . . . . . . . . . . . . . . . . . . . . . . . 3 - 40
3.4.4 Artificial Boundaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 40
3.4.4.1 Symmetry Planes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 40
3.4.4.2 Boundary Truncation – Location of the Far-Field Boundary . . 3 - 41
3.5 Initial Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 44
3.5.1 Uniform Stresses in an Unjointed Medium: No Gravity . . . . . . . . . . . . . 3 - 44
3.5.2 Stresses with Gradients in an Unjointed Medium: Uniform Material . . 3 - 45
3.5.3 Stresses with Gradients in a Nonuniform Material . . . . . . . . . . . . . . . . . . 3 - 47
3.5.4 Compaction within a Model with Nonuniform Zoning . . . . . . . . . . . . . . . 3 - 49
3.5.5 Initial Stresses following a Model Change . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 52
3.5.6 Stresses in a Jointed Medium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 53

3DEC Version 5.2

Contents - 4 User’s Guide

3.5.7 Determination of the In-situ Stress State . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 55

3.5.8 Transferring Field Stresses to Model Stresses . . . . . . . . . . . . . . . . . . . . . . . 3 - 57
3.5.9 Topographical Stresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 58
3.6 Loading and Sequential Modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 59
3.7 Choice of Constitutive Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 82
3.7.1 Deformable-Block Material Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 82
3.7.2 Joint Material Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 83
3.7.3 Selection of an Appropriate Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 84
3.8 Material Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 92
3.8.1 Block Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 92
3.8.1.1 Mass Density . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 92
3.8.1.2 Intrinsic Deformability Properties . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 92
3.8.1.3 Intrinsic Strength Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 93
3.8.1.4 Post-Failure Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 95
3.8.1.5 Extrapolation to Field-Scale Properties . . . . . . . . . . . . . . . . . . . . . 3 - 102
3.8.2 Joint Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 106
3.9 Tips and Advice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 108
3.10 Interpretation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 115
3.10.1 Unbalanced Force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 115
3.10.2 Block/Gridpoint Velocities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 115
3.10.3 Plastic Indicators for Block Failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 116
3.10.4 Histories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 117
3.10.5 Factor of Safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 117
3.11 Modeling Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 120
3.11.1 Modeling of Data-Limited Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 120
3.11.2 Modeling of Chaotic Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 120
3.11.3 Localization, Physical Instability and Path-Dependence . . . . . . . . . . . . . 3 - 122
3.12 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 124

4 FISH BEGINNER’S GUIDE

4.1 Introduction and Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 - 1
4.2 Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 - 2

5 GRAPHICAL INTERFACE

3DEC Version 5.2

User’s Guide Contents - 5

6 DISCRETE FRACTURE NETWORKS IN 3DEC

6.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
6.2 DFN Modeling Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.2.1 DFN Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.2.2 Fracture Size Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.2.3 Densities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
6.2.4 Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
6.2.5 Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
6.3 Building Realizations of an Example DFN Model . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
6.3.1 DFN Model Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
6.3.2 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
6.3.3 Generation of the DFN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 11
6.4 Analysis of DFN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 15
6.5 DFN Simplification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 21
6.6 3DEC Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 25
6.7 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 29

7 USING GEOMETRIC DATA

7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
7.2 Geometric Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
7.3 Geometry Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
7.4 Group Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
7.5 Command Filtering, Geometry Range Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
7.6 Increasing Discretization, or Densifying Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 11
7.7 Using 3DEC Commands to Implement SpaceRanger Capabilities – Solving Mod-
eling Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 12
7.7.1 Modeling Problems that can be Addressed with These Tools . . . . . . . . . 7 - 12
7.7.2 Example 1: Assign Group Names Based on Their Relationship to DXF
Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 13
7.7.3 Example 2: Ignore Existing Groups – Build New Ones Based on Surfaces 7 - 15
7.7.4 Example 3: Partition Existing Groups Based on Surfaces . . . . . . . . . . . . 7 - 16
7.7.5 Example 4: Blocks below Surfaces become Separate Groups, Outside
Groups Remain Unchanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 18
7.7.6 Example 5: Blocks above the Surfaces become a New Group, Everything
below is Unchanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 20
7.7.7 Example 6: Blocks Intersecting Surfaces becomes Separate Groups . . 7 - 21
7.7.8 Example 7: Split Blocks below Surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 22
7.7.9 Example 8: Split Large Blocks Intersecting Surfaces . . . . . . . . . . . . . . . . 7 - 23

3DEC Version 5.2

Contents - 6 User’s Guide

8 DENSIFY
8.1 Densify Tet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 - 8

9 MISCELLANEOUS
9.1 3DEC Runtime Benchmark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1
9.2 Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
9.2.1 Reporting via the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
9.2.2 Reporting via Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
9.3 Technical Support Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

3DEC Version 5.2

User’s Guide Contents - 7

TABLES
Table 2.1 Maximum number of 3DEC blocks in available RAM . . . . . . . . . . . . . . . . . . . . . 2-5
Table 2.2 Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 37
Table 2.3 Boundary condition command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 47
Table 2.4 Basic commands for simple analyses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 57
Table 2.5 Systems of units – mechanical parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 60
Table 3.1 Recommended steps for numerical analysis in geomechanics . . . . . . . . . . . . . . . 3-3
Table 3.2 3DEC block constitutive models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 83
Table 3.3 3DEC joint constitutive models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 84
Table 3.4 Selected elastic constants (laboratory-scale) for rocks (adapted from Goodman
1980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 93
Table 3.5 Selected strength properties (laboratory-scale) for rocks (adapted from Good-
man 1980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 94
Table 3.6 Typical values for Hoek-Brown rock-mass strength parameters
(adapted from Hoek and Brown (1988)) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 105
Table 4.1 Commands that directly refer to FISH names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Table 6.1 Summary of parameters used to generate the three fracture sets . . . . . . . . . . . . . 6-9
Table 6.2 Intersection sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 15
Table 6.3 Data stored in fracture extra variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 17
Table 9.1 3DEC runtime calculation rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1

3DEC Version 5.2

Contents - 8 User’s Guide

FIGURES
Figure 2.1 PostScript plot from “TEST3.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Figure 2.2 First-time execution copies files to user folder . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 10
Figure 2.3 Project file-loading options during startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 11
Figure 2.4 Project file open dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 11
Figure 2.5 3DEC “Wide” layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 12
Figure 2.6 3DEC run button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 13
Figure 2.7 Initial 3DEC block plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 14
Figure 2.8 Plot tab rename dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 14
Figure 2.9 Plot item selection dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 15
Figure 2.10 3DEC block plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 16
Figure 2.11 Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 16
Figure 2.12 Block plot item attributes dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 18
Figure 2.13 Original block split into three blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 18
Figure 2.14 Joint planes added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 19
Figure 2.15 Wedge blocks added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 20
Figure 2.16 Plot items list dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 21
Figure 2.17 Completed model view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 22
Figure 2.18 History of vertical velocity during equilibrium cycling . . . . . . . . . . . . . . . . . . . 2 - 24
Figure 2.19 Display setting dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 25
Figure 2.20 Wedge sliding down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 26
Figure 2.21 Displacement vectors plot-item attribute dialog . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 27
Figure 2.22 Block plot-item attribute dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 28
Figure 2.23 Cut plane plot-item attributes dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 28
Figure 2.24 Cross section on cut plane showing blocks and displacement vectors . . . . . . 2 - 29
Figure 2.25 Example of a 3DEC model (not to scale) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 30
Figure 2.26 3DEC model block divided into two blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 34
Figure 2.27 General solution procedure for static analysis in geomechanics . . . . . . . . . . . . 2 - 39
Figure 2.28 Block model with three intersecting joint planes . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 41
Figure 2.29 Tunnel in jointed rock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 42
Figure 2.30 Tunnel in jointed rock – excavation and joint structure . . . . . . . . . . . . . . . . . . . 2 - 43
Figure 2.31 Maximum unbalanced force history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 50
Figure 2.32 z-displacement history at (.3, 0, .3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 51
Figure 2.33 Sliding wedge in tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 53
Figure 2.34 z-displacement history at (.3, −0.1, .3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 53
Figure 2.35 z-displacement history at (.3, −0.1, .3) – wedge is stable . . . . . . . . . . . . . . . . . 2 - 56
Figure 2.36 Sign convention for positive stress components . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 58
Figure 3.1 Spectrum of modeling situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Figure 3.2 Cubic model created with the POLYHEDRON face command . . . . . . . . . . . . . . 3-8

3DEC Version 5.2

User’s Guide Contents - 9

Figure 3.3 An octahedral-shaped prism generated with the POLYHEDRON prism com-
mand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 10
Figure 3.4 Tunnel model created with the POLYHEDRON tunnel command . . . . . . . . . . . . 3 - 11
Figure 3.5 Terms describing the attitude of an inclined plane:
dip angle, α, is positive measured downward from the horizontal (xy) plane;
dip direction, β, is positive measured clockwise from north (y) . . . . . . . . . 3 - 12
Figure 3.6 Model created with the JSET and HIDE commands . . . . . . . . . . . . . . . . . . . . . . . 3 - 14
Figure 3.7 Concave block created with the JOIN command . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 15
Figure 3.8 Rock slope containing continuous and noncontinuous joints . . . . . . . . . . . . . . 3 - 16
Figure 3.9 Tunnel created with TUNNEL command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 19
Figure 3.10 Elements of the POLYHEDRON cube command . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 20
Figure 3.11 Resultant geometry from example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 22
Figure 3.12 Orientation of 3DEC model axes (x,y,z) relative to north-east-vertical reference
axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 23
Figure 3.13 Stereonet plot of fault relative to model axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 26
Figure 3.14 Stereonet plot of pole to fault and model reference axes relative to problem
north-east axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 26
Figure 3.15 Model for Poisson’s effect in rock with vertical and horizontal jointing . . . . 3 - 28
Figure 3.16 Poisson’s effect for vertically jointed rock
(ν = 0.3 for intact rock) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 29
Figure 3.17 Model for Poisson’s effect in rock with joints dipping at angle θ from the
horizontal and with spacing S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 30
Figure 3.18 Poisson’s effect for jointed rock at various joint angles (blocks are rigid) . . . 3 - 30
Figure 3.19 Poisson’s effect for rock with two equally spaced joint sets
with θ = 45◦ (blocks are deformable with ν = 0.2) . . . . . . . . . . . . . . . . . . . . 3 - 31
Figure 3.20 Uplift when material is removed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 37
Figure 3.21 Mixing stress and velocity boundary conditions . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 39
Figure 3.22 Models used to transfer stress boundary conditions . . . . . . . . . . . . . . . . . . . . . . 3 - 42
Figure 3.23 Nonuniform stresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 50
Figure 3.24 Uniform stresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 52
Figure 3.25 Slip of a confined joint; plot shows shear stress contours . . . . . . . . . . . . . . . . . 3 - 55
Figure 3.26 3DEC model of tunnel region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 63
Figure 3.27 Displacement histories at top of model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 65
Figure 3.28 z-displacement history at tunnel roof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 67
Figure 3.29 Close-up view of wedge in roof (surrounding blocks hidden) . . . . . . . . . . . . . 3 - 67
Figure 3.30 Cable bolts positioned around tunnel excavation . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 68
Figure 3.31 z-displacement history at tunnel roof – reinforcement element support . . . . . 3 - 71
Figure 3.32 z-displacement history at tunnel roof – cable support . . . . . . . . . . . . . . . . . . . . . 3 - 72
Figure 3.33 Axial forces in reinforcement elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 73
Figure 3.34 Axial forces in cable elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 73
Figure 3.35 Thick concrete liner support – liner blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 76

3DEC Version 5.2

Contents - 10 User’s Guide

Figure 3.36 z-displacement history at tunnel roof – tunnel liner added after tractions re-
duced by 50% . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 77
Figure 3.37 Thick concrete liner support – prism-shaped liner blocks . . . . . . . . . . . . . . . . . 3 - 80
Figure 3.38 Thick concrete liner support – mixed-discretization zoning in liner blocks . . 3 - 80
Figure 3.39 z-displacement history at tunnel roof – support by prism-shaped liner blocks 3 - 81
Figure 3.40 Principal stress distribution in top section of liner . . . . . . . . . . . . . . . . . . . . . . . . 3 - 81
Figure 3.41 Direct shear test model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 85
Figure 3.42 Average shear stress versus shear displacement
– Coulomb slip model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 88
Figure 3.43 Average normal displacement versus shear displacement
– Coulomb slip model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 89
Figure 3.44 Average shear stress versus shear displacement
– Coulomb slip model with peak and residual strength . . . . . . . . . . . . . . . . 3 - 90
Figure 3.45 Average normal displacement versus shear displacement
– Coulomb slip model with peak and residual strength . . . . . . . . . . . . . . . . 3 - 91
Figure 3.46 Idealized relation for dilation angle, ψ, from triaxial test results (Vermeer and
de Borst 1984) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 95
Figure 3.47 σzz -stress versus zz-strain for tension test with cons 2 model . . . . . . . . . . . . . 3 - 99
Figure 3.48 σzz -stress versus zz-strain for tension test with subi model and tensile-softening
table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 100
Figure 3.49 xx-strain versus zz-strain for tension test with cons 2 model . . . . . . . . . . . . . . 3 - 101
Figure 3.50 xx-strain versus zz-strain for tension test with subi model and tensile-softening
table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 101
Figure 3.51 Plot showing area of failure in slope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 119
Figure 3.52 A small portion of a jointed rock mass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 121
Figure 6.1 Power-law distribution in a log-log diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
Figure 6.2 2D slices from 3D DFNs generated within a cube of L = 100 with lmin = 1,
lmax = 100 and α = 1 with, from left to right and from top to bottom, a = 2,
a = 3, a = 4 and a → ∞ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
Figure 6.3 Measures of fracture density (Golder Associates
www.fracman.com) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
Figure 6.4 Domains, boreholes and outcrops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 11
Figure 6.5 The generated DFN with three fracture sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 13
Figure 6.6 Stereonet of the complete DFN realization (equal area projection, Fisher con-
centrations) (left) contour plot (1% circle area) and (right) points. Note that
superimposed points are not visible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 14
Figure 6.7 Traces on the horizontal outcrop colored by trace length . . . . . . . . . . . . . . . . . . 6 - 17
Figure 6.8 Traces on the vertical outcrop colored by trace length . . . . . . . . . . . . . . . . . . . . 6 - 18
Figure 6.9 Fractures intersecting the vertical borehole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 18
Figure 6.10 Intersections in the system, colored by length . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 19
Figure 6.11 Fractures colored by cluster index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 20

3DEC Version 5.2

User’s Guide Contents - 11

Figure 6.12 Illustration of the connected distance between 4 fractures and the reference,
illustrated by a red cube. F1 is directly connected to the reference, and the
connected distance is 0. For F2 it is the size of the orange segment, while
it is the sum of the black segment size and the orange segment size for F3,
and the sum of the orange segment size and the grey segment size for F4. 6 - 22
Figure 6.13 DFN by filtering fractures based on connectivity: only in the main cluster and
with a connected distance smaller than (or equal to) 50 m. Fractures are
colored according to their distance to the injection section (with an octant
cut in the top-front corner). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 23
Figure 6.14 Simplified DFN by removal of subparallel closely spaced fractures (with an
octant cut in the top-front corner) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 24
Figure 6.15 Blocks after cutting with the subhorizontal and subvertical fracture sets . . . . 6 - 26
Figure 6.16 Illustration of how sub-contacts on a joint plane can be assigned different
properties inside (black) and outside (gray) of a circular fracture . . . . . . . 6 - 27
Figure 6.17 Joints contoured by cohesion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 - 28
Figure 7.1 The 3DEC Open Item dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Figure 7.2 Geometric set of a simple cylinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
Figure 7.3 Displacement magnitude painted on geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Figure 7.4 Groups assigned by the GEOMETRY group command . . . . . . . . . . . . . . . . . . . . . 7-6
Figure 7.5 Blocks selected by the geometry dist range element . . . . . . . . . . . . . . . . . . . . . . 7-8
Figure 7.6 Blocks selected by the geometry count range element . . . . . . . . . . . . . . . . . . . . 7-9
Figure 7.7 Blocks selected by the geometry count range element using the odd keyword 7 - 10
Figure 7.8 Mesh generated with densify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 11
Figure 7.9 Partitioned model and two surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 13
Figure 7.10 Tree surfaces used for partitioning the model with geometry data . . . . . . . . . . 7 - 14
Figure 7.11 Ignore existing groups – build new ones based on surfaces . . . . . . . . . . . . . . . . 7 - 15
Figure 7.12 Partitioning everything below surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 17
Figure 7.13 Blocks below surfaces become separate groups, outside groups remain un-
changed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 19
Figure 7.14 Blocks above surfaces become a new group; everything below is unchanged 7 - 20
Figure 7.15 Blocks intersecting surfaces within 40 m become separate groups . . . . . . . . . 7 - 21
Figure 7.16 Split blocks below surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 22
Figure 7.17 Split large blocks intersecting surfaces down to no less than 100 m . . . . . . . . 7 - 24
Figure 8.1 Original block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
Figure 8.2 Block densified by dividing into 2 segments in each direction . . . . . . . . . . . . . 8-2
Figure 8.3 Block densified by dividing into 3 segments in each direction . . . . . . . . . . . . . 8-3
Figure 8.4 4 × 4 × 4 block model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
Figure 8.5 Densified model by setting the maximum lengths . . . . . . . . . . . . . . . . . . . . . . . . 8-5
Figure 8.6 Densified model using the gradlimit keyword . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6
Figure 8.7 Original block and geometry sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
Figure 8.8 Densified model using geometric data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8
Figure 8.9 A densified tetrahedral block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9

3DEC Version 5.2

Contents - 12 User’s Guide

Figure 8.10 A densified tetrahedral block using the tet keyword . . . . . . . . . . . . . . . . . . . . . . 8 - 9

3DEC Version 5.2

User’s Guide Contents - 13

EXAMPLES
Example 2.1 3DEC output from “TEST1.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Example 2.2 3DEC model block divided into two blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 33
Example 2.3 Block model with three intersecting joint planes . . . . . . . . . . . . . . . . . . . . . . . 2 - 40
Example 2.4 Tunnel in jointed rock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 41
Example 2.5 Assigning material models and properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 46
Example 2.6 Applying boundary and initial conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 48
Example 2.7 Stepping to initial equilibrium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 49
Example 2.8 Reduce the strength of the joints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 52
Example 2.9 Stabilize roof block with a cable bolt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 - 55
Example 3.1 A cube generated with the POLYHEDRON face command . . . . . . . . . . . . . . . . 3-7
Example 3.2 A cube generated with the POLYHEDRON brick command . . . . . . . . . . . . . . . 3-8
Example 3.3 An octahedral-shaped prism generated with the POLYHEDRON prism com-
mand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Example 3.4 A tunnel model generated with the POLYHEDRON tunnel command . . . . . . 3 - 11
Example 3.5 Creation of a noncontinuous vertical joint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 13
Example 3.6 Rock slope containing continuous and noncontinuous joints . . . . . . . . . . . . . 3 - 16
Example 3.7 Tunnel created with the TUNNEL command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 18
Example 3.8 Data file that generates a model using POLYHEDRON cube command . . . . . 3 - 21
Example 3.9 Uplift when material is removed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 36
Example 3.10 Mixing stress and velocity boundary conditions . . . . . . . . . . . . . . . . . . . . . . . . 3 - 38
Example 3.11 Initial and boundary stresses in equilibrium . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 45
Example 3.12 Initial stress state with gravitational gradient . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 46
Example 3.13 Initial stress gradient in a nonuniform material . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 47
Example 3.14 Nonuniform stress initialized in a model with nonuniform zoning . . . . . . . . 3 - 49
Example 3.15 Initial stresses following a model change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 52
Example 3.16 Slip of a confined joint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 54
Example 3.17 Stability analysis of an underground excavation – initial model . . . . . . . . . . 3 - 60
Example 3.18 Stability analysis of an underground excavation – initial equilibrium stress
state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 63
Example 3.19 Stability analysis of an underground excavation – unsupported tunnel . . . . 3 - 66
Example 3.20 Stability analysis of an underground excavation – local reinforcement sup-
port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 69
Example 3.21 Stability analysis of an underground excavation – fully grouted cable support 3 - 70
Example 3.22 Stability analysis of an underground excavation – reduce tunnel tractions by
50% and install liner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 74
Example 3.23 Stability analysis of an underground excavation – liner with m-d zoning . . 3 - 77
Example 3.24 Direct shear test with Coulomb slip model . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 85
Example 3.25 Tension test on tensile-softening material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 97
Example 3.26 Factor-of-safety calculation for a simple joint model . . . . . . . . . . . . . . . . . . . 3 - 118

3DEC Version 5.2

Contents - 14 User’s Guide

Example 4.1 Defining a FISH function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Example 4.2 Using a variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Example 4.3 SETting variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Example 4.4 Test your understanding of function and variable names . . . . . . . . . . . . . . . . 4-4
Example 4.5 Capturing the history of a FISH variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Example 4.6 FISH functions to calculate bulk and shear moduli . . . . . . . . . . . . . . . . . . . . . 4-6
Example 4.7 Using symbolic variables in 3DEC input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Example 4.8 Controlled loop in FISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Example 4.9 Applying a nonlinear initial distribution of moduli . . . . . . . . . . . . . . . . . . . . . 4-8
Example 4.10 Splitting lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Example 4.11 Variable types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Example 4.12 Action of the IF ELSE ENDIF construct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 - 11
Example 7.1 “fish cylinder.fis” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Example 7.2 “Example 1.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 13
Example 7.3 “Example 2.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 15
Example 7.4 “Example 3.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 16
Example 7.5 “Example 4.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 18
Example 7.6 “Example 5.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 20
Example 7.7 “Example 6.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 21
Example 7.8 “Example 7.3ddat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 22
Example 7.9 “Example 8.f3dat” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 - 23
Example 8.1 “DENSIFY 1.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Example 8.2 “DENSIFY 2.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
Example 8.3 “DENSIFY 3.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
Example 8.4 Densification of a tetrahedral block – “DENSIFY 4.3DDAT” . . . . . . . . . . . 8-8
Example 9.1 Benchmark data file – “TIMING.3DDAT” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

3DEC Version 5.2