zone property-distribution command

Syntax

zone property-distribution <[property] fvalue > keyword ... <range>

Primary keywords:

deviation-gaussian    deviation-uniform    deviation-lognormal    gradient    add    multiply    vary

Modify a zone constitutive model property. The property should accept a value of type float. While technically any valid type can be used here, none of the distribution keywords will apply and the zone property command should probably be used instead.

The phrase that modifies the value must be given immediately following the property value. For more information on modifying values and the operation of these keywords, see the Value Modifiers topic.

The special density keyword can be given as a property as well, assigning density to zones. This is not a constitutive model property but stored within the zone class.

deviation-gaussian f <keyword>

A Gaussian distribution is used to assign the property values randomly, with a mean of fvalue and standard deviation of f. The optional keywords fmax and fmin specify the upper and lower bounds, respectively. If a generated value falls outside these bounds, it is regenerated until it lies within the specified range.

maximum fmax

Set the maximum value fmax for the property.

minimum fmin

Set the minimum value fmin for the property. For example, if this value is zero, the property will exclude any negative values.

deviation-uniform f

A uniform distribution is used to assign the property values randomly, with a mean value of fvalue and a standard deviation of f.

deviation-lognormal f

A log-normal distribution is used to assign the property values randomly. In other words, the natural logarithm of property values is a Gaussian distribution with a mean of fvalue and standard deviation of f.

gradient v <origin v >

Apply a gradient to the property value. Note the origin keyword is optional, however, the default value (0,0,0) is used if the origin keyword is not included in the command — which may not produce the intended result.

add

Add fvalue to the property value.

multiply

Multiply the property value by fvalue.

vary v

Apply a linear variation to the property value.

Usage Example

The following example illustrates how zone property-distribution can be used.

zone property-distribution cohesion 600 deviation-gaussian 10

The above example sets a Gaussian distribution on cohesion with a mean of 600 and standard deviation of 10.