Difference between revisions of "Evaluation modes"

m (Mhenrion moved page Evaluation Modes to Evaluation modes: only the first letter of a title shd be capitalized)
 
(14 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
[[Category:Doc_Status_D]] <!-- For Lumina use, do not change -->
 
[[Category:Doc_Status_D]] <!-- For Lumina use, do not change -->
 
   
 
   
Each variable or expression, «x», in Analytica has a '''Mid value''', also known as its ''deterministic ''value. If «x» or any of its predecessors are defined by a probability distribution, it uses the Mid of the distribution (usually its median.) It is fast to evaluate the Mid value because it avoids the Monte Carlo simulation with multiple samples used to represent uncertainties. A multivariate distribution returns an array of Mid values. The [[Mid]] value is often close to [[Median]], but it is not guaranteed, because <code>Median(F(x, y))</code> is not necessarily the same as <code>F(Median(x), Median(y))</code>.  
+
All variables have a '''Mid'''' or deterministic value, computed in "Mid mode".  Some also have a '"Prob"' or probabilistic value, computed in "Prob mode":
 +
* The '''Mid''' value is a deterministic value that ignores any uncertainties, shown when computed in "Mid mode". It uses the [[median]] of any probability distribution in a Definition, and the "Mid value" of any variable or function on which it depends.   The [[Mid]] value is often close to the [[Median]], but it is not guaranteed, to be equal because <code>Median(F(x, y))</code> is not always the same as <code>F(Median(x), Median(y))</code>. By default, when you first ask for a Result -- e.g. to view a Table or Graph -- it first computes and shows the Mid value. A Mid value is much faster to compute for a large model, since it uses only a single value for each distribution rather than a random sample of numbers. 
  
A variable or expression also has a '''Prob value''' if it is defined as a probability distribution, or if any of its predecessor variables are defined as probability distributions. The Prob value is a actually a random sample from the probability distribution for the variable, based on random samples from its predecessors. Each sample is indexed by the system index '''Run '''-- numbered from 1 to '''Samplesize'''. '''Samplesize '''is the number of samples set in the '''Uncertainty''' dialog box (available from '''Result''' menu).  
+
* The '''Prob''' (probabilistic) value is a random sample of values from a probability distribution. Prob values are computed in '''Sample evaluation mode'''. Any probability distribution in a definition -- e.g. <code>Normal(10, 5)</code> -- is evaluated as a random sample using [[Monte Carlo]] or another [[sampling method]]. Each sample is an array indexed by the system index [[Run]] -- numbered from 1 to [[SampleSize]]. A Prob value for a variable or function uses the Prob value of any uncertain Variable or Function on which it depends.  When you select an [[Uncertainty view]] (other than "Mid") from the pulldown menu of a [[Result window]], it computes its "Prob value" and displays it as a Mean, Statistics, Probability Bands, PDF, or whichever option you select.
  
By default, when you first ask for a Result -- Table or Graph -- it computes and shows the Mid value. You can control the evaluation mode by selecting an '''Uncertainty view''' from the pulldown menu in the top left of the [[Result window]]: [[Mid]] displays the Mid value (computing it if necessary). If you select any other Uncertainty view ('''Mean''', '''Stats''', '''Bands''', '''PDF '''or Prob Mass, '''CDF '''or CumProb, or '''Sample'''), it tries to evaluate the variable, and its predecessors, in Prob mode. If it can, it displays the resulting uncertain quantity using the uncertainty view you selected. If neither the variable nor its predecessors contain a probability distribution, it has no Prob value -- it shows a warning message, and shows the Mid result.  
+
If the variable has no "Prob value" because neither the variable nor any of its inputs contain a probability distribution, it gives a warning, and shows the Mid result. You can also select "Mid"  from the [[Uncertainty view of a result|Uncertainty view]]  to go back to see the [[Mid]] value (computing it if necessary).
 +
 
 +
The accuracy with which the "Prob value" represents the underlying probability distribution increases with [[SampleSize]]. It usually makes sense to start with a small number -- e.g. the default 1000. You can increase it later when you have verified the model is correct, in the [[Uncertainty Setup dialog]] (available from the [[Result menu]]).  
  
 
[[Statistical functions]] -- such as [[Mean]], [[Sdeviation]], [[Correlation]] -- expect their main parameter(s) to be uncertain and evaluate them, and their predecessors, in Prob mode, even if they appear in an expression being evaluated in Mid mode. A statistical function estimates its value from a Prob value (or two Prob values, in the case of [[Correlation]], and related functions). If you define  
 
[[Statistical functions]] -- such as [[Mean]], [[Sdeviation]], [[Correlation]] -- expect their main parameter(s) to be uncertain and evaluate them, and their predecessors, in Prob mode, even if they appear in an expression being evaluated in Mid mode. A statistical function estimates its value from a Prob value (or two Prob values, in the case of [[Correlation]], and related functions). If you define  
Line 22: Line 25:
  
 
In this case, evaluating <code>X</code>, causes <code>Y</code> to be evaluated in Mid mode, returning the median of <code>y</code> (15).  
 
In this case, evaluating <code>X</code>, causes <code>Y</code> to be evaluated in Mid mode, returning the median of <code>y</code> (15).  
 
A is a function that returns a median value when evaluated in Mid-mode, and a sample array indexed by the [[Run]] Index when evaluated in [[Sample]]-mode.
 
  
 
==See Also==
 
==See Also==
 +
* [[Uncertainty views]]
 
* [[Mid]]()
 
* [[Mid]]()
 
* [[Sample]]
 
* [[Sample]]

Latest revision as of 01:22, 26 November 2024


All variables have a Mid' or deterministic value, computed in "Mid mode". Some also have a '"Prob"' or probabilistic value, computed in "Prob mode":

  • The Mid value is a deterministic value that ignores any uncertainties, shown when computed in "Mid mode". It uses the median of any probability distribution in a Definition, and the "Mid value" of any variable or function on which it depends. The Mid value is often close to the Median, but it is not guaranteed, to be equal because Median(F(x, y)) is not always the same as F(Median(x), Median(y)). By default, when you first ask for a Result -- e.g. to view a Table or Graph -- it first computes and shows the Mid value. A Mid value is much faster to compute for a large model, since it uses only a single value for each distribution rather than a random sample of numbers.
  • The Prob (probabilistic) value is a random sample of values from a probability distribution. Prob values are computed in Sample evaluation mode. Any probability distribution in a definition -- e.g. Normal(10, 5) -- is evaluated as a random sample using Monte Carlo or another sampling method. Each sample is an array indexed by the system index Run -- numbered from 1 to SampleSize. A Prob value for a variable or function uses the Prob value of any uncertain Variable or Function on which it depends. When you select an Uncertainty view (other than "Mid") from the pulldown menu of a Result window, it computes its "Prob value" and displays it as a Mean, Statistics, Probability Bands, PDF, or whichever option you select.

If the variable has no "Prob value" because neither the variable nor any of its inputs contain a probability distribution, it gives a warning, and shows the Mid result. You can also select "Mid" from the Uncertainty view to go back to see the Mid value (computing it if necessary).

The accuracy with which the "Prob value" represents the underlying probability distribution increases with SampleSize. It usually makes sense to start with a small number -- e.g. the default 1000. You can increase it later when you have verified the model is correct, in the Uncertainty Setup dialog (available from the Result menu).

Statistical functions -- such as Mean, Sdeviation, Correlation -- expect their main parameter(s) to be uncertain and evaluate them, and their predecessors, in Prob mode, even if they appear in an expression being evaluated in Mid mode. A statistical function estimates its value from a Prob value (or two Prob values, in the case of Correlation, and related functions). If you define

X := Mean(Y)
Y := Normal(2, 1)

If you evaluate «x» in Mid mode, the statistical function Mean(y) will evaluate «y» in Prob mode. So, the Mid value of «x» will be an estimate of the mean of «y», based on a Monte Carlo sample which is the Prob value of Y. So, evaluating any variable containing a statistical function will cause a Prob mode evaluation of any variable appearing in its parameter(s), and any predecessors of those variables. The result of a statistical function is a Mid value, not a probability distribution. In the example above, X has a Mid value, equal to the mean of Y, but no Prob value.

Conversely, the function Mid(X) always evaluates its parameter «X» in Mid mode, even when Mid(X) is evaluated in Prob mode. For example

X := Mid(Y)
Y := Uniform(10, 20)

In this case, evaluating X, causes Y to be evaluated in Mid mode, returning the median of y (15).

See Also

Comments


You are not allowed to post comments.