|
•
|
<phys>.sum(expr) evaluates the sum of the expression expr over the grains. The sum includes all grains that are active. It excludes grains that have not yet been released and those that have disappeared.
|
|
•
|
<phys>.sum_all(expr) evaluates the sum of the expression expr over all grains, including grains that are not yet released or have disappeared. Since the coordinates of unreleased and disappeared grains are not-a-number (NaN), the sum may return NaN if the model includes unreleased or disappeared grains. An expression such as pt.sum_all(isnan(qx)) can be used to compute the total number of unreleased and disappeared grains.
|
|
•
|
<phys>.ave(expr) evaluates the average of the expression expr over the active grains. Unreleased and disappeared grains contribute to neither the numerator nor the denominator of the arithmetic mean.
|
|
•
|
<phys>.ave_all(expr) evaluates the average of the expression expr over all grains. It is likely to return NaN if the model includes unreleased or disappeared grains.
|
|
•
|
<phys>.max(expr) evaluates the maximum value of the expression expr over all active grains.
|
|
•
|
<phys>.max_all(expr) evaluates the maximum value of the expression expr over all grains.
|
|
•
|
<phys>.min(expr) evaluates the minimum value of the expression expr over the active grains.
|
|
•
|
<phys>.min_all(expr) evaluates the minimum value of the expression expr over all grains.
|
|
•
|
<phys>.max(expr, evalExpr) evaluates the expression evalExpr for the grain that has the maximum value of the expression expr out of all active grains. For example, in a model that uses the Granular Flow interface with the name gran, the expression gran.max(gran.V, qx) would evaluate the x-coordinate qx of the grain with the greatest velocity magnitude gran.V.
|
|
•
|
<phys>.max_all(expr, evalExpr) evaluates the expression evalExpr for the grain that has the maximum value of the expression expr for all grains, including disappeared and unreleased grains.
|
|
•
|
<phys>.min(expr, evalExpr) evaluates the expression evalExpr for the grain that has the minimum value of the expression expr out of all active grains. For example, in a model that uses the Granular Flow interface with name gran, the expression gran.min(gran.V, qx) would evaluate the x-coordinate qx of the grain with the smallest velocity magnitude gran.V.
|
|
•
|
<phys>.min_all(expr, evalExpr) evaluates the expression evalExpr for the grain that has the minimum value of the expression expr for all grains, including disappeared and unreleased grains.
|