fracture joint-set command

Syntax

fracture joint-set keyword ...

Primary keywords:

dfn    dfn-dominance    dip    dip-direction    dominance    group    intersection-set    number    origin    size    spacing

Create a set of sub-parallel fractures, or joint set, with specified origin, size, and spacing.

Note

  • A model domain must be specified prior to fracture addition.

  • Fractures will be clipped at the model domain boundary if they extend beyond the model domain.

If the specified DFN specified by the dfn keyword does not exist a new DFN is created. If a DFN is not specified then a new DFN is created with the next available ID and name dfnXX, where XX is the DFN ID. This command creates a {line segment fracture in 2D; disk fracture in 3D}. The command contrasts with the fracture generate command, which generates fractures based on a stochastic description of a fracture.

dfn s

Add the fracture to the DFN with name s.

dfn-dominance i

If a new DFN is created, then its dominance is set to i, where i is greater than 1. The dominance is used during contact model assignment, when a contact intersects multiple fractures from different DFNs. The fractures from the DFN with the lowest DFN dominance will be further scrutinized by their individual dominance values to assign the appropriate contact model properties. If not specified, then the next available dominance is used. See the fracture contact-model command for further details.

dip f1 <f2 >

Dip angle of the fracture in degrees, where f1 is in the range {[0,180] in 2D; [0,90] in 3D}. In 2D, dip is the clockwise angle measured from the positive \(x\)-axis. In 3D, dip is the angle from the dip direction projected on the \(xy\)-plane to the fracture surface measured in the negative \(z\)-direction. By default, f1 = 0. f2 optionally can be given to provide a random, uniform deviation of dips.

dip-direction f1 <f2 > (3D only)

Dip direction of the fracture in degrees, as measured in a clockwise fashion from the positive \(y\)-axis where f1 is in the range [0,360]. By default, f1 is 0.0. f2 optionally can be given to provide a random, uniform deviation of dip directions.

dominance i

Specify the starting fracture dominance where i is greater than 1. If not specified or already taken, the next available fracture dominance value is used. Should a contact intersect numerous fractures from a single DFN, then the fracture with the lowest dominance is used to assign the appropriate contact model and properties. See the fracture contact-model command for further details.

group s <slot slot >

Assign the group name s to the fractures and optionally set the slot to slot.

intersection-set s

Fracture intersections with the newly created fractures are calculated and added to the intersection set with name s.

number i

Create i fractures. If no number is specified then a single fracture is created. Fractures are created until a newly created fracture falls completely outside the model domain.

origin v

Set the origin, or starting point, of the joint set. The first fracture generated will pass through this point.

size f1 <f2 >

Size of the fracture. By default, the size is set to span the entire domain. The size is the {fracture length in 2D; disk diameter in 3D}. A random, uniform deviation is specified optionally with f2.

spacing f1 <f2 >

Set the spacing between joints of the set. A random, uniform deviation is specified optionally with f2.