Definition #

Questions contained in a knowledge base are defined in a so-called question tree. Thereby it is essential to always define all the questions, follow up questions, and abstraction questions the system should know.
A question tree describes not only the questions to be used, but rather their (hierarchical) ordering within questionnaires as well as potential follow up questions.

Syntax#

Basics#

A question tree is generally defined with the 'Question' tag. To define questionnaires to further categorize and order the questions, this section is divided into separate sections, whereas the sections are set off against each other by blank lines. At the beginning of each section then the name of the questionnaire is placed in the first line. Subsequently the structure of the questions is defined. Thereby the number of hyphens at the beginning of each line corresponds with the hierarchic depth of the questions.

%%Question
Quest A
- question1 [oc]
-- answer1
-- answer2 

Quest B ...
%
The previous listing demonstrates the basic syntax of a question tree. There, 2 questionnaires (Quest A and Quest B) are defined; Quest A contains one question which in turn provides 2 answer possibilities.

Supported Question Types #

The type of a question is defined in square brackets next to the question name. Currently, the following question types are supported:

Symbol Type
[text] textual question
[oc] one-choice question: exactly one answer from a given answer range is to be chosen by the user. Every answer alternative of such a question has to be defined in a separate line subsequent to the question (indented by a further hyphen, see example).
[mc] multiple-choice question: here, the user can chose more than one answer from the given answer alternatives. Definition: see one-choice question.
[num] numerical question: the numerical answer value is entered by the user. For numerical questions it is possible to additionally define the unit (in curly braces) and the range of values (in parentheses) - see example below.
[yn] yes/no question: special case of a one-choice question with given answers yes and no
<abstract> abstraction question: an abstraction question (similar to abstraction rules) is not displayed within a dialog for the user to answer it; rather its answer value is derived from previously provided answers. It is essential that the abstraction flag is the last declaration in a line.

Question Types: Example

%%Question 
- one choice question1 [oc] 
-- answer1 
-- answer2 
- yes no question [yn]
-- yes
-- no
- multiple choice question 2 [mc]
-- answer 3
-- answer 4
- numerical question 3 [num] {numQuestion_unit} (lowerBound upperBound)
- numerical question 4 [num] {numQuestion_unit} (lowerBound upperBound) <abstract>
- textual question 5 [text]
%

Indication mechanisms#

Indication of follow up questions and -questionnaires
Follow up questions or follow up questionnaires---that is questions/questionnaires that are to be presented depending on a certain answer of a different question---can also be defined in the question tree. Therefore, the name of the follow-up question is simply written in the line right after the answer (hierarchically one level deeper than the answer, indicated through an additional hyphen).

- Year of construction? [num]
-- >= 1995
--- Does your car have ABS?  [yn]
-- < 1995

In the example the follow up question Does your car have ABS? is only presented to the user, if the previous question Year of construction? was answered with a value >= 1995.

The indication of questionnaires is analog, only instead of a question name, a questionnaire name is written in the line following the answer.


Indication caused by established solutions

The indication of questionnaires can also be initiated by derived diagnoses. Therefore, the particular questionnaire (or also more than one) has to be defined in the line following a diagnosis derivation.

- Does your car make trouble? [yn]
-- yes
--- Problem (P7)
---- Air intake system
---- Ignition timing
---- Air filter
---- Battery
--- no
---- perfect(P7)

The previous example shows the indication of the questionnaires Air intake system, Ignition timing, Air filter and Battery, which is caused by the derivation of the superordinate diagnosis Problem.


Repeated indication

If a question is to be indicated multiple times, it still has to be defined (with type and answer alternatives) only once, the first time it is used. At a later point, the keyword &REF can be used in order to reference to the question without having to define it again. If the original definition of the question contains follow up questions, those are also included when the referencing question is used later on.

questionnaire1
- question1 [oc]
-- answer0
--- question2 [oc]
---- answer3
---- answer4
-- answer1
-- answer2
--- &REF question2
...

The example shows, that question 2 is completely defined the first time needed---after answer 0---and then is referenced later on as a follow up question for answer2.

Derivation mechanisms#

Derivation of solutions

Through the use of solution derivation within the question tree it becomes a decision tree, as now decisions (that is, solutions) are derived. The solution that is to be derived simply has to be defined (along with the score points that it is to be assigned) in the line succeeding the corresponding answer. An overview of possible score points is presented on the page Doc DiagnosisRule.

- Exhaust pipe color evaluation [oc]
-- abnormal
--- Clogged air filter (P5)
-- normal
--- Engine noises [oc]
...

The previous listing shows the derivation of the diagnosis Clogged air filter with the score points P5, if the question Exhaust pipe color evaluation was answered with abnormal.


Derivation of criterion abstractions

Similar to diagnoses, also numerical criterion abstractions (symptom-interpretations) can be evaluated numerically. Here, a value can be set to the present value.

questionnaire
- SymptomInterpretation1 [num] <abstract>
- question1 [oc]
-- answer1
--- SymptomInterpretation1 (-5)
-- answer2  

In the example, the given value -5 is assigned to the question SymptomInterpretation1.

Definition of Initial Questionnaires#

With respect to the user dialog, questionnaires are not indicated by default. The markup allows for the definition of so-called init questionnaires, i.e., questionnaires that are presented at the beginning of every problem-solving session. The order of the init questionnaires is defined by a hash sign

#
following by a number indicating the order of the respective questionnaire. With the following markup, the initial questionnaires '(questionnaire1, questionnaire3, questionnaire2)' are defined:

%%Question
questionnaire1 #1
- Question 1 [num]
- Question 2 [num]

questionnaire2 #3
- Question 5 [num]
- Question 6 [num]

questionnaire3 #2
- Question 3 [num]
- Question 4 [num]
%