- UPPAAL Help
The options menu contains settings to control the behavior of the model-checker.
This option influences the order in which the state space is explored.
- Breadth first
- Search the state space in breadth first search order. This is typically the most efficient option when the complete state space must be searched. When generating shortest or fastest traces, this is likely the best setting.
- Depth first
- Search the state space in depth first search order. If a counter example or witnessing trace is expected to exist, this setting is usually better than the breadth first setting. It is not recommended to use this search order when generating shortest or fastest traces.
- Random depth first
- Search the state space in randomised depth first search order. If a counter example or witnessing trace is expected to exist, this is usually the best setting. Due to the randomisation, traces may vary from run to run. It is not recommended to use this search order when generating shortest or fastest traces.
State Space Reduction
When searching the state space, UPPAAL does not necessarily have to store all states in memory in order to guarantee termination. This option influences how aggressively UPPAAL tries to avoid storing states. There is normally a tradeoff between space and speed.
- Store all states.
- Avoid storing committed states.
- Avoid storing more than one state per cycle.
State Space Representation
This option determines how the state space should be represented in the model checker.
Some representations are approximative in the sence that either a larger or smaller state space than the real one is generated. When an approximative representation is used, UPPAAL may conclude that a query is maybe satisfied, i.e., UPPAAL cannot make a decisive conclusions given the representation selected.
- Difference Bound Matrices (DBM)
- DBMs are often fast, but for models with many clocks they require a lot of memory.
- Compact Data Structure
- A more compact, but slower representation than DBMs. In particular for models with many clocks, this setting will often significantly reduce memory consumption. Even for models with no or few clocks, this option enables other memory saving techniques at the expense of speed.
- Under Approximation
- Uses bit-state hashing to represent the state space. This results in an under approximation, however the degree of approximation can be adjusted by adjusting the size of the hash table: Large hash tables result in a larger part of the state space being searched. The hash table size can be selected with the hash table size option.
- Over Approximation
- Uses convex-hull approximation of zones. This results in an over approximation of the state space. For models without clocks, this setting has no effect.
This option controls if a counter-example or witnessing trace (if there is one) should be generated during verification. The trace is loaded into the simulator after verification. Enabling trace generation has two side effects:
- Only one property at a time can be verified.
- Symmetry reduction is disabled.
The possible settings for trace generation are:
- Do not generated any diagnostic trace.
- Generate a diagnostic trace.
- Generate a shortest trace, i.e. a trace with the smallest number of transitions.
- Generate a fastest trace, i.e. a trace with the shortest accumulated time delay.
The range of clocks is unbounded, i.e., clocks can obtain arbitrarily large real values. To guarantee termination, UPPAAL uses an abstraction techniques called extrapolation. The extrapolated state space is finite. UPPAAL implements a number of extrapolation techniques that differ in the size of the extrapolated state space. Not all extrapolation techniques preserve all properties for all kinds of models. UPPAAL automatically selects the coarsets extrapolation, which still preserves the property being analysed.
Sometimes it may be of benefit to use a coarser (and faster) extrapolation that the one selected by UPPAAL. By doing so, the analysis will use an over-approximation of the state space. Listed from finest to coarsets, the choices are: None, Difference, Local, and Lower/Upper.
- Selects the coarsest extrapolation preserving the property being analysed. If in doubt, use this setting.
- Do not use extrapolation. Termination is no longer guaranteed. Since performing the extrapolation is relatively expensive, this may be of use if you know that the symbolic state space is finite.
- Used whenever the model or the query contain difference constraints over clocks, e.g., x - y < 3.
- Used whenever the query contains either the deadlock keyword or involves a liveness property (except if the model or the query contain difference constraints).
- Used whenever a reachability analysis is performed, except when the deadlock keyword is used or when the model or the query contain difference constraints.
Hash table size
Adjusts the amount of memory used to represent the state space when using bit-state hashing. This option has no effect unless under approximation is selected.
When selected, instructs the verifier to (whenever possible) reuse the generated portion of the state space when several properties of the same system are checked.
- Lower probabilistic deviation (-δ)
- Used in hypothesis testing (qualitative model-checking) to specify the lower bound of indifference region from the specified probability.
- Upper probabilistic deviation (+δ)
- Used in hypothesis testing (qualitative model-checking) to specify the upper bound of indifference region from the specified probability.
- Probability of false negatives (α)
- Used in hypothesis testing (qualitative model-checking) and probability estimation (quantitative model-checking) to specify the level of significance.
- Probability of false positives (β)
- Used in hypothesis testing (qualitative model-checking) to specify the level of significance.
- Probability uncertainty (ε)
- Used in probability estimation (qualitative model-checking) to constrain the probability interval.
- Ratio lower bound (u0)
- Used in comparison of two probabilities.
- Ratio upper bound (u1)
- Used in comparison of two probabilities.
- Histogram bucket width
- Specifies the width of each column in the histogram. By default it is set to zero meaning that the width is determined by ratio of entire histogram width divided by a bucket count.
- Histogram bucket count
- Specifies the number of columns in the histogram. By default it is set to zero meaning that the count is determined by taking a square root of a total number of samples and dividing by four.
The compact data structure and the options for state space reduction are described in the following paper:
Efficient Verification of Real-Time Systems: Compact Data Structure and State Space Reduction, Kim G. Larsen, Fredrik Larsson, Paul Pettersson and Wang Yi. In Proceedings of the 18th IEEE Real-Time Systems Symposium, pages 14-24. San Francisco, California, USA, 3-5 December 1997.