Tutorial 6 Evaluation and reporting | Learning goals
|
In this tutorial we will evaluate the systematic variations of the design using a weighted average of all parameters describing the compatibility of the ships. Then we'll sort the designs in order of compatibility and finally a report is created in MS Word for each design.
To start this tutorial, a knowledgebase is available [Tutorial 6 start.qkb]. This knowledgebase contains the results of tutorial 5 and is the basis for this tutorial.
Also a Word template file (Report.rtf) has been provided. Make sure you save this file in the Applic directory of your knowledge base so it can be found during calculation.
Create a new object Ship_evaluation. Add this to the list of the present Data object in Dataset (you can either leave the existing Shipsobject or delete is). Make sure that the Determined by property of Ship_evalation is OBJ, otherwise you will discover later on that the data inside the object is not taken to the solution.
1. Add the following parameters to the knowledge base:
This is the starting point of our evaluation.
Create the following evaluation relations:
Add the evaluation parameters as goals to the Ship_evaluation object using a relation:
Sort the ships, based on their grade
To check whether all this works, carry out a calculation. Start the process manager. Select Data and select Sorted_evaluation#. The content of Sorted_evaluation# will be:
Open the file (Report.rtf) in MS Word to take a look at it. All kind of parameters between # are visible. Moreover, a Boolean expression is used in: #GM<0.4[1]#INSUFFICIENT[1]: When GM is smaller then 0.4, the text INSUFFICIENT is shown. More information on the possibilities with templates is given in the description of the function TEMPLATE$() in the wiki.
This template should always first be checked on strange RTF code. Use the menu item Tools>RTF Template Check... You will be asked to select a file and the Template delimiter (usually #, as in our file). Then Quaestor will check, rovide a log file and store the original and changed template. The log is as follows:
Do this once or twice until you only see sensible template code in the log.
We will end this tutorial creating a report of each ship. Add the folowing relation to create the report:
The WINWORD$() function will create Word files named Report*.doc in your report directory and returns the name of this file to Report$. In multiple case situations a number (*) is added to the name of the document.
So make sure the reports are created, modify Evalution# and add Report$:
Make sure Report.rtf can be found.
To generated the total solution, select Data in the dataset and run Evaluation# as top goal. A report is generated for each ship and added to each case. If parameters are requested during the calculation, check the following:
You can open a document by double-clicking it in the object:
One of the Word reports:
These six tutorials showed both the way to create a knowledge base and some basic elements about working with ranges, objects, data and external processes, in general used in classical knowledge based applications and Scenario base applications.
Please note that it is possible to create the same functionality in many different ways. So feel free to experiment. For instance, it is possible to make the ship design variations (B, Lpp, etc.) part of the calculation process enabling a user to vary the design space he or she wants to investigate. Moreover, we did not discuss the SCENARIO$() function to create a scenario of input and output actions or all kind of other intrinsic functions.
Moreover, we have not discussed any specific knowledge engineering related to Taxonomy based applications. For the latter we will introduce a new set of tutorials.
For more inside information you can use the following KE resources on Quaestor:
Also take a look at examples, these are always very helpful to solve a particular problem. [Example applications]
You can verify your results by comparing it to [Tutorial 6 finish]