If you just want to have a look, a recent version of Polymetric Views is hosted here. Simply open the page and once the demo data has loaded you can switch between layouts and mappings.
You can also use this online version to visualise your own projects. Simply load the MSE file with your metrics into the web page. (See section on inFamix below for details on how to create the MSE file.) Note that all the processing happens in your browser on your computer; no data is uploaded to a server.
Getting the metrics data with inFamix
To get the metrics for a Java, C, or C++ project use inFamix. On Linux simply call inFamix like this
inFamix -lang ( cpp | java | c ) -path path/to/project -mse path/to/msefile.mse
On OS X, depite the fact that inFamix is packaged like an application, it must also be used from the command line:
./inFamix.app/Contents/MacOS/inFamix -lang ( cpp | java | c ) -path path/to/project -mse path/to/msefile.mse
Copy the MSE file into the public directory and rename it to data.mse.
MSE is a file format. The files generated by inFamix use the MSE format to write FAMIX models. Information about FAMIX and MSE can be found on the Moose Technology website.
Displaying the polymetric views
Open the file public/polymetrics.html in a browser. If a file named data.mse is present a diagram for the data contained in that file should be displayed in the browser. In either case, other MSE files can be loaded from the page.
Note that depending on your browser and computer and the size of the MSE file it can take 10 seconds or more before the diagram is rendered. Switching between layouts and metrics mappings should be very quick.
Supported browsers: Firefox, WebKit/Blink-based browsers (e.g. Safari, Chrome), "modern" Internet Explorer (i.e. Internet Explore 9 and above). Other browsers may or may not work. Internet Explorer 8 and below definitely do not work.
The following metrics are currently available at the class level:
- LOC (Lines of Code): the sum of the lines of code of all methods in the class
- NOA (Number of Attributes): the number of attributes (instance variables/fields/members) of the class
- NOM (Number of Methods): the number of methods in the class
- NOPUBM (Number of Public Methods): the number of methods in the class that are public
- WMC (Weighted Method Count): the sum of the weight of all methods in the class. We are using the method's Cyclomatic Complexity as its weight. This makes WMC the sum of the complexity of all methods in the class.
- CBO (Coupling between Objects): the number of other types and classes the class is coupled to. This metric was proposed by Chidamber and Kemerer, and is described well in this brief intro.
The following ratios are also available at the class level:
- LOC/NOM: The lines of code over the number of methods, i.e. the average method length
- WMC/LOC: The total complexity over the number of lines of code, i.e. the average complexity per line of code
The following metric is available at the package/namespace level:
- NOC (Number of Classes): the number of classes in the package/namespace. This includes classes that are in child packages/namespaces.
The MSE parser
The MSE parser in public/mseparser.js was generated with PEG.js. The grammar is included in mse/mse.pegjs. If you want to modify the grammar and regenerate the parser, run the generate.sh script. You will need Node.js, npm, and the pegjs package to do so. Detailed instructions are available in the PEG.js documentation.
Copyright and license
Copyright 2013 Erik Doernenburg
Licensed under the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.