elsA PyGelsA Graphical User Interface User's Manual (User's Manual)
Contents
1. boundary object bnd1 created E Python console gt gt gt cfdi cfdpb name cfd1 gt gt gt bndi set block name blk1 gt R f ELSA MU 02044 el SA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 15 37 3 4 Instance creation When a new object name has been typed in the adequate entry field and validated see above and required arguments filled in a mouse click on the Create button completes the creation of a new object which is the value of a Python variable with this object s name At this time the Create button is deactivated the ElsaDefs clear buttons for various meth ods to be called on the object are activated and the by sub class tabnotebook widget for attributes is created and filled with current values using any defined class defaults see MU 98057 EN PyGelsA d File View Defaults Help Choose object class cfdpb Operations for cfdpb class mesg plane A m block inesh Create ElsaDefs clear view show attach sl 3 Li Define attributes for plane object window state boundary Main numerics attachments init global model global numerics extract function axi_dir axi_rot_theta config mask None 0 1 3d a globborder nb_error_max 100 Operations for Main sub object of plane object UserDefs Check Clear RE2. t Python console gt gt gt plane cfdpb name plane R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 16 37 User s Manual Empty page R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 17 1137 4 MANAGING DESCRIPTION ATTRIBUTE VALUES 4 1 Plain atomic attributes Modification and display of attribute values is done through the associated widgets whose type entry field pop down list see appendix II is automatically adapted to the type and value range of the attribute Each attribute widget has its tool tip help pop up which appears when the mouse pointer stays a bit long over it the pop up string is the description string from the EpAttrDefs py resource file Remark In the case of the entry widget the sensitive region for tool tip action is the entry widget itself and not the label displaying the attribute name over it 4 2 Value checking Value checking is performed at two levels by the attribute domain of definition from EpAttrDefs py inthe context of other attributes when possible from EpDepends py 4 3 Macro attributes Individual widgets for atoms of a macro attribute or variants of a variable length macro attribute are gathered in a frame labelled with the macro attribute
3. AlS eb SA TE gt nm gt D Im d Bookmarks N Thumbnails D Introduction PyGelsA interface summary Creating a description class instance Managing attribute values Dependencies management File based operations Python console usage Appendix PyGelsA installation and required ndex TYPICAL DOCUMENT DISTRIBUTION vovv vv J L3 CO E32 The Acrobat plugin for thi Hyperlinks active text elements are highlighted by a red border and the change of appearance from open hand or looking glass to pointed index finger of the mouse pointer The Acrobat Reader viewer as any Web browser allows to move backwards and forward through the already traversed hyperlinks using the right mouse contextual menu String search is accessible through the field glasses icon on the tool panel this requires an extended version of the Acrobat Reader viewer which may not be available on all platforms Browsing this manual online i e screen viewing is especially recommended as many colour illustrations are easier to read this way Remark The Acrobat plug in for the Netscape browser may also be used but is not recommended R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 7 37 2 PYGELSA INTERFACE SUMMARY 2 1 PyGelsA aim and focus The
4. 12 Environment variables The usual SELSAHOME Dist 1ib py directory towards which the PYTHONPATH environment variable must point to holds the PyGe1sA sub directory of all GUI specific modules Launching this GUI is accomplished with the elsa g command other command line options being also available see MU 98057 or try elsa help Remark Using PyGelsA in an overloaded computer environment computer or network is to be avoided As for any graphical interface any gain in efficiency is obtained through augmented resource usage as needed for a greater quantity of displayed information this gain may be completely annihilated even reversed by a too low or uneven display speed Where elsa is a symbolic link to SELSAHOME Dist lib py EpelsA py R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 32 37 User s Manual Empty page R f ELSA MU 02044 elsA Version Edition 1 0 PyGelsA Graphical User Interface Date 21st May 2002 DSNA User s Manual Page 33 37 APPENDIX II WIDGET TYPES The PyGelsA interface uses a variety of widgets from the gtk toolkit In the following illus trations taken from PyGelsA the non pertinent regions of interest are overlayed by a red semi transparent veil the tabnotebook widget Main SpaceDisc Timelnteg Implicit MultiGria the entry field this is used to input and display str
5. Welcome to the elsA Python interface type D or close to exit elsA gt gt gt nl numerics elsA interface ERROR Coherency error missing required cfdpb instance no cfdpb instance is defined or missing name argument one is required before you can create a numerics instance gt gt gt Press Return to continue lt lt lt In GUI mode a message explaining the situation is displayed in a pop up window and the interface is locked until its OK button is pressed XPyGelsA Warning ex No cfdpb object created yet One is needed before creation of any numerics object You have been automatically placed in the context for creation of the required cfdpb object After that you may resume creation of the initially desired numerics object Ok 3 2 Instance name specification File View Defaults File View Defaults Choose object class Choose object class cfdpb Operations for cfdpb class cfdpb Operations for cfdpb class model pad 1 model blo Click the arrow at right to lookup existing block meg object names ar mesh z E 5 wind Type a new name to create a new one window stal then press the Create button state bounqHint click the window to type in it press boundary E Return to confirm the typed or selected ee name init init avtract avtra
6. 3And maybe even on Win32 platforms as a standalone script editor using the Python stubs defined in EpIntStubs py to mimic the elsA kernel on the hypothesis that the original software archives are stored in HOME incoming unpacked in SHOME install and final installation made in HOME 10cal prefix parameter of the configure script Variable names might be different on some platforms R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 30 37 User s Manual 4 On some platforms it may be necessary to install the GNU version of the make utility to be able to generate the gtkmodule_defs c or gtkmodule impl c files as part of the pygtk compilation process 5 The gcc compiler and associated linkage utilities on the GNU Linux platform require the Xlinker export dynamic options 6 The gtk and pygtk libraries and Python modules will be installed in the site packages directory of the Python interpreter found during the installation This must be the same as during creation of the elsA x executable if this is not the case the PYTHONPATH and LD_LIBRARY_PATH environment variables will have to be defined with prefix lib python version site packages in front for each PyGelsA execution 7 For those platforms which support different executable formats ex 32 64 bits on SGI IRIX it may be necessary to implement sub directories for each of them ex lt p
7. PyGelsA GUI aims to provide better comfort and security for the man machine elsA inter face while preserving the efficiency of the plain text mode It has been built as a graphical wrapper for the Python e sA plain text mode most functionality of which is encapsulated in graphical metaphors buttons pop down menus click able lists It is focused on compressing the learning timescale for new users or for seasoned users who need to master new features of the e SA software The main conceptual difference relative to the pure text based e1 sa interface is in this light not in the new possibilities in user data entry through pop down lists although they are most useful but in the greater information content of the graphical software feedback The larger volume of information which can be simultaneously presented to the user allows for a priori checking see as opposed to user requested a posteriori checking see 5 3 2 2 PyGelsA structure PyGelsA s main outline is an upper part with the usual elements of a graphical interface alower part with the Python console for Python e sA commands All interface elements are interconnected meaning that graphical commands show up in text mode in the console and text mode commands are reflected in GUI changes The widget word will be used hereafter for all the graphical elements participating in human computer interaction HCI buttons selectors labels text
8. contained in the single Main tab of the secondary horizontal tabnotebook widget For the numerics class only case in the current version several tabs are displayed for sub classes which were not documented for the text mode interface Main SpaceDisc TimeInteg Implicit MultiGrid These sub classes and the associated tabs are meant to provide faster searches for the location of specific attribute widgets 2 2 6 Python console The lower part of the interface is dedicated to a text console which accepts Python e sA com mands and is fully linked to the pure GUI upper part an SpaceDhe mers strat Ax parare m ter ardscosity jameson 2 rotsen 2 desea a m baee aveost sigma m mobi avere k IEEE ys r gie lo 2 3 Functionalities of the present version The present PyGelsA version is v0 7 available in the He1p About menu R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 12 87 User s Manual This version integrates a beginning of solution for the problems of default values dependency relations between attributes Its main limitations are 1 the group class is not directly available in graphical mode creation in text mode only group instances appear as instances of their members class 2 execution is always interactive no detach mode The
9. second limitation may be circumvented by re using in bat ch mode the user 10g epy trace file generated by the interactive PyGelsA session In this case PyGelsA is used as an offline script editor and not as a direct control interface for the e1sa application Remark Scripts imported into PyGelsA File Import script file are never automatically executed in this case description objects are created and filled but calls to executive methods submit compute extract are routed to a pending operations stack which may be validated on demand to start the actual computation File Activate pending ops or only visualised File Show pending ops The management of this stack is presently incomplete which may lead to difficulties improper operations order when creating new objects relative to the original script 2 4 GUI representation of newly added interface elements The PyGelsA GUI is self configurating using the EpAttrDefs py for attribute definitions and EpDepends py for dependencies resource files at startup Thus any new elements classes methods attributes added by a developer will naturally appear in PyGelsA if they are correctly declared in EpAttrDefs py and dependency influence rules defined in EpDepends py will be applied The simple rule is if it works in text mode elsa then it works in PyGelsA Remark A current limitation is that EpAttrDefs py or rather the associated engine in EpAttr Dict py d
10. 1 2 3 Functionalities of the present version 11 2 4 GUI representation of newly added interface elements 12 2 5 Fonts colours and widget appearance 12 3 MANAGING DESCRIPTION CLASS INSTANCES 13 3 1 Class selection 4 doux ota oe eee ES RES AS eK EEK ESR EK X3 13 3 2 Instance name specification 13 3 3 Args tab for constructor arguments 14 3 4 Instance creation 34 6 4462 i xx an eae EER We ee 15 4 MANAGING DESCRIPTION ATTRIBUTE VALUES 17 4 1 Plain atomic attributes 17 4 2 Value che cking s os dope ce rez a Oe a e we BE i 17 4 3 Macro attributes 17 44 Special widgets 17 5 DEPENDENCIES MANAGEMENT 19 5 1 Dependency and influence rules 19 5 2 Automatic behaviour 19 5 2 1 A priori checking 19 R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface Page 4 37 User s Manual DER 5 2 2 Automated data definition not implemented 20 5 3 User requested a posteriori checks 21 6 PYTHON CONSOLE USAGE TEXT MODE INSIDE GUD 23 7 FILE BASED OPERATIONS PERSIS
11. Page 25 87 7 FILE BASED OPERATIONS PERSISTENCY The only means of persistent storage available at this time for e sA scripts is file based using script files with Python e sA commands Other means could be useful ex databases see or XML based descriptions as studied in ELSA NI 01061 Persistance des donn es de l interface utilisateur e sA 7 1 Script file import and execution The PyGelsA interface may be used as an editor for existing Python e sA script files or also to launch their execution The Parse script file and Import script file fields in the File menu respectively allow direct execution of the script Parse script plain import i e objects creation and filling without execution Import script Eile View Defaults Import script file Cth Show pending ops Activate pending ops Parse script file CthJ Exit CtHQ mesm ode class ElsaDefs Clear X PyGelsA File View Defaults Choo E Choose script file o Ox data Wksp lazareff v2 0 13 api Test PyGelsA Shots 4 Selection data Wksp lazareff v2 0 13 api Test PyGelsA Shots eu8dom epy OK Cancel R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 26 37 User s Manual Those executive method submit compute extract calls trapped during the script import may be visualised through the File Show
12. TENCY 25 7 1 Scriptfileimportandexecution 25 7 2 Trace and dump files 2 402 eo RR A RC a A Oo Rs 26 APPENDIX I PYGELSA INSTALLATION AND REQUIRED ENVIRONMENT 29 I1 Required libraries 29 L2 Environment variables 31 APPENDIX Il WIDGET TYPES 33 ooo rra ee ere ere A A ae eae eee ae 35 R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 5 37 1 INTRODUCTION The e sA ensemble ogiciel de simulation en A rodynamique Computational Fluid Dynamics software package in its present version is dedicated to numerical simulation of single species viscous compressible flows on three dimensional or two dimensional or axisymmetric block structured grids This User s Manual covers the PyGelsA graphical front end of the e1sa software described in the ELSA MU 98057 document Installation of and required environment variables for execution of PyGelsA are described in appendix It is highly recommended that this Manual be read while playing with the PyGelsA software to get a better feel of its dynamic behaviour Index specific typography Usage of the index p is highly recommended to navigate this manual Please refer to the above mentioned ELSA MU 98057 document for the explanation of the various terms attri
13. al Page 19 37 5 DEPENDENCIES MANAGEMENT The current PyGelsA version as the text mode Python e sA interface through the check method provides a partial implementation of dependencies management At this time the scope of this management is mostly limited to the context of one description object no general inter object dependencies An exception is the dependency of the extract var attribute to the model phymod one 5 1 Dependency and influence rules Relations between attributes are described not by a complete tree graph of all possible scenarii which would be un manageable but by a set of transition rules from one state to another i e when defining a new attribute value describing the relations between neighbours along the tree graph These rules may be inspected in the EpDepends py file The rules may be divided in two sub sets dependency rules which specify when an attribute s widget should be active according to the context of other widgets values influence rules which specify which attributes should be defined when a specific attribute has been given a specific value The first sub set is responsible for grayed out or folded up for macro attributes widgets while the second one governs the appearance of attention symbols alongside the names of attributes whose value is requested Differently put when sitting on the tree graph at the location of an attribute with his her back to already
14. bute Please take note that the same name may refer both to an attribute and an attribute value In this index page numbers are displayed with a specific font infinity 95 96 99 small upright font for attribute values init 6 43 61 81 128 128 142 166 slanted font for other elements functions classes init lift 95 104 methods attributes initial angles 118 120 bold face for definitions initial pitch grid 118 125 initialmodel 31 131 131 131 inititer 29 159 89 89 definition of and reference to type inj1 inj1 89 89 90 90 99 99 100 100 102 100 99 definition of and reference to the in j1 attribute which makes up a total of four combinations ex PDF version of this document The PDF version of this document MU 02044 pdf which can be visualised on most platforms using the Acrobat Reader software may be interactively navigated using four methods l Portable Document Format of Adobe Inc Freely downlowdable http www adobe com R f ELSA MU 02044 Version Edition 1 0 el sA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 6 37 User s Manual CEE 1 the bookmarks pane of the viewer always File Edit Document View Window ES visible 2 the hyperlinked contents table at the be ginning of the document 3 in text hyperlinks 4 the hyperlinked index at the end of the document
15. ct R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 14 37 User s Manual Selection of an instance name manually typed in the entry widget s window or chosen among the existing names in the pop down list is complete only after validation through a Return key press the chosen name is then overstriked in colour and the Create button activated if needed new object name The pop up help string for the name entry field is a reminder of the above procedure 3 3 Args tab for constructor arguments For those classes requiring argument s for instance construction a specific Args tab is created simultaneously with the activation of the Create button this is the only tab which exists before the object itself Until all required arguments in this tab are filled in use of the Create button leads to a warning message in a pop up window listing still required arguments X PyGelsA Choose object class cfdpb Operations for boundary class model bnd1 block PyGelsA Warnin mesh Create Missing required arguments for boundary instance bnd1 n window_name window type Define constr state boundary Args numerics args init block_name window_name type extract E None rj function mask globborder Operations for Args sub object of bnd1 object UserDefs ElsaDefs Check Clear F 6
16. d gtk libraries installation of the pygtk library is required as part of the gnome python package to provide the Python interpreter with a graphical front end The following versions are adequate but will shortly be superseded by new components of the GNOME 2 0 development glib glib 1 2 8 glib 1 2 9 gtk igtk l Z 8 9tk 1 2 9 pygtk gnome python 1 0 53 The GNOME environment is not required for PyGelsA this GUI should run on all Unix systems Remarks 1 A typical installation is made of the following steps cd SHOME install cat SHOME incoming lt package gt lt version gt tar gz gzip cd tar xvf cd lt package gt lt version gt configure prefix HOME local amp amp make amp amp make install 2 If the installation directory is prefix as specified by configur prefix prefix the current shell environment must contain prefix bin as head of PATH prefix lib as head of LD_LIBRARY_PATH or their equivalents before gtk installation so that installation parameters for glib be accessible to configure 3 If GNOME is not installed on the computer the installation must start in the pygtk sub directory of the gnome python source hierarchy the message issued by configure warning that the imlib is missing may be safely ignored freely available on http www gtk org initial authors Peter Mattis Spencer Kimball Josh MacDonald http www gnome org
17. defined values and at their edge last defined attribute on this tree segment a new age Maxwell daemon could reflect during this break on the data filling voyage that he she was able to get there through dependency rules and will probably user permitting go where influence rules call him her This is hyperbolic behaviour provided that hopefully the rules contain no circular references or loops 5 2 Automatic behaviour 5 2 1 A priori checking The following screen shot fragments are an illustration for this functionality in the case of depen dency upon the physical model parameter the model phymod attribute R f ELSA MU 02044 Version Edition 1 0 Date 21st May 2002 elsA PyGelsA Graphical User Interface Page 20 37 User s Manual Define attributes for modnozzle object Define attributes for modnozzle object Main Main 3 3 models models fluid phymod fluid phymod visclaw pg al euler None E pg nslam None E turbmod turbmod None None a phys_props phys_props gamma cv prandtl gamma cy prandti prandtitb prandtitb viscosity j suth_const suth_muref suth_tref RS ioi neg ln n IPIOU AA iod variants j ba michel _ ext turb j ovt turh law avt tirh law mod avt turh law iiraf Those widgets for attributes with no meaning in the current context are put in in active state they appear grayed out frames for in activated mac
18. dump files Just like in the case of the text interface the trace file and optionally the dump file provide a per sistent version of the state of the objects their data values whether created from script graphical interface or console R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 27 87 the trace file automatically created unless otherwise specified is an image of the sequence of all operations since the interface was started the dump file created by a call to the dump function is an instant image of the state of all objects or of some objects if the dump method was used without any history character contrary to the trace file In both cases both the console and GUI s top part mirror the changes in the script file Please refer to the e SA User s Manual MU 98057 for details about the trace and dump files and their differences R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 28 37 User s Manual Empty page R f ELSA MU 02044 elsA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 29 37 APPENDIX I PyGelsA INSTALLATION AND REQUIRED ENVIRONMENT 1 1 Required libraries PyGelsA uses the Python pygtk bindings by James Henstridge of the gtk graphical toolkit On top of the base glib an
19. e CAD description Group creation Direct creation of a group instance ex from the filtered names list see above is not yet implemented In the current version this must be done in text mode using the Python console elsA gt gt gt wnd g group window wnd 2 4 will create a new instance of the group class with window members selecting only those with names defined by the wnd_ 2 4 regular expression That is names beginning with wnd followed by at least one repetition of one of 2 3 4 as specified by the element at the end of the regular expression Possible names if they exist are bnd_4 bnd_32 and bnd_222333444 2 2 4 Object action buttons Under the object name selection entry field a row of buttons with associated scrollbar if needed for many buttons defines the main global actions available for the object R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 11 87 2 2 5 Sub classes tabnotebook widget and widget attributes When displaying an existing object the interface s central part is used for the attribute widgets managing the data in the description object For classes with only a limited number of attributes or when only a small number of them is mean ingful at once these widgets are all
20. e information to be conveyed being only their relative positions and not their content see p 26 for a plain full view of the interface In each case the region of interest is displayed with a light background while the remainder of the interface is overlayed by a red semi transparent veil R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 9 37 The tool bar holding the File menus and the status bar just above the Python console are not detailed 2 2 2 Classes tabnotebook widget The upper part s structure is a mirror of the description classes and sub classes of the Python elsA interface displayed as tabnotebook widgets overlayed notebook like pages with protrud ing selection tabs one of which only is active at any time Operations for SpaceDis sub cbject of rur object r3 Sear E The main tabnotebook widget in vertical position on the left side displays the various classes cfdpb and is always visible 2 2 3 Class instance management Man SpaesDisc rrmeintsg umana Impr Aux param 3 mue Writer iriaccay Jameson 2 renes 2 een a av base a wooot KA awcoet sigma paz T la Object name choice The Operations for xxx class frame contains an entry field f
21. el sA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 24 87 User s Manual PyGelsA Eile View Defaults H Python console egcompres 3 Choose object class inplieit neinplicit cfdpb Operations for numerics class AMA multigrid nomultigrid mode frum Ya niter o ode i Crk4 block restrict_type synchronous mesh Create ElsaDefs Clear Show Submit time algo ld 3 Steady T window EE Define attributes for num object p gt num show Main SpaceDisc fTimelnteg MultiGrid Implicit Global actions Names Objects Clear boundary numerics time_stepping ode time algo convergence level k4 steady 18 06 iterations inititer niter 1 10 periods freqcompres freqcomptimestep cfivali cflvalf cfliteri cfliterf Operations for Timelnteg sub object of num object ElsaDefs Clear Check gt boundary object bk2_8 created The reverse operation is also possible by bringing back the console to its initial location Scrolling the text for the console output larger window of the console is possible by clicking in it and using the PageUp and PageDown keyboard keys R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual
22. elsA DSNA PyGelsA Graphical User Interface User s Manual R f ELSA MU 02044 Version Edition 1 0 Date 21st May 2002 Page 1 87 PyGelsA Graphical User Interface User s Manual User s Manual Diffusion see last page Qualit For the writers For the checkers Function Head of interface Head of quality Name M Lazareff A M Vuillot Visa Informatic management GCL ELSA Applicability date Imm diate Approver Project head L Cambier R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 2 37 User s Manual HISTORIC VERSION EDITION DATE CAUSE and or NATURE of EVOLUTION 1 0 21st May 2002 Extracted from MU 98057 User s Manual R f ELSA MU 02044 el sA Version Edition 1 0 PyGelsA Graphical User Interface Date 21st May 2002 d User s Manual Page 3 37 CONTENTS 1 INTRODUCTION 5 IT ae ae Se a Be oe Se nee Ge ee a 7 2 1 PyGelsAaimandfocus 7 2 2 PyGelsA structure 7 2 2 1 Main interface regions x ss nues dede nd d 2 2 2 Classestabnotebook widget 9 2 2 3 Class instance management 9 2 24 Object action buttons 10 2 2 5 Sub classes tabnotebook widget and widget attributes 11 2 2 6 Python console ooo eo 1x dus o ok sens erveres 1
23. fields The main widget types are defined in appendix IT As a general rule the scope of action of a button for a function or method call ex Clear for the clear call is that of the enclosing frame so that Clear may mean clear the object in the scope of an object that is un define all attribute values clear the script in the scope of the script try View Toggle global actions to make the global c1ear button appear that is delete all description objects 2 2 1 Main interface regions This screen shot outlines the main regions of the interface which will be individually described below R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface Page 8 37 User s Manual DONA ARTE Fle wew Cefauts Choose abjact class Cperatane for numerks chee lt object naming a 1 Ly te Elsaer object actions Submit e gt Beating attributes for num object Wan SpacaLilsc Timeinteg Multiirid Implicit flux param fiu te Erte coed by amesan t a dica E ay haee class selection function attribute values aoet k avcoat_sigma paa in mesk glabberder r group aw specrad Operations far SpaceDisc sub ebject af num abjart ral mtrs H l rakal E Lg d Python console a E O E The sizes of the corresponding images seen below as icons for individual regions are purposely small th
24. ing values or numerical values with too wide a range for a slider widget not represented newton_tol 1e 05 the button in in active state locked and active state Create ElsaDefs the radio button in closed state and deployed state this is used for a choice in a closed list of possible values implicit none El R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 34 37 User s Manual the toggle button in raised state and pressed state the combo widget with its pop down list show in deployed state Operations for block class R f ELSA MU 02044 Version Edition 1 0 PyGelsA Graphical User Interface Date 21st May 2002 DSNA User s Manual Page 35 37 INDEX GNU Linux in active state 20 33 LD LIBRARY PATH index PYTHON 23 IRIX PYTHONPATH 80 31 label Python 7 9411 15 21 23 29 80 Python elsA 7 9 active state 33 baldwin model attribute button 10 33 CAD 7d cfdpb class check method 19 clear od closed state 33 combo widget 34 compute method 26 console context deployed state 33 description object 12 dump function dump method 27 dump file elsa 7 12 entry field 9 17 83 entry widget EpAttrDefs py 12 EpAttrDict py EpDepends py 12 extract class extract meth
25. name Dependency rules may lead to global macro attribute frame or partial some atoms inactivation see chapter 5 4 4 Special widgets The file and var attributes use special widgets which combine an entry field and a button which opens for file a file selector dialog for var a dedicated list selector for var values R f ELSA MU 02044 Version Edition 1 0 Date 21st May 2002 Page 18 87 elsA PyGelsA Graphical User Interface DSNA User s Manual Create Dir Delete File Rename File Ihome lazareff elsA Current K ernel api Test euxdom 4 eu8dom py eu8dom pyc eu8dom api py eu8dom api py eu8dom api log epy eu8dom dmp epy r Selection home lazareff elsA Current K ernel api Test euxdom OK Cancel windows bladesecforce bladesecforcem2 bladesectorque bladesectorquem2 zone_file convflux_ro convflux_roe convflux rou convflux rov blade radius flightspeed s convflux row Gara annmanndnm convtorque rou Operations for Main sub object of ext object convtorque rov convtorque row UserDefs ElsaDefs Check J itti roe diffflux rou diffflux rov diffflux row difftarauie rail None Cancel OK t extl created R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manu
26. nt of such an fuzzy expert sys tem http www 2 cs cmu edu Groups AI html faqs ai fuzzy partl faq doc 4 html forthe e sA interface So for the time being the Maxwell daemon see 5 1 will not be allowed to proceed on its own 5 3 User requested a posteriori checks The check button invokes a check call this is useful when attribute values have been modified through the Python console see chapter 6 User required checks are normally not needed when the interface is used in pure GUI mode because in this case all checks are made a priori and all attribute values should be consistent One exception is when using the ElsaDefs button request for object completion from default values because default values may together with user specified values or on their onw even form an inconsistent whole R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 22 37 User s Manual Empty page elsA PyGelsA Graphical User Interface User s Manual DSNA 6 PYTHON CONSOLE USAGE TEXT MODE INSIDE GUI The Python console duplicates the functionality of the text mode Python accessed through the text only mode of the e1sa application Here are some examples of actions initiated from the Python console Python console R f ELSA MU 02044 Version Edition 1 0 Date 21st May 2002 Page 23 37 elsA interface usually 8 extract 8 blk8 ini
27. od file attribute glib GNOME GNU 30 group class 10 gtk 12 29 29 33 GUI 4 4 17713 27 2327 29 87 HCI A Henstridge 29 macro attribute Mattis Kimball MacDonald 29 Maxwell daemon 19 21 michel_model attribute model class mouse click mouse pointer name entry field 9 14 name filter numerics class 11 PDF 3 phymod attribute 79 pop down list pressed state pygtk radio button 33 raised state regular expression script file 25 25 scrollbar SGI 30 slider widget 33 status bar 9 submit method 26 tab 9 tabnotebook widget 9 83 toggle button tool bar 9 tool tip trace file typography var attribute widget window class XML 25 R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 36 37 User s Manual Empty page R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 37 37 TYPICAL DOCUMENT DISTRIBUTION Archives Secr tariat R dacteurs D veloppeurs e sA Utilisateurs e sA Responsable Documentation FIN de LISTE
28. oes not define a mechanism for the declaration of method arguments so that currently using the button for a method which requires arguments will fail by lack of an adequate popup to fill them in 2 5 Fonts colours and widget appearance The default appearance of the interface is defined by the toolkit default values for the various parameters fonts colours textures these may be overridden by a gtkrc resource file for the gtk toolkit or by a full theme which may use specific libraries for widget customisation see http gtk themes org A colour theme example is provided by the PyGelsA _ PyGelsArc theme file which should be copied to the user s home directory to be found by PyGelsA on startup R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 13 87 3 MANAGING DESCRIPTION CLASS INSTANCES Class instance management includes creating new objects class instances selecting them among existing objects and creating groups of objects 3 1 Class selection The proper class for the instance about to be created must first of all be selected in the tabnotebook widget on the left side of the interface A cfdpb instance must be created before instances of some classes may be created In text mode failure to verify this condition ex trying to create a numerics instance when no cfdpb exists is an error with the following message
29. or the name of an object of the current xxx class active tab of the classes tabnotebook widget and buttons for creation and other operations on this instance The object name may be a new one for object creation or the name of an existing object A new name must be typed in the name entry field while an existing name may be typed or selected from the pop down list displayed when the arrow at the right of the entry field is clicked R f ELSA MU 02044 Version Edition 1 0 elsA Date 21st May 2002 PyGelsA Graphical User Interface DSNA Page 10 87 User s Manual In all cases the chosen name must be validated by a press on the Return key the validated name then appears overstriked in colour see 3 2 Name based objects filtering On the right of the instance name field and separated from it by a toggle button is the name filter field When the toggle button is in the pressed state the name filter field may define a regular expression in the sense of the re Python module defining a display filter for the names in the pop down list under the instance name field This may be useful for faster lookup of objects ex the bnd a regular expression will select description objects whose name begins with bnd and ends with a This is a very powerful mechanism if the objects naming pattern is chosen adequately although it cannot fully replace a continuously kept definition of related configuration fragments ex taken from th
30. pending ops menu entry while their execution is activated through the File Activate pending ops entry Use of the compute button of the cfdpb instance implies activation of pending operations IZ SETA a 3X o File View Defaults Help Choose object class cfdpb Operations for numerics class Eu wg 33333 o 44 block ElsaDefs clear view show submit a E AA gt KK K KE window Define attributes for num object state bounday Main SpaceDisc Timeinteg implicit MultiGrid numerics flux params init flux limiter artviscosity extract jameson 4 None dissca 4 function artviscturb mask None globborder av_base avcoef_k2 avcoef_k4 avcoef_sigma 1 0 0 032 1 0 av base multigrid av sr av lsr dir av lsr exp av Isr var None al None al None Operations for SpaceDisc sub object of num object UserDefs ElsaDefs Check Clear Janl e boundary object bk2_8 created Python console Message no generic object for extract skipping Message from view model models C pg euler sutherland Nonel model phus props 1 4 None None Nonel numerics iterations C1 10 numerics Flux_params numerics time stepping ns on ns p ENE 7 jameson none dissca None rk4 steady 1e 06 p M 7 2 Trace and
31. refix gt lib 32 and lt prefix gt lib 64 to be referenced in the LD LIBRARY PATH and PYTHONPATH variables and to modify the Makefile files according to the one in the e sA distribution ex on SGVIRIX n32 or 64 arguments for the various compilation linking tools In such a case installation of Python glib gtk and pygtk must be adapted to the chosen sub directory structure by modifying every configure invocation as in configure prefix HOME 10cal 32 configure prefix HOME local 64 the Python modules will be installed in the following directories prefix 32 lib pythonl 5 site packages and prefix 64 lib pythonl 5 site packages and both installations 32 and 64 bits may be tested with oneroa36 export prefix home local oneroa36 export LD LIBRARY PATH S LD LIBRARY PATH prefix 32 lib S prefix 64 lib oneroa36 prefix 32 bin python Python 1 5 2 gt gt gt import gtk gt gt gt oneroa36 lt prefix gt 64 bin python Python 1 5 2 gt gt gt import gtk gt gt gt dir gtk ACCEL LOCKED ACCEL MASK ACCEL SIGNAL VISIBLE The same tests may be carried on with the e SA executable instead of the plain Python one 6Available on http ww gnu org or as ftp ftp lip6 fr pub gnu make make XXX tar gz R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 31 37
32. ro attributes are grayed out and folded up ex baldwin model above michel model so that only the macro attribute name and the collapsed frame are visible This is a priori checking as opposed to user requested a posteriori Define attributes for modnozzle object Main models fluid pg turbmod None ef phys_props gamma cv prandt rl phymod visclaw nstur None r prandtltb viscosity suth_const suth_muref suth_tref baldwin_model michel_model ext_turb ext turb checking see below lev ext turb lev mod ext turb lev uref 5 2 2 Automated data definition not implemented The current PyGelsA version does not sport any automatic mechanism for data definition other than from here on use all default values using the E1saDefs button R f ELSA MU 02044 el sA Version Edition 1 0 DSNA PyGelsA Graphical User Interface Date 21st May 2002 User s Manual Page 21 87 The rules based approach employed here for hard logic dependency influence management is the bread and butter of expert systems but is not of great help for filling out description objects A more complete and a dangerous one if not carefully crafted mechanism would involve fuzzy logic probabilistic rules to determine the correct value of at least a fraction of attribute values The time is probably a little too early now for the developme
33. tnozzle 1 initnozzle_1_blk1 init 2 2 initnozzle 2 blk2 initnozzle 3 initnozzle 3 blk3 initnozzle 4 initnozzle_4_b1k4 initnozzle 5 initnozzle 5 blk5 2 initnozzle_6 initnozzle 6 blk6 initnozzle 7 blk7 initnozzle 8 initnozzle 8 blk8 modnozzle mshnozzle 3 mshnozzle_4 mshnozzle 7 mshnozzle 8 nozzle initnozzle_7_ 2 mshnozzle 1 2 mshnozzle 5 mshnozz num J mshnozzle_2 le_6 Inames Python console z mshnozzle 2 mshnozzle 3 mshnozzle 4 mshnazzle 5 mshnozz 2 le 6 mshnozzle 7 mshnozzle_8 nozzle num gt gt gt num show Dbject name Description num lt numerics instance num gt artviscosity av_mat_fre avcoef k2 avcoef k4 avcoef sigma cfl H convergence level flux freezing freqcompres implicit inititer limiter multigrid niter ode restrict_type time_algo dissca 0 5 0 032 0 0 1e 06 jameson noimplicit 1 nolimiter 3 nomultigrid 10 3 rk4 synchronous steady gt gt gt num show If required ex for desktop real estate optimisation the console may be hidden using the View Toggle Python console entry or extracted from the interface by dragging it by its guilloched leftmost part R f ELSA MU 02044 Version Edition 1 0
Download Pdf Manuals
Related Search