zone relax command

Syntax

zone relax keyword

Primary keywords:

delete    excavate    fill    list    modify

Create and modify a special apply condition on the zones in the range. This condition gradually “excavates” the material by reducing the stiffness, stresses, and densities of the zones. This keeps spurious inertial effects in the static solution process from causing unrealistic damage to the region around the excavation.

The values of these quantities are systematically reduced by applying a multiplier (the reduction factor) that varies from 1.0 to 0.0 over time. The precise time taken and shape of the curve is controllable by the user, but defaults to a servo controlled by the current mechanical force ratio (see zone ratio ).

When the reduction factor for a given zone is brought to zero, the mechanical constitutive model for the zone is set to null and the apply condition for that zone is removed. When all the zones involved in a given condition are nulled by the apply condition, the apply condition itself is destroyed.

The constitutive model of all zones included are set to elastic, preserving the bulk and shear modulus of the original model.

Because the density and stiffness of the material is reduced over time, in small strain mode a periodic recalculation of some parameters (body force due to gravity, inertial mass) will take place. This will happen when the reduction factor changes, but no more frequently than the current zone geometry-update setting.

Note that while the total stress is reduced to zero, any pore-pressures in the gridpoints attached to the zones will remain unaffected.

The fill option is in some sense the opposite of excavate - it creates new material and slowly increases its density. If the zones in the range are null they will be made elastic and given the elastic properties specified in the command. If the zones already have a non-null material model then the current model and properties will be used, but the density will be set to zero and slower brought up to the original value.

delete s

Find a previously created zone relax apply condition with name s, and delete it. If the reduction factor has reached 0, the material has been nulled and thus its relax condition has been deleted. For this case, no need to delete it once more.

excavate keyword <range>

Create and initialize an excavation condition on all zones in the range.

The following keywords are available to customize how the excavation progresses.

fish s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This should return a value of 1.0 at the start, and 0.0 and the end. If this keyword is used, the default servo is not used.

fish-local s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This function is called separately for each individual zone taking part in the apply condition. If this keyword is used, the default servo is not used.

The function is assumed to take two arguments. The first argument is a pointer to the zone in question. The second argument is unused.

minimum f

Set the minimum reduction factor that will be allowed. The default value is 0.0. This should be a number between 0.0 and 1.0. This value can be used to solve to a specific reduction factor before installing reinforcement or other operation. Then the zone relax modify command can be used to lower the minimum.

Note changing the minimum when using the table, fish, or fish-local options to control the reduction factor may result in unexpected behavior, as the time index used for those options will not stop advancing after reaching the minimum value.

name s

Assign the apply condition an identifying name s. If a name is not specified one will be created automatically based on the internally assigned ID number.

servo-bound f

If the current mechanical force ratio (see the zone ratio) is lower than this value, the reduction factor is reduced by the increment. The default value is 5e-3.

servo-increment f

If the current mechanical force ratio is less than servo-bound, then the reduction factor is reduced by subtracting f from it. This number should be less than 1.0, and greater than 0.0. The default value is 0.005.

step i

If set to a positive value, then any FISH, table, or servo parameters are ignored and the reduction factor is reduced linearly from 1.0 to 0.0 over the course of i steps.

table s <time keyword>

If specified, then the reduction factor is given by table s. A lookup is performed every step. By default the x value used to lookup a table y value will be the accumulated mechanical time, which for a purely static analysis is the same as the number of steps. The time index used can be changed by using the optional time keyword, with the following options.

step

Use the total cycle count.

mechanical

Use the accumulated mechanical time (the default).

fluid

Use the accumulated fluid flow time.

thermal

Use the accumulated thermal time.

creep

Use the accumulated creep time.

dynamic

Use the accumulated dynamic time.

fill keyword <range>

Create and initialize a fill condition on all zones in the range. This behaves similarly to excavate but only the density is modifed and this is increased from 0.0 to the final value. If the zone has a non-null constitutive model the current density will be used as the final target density. If the zone is null then the target density must be specified, as well as elastic properties, because the elasic constitutive model will be assigned automatically. Either shear and bulk moduli or young and poisson may be specified.

The following keywords are available to customize how the excavation progresses.

bulk f

Specifies the bulk modulus that will be assigned to any null zones in the range when they are made elastic.

density f

Specifies the density that will be used at the target density if a null zone is found in the range.

fish s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This should return a value of 0.0 at the start, and 1.0 and the end. If this keyword is used, the default servo is not used.

fish-local s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This function is called separately for each individual zone taking part in the apply condition. If this keyword is used, the default servo is not used.

The function is assumed to take two arguments. The first argument is a pointer to the zone in question. The second argument is unused.

maximum f

Set the maximum reduction factor that will be allowed. The default value is 1.0. This should be a number between 0.0 and 1.0. This value can be used to solve to a specific reduction factor before installing reinforcement or other operation. Then the zone relax modify command can be used to increase the maximum.

Note changing the minimum when using the table, fish, or fish-local options to control the reduction factor may result in unexpected behavior, as the time index used for those options will not stop advancing after reaching the minimum value.

minimum f

Set the minimum reduction factor that will be allowed. The default value is 0.0. This should be a number between 0.0 and 1.0. This value can be used to solve to a specific reduction factor before installing reinforcement or other operation. Then the zone relax modify command can be used to lower the minimum.

Note changing the minimum when using the table, fish, or fish-local options to control the reduction factor may result in unexpected behavior, as the time index used for those options will not stop advancing after reaching the minimum value.

name s

Assign the apply condition an identifying name s. If a name is not specified one will be created automatically based on the internally assigned ID number.

poisson f

Specifies the Poisson’s ratio that will be assigned to any null zones in the range when they are made elastic.

servo-bound f

If the current mechanical force ratio (see the zone ratio) is lower than this value, the reduction factor is increased by the increment. The default value is 1e-3.

servo-increment f

If the current mechanical force ratio is less than servo-bound, then the reduction factor is reduced by subtracting f from it. This number should be less than 1.0, and greater than 0.0. The default value is 0.005.

shear f

Specifies the shear modulus that will be assigned to any null zones in the range when they are made elastic.

step i

If set to a positive value, then any FISH, table, or servo parameters are ignored and the reduction factor is reduced linearly from 1.0 to 0.0 over the course of i steps.

table s <time keyword>

If specified, then the reduction factor is given by table s. A lookup is performed every step. By default the x value used to lookup a table y value will be the accumulated mechanical time, which for a purely static analysis is the same as the number of steps. The time index used can be changed by using the optional time keyword, with the following options.

step

Use the total cycle count.

mechanical

Use the accumulated mechanical time (the default).

fluid

Use the accumulated fluid flow time.

thermal

Use the accumulated thermal time.

creep

Use the accumulated creep time.

dynamic

Use the accumulated dynamic time.

young f

Specifies the Young’s modulus that will be assigned to any null zones in the range when they are made elastic.

list

List all relax conditions, including their name and settings.

modify s keyword

Find the previously created zone relax apply condition with name s and modify its settings. The following keywords are available.

fish s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This should return a value of 1.0 at the start, and 0.0 at the end (assuming it is an excavation and not a fill). If this keyword is used, the default servo is not used.

fish-local s

Specify a FISH function that determines the multiplier to use as the excavation progresses. This function is called separately for each individual zone taking part in the apply condition. If this keyword is used, the default servo is not used.

The function is assumed to take two arguments. The first argument is a pointer to the zone in question. The second argument is unused.

name s

Assign the apply condition an identifying name s. If a name is not specified one will be created automatically based on the internally assigned ID number.

servo-bound f

If the current mechanical force ratio (see the zone ratio) is lower than this value, the reduction factor is reduced by the increment. The default value is 1e-3

servo-increment f

If the current mechanical force ratio is less than servo-bound, then the reduction factor is increased by adding f to it. This number should be less than 1.0, and greater than 0.0. The default value is 0.005.

step i

If set to a positive value, then any FISH, table, or servo parameters are ignored and the reduction factor is increased linearly from the current value (which is at start 0.005) to minimum (by default 0.0) over the course of i steps.

table s <time keyword>

If specified, then the reduction factor is given by table s. A lookup is performed every step. By default the x value used to lookup a table y value will be the accumulated mechanical time, which for a purely static analysis is the same as the number of steps. The time index used can be changed by using the optional time keyword, with the following options.

step

Use the total cycle count.

mechanical

Use the accumulated mechanical time (the default)

fluid

Use the accumulated fluid flow time.

thermal

Use the accumulated thermal time.

creep

Use the accumulated creep time.

dynamic

Use the accumulated dynamic time.