/fm_characterization

Characterization and visualization of feature models using a fact label

Primary LanguageCSSGNU General Public License v3.0GPL-3.0

Table of Contents

FM Fact Label: A Configurable and Interactive Visualization of Feature Model Characterizations

A tool to generate visualizations of feature model characterizations as a fact label similar to the nutritions fact label.

Available online

Artifact description

FM Fact Label is an online web-based application that builds an FM characterization and generates its visualization as a fact label.

It offers a web service providing an online form to upload the FM and its metadata. Currently, UVL and FeatureIDE formats are supported. At this date, the FM characterization provides up to 46 measures, including metrics and analysis results, and it is open to extension with further metrics from the SPL literature. The fact label visualization is automatically generated using D3. D3 relies on web standards (HTML, CSS, JavaScript, SVG, and JSON) to combine visualization components and a data-driven approach that allows binding arbitrary data to a Document Object Model (DOM), and then applying data-driven transformations to the DOM. The tool benefits from D3 to provide an interactive and configurable visualization of the FM characterization.

How to use it

The tool is currently deployed and available online in the following link:

https://fmfactlabel.adabyron.uma.es/

The main use case of the tool is uploading an FM and automatically generates a visualization of its characterization which can be customized and exported. The use case can be described with the following steps:

  • Upload an FM and provide metadata.
  • Build the FM characterization and generate the FM fact label.
  • Interact with the FM fact label.
  • Customize the FM fact label.
  • Export the FM fact label and the FM characterization.

Deployment of the web application

Requirements

Download and install

  1. Install Python 3.9+

  2. Clone this repository and enter into the main directory:

    git clone https://github.com/jmhorcas/fm_characterization

    cd fm_characterization

  3. Create a virtual environment:

    python -m venv env

  4. Activate the environment:

    In Linux: source env/bin/activate

    In Windows: .\env\Scripts\Activate

    ** In case that you are running Ubuntu, please install the package python3.9-dev and update wheel and setuptools with the command pip install --upgrade pip wheel setuptools right after step 4.

  5. Install the dependencies:

    pip install -r requirements.txt

Execution

To run the server locally execute the following command:

python run.py

Access to the web service in the localhost:

http://127.0.0.1:5000 or http://10.141.0.170:5000

Video

video_low_res.mp4

Architecture and repository's structure and contents

Here is a description of the architecture of the tool and the folders' structure and contents of this repository for those interesting in contributing to the project.

Software architecture

Software architecture

The tool offers a web service to upload the feature model and its metadata via an online form (Web Service component). It supports feature models in UVL and FeatureIDE formats. The FM Characterization module in the server-side gathers and manages all the feature model information. We distinguish three kinds of information: metadata (FM Metadata), structural metrics (FM Metrics), and analysis results (FM Analysis), treating all of them as an FM property. Each FM Property includes a name, a description, and a parent property for hierarchical organization in the fact label. Properties are associated with an FM Property Measure that provides the specific values of the property. For instance, the list of abstract features, their size, and ratio for the ABSTRACT FEATURES property. Analysis tasks are delegated to external tools, with the current implementation relying on flama (dark component).

Repository's structure and contents

  • run.py: It is the entry point of the application that consists on a Flask server to expose the tool's functionality.
  • fm_characterization: Contains the code related to the server-side of the architecture in charge of gathering all the information of the feature model that is needed to build the fact label. Concretely, it contains the FM Characterization, FM Metadata, FM Metrics, FM Analysis, FM property, and FM Property Measure modules, among other utils. The dependency with the flama library is on the FM Analysis module.
  • web: Contains the code related with the client-side of the architecture in charge of building the visualization of the fact label from the JSON information provided by the server-side. Concretely, it contains the HTML, CSS, and JavaScript files, where the most important is the fm_fact_label.js script which contains the main code in D3.js to build the visualization of the fact label. Also, the fm_models contains the feature models examples availables in the tool.
  • resources: Contains the images and videos used in this README.md file.

References and third-party software