From 2b09b52dea6cbb333e871493a97778196bbc338a Mon Sep 17 00:00:00 2001
From: rakhimov <ol.rakhimov@gmail.com>
Date: Sat, 10 Dec 2016 23:20:08 -0800
Subject: [PATCH 1/2] Add specification for importance factor reporting

The commonly calculated importance factors (DIF, MIF, ...)
can be reported in attributes of variables (basic events).
The approach has been tested with SCRAM
and is flexible for new factors or omitted factors.

Note that importance factor reporting is missing for CCF events
because the general representation of them
is not yet accepted into the report layer.
It should be trivial to add CCF event importance factor reporting
(if not cumbersome, though)
after the initial formatting is established.
---
 mef/report_layer.rst              | 21 +++++++++++++++++++++
 mef/schema/importance_factors.rnc | 17 +++++++++++++++++
 spelling_wordlist.txt             |  3 +++
 3 files changed, 41 insertions(+)
 create mode 100644 mef/schema/importance_factors.rnc

diff --git a/mef/report_layer.rst b/mef/report_layer.rst
index 01e9a11..5057bee 100644
--- a/mef/report_layer.rst
+++ b/mef/report_layer.rst
@@ -87,6 +87,7 @@ The following three categories are so frequent
 that is it worth to normalize the way they are stored into XML files.
 
 - Minimal cut sets (and prime implicants)
+- Importance factors
 - Statistical measures (with moments)
 - Curves
 
@@ -108,6 +109,26 @@ to carry the relevant information.
     :caption: The RNC schema for the XML representation of sums-of-products
     :language: rnc
 
+Importance factors
+------------------
+
+Importance factors are typically computed for basic events
+with the same configurations as for probability analysis.
+The following importance factors are long-established and commonly calculated:
+
+    - Fussel-Vesely Diagnosis Importance Factor (DIF)
+    - Birnbaum Marginal Importance Factor (MIF)
+    - Critical Importance Factor (CIF)
+    - Risk Reduction Worth (RRW)
+    - Risk Achievement Worth (RAW)
+
+The definitions of these factors can be found in PSA/PRA literature.
+
+.. literalinclude:: schema/importance_factors.rnc
+    :name: schema_importance_factors
+    :caption: The RNC schema for the XML representation of importance factors
+    :language: rnc
+
 Statistical measures
 --------------------
 
diff --git a/mef/schema/importance_factors.rnc b/mef/schema/importance_factors.rnc
new file mode 100644
index 0000000..4264b15
--- /dev/null
+++ b/mef/schema/importance_factors.rnc
@@ -0,0 +1,17 @@
+importance =
+  element importance {
+    name?,
+    attribute description { text }?,
+    attribute basic-events { xsd:nonNegativeInteger }?,
+    importance-event*
+  }
+
+importance-event =
+  element basic-event {
+    name,
+    attribute DIF { xsd:double }?,
+    attribute MIF { xsd:double }?,
+    attribute CIF { xsd:double }?,
+    attribute RRW { xsd:double }?,
+    attribute RAW { xsd:double }?,
+  }
diff --git a/spelling_wordlist.txt b/spelling_wordlist.txt
index 26c9327..1a31286 100644
--- a/spelling_wordlist.txt
+++ b/spelling_wordlist.txt
@@ -1,12 +1,15 @@
 Ai
+Birnbaum
 CCF
 Fi
+Fussel
 LAnguage
 Napierian
 PSA
 REgular
 Ri
 Schematron
+Vesely
 datatype
 datatypes
 formulae

From 32c66697b0809f0cb04c01b358cf73df046debfd Mon Sep 17 00:00:00 2001
From: rakhimov <ol.rakhimov@gmail.com>
Date: Mon, 13 Feb 2017 09:41:55 -0800
Subject: [PATCH 2/2] Add "probability" & "occurrence" in importance report

The idea is borrowed from XFTA.
---
 mef/report_layer.rst              | 5 +++++
 mef/schema/importance_factors.rnc | 2 ++
 2 files changed, 7 insertions(+)

diff --git a/mef/report_layer.rst b/mef/report_layer.rst
index 5057bee..989e2ce 100644
--- a/mef/report_layer.rst
+++ b/mef/report_layer.rst
@@ -124,6 +124,11 @@ The following importance factors are long-established and commonly calculated:
 
 The definitions of these factors can be found in PSA/PRA literature.
 
+In addition to the importance factors,
+this report section may contain
+the evaluated probability of an event and
+the number of products it occurs in.
+
 .. literalinclude:: schema/importance_factors.rnc
     :name: schema_importance_factors
     :caption: The RNC schema for the XML representation of importance factors
diff --git a/mef/schema/importance_factors.rnc b/mef/schema/importance_factors.rnc
index 4264b15..7a21bee 100644
--- a/mef/schema/importance_factors.rnc
+++ b/mef/schema/importance_factors.rnc
@@ -9,6 +9,8 @@ importance =
 importance-event =
   element basic-event {
     name,
+    attribute occurrence { xsd:nonNegativeInteger }?,
+    attribute probability { xsd:double }?,
     attribute DIF { xsd:double }?,
     attribute MIF { xsd:double }?,
     attribute CIF { xsd:double }?,