General metrics
General metrics are aggregated on five levels:
- The Specification level
- The Plain text level
- The Rationale level
- The Requirement level
- The Example level
Aggregating metrics on these five levels enables the User to do some basic data mining. It can also help Quality Assurance to set limits for different levels.
The metrics given on the Specification level in the table is basically an aggregation of the metrics for the other four levels with some additions. The additional measurements are performed on the Specification level only. The measurements on the other four levels can therefore not be added and be compared to the measurement found on the Specification level.
Whereas Specific metrics are mostly focused on the Requirements level, General metrics cover the whole Specification. And while General metrics contain absolute values, such as the number of tables or the number of requirements, Specific metrics contain mostly weighted values, such as the number of serious issues per requirement. A larger specification will, therefore, generate larger measurements for the General metrics, while weighted measurements for Specific metrics don’t change correspondingly.
A measure is defined as an operation for assigning a number to an object. During analysis, the program measures the number of serious issues for a Specification. A metric is the interpretation of the assigned number. The metric Minor issues is interpreted as the number of minor issues generated during analysis of a Specification. When a measure is applied, the number obtained is a measurement, for example the value 5.
| Label | Metric Name | Metric | Range | Decimals |
|---|---|---|---|---|
| G-1 | Serious issues | The number of serious issues found | [0, ∞) | 0 |
| G-2 | Minor issues | The number of minor issues found | [0, ∞) | 0 |
| G-3 | Requirements | The number of requirements in the Specification | [0, ∞) | 0 |
| G-4 | Rationales | The number of rationales in the Specification | [0, ∞) | 0 |
| G-5 | Examples | The number of examples in the Specification | [0, ∞) | 0 |
| G-6 | Figures | The number of figures at the level | [0, ∞) | 0 |
| G-7 | Tables | The number of tables at the level | [0, ∞) | 0 |
| G-8 | Definitions | The number of definitions made in the Definitions chapter | [0, ∞) | 0 |
| G-9 | Main actors | The number of actors defined in the Actors chapter | [0, ∞) | 0 |
| G-10 | Abbreviations | The number of abbreviations made in the Glossary chapter | [0, ∞) | 0 |
| G-11 | Bulleted lists | The number of bulleted lists at the level | [0, ∞) | 0 |
| G-12 | Numbered lists | The number of numbered lists at the level | [0, ∞) | 0 |
| G-13 | References | The number of references at the level | [0, ∞) | 0 |
| G-14 | URL's | The number of URL's at the level | [0, ∞) | 0 |
| G-15 | Automated Readability Index | The calculated ARI at the level | [5, 16] typically | 2 |
| G-16 | Coleman-Liau readability | The calculated Coleman-Liau readability index at the level | [0.4, 16.3] typically | 2 |
| G-17 | Kincaid readability | The calculated Kincaid readability index at the level | [5.5, 16.3] typically | 2 |
| G-18 | Lix readability | The calculated Lix readability index at the level | [34, 57] typically | 2 |
| G-19 | Average words per sentence | Average number of words per sentence at the level | [0, ∞) | 1 |
| G-20 | Max number of words in a sentence | The max number of words in any sentence at the level | [0, ∞) | 0 |
| G-21 | Sentences using the passive voice | The number of sentences using the passive voice at the level | [0, ∞) | 0 |
| G-22 | Adjectives | The number of adjectives at the level | [0, ∞) | 0 |
| G-23 | Adverbs | The number of adverbs at the level | [0, ∞) | 0 |
| G-24 | Conjunctions | The number of conjunctions at the level | [0, ∞) | 0 |
| G-25 | Pronouns | The number of pronouns at the level | [0, ∞) | 0 |
| G-26 | Nominalizations | The number of nominalizations at the level | [0, ∞) | 0 |
| G-27 | Special characters | The number of special characters at the level | [0, ∞) | 0 |
| G-28 | Special expressions | The number of special expressions at the level | [0, ∞) | 0 |
| G-29 | Subordinate clauses | The number of subordinate clauses at the level | [0, ∞) | 0 |
| G-30 | Misspelled words | The number of misspelled words at the level | [0, ∞) | 0 |