<commit_before>:numbered:

[[Evaluate]]
== Evaluate

image::evaluate.jpg["evaluate-phase", title="Evaluate-Phase"]

=== Goals

Make the issues, problems and risks found during the <<Analyze, analysis>>
comparable by estimating or measuring their *value*
(that's why we call this activity *evaluate*):

. estimate _value_ of problems, issues, risks and their remedies
. prioritize issues, their remedies and improvement measures

Usually evaluation implies _estimation_, only in few cases can you measure
or observe the evaluation subject and produce _hard facts_.

=== Estimation

[[figure-evaluation-concepts]]
image::evaluate-domain-conceptmap.png[title="Evaluation Concepts Domain Model"]


[width="80%",cols="3,10"]
.Evaluation Domain Concepts
|===
| Estimation | x
| Subject    | z
| Assumption | y
| Observation | o
| Parameter  | 2
| Interval   | 1
|===


=== Pattern and Practices for Evaluation

// image map - created manually from OmniGraffle Export
++++
<map name="EvaluationPractices">
	<area shape=rect coords="11,174,63,209" href="#Estimate-Feature-Value">
	<area shape=rect coords="219,249,281,283" href="#Impact-Analysis">
	<area shape=rect coords="214,11,270,54" href="#Estimate-Problem-Cost">
	<area shape=rect coords="351,65,426,108" href="#Estimate-Remedy-Cost"><commit_msg>first version of description table for Evaluation Domain Concepts<commit_after>:numbered:

[[Evaluate]]
== Evaluate

image::evaluate.jpg["evaluate-phase", title="Evaluate-Phase"]

=== Goals

Make the issues, problems and risks found during the <<Analyze, analysis>>
comparable by estimating or measuring their *value*
(that's why we call this activity *evaluate*):

. estimate _value_ of problems, issues, risks and their remedies
. prioritize issues, their remedies and improvement measures

Usually evaluation implies _estimation_, only in few cases can you measure
or observe the evaluation subject and produce _hard facts_.

=== Estimation

[[figure-evaluation-concepts]]
image::evaluate-domain-conceptmap.png[title="Evaluation Concepts Domain Model"]


[width="80%",cols="2,8,6a", options="header"]
.Evaluation Domain Concepts
|===
| Domain concept | Explanation | Example
| Estimation | an _approximation_ of any subject
  (here: issues,problems or remedies), which is needed because
	facts or real observations are not available or possible.
	|

| Subject    |  | a recurring problem in the <<SuD>> or
associated processes

| Parameter  | an important element or foundation of the
estimation.
  |
		* number of developers on the system
	  * Lines-of-Code (LOC)

| Assumption | a fixed setting for any parameter.
  See <<Explicit-Assumption>>  
  |

| Observation | measure, count, calculate gather real data
for parameters  | if every developer is
concerned by the problem, we count their number.

| Interval   | see <<Estimate-In-Interval>> | between 15 and 25%

|===


=== Pattern and Practices for Evaluation

// image map - created manually from OmniGraffle Export
++++
<map name="EvaluationPractices">
	<area shape=rect coords="11,174,63,209" href="#Estimate-Feature-Value">
	<area shape=rect coords="219,249,281,283" href="#Impact-Analysis">
	<area shape=rect coords="214,11,270,54" href="#Estimate-Problem-Cost">
	<area shape=rect coords="351,65,426,108" href="#Estimate-Remedy-Cost">
{'fraction_non_alphanumeric': 0.11964773762526572, 'fraction_numerical': 0.03097479501973884, 'mean_word_length': 5.509881422924901, 'pattern_counts': {'":': 0, '<': 23, '<?xml version=': 0, '>': 23, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6792310', 'n_tokens_mistral': 1080, 'n_tokens_neox': 938, 'n_words': 325}