The quality model setup for the PolarSys maturity assessment project was defined in a json file, and it was decided to use D3js to provide a nice and efficient visualisation of its structure. This page describes how to setup a workspace to develop and use the D3js visualisation files of the PolarSys/Eclipse quality model.
Note: The early versions of the quality models were put in GitHub. Things have been moved in BitBucket since then and have considerably evolved, but the structure is roughly the same.
npm. To install a lightweight http server, type in as root (if you want the program to be installed for all your users, otherwise it can simply be installed as a user):
npm install http-server -g
Then simply go to the directory you want to be served and type in:
Another option is to use Python's SimpleHTTPServer. Just go to the directory you want to serve, and type in:
python -m SimpleHTTPServer 8080
Whatever the method used you can check it works fine by opening a browser at the url localhost:8080. It should display the contents of the directory, since there is no index.
First clone the git repository from github:
git clone https://github.com/borisbaldassari/PolarsysMaturity.git
In this example the repository is cloned in the
~/git/ directory, and the sources are thus available in
~/git/PolarsysMaturity. After cloning, the structure should look like the following:
data/contains json files describing the quality model at various levels (simple, medium, full), the measurement concepts and metrics used. For an overview of the quality model structure check the PolarSys wiki.
qm_visualisation/contains html files for the visualisation of the json quality model. An example for the full quality model is available there: http://borisbaldassari.github.io/PolarsysMaturity/qm/polarsys_qm_full.html .
scripts/contains some scripts to check the structure of the json files, export it to various human-readable formats (html, mediawiki formatting), and publish the maturity assessment results.
Open a terminal, go to the parent directory of PolarsysMaturity and serve this directory:
cd ~/git/ && http-server .
Now open a browser and go to localhost:8080/PolarsysMaturity/qm_visualisation/. You should see something like this:
Click on the html page you want to display; for the full hierarchy of the quality model go for
data directory. Namely there are: