4 In Eficas, many common commands can be invoked via menus, toolbar buttons as well as keyboard shortcuts.
5 As in many GUI, a menu widget can be either a pull-down menu or a standalone context menu. Pull-down menus are shown by the menu bar when the user clicks on the respective item or presses the specified shortcut key. Context menus are usually invoked by some special keyboard key or by right-clicking.
6 Eficas allows you to write (and reread) an unvalid file. At any time, user can save its works.
11 So try to build a new JDC.
13 Eficas will ask you to choose the code you want to work with, each time you click on "Nouveau" or "Open" in the "fichier" Menu, unless you have started Eficas for a specific code ( see how to launch Eficas in Salome)
15 .. image:: images/choix_code.png
18 Choose a version of the Code
19 ----------------------------
21 .. image:: images/choix_cata.png
25 -------------------------
27 Eficas main widget provided two distinct views: The left size always contains the JDC explorer as a tree view. The right widget contains all informations used by the user to constructs the JDC. It shows which commands are available and which :ref:`rules-label` have to be followed. Commands are append after this selected in the JDC tree.
29 .. image:: images/command.png
33 The user can use "Filtre", which is a filter widget to find a command position. The PushButton "suivant" shows the next matching command.
39 The user also can choose the way the commands are sorted, either by alphabetical order, either by fonctionnalities.
41 .. image:: images/groupes.png
44 Choosing command's keywords
45 ---------------------------------
47 For each command, EFICAS shows which keywords are available.
49 .. image:: images/motClef.png
53 These keywords depend from the context, ie the value of one other
56 .. image:: images/motClef2.png
62 .. image:: images/motClef3.png
65 types of item in the JDC (Jeu De Commande)
66 -------------------------------------------
68 In JDC, you can have :
70 * PROC : this is a command with all its keywords.
74 - for ASTER, it initializes memory and files.
76 * OPER : creates an object which has a type and a name
79 - MONMAIL=LIRE_MAILLAGE(UNITE=20);
80 - This line creates a new concept MONMAIL of type "maillage", which can be re-used
82 When an oper is valid, the user have to named it.
84 .. image:: images/nommerConcept.png
91 This is a list of keywords which jointly have a meaning for the code.
92 Some are mandatory, repeatable .
93 This list can depend on conditionnal rules.
98 this is a simple keyword. it also can be mandatory or not...
101 These items are associated according to rules or conditions. These items are
102 described in the catalog.
105 Attributes of a keyword
106 ---------------------------
108 a parameter ("mot-clef simple") should have :
110 - a type : Real, string, complex, integer or a python class which is defined in the catalog. As we have already seen, LIRE_MAILLAGE produced a "maillage" concept and MODELE in AFFE_MODELE oper waits for a concept of type "maillage". Eficas will propose all the valid concepts of type "maillage".
112 .. image:: images/Affe.png
116 - a File parameter should be :
118 - an existing file (type='Fichier'),
119 - a directory (type='Repertoire'),
121 - an existing file with specific suffix (type='Fichier','JDC Files (*.comm);;All Files (*)') The contents of the directory are filtered before being shown in the dialog, using a semicolon-separated list of filters specified.
123 - a non-allready existant (type=('Fichier',"",'Sauvegarde'),
125 - a simple string (type='FichierNoAbs').
127 This is the way the catalog should look like :
129 input_datafile=SIMP(typ='Fichier',fr='',ang='',statut='o',docu='',min=1,max=1,defaut=None),
131 input_commfile=SIMP(typ=('Fichier','JDC Files (*.comm);;''All Files (*)'),fr='',ang='',statut='o',docu='',min=1,max=1,defaut=None),
133 output_datafile=SIMP(typ=('Fichier','JDC Files (*.comm);;''All Files (*)','Sauvegarde'),fr='',ang='',statut='o',docu='',min=1,max=1,defaut=None),
135 datafile=SIMP(typ='FichierNoAbs',fr='',ang='',statut='o',docu='',min=1,max=1,defaut=None),
137 repetoire=SIMP(typ='Repertoire',fr='',ang='',statut='o',docu='',min=1,max=1,defaut=None),
141 - a default value (or not)
145 - a short documentation
147 - an interval of values or a set of discrete values
150 Input data panel depends on both these attributes. It forces the user to enter a list if needed, it verifies the input type...
152 - Example of input Data Pannel for complex valuesNew
154 .. image:: images/complex.png
161 a very simple colors chart helps the user to know if a item is valid or not :
163 * In the JDC tree view
165 - green square : valid objects (JDC, Oper ...)
166 - red square : unvalid objects
167 - yellow square : valids OPER the user must name
168 - green circle : valid keywords
169 - red circle : unvalid keywords
170 - green rhomb : condition. all the depending keywords are valid
171 - yellow rhomb : condition. one of the depending keywords is unvalid
175 - red is for unobserved rules
176 - black is for observed rules
181 In the JDC tree, Context menus (invoked by right-clicking) allow user to :
183 - create comments in the tree
184 - comment the command itself
188 .. image:: images/menus.png
195 The Users can define parameters. As parameters, Eficas accepts :
202 A parameter's definition can use existing parameters such as :
203 eps=sqrt((((W / NX) ** 2) + ((H / NY) ** 2)))
205 Pushing on "Parametres" Pushbutton opens a dialog containing all correct parameters (depending of the attended value's type)
207 .. image:: images/parametres.png
211 To select the value in the modal dialog widget, highligh the corresponding line and Push on "Valider".
215 Import data from file
216 -----------------------
218 The user also can import data from a ASCII text file by pushing button "Importer". He chooses to import part of or the complete file.
220 .. image:: images/import.png
225 ---------------------
228 - Rapport de Validation (Jdc Menu) : It resumes JDC errors
229 - Fichier Source (JdC Menu) : It shows the text of the initial JDC (in the .comm file).
230 - Fichier Resultat (JdC Menu) : It shows the text which will be stored at next
232 .. image:: images/rapport.png
237 ---------------------
239 EFICAS allows you to open
240 simultaneously files with differents catalogs : for example a file with Openturns Study catalog and a file for Openturns wrapper. The user also can easely swap from one file to another by clicking on its tab.
244 .. image:: images/multiples.png
248 If the user want to open the same file in two tabs, Eficas allows it, but corrections in one tabs are not reported in the other.
250 .. image:: images/duplication.png