mirrors/eiffel-org
1
0
Fork 0
mirror of https://github.com/EiffelSoftware/eiffel-org.git synced 2025-12-07 23:32:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

Added release 19.05.

Browse Source 
git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@2152 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
jfiat
2019-05-19 11:17:36 +00:00
parent 2c8d6d6f35
commit 5c23b7c968
2939 changed files with 62245 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/detailed-result-panel.wiki Normal file
View File

@@ -0,0 +1,16 @@
[[Property:title|Detailed Result Panel]]
[[Property:weight|1]]
[[Property:uuid|35018218-cf90-5aca-dc47-205bb351592e]]
The Detailed result panel is where detailed metric result and archive comparison result are displayed. In the following two figures, a detailed metric result and an archive comparison result are shown.
Detailed metric result:
[[Image:interface4|Defining an input domain]]
Archive comparison result:
[[Image:interface5|Defining an input domain]]

5
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/index.wiki Normal file
View File

@@ -0,0 +1,5 @@
[[Property:title|User interface basics]]
[[Property:weight|3]]
[[Property:uuid|c2b8d8b6-661c-1cb5-a991-388e8374c696]]
EiffelStudio includes a Metric tool based on the previously defined metric theory. This tool provides many facilities like computing measures over a project, including smaller scopes, defining new metrics according to users needs, and handling archives to compare projects.

34
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/metric-archive-panel.wiki Normal file
View File

@@ -0,0 +1,34 @@
[[Property:title|Metric Archive Panel]]
[[Property:weight|4]]
[[Property:uuid|c8793405-c91d-c04b-10ed-07739728f697]]
The metric archive panel is used to calculate and restore metric archives and to do metric archive comparison.
==Metric Archive Calculation==
Let's have a look at the buttons and options related to metric archive calculataion:
[[Image:metrics-tool--debug-run-icon|calculate archive]] Start metric archive calculation<br/>
After selecting the metrics you want to archive and the input domain, use this button to start a metric archive calculation.
[[Image:metrics-tool--debug-stop-icon|stop archive]] Stop metric archive calculation<br/>
Use this button to stop a metric archive calculation.
[[Image:interface22|archive file location]] Specify archive file<br/>
The file to store metric archive results is specified here.
[[Image:interface23|reset archive]] Reset archive file<br/>
If the specified archive file already contains some archive information, this option will be sensitive. If it's enabled, the information contained in that archive file will be cleaned before new archive information is written to that file, otherwise, new archive information will be appended to that file.
==Metric Archive Comparison==
After you specify two archive files you can compare them, as shown in the following image:
[[Image:interface24|Compare archives]]
The archive comparison result is shown in the following figure:
[[Image:interface25|archive comparison result]]

87
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/metric-definition-panel.wiki Normal file
View File

@@ -0,0 +1,87 @@
[[Property:title|Metric Definition Panel]]
[[Property:weight|2]]
[[Property:uuid|5a778f15-cefe-182d-a296-545ee77d3028]]
In the metric definition panel, you can do the following:
* Manage user-defined metrics, such as defining new metrics and modify or remove existing ones. Metrics with a small lock in their icons are predefined metrics which cannot be changed or remvoed
* Import metrics from other systems
* Backup user-defined metrics
The following figure shows the layout of the metric definition panel:
[[Image:interface6|Metric definition panel]]
Let's have a look at the buttons in the main toolbar which is highlighted in the following figure:
[[Image:interface7|Main toolbar buttons]]
[[Image:metrics-tool--new-metric-icon|New metric]] New metric
Use this button to create a new metric. First you need to select a metric type (basic, linear or ratio) and then you may need to select a unit (only for basic and linear metrics). Once a metric is created, its unit cannot be changed.
[[Image:metrics-tool--new-document-icon|Clone metric]] Clone selected metric to a new metric
If you want to define a new metric but the new metric is quite similar to an existing one, then you can use this button to simplify your work: just clone an existing one and do the modifications.
[[Image:metrics-tool--general-remove-icon|Remove metric]] Remove metric
Remove current selected metric. This button will be insensitive when the current selected metric is a predefined metric.
[[Image:metrics-tool--general-save-icon|Save metric]] Save metric
To make your newly defined or modified metric take effect, you need to save it first. This button will be insensitive when the current selected metric is a predefined metric.
[[Image:metrics-tool--command-send-to-external-editor-icon|External editor]] Open user-defined metric file in external editor
Metrics are stored in XML format, and this button opens the XML file of user-defined metrics in a an external editor which can be specified in the preferences.
[[Image:metrics-tool--general-open-icon|Reload metrics]] Reload metrics
This button reloads all metrics including predefined and user-defined metrics. It's useful when you modify the metric XML file in an external editor and want the changes to have an effect without restarting EiffelStudio.
[[Image:metrics-tool--metric-export-to-file-icon|import]] Import metrics
This button opens a dialog to backup or import metrics.
==Define New Metrics==
To define a new metric, you need to choose the metric type and unit (for basic metric and linear metric). The following figure shows how to choose metric type and unit:
[[Image:interface8|Choose metric type]]
The following figure shows a new basic class metric:
[[Image:interface9|basic metric]]
When defining basic metrics, you can press <code>CTRL</code>+<code>Space</code> in a cell in the criterion column (the first column in "definition" area) to get a list of all applicable criteria. You can also type "and" or "or" in that cell to get criterion connectors. And you can put "not" in front of a criterion name to get its negation. After typing the criterion name and hitting enter, if the criterion needs further setup, the property cell of that criterion will be highlighted. For domain criterion such as ancestor_is, caller_is, you can pick an item and drop it into this property cell.
The following figure shows a new linear feature metric:
[[Image:interface10|linear metric]]
For every metric referenced in a linear metric, you need to specify a coefficient. You can pick a metric and drop it into a cell of the "Metrics" column in the "Metric Definition" area.
The following figure shows a new ratio metric:
[[Image:interface11|ratio metric]]
For the numerator or denominator metric, you need to specify a coefficient. When the denominator part evaluates to zero, the result of the ratio metric will be "Undefined". You can pick a metric and drop it into the numerator or denominator metric area.
==Import Metrics==
In order to reuse metrics defined in a different system, you need to import them into current system. The following figure shows how to import metrics:
[[Image:interface12|Import metrics]]
==Backup User-defined Metrics==
The following figure shows how to back user-defined metrics:
[[Image:interface13|Backup metrics]]

39
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/metric-evaluation-panel.wiki Normal file
View File

@@ -0,0 +1,39 @@
[[Property:title|Metric Evaluation Panel]]
[[Property:weight|0]]
[[Property:uuid|c31fddbb-7421-fe4b-57d3-7eea32f5e9e0]]
The Metric Evaluation panel is the place to do metric evaluation. After selecting a metric from the "Select metric" area and setting an input domain in the "Setup input domain" area, you can click the run button to start metric evaluation. You can start metric evaluation with and empty input domain and the result will be always zero.
[[Image:interface1|Defining an input domain]]
Let's first have a look at the buttons in the main toolbar, see the following figure in which the main toolbar is highlighted:
[[Image:interface2|Defining an input domain]]
[[Image:metrics-tool--debug-run-icon|Defining an input domain]] Start metric evaluation <br/>
Press this button to start evaluating the currently selected metric.
[[Image:metrics-tool--debug-stop-icon|Defining an input domain]] Stop metric<br/>
Press this button to terminate a running metric evaluation.
[[Image:metrics-tool--metric-send-to-archive-icon|Defining an input domain]] Send last result to metric history<br/>
After a metric evaluation this button will be sensitive and clicking it will record the evaluated metric as well as its input domain and result in the metric history. This facilitates evaluating it again and lets you compare different metric runs.
[[Image:metrics-tool--metric-run-and-show-details-icon|Defining an input domain]] Keep detailed result when evaluating metric<br/>
Normally, evaluating a metric will give you a number as result, but sometimes, you want to investigate into those items which make up that value. For example, evaluating '''Classes''' metric over the base library gives you 242, which means there are 242 classes in the base library, and sometimes, you want to know which they are. With this option enabled, you'll have a detailed result listed in the detailed result panel after a metric evaluation. This option only has effect when evaluating basic metrics, because the detailed result has no meaning for derived metrics (linear or ratio metrics) in general. Suppose you have a linear metric defined as 5 * Classes, then the notion of detailed result has no meaning. Another use of this option is for performance: keeping a detailed result can be quite expensive in some cases, such as when you calculate the metric '''Lines of code''' for a large system, which may result in hundred of thousands of lines in the result. So turning it off in such as case may be a good idea.
[[Image:metrics-tool--metric-filter-icon|Defining an input domain]] Filter result which is not visible from input domain<br/>
If this option is enabled, all non visible items from the input domain will be filtered. For definition of "non visible" items, please see documentation for criterion is_visible.
[[Image:metrics-tool--context-sync-icon|Defining an input domain]] Automatically go to result panel after metric evaluation<br/>
If this option is enabled, the metric tool will switch to the detailed result panel after a metric evaluation.
[[Image:metrics-tool--metric-quick-icon|Defining an input domain]] Define quick metric<br/>
Sometimes, you want to calculate some metrics which are not defined already. For example, find a feature which is named "foo". And it may be just a one time thing, so there is no need to go to metric definition panel, define and save a metric and then go back to evaluation panel and run it. Quick metric is designed for this situation, you can defined any basic metric in the quick metric definition area. It's the same as the basic metric definition area in the metric definition panel. Just define your metric and run it.
In the following figure, a defined quick metric is shown:
[[Image:interface3|Defining an input domain]]

80
documentation/19.05/eiffelstudio/eiffelstudio-reference/metrics-tool/user-interface-basics/metric-history-panel.wiki Normal file
View File

@@ -0,0 +1,80 @@
[[Property:title|Metric History Panel]]
[[Property:weight|3]]
[[Property:uuid|373d7403-eb3a-3c05-787e-b4a8cb5848cb]]
The metric history panel lists all recorded metric evaluations. You can select them and reevaluate them to see the new value and if it differs from the old result.
Lets have a look at the buttons in the main toolbar highlighted in the following figure:
[[Image:interface14|Metric history panel]]
[[Image:metrics-tool--debug-run-icon|Run history]] Recalculate history<br/>Recalculate selected metric history items
[[Image:metrics-tool--debug-stop-icon|Stop history]] Stop history recalculation<br/>Stop running metric history recalculation.
[[Image:metrics-tool--metric-run-and-show-details-icon|Keep detailed result]] Keep detailed metric result<br/>
If this option is enabled, the detailed metric result will be kept and will be available after a metric history recalculation.
[[Image:metrics-tool--metric-unit-assertion-icon|Check warning]] Check metric history warnings<br/>If this option is enabled, specified metric history warnings will be checked.
[[Image:metrics-tool--general-reset-icon|Remove detailed result]] Remove detailed metric result<br/>Remove detailed metric result, if any.
[[Image:metrics-tool--general-remove-icon|Remove history]] Remove metric history item<br/>Remove selected metric history items.
[[Image:metrics-tool--metric-group-icon|Show tree]] Display tree view<br/>If this option is enabled, the metric history items will be displayed in a tree view.
[[Image:interface16|Hide old metrics]] Hide old metric history<br/>Hide metric history items which are calculated before the specified number of days
[[Image:select-all|select all history]] Select All<br/>Select all recorded metric history items.
[[Image:deselect-all|deselect all history]] Deselect All<br/>Deselect all recorded metric history items.
[[Image:select-recalculatable|select all calculatable]] Select all recalculatable history items<br/>Select all recalculatable metric history items. A metric history item is recalculatable if its associated metric is valid and its specified input domain is valid.
[[Image:deselect-recalculatable|deselect all calculatable]] Deselect all recalculatable history items<br/>Deselect all recalculatable metric history items.
==Recalculate Metric History==
To recalculate a metric history, you need to selected those items that you want to recalculate. In the following figure, a metric history item '''Uncommented features''' is selected.
[[Image:interface17|Select metric history]]
After recalculating the selected metric history items, the result will be highlighted, as shown in the following figure:
[[Image:interface18|History recalculationg result]]
In the above figure, the row '''Uncommented features''' is highlighted indicating that this item has been recalculated. And from the row, we can see that the current value is 1 while the previous value is 0, meaning that there is one uncommented feature in cluster sample now while there was no uncommented feature in cluster sample when this metric was calculated the last time.
==Metric History Warning Checking==
Another thing you can do in metric history is to assign a warning tester to each item. When the metric history is recalculated with metric history warning checking enabled, the warning tester will be evaluated against the metric value to see if it's condition is satisfied.
Let's use an example to demonstrate the idea. Suppose we have set up a metric history warning shown in the following two figures:
[[Image:interface20|warning tester]]
[[Image:interface19|warning tester]]
This warning means, when the metric '''Uncommented features''' is calculated over the input domain {sample}, the value should be zero, otherwise a warning should be emitted.
After recalculating the metric history item, we get the following result:
[[Image:interface21|warning tester]]
From the above result, we can see that the value of the metric '''Uncommented features''' over the input domain {sample} is 1 while our warning says it should be 0. So we get a warning message.