Average Essential Complexity is one of the source-code metrics Understand computes across 17+ languages — browse them in the GUI, export and track them, or script them with the Python API.
Average Essential Complexity
API ID: AvgEssentialLanguages: Ada, Basic, C#, C++, Fortran, Java, Jovial, Python, Rust, Web
Targets: Architectures, Classes, Files, Modules, Packages, Project
Average Essential complexity for all nested functions or methods.
For example:
class SayHello {
public:
SayHello() {}
void printHello();
};
void SayHello::printHello() {
switch (i) {
...
}
}
void cyclomaticDemo() {
...
}
int func(); // declared here, not defined - excluded from aggregates
int main() {
...
}
SayHello(), printHello(), cyclomaticDemo(), and main() have Essential Complexity of 1, 3, 1, and 1. func() is only declared, not defined, so it isn't counted. For the SayHello class, the average is (1 + 3) / 2 = 2, exactly. For the whole file (sample.cpp), the average is (1 + 3 + 1 + 1) / 4 = 1.5, rounded to 2.
See Sum and Max Essential Complexity for the other aggregations.
- Ada: Project, File, Package
- Basic: Project, File, Module, Class, Struct
- C#: Project, File, Class, Struct
- C++: Project, File, Class, Struct, Union
- Fortran: Project, File
- Java: Project, File, Class, Interface
- Jovial: Project, File
- Python: Project, File, Class
- Rust: Project, File
- Web: Project, File, PHP Class, PHP Interface
- For projects and architectures, this metric must also be enabled from "Project Configuration/Metrics/Projects and Architectures" with the "Show aggregated function metrics" option.
- This metric can be enabled from "Project Configuration/Metrics/Complexity" with the "Essential" option.