SDA SE Wiki

Software Engineering for Smart Data Analytics & Smart Data Analytics for Software Engineering

User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
research:jtransformer:tutorial:control_center [2014/09/08 09:13]
andreas.becker
research:jtransformer:tutorial:control_center [2018/05/09 01:59] (current)
Line 1: Line 1:
 +====== Control Center ======
  
 +{{:​research:​jtransformer:​tutorial:​cc_overview_highlight.png|}}
 +
 +The JTransformer Control Center is the most important view for working with JTransformer. It contains the following components:
 +  - a factbase selector,
 +  - a set of possible operations for the selected factbase,
 +  - a table of available analyses,
 +  - a table of analysis results and
 +  - a toolbar offering actions for analyses.
 +
 +===== Factbase Selector =====
 +
 +The factbase selector allows the selection of a JTransformer factbase. All operations, the lists of analyses and analysis results work for the selected factbase. Thus, it is important to make sure that a factbase is selected before performing any operation in the view.
 +
 +===== Factbase Operations =====
 +
 +{{:​research:​jtransformer:​tutorial:​cc_factbase_operations.png|}}
 +
 +The possible operations for the selected factbase are:
 +
 +  - **Factbase Statistics**:​ Opens the [[factbase_statistics|JTransformer Statistics]] view and selects the same factbase in the view.
 +  - **Recreate Factbase**: Recreates the complete factbase, i.e. all PEFs will be deleted first and recreated afterwards.
 +  - **Restart process**: Allows restarting the Prolog process of the factbase. This operation is the same as in the [[https://​sewiki.iai.uni-bonn.de/​research/​pdt/​docs/​console#​processes|Prolog Console]].
 +  - **Import factbase**: Loads a factbase file into the Prolog process of the selected factbase. The selected factbase will be cleared before performing the import.
 +  - **Export factbase**: Exports the selected factbase to a Prolog file (either plain or [[http://​www.swi-prolog.org/​pldoc/​man?​section=qlf|compiled]]).
 +  - **Save factbase**: The operations offered in the drop down menu allow to generate reverse engineered code. A detailed description can be found [[reverse_engineering|here]].
 +
 +===== Available Analyses =====
 +
 +{{:​research:​jtransformer:​tutorial:​cc_analysis_table.png|}}
 +
 +The analysis table shows the availabe analyses of the selected factbase. An analysis is availabe if it is loaded in the factbase. If the table is empty no analyses have been loaded and it is necessary to load a file containing analysis declarations and implementations. When switching to another factbase it might be necessary to load them again (once per factbase), since each factbase corresponds to a separate Prolog process having its own set of loaded analyses and transformations. ​
 +
 +The analysis table allows **enabling** ({{:​research:​jtransformer:​tutorial:​cc_enabled.gif|}}) and **disabling** ({{:​research:​jtransformer:​tutorial:​cc_disabled.gif|}}) of analyses. If an analysis is enabled (and its //Run// property is //onSave//) it will be executed after each update of the factbase. This means that all results are deleted and recomputed after each update.
 +
 +The analyses in the table are grouped into //​categories//​. //​Categories//​ are written with an emphasized font, analyses are written with a normal font.
 +
 +For each analysis and category the table shows:
 +  * the **name** of the analysis/​category,​
 +  * a **description** of the analysis/​category and
 +  * the **number of results** of the analysis/​category.
 +
 +Additionally the table shows the following information for each analysis in the tooltip:
 +  * **Run** defines when to run the analysis. Possible values are:
 +    * //onSave//: The analysis is run automatically after each update of the factbase. The most likely case is saving a file whose contents is represented in the factbase. ​
 +    * //​manually//:​ The analysis can only be run explicitly from of the Control Center.
 +  * **Type** is the kind of [[viewing_results#​markers|markers]] that JTransformer creates for this analysis. Possible values are 
 +    * //info// ({{:​research:​jtransformer:​tutorial_old:​info_tsk.gif|}})
 +    * //warning// ({{:​research:​jtransformer:​tutorial_old:​quickfix_warning_obj.gif|}}) ​
 +    * //error// ({{:​research:​jtransformer:​tutorial_old:​quickfix_error_obj.gif|}})
 +
 +==== Context Menu ====
 +
 +{{:​research:​jtransformer:​tutorial:​cc_analysis_table_contextmenu.png|}}
 +
 +The context menu of the analysis table offers two operations for the **selected** analyses.
 +  * **Run analysis**: Runs the selected analyses and creates markers for the results. The old results of the selected analyses are deleted before.
 +  * **Remove analysis markers**: Deletes the results of the selected analyses.
 +
 +===== Analysis Results =====
 +
 +{{:​research:​jtransformer:​tutorial:​cc_analysis_result_table.png|}}
 +
 +The analysis result table shows the results for the analyses which are **selected** in the analysis table. For each analysis result the table shows:
 +  * a **description** of the result,
 +  * the **resource** of the result and,
 +  * the **location** (line) of the result in its resource.
 +
 +By double-clicking on a result in the table it is possible to select the location of the result in an editor. Further information about working with analysis results can be found [[viewing_results|here]].
 +
 +===== Toolbar =====
 +
 +{{:​research:​jtransformer:​tutorial:​cc_toolbar.png|}}
 +
 +The toolbar offers two operations:
 +  - **Run all enabled analyses**: Runs the **enabled** analyses and creates markers for the results. The old results of the **enabled** analyses are deleted before.
 +  - **Delete all analysis markers**: Deletes **all** analysis results.
research/jtransformer/tutorial/control_center.txt · Last modified: 2018/05/09 01:59 (external edit)

SEWiki, © 2019