Home

Symbolic Nuclear Analysis Package (SNAP) User`s Manual

Contents

1. Root Folders Note Root folders cannot be mounted or unmounted for remote Calculation Servers Right clicking on a folder in the Job Navigator will also display a pop up menu A folder s pop up menu will contain the following menu items e Create Folder Creates a new folder within the directory Selecting this option opens a dialog which requests a name for the new directory e Rename Folder Opens a dialog for renaming the folder This option is not available for root directories SNAP User s Manual 42 Menu Items e Remove Folder Removes a folder from the Calculation Server This option is not available for root and non empty directories e Import Local File Imports a plot file from the selected folder into the local Calculation Server For more information refer to Section 4 5 Importing a Local File e Unmount folder name Unmounts the folder removing it from the Job Navigator This option is only available to folders that have been mounted as root folders it is not available for subfolders A pop up menu is also available for job files However as the menu is identical to that found in the menu bar under the Tools menu that functionality will be described in the section Section 4 2 Menu Items 4 2 Menu Items The menu bar is broken into four menus File View Tools and Help File e Sounds Check Box Enables and disables Job Status sounds e Add Server Opens a dialog for adding Calc
2. W Loading homefdjwoat SN A4P_PROJECTS CAFEAN i Messages Window W Open Complete W Opening file fhome djvogt SNAP_PROJECTS CAFEAN lib Samples WLoop W4Loop med Loading sh Figure 2 1 ModelEditor UI 3 SNAP User s Manual The ModelEditor User Interface 2 1 1 The Main Toolbars The main toolbars include basic file operations model operations and undo redo see Figure 2 2 ModelEditor Main Toolbar These toolbars can be individually enabled or disabled using a right click pop up menu located on the main toolbar panel Buttons for the basic file and model operations include New Open and Save as well as shortcuts for Undo Redo Check Model and About The memory toolbar displays information on the current memory usage JACA IE AN ANN UN y S 92 947 EE Es e A Figure 2 2 ModelEditor Main Toolbar 2 1 2 Main Menu Items e File The File menu contains a standard list of options to create open save and close a model as well as a list of recently opened files in the Open Recent menu and an Exit option The File menu also contains two important sub menus Import and Export The Import menu contains a menu of the file formats supported by the currently loaded plug ins In the case of COBRA the COBRA ASCII item will create a new COBRA model and import the given file as COBRA input Similarly the Export menu contains a menu of the export file formats supported by the currently selected model
3. e cygwin bin c cygwin usr X11R6 bin without quotes SNAP User s Manual 36 Configuration Tool Properties Executable The location of the jEdit executable used by SNAP for displaying ASCII data jEdit is a pure Java programmer s text editor that was chosen for use with the SNAP system because of its stability and multitude of features For more information on using jEdit refer to Chapter 8 Using the jEdit Plug in For instructions on installing jEdit or the jEdit plug in refer to Appendix A Installing the jEdit Plug in for SNAP Use System Look amp Feel When set to Yes SNAP applications will be displayed with system specific window decorations When set to No the platform independent look and feel will be used Turning the system look and feel on requires an application restart Use System Look amp Feel is only available on platforms for which the Configuration Tool is able to detect a system specific look and feel 3 2 2 Calculation Server Properties Calculation Server properties are used to configure the Calculation Server used to run analysis codes and retrieve data from completed calculations In addition the Calculation Server can be started from the Configuration Tool Server Status The Server Status property can be used to start or stop the Calculation Server as well as obtain information about an active server It is displayed in Figure 3 2 Stopped Calculation Server and Figure 3 3 Started Calculat
4. Help Send Command Displays a dialog for sending an interactive command to the selected job This option is only available interactive calculations Terminate Terminates the selected job This option is only available for jobs that are currently active Change Priority Changes the priority of the selected job This priority determines the order in which jobs are started by the Calculation Server Otherwise jobs are selected based on the order of their submission into the queue This option is only available for jobs waiting to be started in the job queue Load Data Loads a completed job into memory Most options in the Tools menu can only be activated after a job has been loaded Unload Data Unloads a job freeing any system resources required in keeping the job loaded Release Releasing a job removes the Calculation Job File cjf but does not remove any of the job s data files Delete Removes the job from the Calculation Server This removes any data files associated with the job Help Topics Displays the SNAP help set section on Job Status Included Technologies Displays a dialog listing various technologies included in SNAP and their licenses 4 3 Root Folders The Calculation Server includes support for multiple Root Folders with sub folders that can contain any number of jobs These Root Folders can be mounted in Job Status by selecting the Mount Root Folder item from the right click pop up menu of the l
5. The following are some of the more frequently available menu items in the Tools menu e Add Remove Components This item will open a dialog that allows the user to choose from a list of components in the model show in the left hand column to add to the view Also the user may select components already in the current view that they would like to remove from the view A Component Category O Organize After Insert Components Components In View Interactive Variable 16 NC Part Pres Break 11 Problem Time 1 Interactive Variable 1 Heat Fling Heat Structure 31 Interactive Variable 10 Liquid Mas Default View Interactive Variable 11 Vapor Mass Interactive Variable 12 Liquid Tem Interactive Variable 13 Vapor Tem Interactive Variable 14 Void Fractic Interactive Variable 15 Pressure Fluid Velocity Across the Z Axis 3 F Fill 1 Figure 2 8 Add Remove Components Dialog e Show All Connections When components are added to a view drawn connections are created to represent connections between the components The drawn connections can be Cut from the display to simplify the view Show All Connections will restore any drawn connections missing from the view e Reset Connections This will cause all of the selected components connections to be reset Reset means to remake the visible connection by dropping any user added points or adding points per the default connection creation algorithm e Import Export View Templa
6. This editor includes proper syntax highlighting for Python source as well as highlighting for the special access methods listed above 2 5 Command Line Usage The SNAP installation includes platform specific launchers for each of the included applications For Windows a set of windows executables are included For UNIX type systems including OS X shell scripts are included These launchers are placed in the bin directory of the SNAP installation and can be executed directly from the command line This allows the ModelEditor to be executed from other applications or scripts When combined with batch commands Section 2 6 Batch Command Syntax this allows the ModelEditor to be used by automated systems such as analysis code test suites When run from the command line certain options can be specified for the ModelEditor The command line options can be displayed by running the ModelEditor from the command line with the option usage as shown below Symbolic Nuclear Analysis Package SNAP ModelEditor Version 0 25 2 Command line usage snap batch filename debug nosplash remote usage version where batch identifies a batch file to process debug turns on debug mode nosplasn turns off the splash screen remote disables double buffering for remote X displays usage prints this message and exits version prints the version info and exists batch lt filename gt The ModelEditor supports a b
7. lib corba jar Where lt installfolder gt is your SNAP installation folder e Under Unix Find the script that starts jEdit called jedit Edit the line that begins with exec and edit it so that it looks like on one line exec lt path to java gt java mx32m Djava endorsed dirs lt installfolder gt lib corba JEDIT jar lt jeditinstalldir gt lib jedit jar se Where lt installfolder gt is your SNAP installation folder lt path to java gt is the path to your java executable and lt jeditinstallfolder gt is your jEdit installation folder The entire command should be on one line A 4 Set the SNAP Installation Directory Start jEdit and enter the SNAP installation directory when prompted If the SNAP jEdit plug in was already installed this setting can be updated by opening the Global Options dialog from the Utilities gt Global Options menu item Note jEdit must be restarted for this change to take effect BE Global Options o jEdit Plugins Snap o File System Browser Plugins BufferT abs QuickMotepacd gt InfoViewer SNAP Install Directory jusr local snap_0 25 2 ox canes Cama Figure A 1 Snap Installation Directory Option A 5 Set the jEdit Executable Set the jEdit Executable preference in the Configuration Tool Section 3 2 1 General Properties section to refer to the installed jEdit executable E SNAP User s Manual 78 Appendix B Calculation Job Fi
8. Control Block Signal Variable Trip no data no data data Figure 7 16 Control Block Signal Variable and Trip Beans The Control Block Signal Variable and Trip beans are intended can be used to layout logical control systems such as those in the TRACE and RELAPS plug ins These beans can be created via the Insertion Tool or by pasting a control system type component into an animation view from a code plug in that supports control system display bean creation such as TRACE or RELAPS These bean support the standard single data source and data channel along with a numerical format for the float display and a label to replace the data channel name when animating In addition SI and British units strings can be provided for display depending on the units setting for the animation model SNAP User s Manual 62 Display Beans 7 8 2 Indicators 1 3D Graph Analog Dial hug Annunciator BE Axial Map E AxialPlot 123 Data Value Flow Indicator E Fluid Level 5 Polygon Python Output Display On Simple Annunciator Vs Strip Plot Figure 7 17 Indicator Beans The Indicators group contains a set of more specialized beans for plotting and data display 7 8 2 1 3D Graph Fuel Temperature Axial Node 9 1 MEETS FEAT FFFZIFZZZ AI 1234567809l101112131415 Y Figure 7 18 3D Graph Bean The 3D Graph bean is a three dimensional representation of data values similar in nature to the Stacked Element bean Ind
9. GetConstant The syntax for retrieving a constants value inside a user defined function 1s as follows X GetConstant Symbolic Name Where X is a simply a script variable for temporary use inside the user defined function and Symbolic Name is the name of the user defined constant e GetVariable The syntax for retrieving a variables value inside a user defined function is as follows X GetVariable Symbolic Name where X is a simply a script variable for temporary use inside the user defined function and Symbolic Name is the name of the user defined variable e SetVariable The syntax for setting a variables value inside a user defined function is as follows SetVariable Symbolic Name X where X is a simply a script variable for temporary use inside the user defined function and Symbolic Name is the name of the user defined variable 29 SNAP User s Manual Command Line Usage i source Editor Function Volume Calculation E File Edit Show Inputs Show Outputs Input the values needed to calculate the volume leni Gettonstant Length 1 areal GetVariablet Area 1 y Tene GetConstant Length 2 area GetVariablet Area 2 y Set the volume values SetVariable Volume 1 leni areal 3 setvariablef Volume 2 lenz areaz y Figure 2 26 UDF Source Editor The Python source that makes up a user defined function is edited via the Function Source Code property
10. Model Options node in the Navigator as 1t contains several important model specific properties refer to Figure 2 14 Model Options Editing buttons are provided to enter specified model data Note that pressing the E to open a particular working window when it is already open will bring the window to the foreground 17 SNAP User s Manual Creating a Model File Edit Tools Window Help olele vlel mle o EN TRACE models W4Loop med tw4loopnewHs o Model Options o TE Hydraulic Components 33 o Control Swstermn C Model Options Optional O En re a E D o T IL LA itle Cards TEST PROELE ES lt NnOne gt 0 Gas Treated as 1 INOPT Data Afte 0 H20 Fluids None 0 No 4 CSS with HPSSI re m TKN KD ENE ransient Calculation l O Liquid and Yapo 1 From Donor Cell 1 QE 1 0E s State Convergence a General ite Cards Fluids Transient Calculation Figure 2 14 Model Options 2 3 2 Creating and Editing Components SNAP provides several methods of creating and editing components The most common method is to use the component insertion button located above the 2D View see Section 2 1 5 1 View Toolbars This button opens a pop up menu that contains all of the component types organized by category as shown in Figure 2 15 Adding TRACE Components from the View Toolbar As an example when edi
11. along the Z axis Display Wire Mesh When set to True a wireframe mesh is used to display data When set to False the default bar graphs are displayed Wire Thickness The thickness of lines used in displaying a wire mesh Column Spacing and Row Spacing Determines the relative widths of columns and rows Editing either property opens the Grid Spacing dialog which displays the current spacing values Display Grid When set to True lines indicating the borders of cells in the grid are displayed Display Opaque Grid When set to True the cells of the grid are filled with the color specified by the Grid Base Color property Display Labels When set to True numbers indicating the index of cells in the grid are displayed along the X and Y axes If the Position Labels on Axes property is set to False the labels will be displayed along the bottom and right lines of the grid parallel to the X and Y axes Display Ticks When set to True tick marks will be displayed along the Z axis The spacing of these tick marks are determined by the specified Range 7 8 2 2 Analog Dial Figure 7 19 Analog Dial Bean The Analog Dial is a 0 10 representation of a single data channel as a dial A scale factor must be set to translate the value of the data channel into the 0 10 range SNAP User s Manual 64 Display Beans 7 8 2 3 Annunciator Figure 7 20 Annunciator Bean The Annunciator bean is a more complete version of the Simpl
12. component and dragging the mouse to extend the box completely around the component Pan Tool The pan tool is used to change the visible portion of a zoomed in View This feature can be used to maneuver around a large model by pressing the left mouse button and dragging The displayed portion of the model will move with the mouse Zoom Tool The zoom tool changes the position and scale of the View Clicking in the View will zoom in a set amount holding the shift key and clicking will zoom out the same fixed amount Clicking and dragging to select a region drawing a box will zoom in to the selected region Right clicking in the View with the zoom tool will show a menu for selecting a specific zoom position or fitting the entire View to the window Connect Tool This tool 1s used to create connections between two components by selecting connection points on each component To connect two components place the pointer over a from connection point SNAP User s Manual 8 The ModelEditor User Interface and click the left mouse button then move the pointer to the desired to connection point on another component and left click again The mouse pointer will turn into a blue dot when a viable to connection point is passed over A line representing the connection will then be drawn in the view Insert Tool The insert tool includes a button to activate the tool and a drop down menu to select the type of Annotation or component to insert Once
13. e Edit This menu contains menu items for the Undo Redo operations and an item to open the Preferences Dialog The Edit menu also contains an item for the Plugin Manager which can be used disable unused plug ins e The Tools menu contains the Check Model Submit Job and Export to Edit items Check Model The Check Model button and menu item both perform a model validation check on the currently selected model The checks performed for a model are defined by its plug in Submit Job The current model can be submitted to the Calculation Server by selecting the Submit Job menu item from the main Tools menu Refer to Chapter 5 Submitting a Job for more information on the job submission process Export to jEdit This item exports the current model to the jEdit text editor Refer to Section 3 2 1 General Properties for more information about configuring jEdit for use by the ModelEditor SNAP User s Manual 4 2 1 3 The ModelEditor User Interface e Window The Window menu includes an item for the batch command interpreter window and a list of the currently open ModelEditor dialogs such as Property Views The Navigator The Navigator provides a logical hierarchical representation of the model s components and views The root of this tree 1s the Plug in node Any model that is currently open will appear underneath the appropriate plug in node For example in Figure 2 3 Example Navigator View note the node labeled w4Loop med
14. foreground color or hidden entirely 7 8 4 Plant Components bd Break Y Break Spray k4 Control Valve Ey Fill bl Gate Valve a Pipe Elbow Plenum Y Simple Pump NI Single Element Single Volume MM Stacked Elements 5 Vessel Rings Volume Stack Figure 7 33 Plant Component Beans 69 SNAP User s Manual Display Beans 7 8 4 1 Break Figure 7 34 Break Bean The Break bean is a simple indication of whether a data value is above a specified Threshold Value The break display can be customized by its On Color Off Color Orientation and Line Width 7 8 4 2 Fill Figure 7 35 Fill Bean This bean differs from the Break Bean only in its shape 7 8 4 3 Break Spray y Figure 7 36 Break Spray Bean The Break Spray 1s intended to represent a break in a fluid system with a color change and a spraying animation The properties available for this bean are nearly identical to the Break Bean with the exception of the Line Width used to control the thickness of the spray lines 7 8 4 4 Control Valve Figure 7 37 Control Valve Bean The Control Valve bean represents a valve that can be partially open When the data value is greater than or equal to the Open Value the valve is considered open is drawn using the Open Color When the data value is less than or equal to the Closed Value it is considered closed and is drawn using the Closed Color Values in between the two are considered partially open and a
15. from the main Tools menu From jEdit this dialog can be accessed by selecting the Plugins gt Snap gt Submit Calculation menu item Note When submitting from jEdit the calculation type may be selected just below Server When submitting from the ModelEditor the calculation type 1s determined by the model being submitted i Submit Calculation Server Target Folder Tutorial Run Options Mame lv EctwardsPipe Restart EcwardsPipe Restart Restan 3 Overwrite Yes No O Prompt ote Be Interactive 8 True O False Start Paused O True 2 False Parametric Enabled First Second Restart O No Restan O Selected Restart File 8 Selected Restart Job Restan Job Tutorial EcwardsPipe Submit Into Separate Folder Animation Connect Animation After Submit fhomefuserfEdwardsPipe_anim med View Console Output Figure 5 1 Submit Dialog 47 SNAP User s Manual To submit a job first select the target Server from the list of available Calculation Servers refer to Section 4 4 Adding a Remote Server for a description of adding and removing servers Selecting a server will automatically retrieve the list of available executables for the current calculation type Select the desired executable from the Executable list Note When submitting to the local Calculation Server if the server is not currently active it will be started automatically based on the current setting of Start Server Automa
16. property for more information on the pattern syntax Fluid Condition This range type displays the current fluid conditions of a volume by Volume ID only as a set of color ranges Separate color ranges are specified for subcooled saturated and superheated liquid For this range type the superheat and subcool values are specified as a number of degrees from the saturation temperature Note The Fluid Condition range type can only be used with beans that use a Volume ID 7 7 Animation Playback Time 5 Connect Data Source Figure 7 8 Playback Controls No Data Source Connection When an Animation Display is open the Animation Playback Controls will become available in the Main Toolbar The playback controls are a collection of buttons used to drive an animation They are illustrated in Figure 7 8 Playback Controls No Data Source Connection and Figure 7 9 Playback Controls Connected to a Data Source eE 14 4 E D gt Di Time 9 00 s Skip to End Disconnect Data Source Skip Forward Stop Animation Figure 7 9 Playback Controls Connected to a Data Source SNAP User s Manual 58 Display Beans e Connect Data Source Connects the Animation to the currently defined Data Sources Once connected to a Data Source this button becomes the Disconnect Data Source button Only one Animation Model may be connected at a time e Disconnect Data Source Disconnects from the current Data
17. window component navigator and all other inner frames of the ModelEditor become undocked and independent of each other Switching back to single arrangement recombines the views into one main window 2 3 Creating a Model Facilitating the creation of models is the primary purpose of the ModelEditor Models are classifed in one of two categories pre and post processing A pre processing model is generally comprised of components used to form the basis of a calculation which shall be submitted to a Calculation Server Alternatively a post processing model is used to display the either the results of a calculation or some other form of data in SNAP this usually takes the form of an Animation This section shall focus on functionality common to pre processing models Refer to Chapter 7 The Animation Plug in for more information about post processing in SNAP 2 3 1 Opening a New Model Pressing the New button on the main toolbar will open the model type selection dialog as shown in Figure 2 13 Example New Model Dialog This dialog allows the selection of any of the SNAP User s Manual 16 Creating a Model currently loaded plug ins for a new model After selecting the desired type a new model will be created and added to the Navigator A single empty view will also be created and opened Select Model Type E CONTAN model Figure 2 13 Example New Model Dialog After creating a new model special attention should be paid to 1ts
18. 3 4 Export 9 Beginning Non condensible Partial Pressure Test W Non condensible Partial Pressures greater than 0 0 allowed because NOAR equals O W Beginning Junction Flow Area Test W Junction Flow Area Test passed with no failures ad Error check complete One error found F 6 warnings found p 4 Figure 2 9 Message Window 2 2 User Preferences The SNAP ModelEditor user preferences are available from the main Edit menu These preferences are presented as a set of General Preferences such as Handle Size used by all plug ins and a set of preferences for each plug in The General Preferences are divided into three Attribute Groups General Colors and Window Arrangement These are described in more detail below 13 SNAP User s Manual User Preferences Attribute Groups Model Editor Preferences Select Preferences Plugins General COBRA Analysis Code CRUD Analysis Code RELAPS Analysis Code TRACE Analysis Code Display Options General Optional Disabled Connection Size 107 E Default Model Units SI Double Click Behavior Open Mini Navigator wi Handle Size 5 Attri ribute Layout Iterations 1500 P H Scale Components True False 7 op up e p Show Create Views Dialog e True False Show Welcome Dialog True False i Sound Option Beeps On o smeo X Always Use Anti Aliasing a True False Colors Error Col
19. An installer and user s manual for jEdit 4 1 1s included as an optional package in the SNAP distribution If you selected this option during SNAP installation or upgrade the following files should have been placed in a jEdit subdirectory under your SNAP installation directory e jedit4linstall jar The jEdit 4 1 installer e Jedit41manual a4 paf The jEdit 4 1 user s manual Start the jEdit 4 1 installer under Java and follow the instructions to complete installation A 2 Installing the Plug in Files The SNAP plug in for jEdit 4 1 1s also included as an optional package in the SNAP distribution If you selected this option during SNAP installation or upgrade the jars and modes folders should have been placed in a jEdit sub folder in your SNAP installation folder These folders contain the SNAP plug in for jEdit and the SNAP syntax highlighting modes respectively 1 Copy the file lt installfolder gt jars snap jar tothe jars folder under the jEdit install folder 2 Copy all of the xm1 files from the lt installfolder gt modes folder to the modes under the jEdit install folder A 3 Update the jEdit Configuration e Under Windows Start the Edit configuration tool jeditinit located in the jEdit installation folder and add the following to the Command Line Options for Java Application Loader on one line 71 SNAP User s Manual Set the SNAP Installation Directory mx32m Djava endorsed dirs lt installfolder gt
20. Chapter 4 Job Status The Job Status application 1s a client application which details the status of jobs submitted to a Calculation Server It also provides support for adding connections to remote Calculation Servers and importing local files into the list of available jobs 4 1 User Interface The Job Status User Interface UI is composed of a Job Navigator on the Left and a Job Panel on the right which can display either the Job Table shown in Figure 4 1 The Job Status UT or the detailed view of the currently selected job shown in Figure 4 2 Job Status Job Details 3 SNAP Job Status 0 25 2 File View Tools Help o Al localhost 5006 i calcserv localhost sample So Started caleTime job caerme LL LLL gt El dummyserver 5006 Senos dasa 19995 dema PT DATATNIO b do Figure 4 1 The Job Status UI The Job Navigator is a tree style view representing a logical hierarchy of servers and root folders Each server can be expanded into a list of mounted folders which can in turn be expanded into a list of subfolders Selecting an item in this view changes the contents of the Job Panel In general selecting a folder displays any jobs contained within that folder in the Job Table while selecting a job displays the detailed view for that job 4 SNAP User s Manual User Interface E SNAP Job Status 0 25 2 File View Tools Help localhost 5 006 Calcserv flocalhost new_runs Testing_0O_2 5_7 3 Old
21. Data Channels in this Python Data Source with setChannel calls Inittalization Sou rce 2 File Edit Insert Example User Defined Data Channels Virtual Channel Marne tempti 10803 0000 a tempf 108040000 TIN E cos time JS a ERE ERE EERE SRS EERE ERAGE EGR S ERAGE a A D BE D D BE DE a 1 4 e REE RR REG Ta th t War 15 an allas to the Python Data Source For other data sources use the sourcetName method to retrieve a reference to that source 50 sourcec Master Data channels required from Data Sources must be Register ed in the a initialization block to ensure that data is retrieved for them Lregistert temp ft 108010000 Pegisterd temp t LOso 20000 4 register tempt 1080 30000 4 Pegister temp F Loso4o000 4 Fegister ti me o 4 15 14 Apply Figure 7 5 Python Data Source Source Editor Both of these source semgents are edited by using the source editor shown in Figure 7 5 Python Data Source Source Editor The source editor provides a syntax highlighted text editor for editing python code The list of virtual data channels available from this python data source is at the top of the source editor Any data channels that will be made available from the python source must be added to this list Example python code for the various data source specific methods can be found in the Insert Example menu Included in this menu are Get a Source Register a Data Channel Get a Channel Value a
22. Job Status to create a demultiplexed data file for use by plotting packages Access to a demultiplexed file greatly speeds the process of plotting very large data sets e DeMUX Arguments Additional command line arguments to pass to this executable s demultiplexer Refer to the demultiplexer documentation for a listing of the available command line arguments CORBA Timeout The timeout value in seconds used by CORBA connections between SNAP applications SNAP communication over dialup connection or networks with very high traffic may sometimes exceed the maximum timeout and fail In these cases the timeout must be increased However increasing this value will cause some operations such as checking for an unavailable local server to take much longer to complete The default value is recommended in most circumstances Server at Login When set to Yes a shortcut will be placed in the Startup group of the user s Start Menu This option is only available on Windows platforms 3 2 3 Web Support Web support properties are used in configuring how SNAP attempts to look for updates and other web related tasks e Use HTTP Proxy Set this property to Yes if the Web Support Services such as update should use an HTTP proxy server e HTTP Proxy Server The HTTP Proxy server to use for all Web Support communication e HTTP Proxy Port The HTTP Proxy server port to use for all Web Support communication SNAP User s Manual 40
23. Main Property View shown in Figure 2 4 Example Property View provides the central point for viewing and editing properties of model components Display Beans etc It displays the properties of the current selection from either the Navigator or a 2D View Changes to these properties will immediately be reflected in all other open views 2D ASCII Property etc An example of a Property View is shown in Figure 2 4 Example Property View Property Views are made up of a set of Attribute Groups and a turn key button to show and hide each Next to each button is the name of the group Attribute Groups are used to organize the properties of a component within the Property View A turn key button located before the Attribute Group Name is used to expand or collapse the list of attributes Each group has a 2 column table of the attributes description and value While some objects have only the General group others may contain several more groups Help Button A help button Y appears next to each property Pressing this button will display a more detailed description of the property being edited SNAP User s Manual 6 The ModelEditor User Interface Disabled Check Box This check box shown in Figure 2 4 Example Property View 1s used to activate the display of disabled properties in each of the attribute groups Custom Editor E and Component Selection 5 buttons are located adjacent to some attribute values These button
24. OD ias 47 O Ne CACA CONS CNEA id 51 Je Une Animation PUA sida iio 53 7 1 Creating a New Animation Model oocooccocnccnnccnncnncnnncnncnonnnncnncnnannnnnnnnos 53 7 2 Animation Components acid 54 Data SOURCES ap bado 54 A Sequenced Data SOULCES eri a 55 Tos Te PRON Data S OUNCE iii E 55 111 SNAP User s Manual Symbolic Nuclear Analysis Package SNAP AA A A A Males techn 57 TEANN Play AA E E E RA 58 Tea DISPLAY BEANS ad 59 TS CONOS Y CM tic 62 IAN A A canes deacesk E SN 63 TOO 5 LETAN neni Nain ts 68 Tok Plant Components esi a 69 S Usine the Jedit PIOS iiser a teenie Misti snd saeu gene ued vomedevanns Mash wssianands 75 A Installing the jEdit Plug in for SNAP 00 0 cccc cece eeceeceeceeeneeeeeeeeeseeeeeenseeeeeaes TI AAA AS JEM ea E AA het daa 71 A2 dastan the Plus PIES ls 71 AS Update the JEdit Cont curation sissi A Ti A 4 Set the SNAP Installation Directory oocooccocnoonnocnncnnncnncnnnnnoconcnoncnnnononos 78 AO Set Me Edit Execution ico 78 B Calculation Job Ple iia 79 B A Sample Calculation Job Bile a EINS 79 DAS NO 81 SNAP User s Manual 1V Chapter 1 Introduction The Symbolic Nuclear Analysis Package SNAP consists of a suite of integrated applications designed to simplify the process of performing engineering analysis SNAP is built on the Common Application Framework for Engineering Analysis CAFEAN which provides a highly flexible framework for creating and editing input for
25. Sources e Analysis Time Opens the Analysis Time dialog This dialog is used to select an arbitrary time to seek to as well as configure various time related settings for the animation e Rewind to Beginning Moves the animation back to the first available time value e Skip Backward Moves the animation backward by a fixed number of time steps This number of time steps can be configured in the Analysis Time dialog by changing the Skip Forward Back Steps e Play Animation Begins playback of the animation Once pressed this button becomes a pause button which can be used to pause playback e Stop Animation Halts the currently animating job The stop button is only available when the job is currently active executing and the current playback is at the last available timestep e Skip Forward Moves the animation forward by a fixed number of time steps This number of time steps can be configured in the Analysis Time dialog by changing the Skip Forward Back Steps e Skip to End Moves the animation forward to the last available time value Note Skip Forward and Skip Backward are not supported by all plug ins 7 8 Display Beans Display Beans are objects that can be added to a 2D view to display values retrieved from a job on a Calculation Server or an external data source Display Beans are created using the Insertion Tool in the exact same way as Annotations Display Beans can also be resized reshaped and moved in a similar
26. Symbolic Nuclear Analysis Package SNAP User s Manual Fuel Temperature Axial Node 9 ar PO O OE of ff A Pf ff of ff ff ff TAE JF IF UF IF IF FF Fu FFD 12345 6 7 8 9301192131415 1 April 2007 Applied Programming Technology Inc 240 Market St Suite 208 Bloomsburg PA 17815 1951 Symbolic Nuclear Analysis Package SNAP User s Manual Applied Programming Technology Inc Copyright O 2006 2007 KEK Disclaimer of Liability Notice The Nuclear Regulatory Commission and Applied Programming Technology Inc provide no express warranties and or guarantees and further disclaims all other warranties of any kind whether statutory written oral or implied as to the quality character or description of products and services its merchantability or its fitness for any use or purpose Further no warranties are given that products and services shall be error free or that they shall operate on specific hardware configurations In no event shall the US Nuclear Regulatory Commission or Applied Programming Technology Inc be liable whether foreseeable or unforeseeable for direct incidental indirect special or consequential damages including but not limited to loss of use loss of profit loss of data data being rendered inaccurate liabilities or penalties incurred by any party or losses sustained by third parties even 1f the Nuclear Regulatory Commission or Applied Programming Technology Inc have been advised of the possibi
27. _Runs Job Properties pa a status Complete 5 5 8 EJ NewSubRunse Plug in ID RELAF o 7 NewSubRuns3 o 3 RelapFailure o 3 Testing_0_25_0 Priority 0 e 3 Testing_0_25_1 o E Testing_0 25_2 Loaded Yes B o 3 Build_05 EdwardsPipe EdwardsPipe Resta Calculation Time 0 500563 Executable ID 2ef_Wine Start Time 0 0 Interactive Submitted Date 2006 10 20 11 33 11 EDT i Interactive T est Y Typpwr gt Typpwr 2 Completed Date 2006 10 20 11 33 20 EDT A Tyopwr 2 E Tuppwr Test Viewable Files Y Typpwr Test2 Input File Output file Y Typpwr Test3 Screen Output Demux Screen Output Start Date 2006 10 20 11 33 14 EDT Figure 4 2 Job Status Job Details Right clicking on components in the Job Navigator will display a pop up menu A Calculation Server s pop up menu will contain the following menu items e Connect Attempt to make a connection to the server This may fail if the server is unavailable or the specified server key is invalid see Adding a Server e Disconnect Disconnects from the server e Reconnect Disconnects from the server and attempts to reconnect This option is equivalent to using the Disconnect and Connect options above e Mount Root Folder Opens a file selection dialog for specifying a folder on the local Calculation Server which should be mounted as a root folder For more information on this functionality refer to Section 4 3
28. a juni i fe ioff El 10 J Er i fsv nth O O O tico d rmx concin O 0 0 0 0 0 dxin volin alpin tlin 2 0 O 1459318 0 0 300 0 pin pain flowin twin 5 0E6 0 0 0 0 372 756 i fm sv 1Fmusw 1ftlsw fas 10 11 12 14 i fps 1fpasw 1fcnosw 15 16 O Figure 2 6 ASCII View 9 SNAP User s Manual The ModelEditor User Interface e Reference Docs The Reference Docs menu item will bring up a window displaying the relevant portion of the analysis code user s guide e Copy Copies the selected objects to the clipboard Whenever a new cut or copy operation is performed the copy paste buffer s contents is overwritten with the new cut copy object and the old object is lost The Control C keyboard shortcut is supported on most platforms e Cut Copies the selected objects to the clipboard and then removes these objects from the view This process does not remove components from the model but merely removes the graphical representation of those components from the view The Control X keyboard shortcut is supported on most platforms e Paste Pastes the graphical items not the model components previously copied to the clipboard The Control V keyboard shortcut is supported on most platforms Note A component can only be represented in a view by a single drawn component e Paste Special Opens the Paste Special dialog to allow duplicates of the copied model components to be pasted This dialog is a plug in specific feature howeve
29. a plot A single plot point is added to the line for each timestep animated Pressing the Reset button or rewinding time will clear all plotted points and restart the plot from the new current time Note The Reset button and time scrollbar can only be used when the 2D View is locked In addition to the normal font background color etc this bean can be customized by setting the following plot appearance related properties Plot Background Color The background color of the plot region Line Thickness The thickness in pixels of the plotted line Show Legend When set to True the legend shown at the top right will be displayed showing the channel names and their corresponding line colors Show Scrollbar When set to True the scrollbar will be displayed at the bottom of the plot to allow scrolling to previously plotted data Y Axis Label This property is the label used to describe the y axis shown as Temperature above Show Units When set to True the units of the y axis will be appended to the Y Axis label Thus the above Temperature would be displayed as Temperature K Time Base This property determines the x scaling of the plot and how much data is visible at one time 7 8 3 Interactive Li InteractiveValue HI Playback Controls u Playback Status Playback Time Slider Figure 7 29 Interactive Beans 7 8 3 1 Interactive Value Figure 7 30 Interactive Value Bean This bean is designed
30. a type has been selected left clicking anywhere in the view will create an object of the selected type After the insertion is complete the insertion tool will be deactivated To insert multiple components of the same type hold the CONTROL key during the insertion click This will keep the insertion tool active and allow multiple inserts 2 1 5 2 View Menu Items View menu items can be accessed via the right click pop up menu of the view and via the menu bar for undocked views The actual pop up menu displayed will depend on the item type and quantity currently selected in the view The specific code plug ins dictate what items the right click menus contain however certain menu items appear frequently and will be described here Many of the menu items available from the right click menu in the 2D view perform identical functions to those in the Navigator e Properties This item opens a separate property view for the selected object This separate property view is functionaly equivalent to the main property view shown in Figure 2 4 Example Property View e Show ASCII The Show ASCII menu item will open a view showing what the corresponding model s ASCII deck would look like for the selected component This view is handy for those analysts who are familiar with ASCII decks and want to verify that they are creating viable ASCII input for their codes ASCH View Fill 1 Y RON type FL userid component name fill 1 1 unnamed
31. able when right clicking on or very near a point e Arrow Size The size of the annotation s arrow heads relative to the specified line thickness e Dashed When this property is True the line will be drawn with a dashed pattern Color The color used to draw the line e First Second Arrow Head The style used to draw the line s arrow heads Each head style can be specified individually Available styles include None no head Filled a filled triangle and Hollow an unfilled triangle e Thickness The thickness in pixels of the line This value also affects the size of the arrows on either end of the line Tooltip Text The line annotation includes optional tooltip text This text is displayed when hovering the mouse over the annotation Some simple HTML tags may be specified for this property but must be surrounded by lt html gt lt html gt tags Polygon The polygon annotation is a 2D closed figure made up of any number of line segments Inserting a polygon annotation is a process of defining the line segments that will make up the polygon The first left click will begin the polygon Moving the mouse will show that a rubber band line is drawn to the previously defined point Left clicking again at another location will create a line segment and begin drawing the rubber band line to that location Additional left clicks will create more line segments Double clicking with the left mouse button will complete the last seg
32. alculation Server to manager a much larger pool of completed jobs with a minimum of memory and processor usage B 1 A Sample Calculation Job File The following is a sample Calculation Job File created for a TRACE job named TestJob The CJF files for jobs using other plug ins will differ only in the FILE entry names used Note that the order of the entries in a CJF 1s not important but they are case sensitive In the following example the header CJF is required and must be in the format shown The format of this header is used to determine if the CJF is a valid file Comments start with and are completely optional Dates SUBMITTED STARTED and COMPLETED are stored as a UNIX timestamp Times START_TIME END_TIME and CALC_TIME are stored in seconds Files FILE _ are stored as relative file locations when possible CUJF C Runs TestJob cjf Fri Sep 01 09 26 55 EDT 2006 NAME TestJob PLUGIN TRACE EXECID V4260MOD PRIORITY 5 79 SNAP User s Manual START_ END CABE A Sample Calculation Job File TIME 0 0 _TIME 588 392578125 TIME 588 392578125 SUBMITTED 1156937862323 STARTED 1156937865365 COMP LETED 1156938057558 FILE _ DEMUX TestJob dmx FILE _ INLAB TestJob lab FILE _INPUT TestJob inp FILE _ MED TestJob med FILE _ MESSAGE _IDX TestJob msg idx FILE _ MESSAGE TestJob msg FILE MUX CACHE TestJob xtv_cache FILE _ MUX TestJob xtv FILE _OUTPUT_IDX Te
33. an be entered directly into the text of a text annotation These tags will be interpreted by the built in Java HTML renderer This allows tables bulleted lists font colors font sizes etc to be specified directly in a text annotation The above example can be seen by entering the following text lt H2 gt Interactive Calculation Demo lt H2 gt lt CODE gt Vertical 4m 6 Schedule 80 Pipe lt P gt Heated from 0 4m 3 6m lt P gt lt P gt Interactive Variables are used to control lt UL gt lt LI gt O0uter Surface Heat Flux lt LI gt lt LI gt Fill State Conditions lt LI gt lt LI gt Inlet Steam and Vapor Velocities lt LI gt lt UL gt lt CODE gt Component Display Scaling The scaling of components within a 2D View is controlled by the Pixels Per Meter property of the View to display the View properties within the Main Property View switch to the Selection Tool and select any point in the view not occupied by a component The initial default value of 20 pixels per meter is designed to display complete model diagrams for large full plant models If the components appear too small to identify key details the relative size of the components may be increased by adjusting the Pixels Per Meter property Furthermore 1f increasing the scale of the View does not allow certain features of components to be distinguished such as the cells of a pipe it is possible to increase the relative width to height scaling for components placed
34. appears under the node labeled TRACE models This indicates that w4Loop is a TRACE model The name of each model appears in parentheses to the right of its node This is used as an abbreviated description of what the model represents A model s name is separate from its file name to distinguish between different working versions of the same model It can be changed by selecting the Model Options node underneath the model node and changing the Name property The default value for the model name is unnamed Each model is broken down into categories of components The majority of these categories are Plug in specific however some are shared between all plug ins The Navigator provides access to all of the model s components including non visual elements such as global Model Options Right click pop up menus located on the individual nodes of the Navigator can be used to add delete or edit components as well as to perform operations on the model The Show ASCII menu item in the right click pop up menu of a View s node will open an ASCII View showing what the corresponding model s ASCII deck would look like only for the selected component This non editable view is handy for those analysts who are familiar with ASCII decks and want to verify that they are creating viable ASCII input for their codes Note The number of components of that contained within a category or sub category is displayed in brackets following the node name Notice in Figu
35. as a controller for an interactive variable inside a calculation In essence it is an enhanced Data Value that allows the retrieved value to be edited and sent as an interactive command To use this bean first specify a Data Channel to be displayed Then specify the SNAP User s Manual 68 Display Beans Variable Name of the interactive variable in the calculation During animation the data value will be displayed in red for a brief time each time the value changes 7 8 3 2 Playback Controls The Playback Controls bean is identical to the controls available on the main toolbar Refer to Section 7 7 Animation Playback for more information on these controls 7 8 3 3 Playback Status Paused 0 0s 494 8s 1026 9s Figure 7 31 Playback Status Bean The playback status bean shows the status of the current animation including the current start and end times The time display can be customized with a numerical format as well as the standard font and foreground color properties 7 8 3 4 Playback Time Slider 5 55 Figure 7 32 Playback Time Slider Bean This bean can be used to quickly scroll through to an approximate location in a calculation Clicking inside the bounds while the view 1s locked will skip the playback to a time relative to the clicked position in the slider Clicking and dragging to interactively skip the animation following the mouse The time display can be customized using a numerical format font and
36. atch command language When run in batch mode a batch file must provided Refer to Section 2 6 Batch Command Syntax for a detailed explaination of the ModelEditor batch command syntax SNAP User s Manual 30 Batch Command Syntax debug This option enables various debugging features of the ModelEditor and is reccomended that this parameter only be used by plug in developers This option disables the splash window display on startup remote The default JAVA double buffering scheme causes a significant UI performance loss on some systems when displaying the ModelEditor from a remote machine This option disables the double buffering and may improve performance in these circumstances usage help This option simply displays the usage information shown above and exits version This options simply displays the current ModelEditor version 0 25 2 above and exits 2 6 Batch Command Syntax The following is the standard batch command set Each command is listed with optional fields shown in between less than lt and greater than gt signs while required fields are shown between square brackets e SHOW The show command is used to display the primary user interface This allows for batch commands to execute in such a way that the user receives immediate visual feedback If this option is not used the ModelEditor will run without a graphical interface HIDE This command hides the primar
37. ated when selecting jobs This location 1s the URL to the job that will be used for the Data Source For example Figure 7 3 Select Data Source Dialog shows a selected job extdata that 1s an external data file managed by the EXTDATA plug in Note Unlike other Animation components Data Sources cannot be added to a view 7 4 Sequenced Data Sources The Animation Plug in s Data Source component allows multiple Source Run URLs jobs to be specified as a sequence To enable this feature set the the Number of Source Runs property to the number of jobs in the sequence up to 4 then select each job in the sequence as described in Section 7 3 Data Sources for the First Second Third and Fourth run URL properties E Master nteractive 2 General Optional Disabled Mame Include in Animation True 0 False 5 True False Number af Source Runs Two Source Runs v First Run URL calcserv localhost Local pecond Run URL calcserv f localhost Local Maximum Included Time Figure 7 4 Data Source Properties When using a sequence of jobs the playback time will begin at the first job s start time with the first job as the current job When the playback time reaches the start time of the next job it will become the current job and re initialize all Display Beans to animate that job s data The same process will occur at the start time of the third job and so on Note Only the last job in a sequence
38. can be actively running The preceeding jobs must be completed The channel name list for a sequence is the union of the channel lists of the jobs included in the sequence Channels that are not available in the current job during an animation will behave in the same manner as other undefined channels For example The single volume bean is colored flat gray When the current job changes to a job that includes the previously undefined channel it will be animated with the currently available data as normal 7 5 The Python Data Source The Python Data Source is used to animate data values that must be calculated based on data from one or more Data Sources This Data Source contains two segments of user defined Python code that are executed at different times 55 SNAP User s Manual The Python Data Source e The Initialization Source is the block of Python source code executed upon activation of this Python Data Source This code should include e Registering required channels from other Data Sources e Setting initial values for Virtual Data Channels in this Python Data Source e Defining methods and global variables to be used in the Transient Source during animation e The Transient Source 1s the block of Python source code executed after each timestep of data 1s retrieved from the master data source This code should include e Retrieving current values of required data channels in other Data Sources e Setting new values for Virtual
39. click on the desired component type to display a popup menu and select New This creates a new component of the specified type with a default name 9 Hydraulic Components 1 a MM Breaks 0 Il Channels 0 gy Fills 1 El oa Properties ER Pipe Show ASCII 7 Plen Reference Docs gt ied Add To View Default View bal Sep Cut Sing Copy dh Tee Paste lt Turk Paste Specia t4 val t iar g Delete Figure 2 16 Adding TRACE Components from the Navigator To add the newly created component to a 2D View right click on the component in the listing under the component type to display a pop up menu From this pop up select the desired View to which the component is added from the Add to View submenu The component will be placed within the selected View 19 SNAP User s Manual Creating a Model To edit a component select the component either in the 2D View or in the Navigator The properties for that component will then appear in the Main Property View See Section 2 1 4 The Main Property View for more information on editing properties 2 3 3 Creating Annotations Annotations can be used to mark up a view with static information about the contents of that view For example A rectangular annotation with titled border can be used behind a group of components to visually separate them from the surrounding components Annotations are created in a view using the Insertion Tool All Annotations appear in the Inse
40. d a unit type such as length temperature etc from the units defined for by the plug in User Defined Variables UDV are very similar to constants with the exception that they cannot be used for parametric runs and the actual value of a UDV is assigned by a user defined function See Section 2 4 3 User Defined Functions below 27 SNAP User s Manual User Defined Numerics 2 4 2 Numerics in a View Diameter 1 4 0 m Diameter 2 2 0 m Length 1 2 0 m Length 2 2 0 m Area 1 12 56637 m Area 2 3 1415926 mn Volume 1 25 132741 mi Volume 2 6 2831852 mi Radius 1 2 0 m Radius 2 1 0 m Figure 2 24 User Defined Numerics Example User defined constants and variables can be added to a 2D view in the same way as other components the Add To View menu in the numeric s Navigator node pop up menu the Create View item from the Numerics Navigator node etc These constants and variables are respresented in a view as a Drawn Numeric Drawn Numerics appear as a text label that displays the name of the numeric current value and units e g Area 1 in Figure 2 24 User Defined Numerics Example above IM Editable H Show Label H Show Units Drawing Properties Figure 2 25 Drawn Numeric Menu The appearance and capability of a drawn numeric can be changed by using the following items in its right click pop up menu As shown in Figure 2 25 Drawn Numeric Menu e Editable This checkbox item enables th
41. desired size and release the mouse button The following properties can be specified for a rectangular annotation Height The vertical height of the annotation in pixels Width The horizontal width of the annotation in pixels Rounded Corners When true the corners of this rectangular annotation will be rounded using the Rounded Arc Height and Width Rounded Arc Height Width The height and width in pixels of the arc used to round the corners of the annotation when Rounded Corners is true Fill Background When this property is set to True the annotation will paint its center the Background Color specified When this property is set to False the center of the annotation will be transparent Background Color The color used to fill the center of the annotation when Fill Background is True Outline Color The color used to paint the outline of the annotation Line Thickness The thickness of the line drawn around the outline of the annotation Border An optional border can be specified for a rectangular annotation Etched line and beveled borders are available using the provided border editor The text annotation is used to label or describe portions of a view and can be inserted with a simple left click Like other annotations the text annotation can optionally fill its background with a specified color and has an optional border The following is a list of the properties of a text annotation Tooltip Text The t
42. e Annunciator that includes High High High Low and Low Low values 7 8 2 4 Axial Map J 2 3 4 5 Figure 7 21 Axial Map Bean The Axial Map bean is a specialized case of the 3D Graph bean Its functionality is identical to a 3D Graph bean with a Z axis length of O and both X and Y angles set to 0 See the section on the 3D Graph for more information on properties specific to this bean 7 8 2 5 Axial Plot Word Fraction Pipe Position 0 0 0 5 1 0 Void Fraction Figure 7 22 Axial Plot Bean The Axial Plot bean displays a line plot based on a set of data channels for each timestep rendered If desired multiple data channel sets can be input to display a line plot for each set Each data 65 SNAP User s Manual Display Beans channel set consists of a number of x y pairs of data channels that determines the location of each point on the plotted line Optionally the x channel may be input as Fixed X Positions for situations where there 1s no x data available as data channels or the x data does not change over time A large number of properties are available in the Axial Plot bean to customize the plot line and axis appearance Refer to the pop up help available next each property for more information on axial plot customization 7 8 2 6 Data Value 547 373 K Fo a Figure 7 23 Data Value Bean The Data Value bean simply displays the numerical value of the selected data channel The font foreground col
43. e Calculation Server and display visual representations of that data This process repeats until either the data is exhausted or the user interrupts the animation Each Animation Model requires one Master Data Source and may have any number of Slave Data Sources Slave sources are other sources of data from a Calculation Server whose data will be interpolated relative to the Master Data Source To specify a job for a data source first select the Data Source from the Data Sources category in the Navigator Then locate the Source Run URL property in the Main Property View and press the red E button to launch the Select Data Source dialog shown in Figure 7 3 Select Data Source Dialog Select Data Source Location Icalcserw localhost Old_Runs EXTDATA extdata q Al localhost 5006 Calc Type tatus Calc Time Started Y EJ ld Runs JEXTDATA extdata Complete 99 999901 Oct 12 10 13 false e 17 3CHAN J Cobra_Test 7 EXTDATAY So 2 Ecward_s Pipe Cancel Figure 7 3 Select Data Source Dialog SNAP User s Manual 54 Sequenced Data Sources Expanding each Calculation Server node in the job tree on the left will show the root folders for that server Expanding each folder will show any contained sub folders and jobs Selecting a folder will display the list of jobs in that folder to the right Selecting a single job in the tree will show the details of that job to the right Note that the Location field is upd
44. e complex parts of the model shown in other views Once added to another view these embedded views will be represented by the Display Icon specified in the view properties The Add To View menu in the 2D View s right click pop up menu is used embed a 2D View into another 2D View 7 SNAP User s Manual The ModelEditor User Interface 2 1 5 1 View Toolbars The view toolbars located above the 2D View include the main view toolbar a tools toolbar and optional plug in specific toolbars used to select components to be inserted into the view The main view toolbar contains buttons for cut copy paste paste special find group and ungroup operations Paste special can be used to paste multiple copies of a copied set Refer to Figure 2 5 2D View Toolbars The Lock View button 1s used to lock the current view Locking a view prevents components from being moved copied pasted resized or deleted Figure 2 5 2D View Toolbars The tools toolbar contains buttons used for manipulating the View in various ways These include Select Tool The select tool is used to select move and manipulate elements of a View Components may be selected using the left mouse button Using the left mouse button with the CONTROL key pressed will add or remove components from the current selection Components may also be selected by drawing a rubber band box around the desired selection by pressing and holding the left mouse button on an empty space near the
45. e components within the input deck The type dropdown contains a list of component types found in the model along with the number of each type located in parentheses The components for the selected type are displayed in the list Selecting a component will result in that component being scrolled into view The Seek Components dialog currently supports the TRACE and RELAPS analysis codes 75 SNAP User s Manual 3 a seek Components 7 Find Components Close Type htstr 48 x 0 132 vessel slabs R1 L2 0 1326 vessel slabs R1 L2 0 1326 vessel slabs R1 L gt O 0 a 133 vessel slabs R2 L2 0 1336 vessel slabs R2 L O 1344 vessel slabs R1 L3 4 5 O 1346 vessel slabs R1 L3 4 5 O 1346 vessel slabs R1 L3 4 O 1355 vessel slabs R2 L3 4 5 O 135 vessel slabs R2 L3 4 SNAP User s Manual 76 Appendix A Installing the jEdit Plug in for SNAP The following steps are required to install and configure jEdit to work with SNAP 1 Installing jEdit 2 Installing the SNAP jEdit Plug in 3 Update the jEdit Configuration 4 Set the SNAP Installation Directory 5 Section A 5 Set the Edit Executable A 1 Installing jEdit The current jEdit plug in for SNAP is designed to work with jEdit version 4 1 Other versions are not supported and may not work Platform specific instructions on installing jEdit are available in the Download section of the jEdit homepage http jedit sourceforge net
46. e editing of a user defined constant by entering a new value into the Drawn Numeric e g Diameter 1 in Figure 2 24 User Defined Numerics Example above Entering a value into a Drawn Numeric will change the value in the same way as editing the constant s properties directly e Show Label This checkbox item enables and disables the display of the user numeric name in the Drawn Numeric e Show Units This checkbox item enables and disables the display of the units defined for a user numeric This option only affects the Drawn Numeric The user numeric units will not be affected nor will Drawn Numerics in other views that refer to the same numeric SNAP User s Manual 28 User Defined Numerics e Drawing Properties The drawing properties item opens the Drawn Numeric Properties dialog This dialog can be used to modify the label text replacing the name of the numeric font foreground amp background colors and border of the drawn numeric 2 4 3 User Defined Functions A user defined function is in essence a Python function that is executed when a model is opened when a user defined constant is changed and when the Execute Functions item is selected This function retrieves data from user defined constants and or external sources and computes values that are then placed in user defined variables User defined functions can use user defined variables and user defined constants through the following special access methods e
47. ehavior will occur e Handle Size This value sets the size of handles or the boxes that are drawn in the selection frame It is defaulted to 5 See Figure 2 12 Handles and Selection Frame Small squares attached to the Selection Frame are Handles Rectangle surrounding the entire Component is the Selection Frame Figure 2 12 Handles and Selection Frame e Layout Iterations A user may choose to organize a model or selection of the model in a graphical view In short organize attempts to place components on the canvas in a logical and clean fashion The iteration number to be entered here determines how much time and effort should be spent on this process Generally higher numbers produce better layouts but cause the organization process to take longer The default value is 1500 Note The Layout Iterations preference is used as a hint for the layout systems included with each plug in Thus the effect of this preference varies from plug in to plug in 15 SNAP User s Manual Creating a Model e Scale Components When this option is selected components shown in a graphical view are scaled in size based on the data entered for that component volume length etc Because small components can become difficult to see with much larger components the user may chooses to turn off scaling when components are of drastically different size Note This preference is used as a hint for plug in 2D View rende
48. engineering analysis codes as well as extensive functionality for submitting monitoring and interacting with the codes SNAP currently includes support the CONTAIN COBRA FRAPCON 3 MELCOR PARCS RELAPS5 and TRACE analysis codes Each code is supported by a separate plug in The list of currently installed plug ins can be found in the Chapter 2 The ModelEditor About dialog by pressing the Plugins button The SNAP Application Suite The SNAP application suite includes the ModelEditor JobStatus and the Configuration Tool client applications as well as the Calculation Server In this context a client application is one that typically is run on the local machine and provides a graphical user interface A server application is one that runs in the background or on a different computer to provide access to data The ModelEditor is the primary SNAP client side user interface It is responsible for the development and modification of input models for the supported analysis codes It is also responsible for animating the results of those analyses using the Animation plug in The Configuration Tool is used to configure properties for the SNAP client applications as well as to startup shutdown and configure the Calculation Server Job Status is used to display the status of jobs on a server as well as to create new jobs by importing local data files The Calculation Server provides control of and communication with active and completed calculations Fo
49. erties 6 S Server 81 adding 43 definition of 51 local 51 remote 51 removing 43 server keys exporting 36 generating 36 Symbol Nuclear Analysis Package 1 U undo redo main menu 4 main toolbars 4 user interface 3 main toolbars 4 view toolbars 8 W window 5 SNAP User s Manual 82
50. example shown in Figure 7 44 Stacked Element Bean has 6 rows and 3 columns of fuel rod temperatures To create a complete Stacked Element bean 1 Insert a new Stacked Element bean using the Insert Tool 2 Set the number of columns in the bean by adding entries to the Column Widths table This table is used in normalized form to scale the size of each column in the bean The number of entries in this table determines the number of columns and the value for each determines its relative width 3 Set the number of rows in the bean by adding entries to the Row Heights table SNAP User s Manual 72 Display Beans This table like the Column Widths table is used to determine the number of rows and their relative heights 4 Specify data channel names for each element in the stack Open the Select Channels dialog by editing the Node Volumes property of the bean The table at the top of this dialog contains the channel names for each element in the bean layed out by row and column in the same order as they will be rendered by the bean These channels can be input individually by editing each table cell selected individually by selecting the Channel Selection radio button or input in groups by specifying a Pattern Refer to the pop up help of the Select Channels dialog for a more detailed discussion of channel selection individually and by pattern In addition to the normal bean customization the stacked element bean provides 2
51. ext annotation includes optional tooltip text This text 1s displayed when hovering the mouse over the annotation Some simple HTML tags may be specified for this property but must be surrounded by lt html gt lt html gt tags Foreground Color The color used to paint the text entered for this annotation Note that HTML tags specified in the Text of this annotation may override this color value Fill Background When this property is set to True the annotation will paint its background the Background Color specified When this property is set to False the center of the annotation will be transparent Background Color The color used to fill the background of the annotation when Fill Background 1s True Border An optional border can be specified for a text annotation Etched line and beveled borders are available using the provided border editor SNAP User s Manual 24 2 3 4 2 3 5 Creating a Model e Text Margin The amount of space used to surround the text for this Text Annotation e Text The text displayed in the text annotation Figure 2 21 Text Annotation Example is an example of a text annotation using the optional HTML tag support Interactive Calculation Demo Vertical 4m 6 Schedule 80 Pipe Heated from 0 4m 3 6m Interactive Variables are used to control O Outer Surface Heat Flux Fill State Conditions O Inlet Steam and Vapor Velocities Figure 2 21 Text Annotation Example HTML tags c
52. fashion to annotations Note For most plug ins the quickest way to create a simple display is to copy the contents of a 2D View e g a set of interconnected pipes or control systems and paste into an Animation view 59 SNAP User s Manual Display Beans Figure 7 10 Display Beans Example Each bean displays its data in a different way but they all share a common set of functionality The following is a list of features supported by most Display Beans In the case that a beans does not support one of these features 1t will be noted in that bean s description 2 Single Volume General Optional Disabled DataSource master ayw S EE Condition noe 5 e conca o oo Vertical olume Shape oolTip Text volume 350020000 Figure 7 11 Single Volume Properties e Data Source All Display Beans connect to at least one Data Source some more than one Those beans that use more than one Data Source include pop up explaining what aspects of the bean will use each source Refer to Section 7 3 Data Sources for more detailed information on Data Sources and Data Source selection e Range A Range is used to map a data value or values to a color for animation This is useful for providing a overall impression of the progress of a calculation Refer to Section 7 6 Ranges for more detailed information on Ranges and Range selection e Channel Name The name of the data channel or often data channels tha
53. grace jEdit Executable fusr bins jedit Use System Look amp Feel lt Disabled gt Calculation Server F Allow FRernote Connections 0 Yes No Stan Server Automatically Yes No Server Idle Time Use Fixed Port w es No Max Concurent oes 0 Executables Jo Executables Corea Timeout start Server At Login lt Disabled gt O el y 7 Web Support Use HTTP Proxy O Yes No HTTP Proxy Server lt Disabled gt HTTP Proxy Port lt Disabled gt Figure 3 1 The Configuration Tool UI 35 SNAP User s Manual Configuration Tool Properties 3 1 1 Property View 3 1 2 The Configuration Tool uses the same property view interface used in the Main Property View of the ModelEditor However instead of changing parameters specific to any one component or View properties edited in the Configuration Tool are global changes to all SNAP applications For more information on how to use a Property View refer to Section 2 1 4 The Main Property View Menu ltems In addition to the Property View the Configuration Tool also includes a menu bar which contains access to various functions outlined below e File gt Save Saves the current configuration e File gt Export Public Keys Exports the public encryption keys used for connecting to the Calculation Server from a remote location Using this menu item opens a file selection dialog which may be used to specify the name and locati
54. hape and appearance can be customized with the following properties e Plenum Type The plenum orientation type Upper or Lower e Curved Fraction The fraction of the plenum that is curved 0 0 1 0 e Outline Width The thickness of the outline in pixels 7 8 4 8 Simple Pump Figure 7 41 Simple Pump Bean 71 SNAP User s Manual Display Beans The Simple Pump bean is a simple indication of whether a data value is above a specified Threshold Value The pump display can be customized by its On Color Off Color and Facing East 7 8 4 9 Single Element Figure 7 42 Single Element Bean The Single Element bean displays a color based on the data value from the specified Data Channel using the specified Range This bean can be either a rectangle or an ellipse based on Element Shape property 7 8 4 10 Single Volume Figure 7 43 Single Volume Bean The Single Volume bean displays a color based on the specified Volume ID and Range This bean can be used to represent a vertical or horizontal pipe segment by setting the Outline Width set to 3 above and the Orientation This bean can also be rectangular or elliptical based on the Volume Shape property 7 8 4 11 Stacked Elements Figure 7 44 Stacked Element Bean The Stacked Element bean is a 2 dimensional stack of Single Element beans designed to simplify the process of visualizing areas of dense nodalization or long stretches of sequential channel numbering The
55. he client applications requesting services of it are run on a different machine or by a different user For information on configuring local and remote Calculation Servers refer to Chapter 3 The Configuration Tool and Chapter 4 Job Status The Calculation Server makes extensive use of the Calculation Job File CJF format for storing information about each job Knowledge of this format is not necessary for the normal use of the Calculation Server however the details of this format may be invaluable to developers and test suite authors A detailed description of this format is found in Appendix B Calculation Job Files 51 SNAP User s Manual 52 Chapter 7 The Animation Plug in Main Steam Main Steam SGRY P l pl EW Turbine Bypass ajj Turbine Bypass Fee dwater Feedwater _ ae lt gt lt a lo Te Pd Aux Feed ages Aux Feed Eb 161431 125615 m 161 45 HL Break Triple LOOP ast Single LOOP Fuel i Temperalui Bt 15 CE Figure 7 1 Example Animation Mask SNAP s interactive and post processing capabilities are predominately realized within its animation displays Within such a display the results of a calculation may be animated in a variety of ways Animation masks are very similar to models They are composed of Views containing a number of objects each of which contain properties that may be edited in the Main Property View However instead of submitting jobs to the Calculation Server an animati
56. he top half of the dialog The attributes of the newly created executable will be shown in the bottom half of the dialog 3 Define the attributes of the new executable e Plug in The plug in i e code type that this plug in will be used with Select the appropriate plug in for this executable from the combo box to the right e Exec ID A short one word name for the executable This name is used only for distinguishing between executables of the same analysis code type For instance RELAPS version MZB might be called Relap MZB e Description A one line description of the executable e Executable The absolute path to the executable e Executable Arguments Additional command line arguments to pass to the executable e Supports Interactive Execution Set to true if this executable and it s corresponding server plug in support the SNAP interactive command system Executables that support 39 SNAP User s Manual Configuration Tool Properties interactive execution will allow the user to send commands to the calculation to control its execution such as pause resume or end e Default to Interactive Execution Set to true if jobs submitted using this executable should default to using the SNAP interactive command system This option is only available if Supports Interactive Execution is set to Yes e DeMUX Executable The absolute path to the demultiplexer for this executable This demultiplexer can be executed from
57. ield Then select the Server Key File received from the remote user that started the calculation server After pressing OK the remote server will appear in the server list in Job Status and in the Animation plug in s job selector For more information on exporting the required Server Keys see Exporting Server Keys T Add Server Serer Host Name Server Port largon 5005 Server Key File fhome argon key Figure 4 4 Add Server Dialog 4 5 Importing a Local File Plot files can be imported into the local Calculation Server directly by using the Import Local File dialog available from the Import Local File item Figure 4 5 Import Local File Dialog To import a plot file in this manner simply select the mounted folder that contains the file then right click and select the Import Local File item The Import Local File dialog will be shown to allow the plug in job name and local file to be selected Pressing OK will import the file into the local Calculation Server and load its data for use in animations Import Local File Job Name External Data Locas File oadatapis y Figure 4 5 Import Local File Dialog 45 SNAP User s Manual 46 Chapter 5 Submitting a Job The submit dialog show in Figure 5 1 Submit Dialog allows the submission of jobs from jEdit or the ModelEditor to local and remote Calculation Servers This dialog can be accessed from the ModelEditor by selecting the Submit Job item
58. ific commands require a way to specify more complex multi line input for some commands An nline File is intended as a way to place a larger more strictly formatted set of data as a single value argument An nline File argument must be the last argument to a batch command PLUGIN SETDESCRIPTION lt This is an example of using an Inline File to set the description of a model This description can span multiple lines and will maintain its spacing and formatting Note that the Inline File begins with the lt less than character and ends with a period The lt should be at the end of the line preceding the Inline File and the should be on the line after the Inline File on a line by itself 33 SNAP User s Manual 34 Chapter 3 The Configuration Tool The Configuration Tool is used to configure global properties for the SNAP client applications Most client application properties changed in the Configuration Tool will not take effect until the client applications have been restarted This tool is also used to startup shutdown and configure the SNAP Calculation Server Most Calculation Server property changes take effect immediately without requiring a server restart Refer to the description of each property below to determine which properties take effect immediately 3 1 User Interface 7 SNAP Configuration File Help SNAP Configuration General Optional Disabled Acirace Executable usri local acgrace bin ac
59. in the view Locate the View s Width Scale Factor property and adjust it to make components appear wider or thinner as necessary Note The 2D drawing of components can also be scaled individually using the Scale Drawing menu item as described in Section 2 1 5 2 View Menu Items Checking a Model for Errors Once a model has been completed it can be checked for errors To do so select either the Check Model button from the main toolbar or the Check Model menu item located under the Tools 25 SNAP User s Manual User Defined Numerics 2 3 6 menu If the model contains no errors the Message Window will display the message Error check complete No errors found If errors are discovered the problem component can be immediately selected by double clicking on the error message inside the Message Window Model validation tests such as the elevation checker may be enabled and disabled by editing the Model Validation property of the Model Options navigator node Saving a Model Save the model using the File gt Save menu item or by utilizing the CTRL S shortcut If the model has not yet been named a Save dialog will be displayed within which the name and location of the model may be selected Note ModelEditor models have a default extension of med 2 4 User Defined Numerics The SNAP User Defined Numerics UDN feature is designed to allow properties of a model to be modified and or calculated outside the normal input for
60. ine the flow are and hydraulic diameter of a simplified Edward s Pipe model Submitting this model with the first constant set to FlowArea and the second constant set to HydraulicDiam would result in the following jobs EdwardsPipe Restart_RO1_O1 FlowArea is 0 9 and HydraulicDiam is 0 9 EdwardsPipe Restart_RO1_02 FlowArea is 0 9 and HydraulicDiam is 1 0 EdwardsPipe Restart_RO2_01 FlowArea is 1 0 and HydraulicDiam is 0 9 EdwardsPipe Restart_RO2_02 FlowArea is 1 0 and HydraulicDiam is 1 0 Restart O No Restan 7 Selected Restan File Selected Restart Job Restan Job Tutorial EdwardsPipe Figure 5 4 Submit Restart The Restart section controls whether the submitted input file will be considered a restart and from where the restart information will be retrieved If the Selected Restart File option is chosen a file can be selected from the local file system to be sent to the server for the restart If the Selected Restart Job option is chosen a job can be selected from the target server to be the restart job This option will ensure that the submitted job will not be started until the restart job completes and will copy the selected job s restart file into the appropriate location for the restart The Animation section allows the selection of an Animation mask to open after this job is submitted After the submission the master data source of the selected mask will be changed to point to the newly submitted run and the mask will be c
61. ion Server The buttons on both properties are from left to right Start Server Stop Server Show Server Status and Open Log Viewer somo fe Figure 3 2 Stopped Calculation Server STARTED Figure 3 3 Started Calculation Server e Start Server This button activates the Calculation Server It is not available when a Calculation Server is running e Stop Server This button activates the Calculation Server It is not available unless a Calculation Server is running e Show Server Status This button displays a dialog containing information about client applications connected to the currently active Calculation Server It is not available unless a Calculation Server is running e Open Log Viewer This feature is not yet implemented 37 SNAP User s Manual Configuration Tool Properties Allow Remote Connections When set to Yes the Calculation Server will allow connections from other users and other machines To allow remote connections from other users first change Allow Remote Connections property to Yes and restart the calculation server Then export the server s public key to a convenient location by selecting the Export Public Key item from the File menu This key can then be transferred to those users who require access to the server Note This feature is only supported under Java version 1 5 or above Start Server Automatically When activated Yes the Start Server Automatically preference will enable
62. it sourceforge net For detailed instructions on installing the SNAP jEdit plug in refer to Appendix A Installing the jEdit Plug in for SNAP The jEdit editor is used primarily for the Export to jEdit feature available in most SNAP plug ins This feature is used to export the ASCII input for the selected object model component etc to a temporary file which is then opened in jEdit There the exported ASCII can be reviewed or copied and pasted into other input files Pe ee File Edit Search Markers Folding View Utilities Macros Plugins Help Y A OQLAR QQ bs Ponana Check jEdit Version eer j 111 aye a see Infoviewer b juni ifty ioff QuickNotepad p E 10 O Snap oo h Submit Calculation iftr d Jl Open Job Status rTmx concin 0 0 volin 0 1459318 pain 0 0 ifmysy 11 1fpasu 16 Seek Components T b TRACE none UTF 8 UMIJE E Mb Figure 8 1 The jEdit Editor The SNAP jEdit Plug in provides the following additional features to jEdit e Job Submission The Submit Calculation menu item will open the submit dialog for use in submitting the currently open file to a Calculation Server Refer to Chapter 5 Submitting a Job for more information on the job submission process e Synax Highlighting The jEdit plug in currently supports syntax highlighting for the TRACE and RELAPS analysis codes e Seek Components The Seek Components dialog shown in Figure 8 2 The Seek Components Dialog is used to locat
63. ividual cells in the grid may be disabled allowing pattern based selection of data channels to skip unneeded cells Orientation grid spacing and relative lengths of the X Y and Z axes can be customized The example shown in Figure 7 18 3D Graph Bean displays fuel temperatures where all empty spaces in the grid are disabled cells 1 Insert a new 3D Graph bean using the Insert Tool 2 Set the number of columns and rows in the bean with the Dimensions property 63 SNAP User s Manual Display Beans 3 Disable any unneeded cells by editing the Enabled Cells property This displays a dialog of toggle buttons which can be used to set the enabled disabled status of each cell in the grid Specify data channel names for each element in the bean Open the Channel Nodes dialog by editing the Data Channels property of the bean The table at the top of this dialog contains the channel names for each element in the bean layed out by row and column in the same order as they will be rendered by the bean These channels can be input individually by editing each table cell or input in groups by seleting the Use Pattern check box and specifying a Pattern 5 Select an appropriate Range for the bean In addition to the normal bean customization the 3D Graph bean provides the following additional properties Orientation Determines the relative angles and lengths of the X Y and Z axes Grid Origin Determines the position of the grid
64. lay Beans The Segments of a range are consecutive regions of increasing value that may have different starting and ending colors This allows for different regions of the overall range to have separate color values The dialog for editing a range s segments is displayed in Figure 7 7 Range Segments Define Range Segments Segment Star End St Index value 0 Value Cole i 0 0 0 0 Add Ok Cancel Figure 7 7 Range Segments Temp Pressure Quality Void Fraction These range types work with beans that use either a Volume ID or a Data Channel to retrieve animation data These types use a sets of min max values and min max colors to determine the displayed color for each bean For beans that use a Volume ID the channel that 1s displayed 57 SNAP User s Manual Animation Playback will be determined by the specific client side plug in managing that data source e g TRACE RELAPS etc Generic This range type allows minimum maximum values and colors to be specified along with Sl and british units for these values Generic is the most flexible range type for Display Beans that use the Volume ID property When these beans use a range of type Generic they will use a user speficied pattern to determine which data channel to animate These patterns can be specified for each plug in currently loaded 1 e one for TRACE another for RELAP5 Refer to the pop up help for the Channel Name Patterns
65. les The Calculation Job File CJF format cjf replaced the previous status file format used by the Calculation Server Information that is was stored in a job s status file 1s now stored in the job s CJF See Section B 1 A Sample Calculation Job File for a more detailed explanation of the CJF format The CJFs used by the Calculation Server are created by the Server Plug in TRACE RELAPS etc for each job that is added In some cases an analysis code may require that its input output files have pre defined names For these situations a sub folder will be used to contain these jobs and the CJF will be placed in the parent folder Any number of jobs can coexist in a single on disk folder or sub folder This feature could be used by an automated test suite to allow immediate access to the suite s results by simply adding the suite s folder and creating a cjf file for each job All CJF files include the following data e Job Name e Plug in ID e Prerequisite Jobs if any e Restart Jobs if any Jobs whose restart data was or will be used by this job e File Names All files related to this job including input output etc e Calculation start and end times if available e Additional plug in specific information stored by the server plug in managing the job TRACE RELAPS etc Calculation Job Files are scanned by the Calculation Server only when requested by a client application This on demand scanning allows the C
66. lities of such damages or losses Table of Contents ge alo AAA PP e l AN ls AAA a a A A 3 2 Ae The ModelEditor User Mena onp dis 3 Zell The Main Too Bars e ideo sich 4 2 AND Mim Mena MES its 4 2 MEAN O a aa is 5 24 The Main Property VIEW sarao sobriedad 6 2 RA E aie ohiiencepteitaneh cea unthieareenes 7 2 1 6 The Message Window issue dida 13 D7 Ser E a E e E E ia dl E alin 13 22 General Prerere NGOS eeng a a illo ados 14 A O O a a ancl 16 22 5 Window Arrangement cr 16 2 E Re AAA A ti uaan A ae ena 16 23 Open New Model ops ollo pi 16 23 2 Creatine and dino Components lies 18 23 03 Creaune Annotations li o 20 2 5 4 Component Display Scaling ai E AN 25 23 5 Checkine a Model tor ENS E 25 D902 AAA A cde aaaled cana see 26 2A User Detined Numerics a 26 2A Constants and Variables ni 26 DADs INC Silla VAC Weir a 28 22 User Denned FUNnCUONS nice seas a iblens Maat 29 20 Command Line Usare wx E is 30 20 Bate EC OMmmand S VMLAR eaan ds 31 gt Phe On bl Curation Todas ti iia isla a meubaieomaadns 35 MS e AAA A A ctaaoaenc sas ont 35 SA A A N 36 EZ ME AS AA AA AA EA AAA 36 32 Configuration Tool Properties dual i isinen era lana ib is 36 Sl General Propere i iia oa ii A 36 3 2 2 Calculation Server Properties ti o a 37 IS A SAE T E E E I dee 40 RJD SLIS e a IA 41 A U Serer A O eat obec aah ice 41 A NAS on 43 A Se LS O A 44 44 Adding a Remote Server siii iii ias 45 A importino a Local Pile asc io 45 Jc OU OMICS A N
67. ll print the only the visible portion of the view using the current zoom scale and pan location Export Image Menu The items in this menu are used to export the view as an image The following formats are currently supported JPEG PDF PNG SVG TIFF Items are provided to export either the Entire View or the Current Perspective similar to the Print View Menu above Select Menu The select menu can be used to select a sub set of the objects in a view by type Items are provided in the sub menus for selecting every type that can be added to the view Zoom Menu This menu includes items for setting the current zoom to either Fit To View or the following preset scales 10 25 50 75 150 200 Undock View Undocking a view removes it the ModelEditor main window and opens it in a separate window This feature can be especially usefull for presentations as the undocked view can then be maximized to fill the entire screen Closing and re opening the view will return it to the docked state Close Closes the current view The view can be re opened by selecting the Open item in the right click pop up menu of the view s node in the Navigator 11 SNAP User s Manual The ModelEditor User Interface 2 1 5 3 View Tools Menu The Tools menu contains a set of useful operations that are less often used Elements may also be added to the tools menu by code plug ins This menu is available as a sub menu of the right click menu of the 2D View
68. ment close the shape and insert the polygon annotation using the defined segments Figure 2 20 Polygon Annotation Examples SNAP User s Manual 22 Creating a Model At any point during the insertion process the right mouse button can be used to remove the previously added point If there is only a single point defined then this will cancel the polygon insertion Once inserted the points that make up a polygon may be relocated by left clicking and dragging the red rectangular handle around the point The vertical and horizontal line segments in a polygon may also be relocated by clicking left clicking and dragging the line The right click pop up menu of a polygon includes the following additional items that can be used to customize its shape Flip Horizontal Flip Vertical These features are used to horizontally or vertically mirror the points about the center of a polygon Reshape Polygon This feature is used to completely reshape a polygon into a regular polygon with a user specified number of sides and outer radius The number of sides and outer radius is requested by an input dialog Rotate Polygon This rotates the polygon points clockwise a user specified number of degrees The number of degrees is requested by an input dialog Scale Polygon This feature scales the points of the polygon by a user specified fraction The scale fraction is requested by an input dialog The following properties can be specified for a P
69. n interpolated color between the two colors 1s used 7 8 4 5 Gate Valve Figure 7 38 Gate Valve Bean The Gate Valve bean represents a valve that can only be fully open or fully closed It differs from the Break Bean only in its shape SNAP User s Manual 70 Display Beans 7 8 4 6 Pipe Elbow Figure 7 39 Pipe Elbow Bean The pipe elbow bean is a more customized version of a Single Volume bean that is intended to resemble a piping elbow Like the Single Volume the this bean uses a Volume ID to select the data to animate In addition to the normal Font Foreground Color Border etc this bean s shape and appearance can be customized with the following properties e Curved Fraction The fraction of the segment length that is curved Smaller values result in a sharper turn 0 0 1 0 e Pipe Width Fraction The thickness of the pipe segment in relation to the width of the elbow Smaller values result in a thinner pipe 0 0 1 0 e Orientation The direction the inner curve is pointed North East North West South East or South West e Outline Width The thickness of the outline in pixels 7 8 4 7 Plenum Figure 7 40 Plenum Bean The plenum bean is a more customized version of a Single Volume bean that is intended to resemble an upper or lower plenum Like the Single Volume the this bean uses a Volume ID to select the data to animate In addition to the normal Font Foreground Color Border etc this bean s s
70. nd Set a Channel Value SNAP User s Manual 56 Ranges 7 6 Ranges A Range is a user defined range of colors and a corresponding user defined range of values used for Display Bean animation During an animation a typical behavior of a Display Bean is to change color based on the current value of its associated Data Channel For example a Single Element Display Bean is depicted as a rectangle If it is tied to a Generic Range with a single segment ranging between values of 0 and 1 with respective colors of red and blue when animating a value of 75 the rectangle will deep red Alternatively when animating a value of 25 the rectangle will display deep blue Any values exceeding the minimum and maximum values of the range will be displayed by the colors defined for the minimum and maximum values alternatively colors can be specified for out or range values As Ranges are themselves components any number can be created and optionally added to a 2D View see Figure 7 6 Generic Range Range Generic 3 1 Figure 7 6 Generic Range The properties available for a Range are dependent on its current Range Type Also the properties available for each type are completely separate from those for other types For example the Segments specified for the Temperature type is independent of the Segments specified for the Liquid Temperature type This means that Range Type can be used to animate different properties for a set of Disp
71. nd Syntax The save command is used to save a model in MED format Optionally the user may specify the model to be saved by that model s predefined label Acceptable values for the label field are MO through M9 If no label is given the current model will be saved The last parameter 1s the file name and should include the full path to the file e CLOSE lt Mn gt Where Mn is defined as one of the ten valid model labels numbered MO M9 The close command is used to close a currently open model Optionally the user may specify the model to be closed by that model s predefined label Acceptable values for the label field are MO through M9 If no label is given the current model will be closed Any unsaved changes to the given model will be lost when closed e SETCONST lt Mn gt name value Where Mn is defined as one of the ten valid model labels numbered MO M9 This command is used to set the current value of a User Defined Constant to the specified value The name of the constant must be enclosed in double quotes if the name contains any spaces e EXECUDF lt Mn gt Where Mn is defined as one of the ten valid model labels numbered MO M9 Executes the User Defined Functions in the specified model if given or the current model if none is specified e SET property value The set command is used to set a property to a specific value Where property is defined as e CURRENT The current model Valid values of CURRENT a
72. nteractive and Start Paused options determine whether the analysis code will be executed in Interactive Mode This mode uses the SNAP runtime communication with the analysis code to send interactive commands 1f supported to the job and receive notifications of the job s current calculation time The Start Paused causes the Calculation Server to send the amp pause message to the job as soon as it is launched This is especially useful for animating an interactive job as it allows the animation to be connected before the job progresses The remaining run options are executable specific options from the server plug in that are used to control the analysis code execution SNAP User s Manual 48 Parametric Enabled First Constant Flow4rea ES Second Constant HydraulicDiarm Figure 5 3 Submit Parametric The Parametric section controls the submission of a parametric set of jobs If enabled one or two User Defined Constants may be selected for use in generating a set of parametric runs If the first and second constants are selected runs will be submitted that represent every combination of the values of both variables If only the first constant is selected a set of runs will be submitted that represent each value of the first constant As an example consider a model EdwardsPipe Restart that contains 2 parametric User Defined Constants FlowArea and HydraulicDiam each with the values 0 9 1 0 ft These two UDCs are used to determ
73. ntified as parametric will have their values changed depending on a user defined table of values for each new deck exported By defining model parameters using user defined constants or variables the analyst may update common model parameters from a single location By creating a parametric constant containing a set on input values an analyst can efficiently generate a series of parametric analyses To assign a property to a user defined constant or variable simply right click in the editor for that value and select the User Values item from the pop up menu A dialog will be displayed to allow the desired value or constant to be selected Wall Roughness qalmlel O User Values Cut Copy Paste Figure 2 22 Assigning a User Defined Numeric The names of user defined values are restricted only by the fact that they must not be valid numbers For example 1 3 is a valid number and therefore cannot be a user defined numeric value Names may have spaces and punctuation marks When choosing a user user defined constant or variable in an editor the choices are listed alphabetically so wise choice of names can save time and avoid confusion General Optional Disabled Current Vawe AA Descripion lt none gt EG ms poumes e velit s Yiscosdbm ft hry Volflwigpm Volhts tu tt 3 hr Vora voltrat s volumet Fy htt F hi Figure 2 23 User Defined Variable Properties User defined constants can be assigne
74. ocal Calculation Server node localhost These folders can be unmounted by selecting the Unmount item from the right click pop up menu of the folder Unmounting a folder does not remove any data contained in that folder To mount or unmount folders the server s node must first be expanded to make a connection to the server If no root folders are mounted on the local server a prompt will be shown allowing the user to mount one Figure 4 3 No Root Folders Prompt No Root Folders E There are currently no root folders mounted Would you like to mount a root folder now Figure 4 3 No Root Folders Prompt SNAP User s Manual 44 Adding a Remote Server The Calculation Server also supports any number of sub folders under each root folder Sub folder can also contain any number of sub folders and so on Sub folders can be created by selecting the parent folder and selecting the Create Folder item from the right click pop up menu These sub folders can also be renamed or deleted by selecting the Rename Folder or Delete Folder item from the right click pop up menu of the folder Note that only empty folders can be deleted 4 4 Adding a Remote Server After selecting Add Server from the File menu the Add Server dialog is displayed see Figure 4 4 Add Server Dialog To add a remote server first enter the server s host name or IP address in the Server Host Name field and their calculation server port in the Server Port f
75. olume ID 7 8 2 10 Python Output Display E a E w 1 pa Calculated average at 15 03215 is 50 458 K Calculated average at 16 0220s is 570 465K x Calculated average at 1 0118s is 5 0 462 K Calculated average at 16 0016s is 50 458 K Figure 7 26 Python Output Bean The Python Output bean is a specialized bean for displaying the printed output and error streams of the Python Data Source Section 7 5 The Python Data Source The font background color border and error message display properties can be used to customize this bean 7 8 2 11 Simple Annunciator Figure 7 27 Simple Annunciator Bean The Simple Annunciator bean is used to indicate On when the data value has increased beyond the specified On Threshold and then Off when the value has decreased beyond the specified Off Threshold The text displayed On above can be specified by changing the On Text property When off no text is displayed Also like many other display beans this bean includes a background color border tooltip text etc 7 8 2 12 Strip Plot Temperature Over Time 600 0 500 0 a wm a all RT bo 400 0 Figure 7 28 Strip Plot Bean 67 SNAP User s Manual Display Beans The Strip Plot bean is a color coded line plot of multiple data channels A Strip Plot requires a single Time Data Channel and at least one data channel Data Channel 1 through Data Channel 5 specified in order to produce
76. olygon after insertion Foreground Color The color used to paint the outline of the annotation Fill Polygon When this property is set to True the annotation will paint its center the Polygon Color specified When this property is set to False the center of the annotation will be transparent Polygon Color The color used to fill the background of the annotation when Fill Polygon is True Fill Background When this property is set to True the annotation will paint its rectangular bounds in the Background Color specified When this property is set to False the background of the annotation will be transparent Background Color The color used to fill the rectangular bounds of the annotation when Fill Background 1s True Tooltip Text The polygon annotation includes optional tooltip text This text is displayed when hovering the mouse over the annotation Some simple HTML tags may be specified for this property but must be surrounded by lt html gt lt html gt tags Rectangle The rectangle annotation creates a rectangle with an optional filled background and border By default the rectangle has squared corners but can be rounded by setting the Rounded Corners property to True 23 SNAP User s Manual Creating a Model Text When inserting a rectangle left clicking will insert a rectangle of the default size To insert a rectangle of a specific size left click and drag to create a rubber band box that is approximately the
77. on display retrieves data from the server and represents it visually in some fashion This data can be from an actively running calculation a completed calculation imported EXTData files etc 7 1 Creating a New Animation Model Pressing the New button on the main toolbar will open the model type selection dialog as shown in Figure 7 2 Example New Model Dialog Select the Animation Model option Afterward a new animation model will be created and added to the Navigator A single empty view will also be created and opened 53 SNAP User s Manual Animation Components Select Model Type ES CONTAN model Figure 7 2 Example New Model Dialog 7 2 Animation Components Animation models contain only a small number of component types Data Sources Ranges Numerics and Views Creating and editing these components is identical to other component in the ModelEditor Refer to Section 2 3 2 Creating and Editing Components for more information The majority of the objects in an animation model are Display Beans and Annotations within 2D views Refer to Section 7 8 Display Beans and Section 2 3 3 Creating Annotations for more information on the creation and use of Display Beans and Annotations 7 3 Data Sources An animation requires one or more Data Sources to animate data A Data Source is most often a reference to a job on a Calculation Server While animating the ModelEditor will retrieve data from th
78. on of the key Note that Outlook email program may not allow filenames that end with the key extension e File gt Generate Server Keys Regenerates the public encryption keys used for connecting to the Calculation Server from a remote location All previously exported keys will be invalidated e Help gt Check for Updates Displays a login dialog which can be used to login to the SNAP web server and check for updates and optionally retrieve and install them 3 2 Configuration Tool Properties The Configuration Tool options are separated into three attribute groups General Calculation Server and Web Support 3 2 1 General Properties General Properties are used for options applicable to all applications in the SNAP suite Plotting Tool The path to the plotting tool used by client applications to plot data For example right clicking on an animation component in the ModelEditor will display a pop up menu with a Plot Data menu item Selecting this item will launch another dialog within which Data Channels specified for that component are listed After selecting one or more channels and pressing the OK button the specified Plotting Tool will be launched Data specific to the selected channels will be provided to this application for plotting SNAP currently supports the AcGrace and APTPlot plotting packages Note For AcGrace under Windows cygwins bin and _ usr X11R6 bin directories must be included in your system path L
79. onnected When the View Console Output option is selected a Console Dialog will be opened for the submitted job This console can be used to view the console output pause start stop and terminate the job 49 SNAP User s Manual 50 Chapter 6 The Calculation Server The Calculation Server is a remote or local application responsible for processing calculations and other data oriented tasks A user will not typically interact directly with the Calculation Server as it runs in the background waiting for use by a client application Most applications in the SNAP suite are such client applications they request services from a Calculation Server which in turn performs the requested service possibly sending the client data or information depending on the nature of the service The two prevalent uses of the Calculations Server are to execute an analysis code with a provided set of input and to retrieve data from completed calculations and external data files A Calculation Server is considered local if 1t runs as the same user and on the same machine relative to the client applications accessing it Such a local server is can be started from the Chapter 3 The Configuration Tool but by default will start automatically when required by a client application see the section on Section 3 2 2 Calculation Server Properties for more information on how the Calculation Server is started Conversely a Calculation Server is considered remote if t
80. or border etc can be customized like most Display Beans Also a numerical format may be specified in C printf format to control how the data value 1s displayed 7 8 2 7 Flow Indicator Til Figure 7 24 Flow Indicator Beans The flow indicator bean is used to indicate flow beyond a forward and reverse threshold pair When the data value is above the forward threshold the indicator will display an up arrow When the data value is below the reverse threshold the indicator will display a down arrow When the data value is between the two thresholds the indicator will be displayed as a single line The flow indicator can be customized with a foreground color for forward and backward indication a border and an orientation north south east or west 7 8 2 8 Fluid Level Figure 7 25 Fluid Level Bean The Fluid Level bean is a specialized version of the Single Volume bean This bean has a Level Data Channel that is used to indicate the liquid fluid level using specified minimum and SNAP User s Manual 66 Display Beans maximum values and a Volume ID used to determine the color of the filled region Like many other display beans this bean includes a background color border tooltip text etc 7 8 2 9 Polygon The Polygon is the same object as the Polygon Annotation described in the section called Polygon When placed in an animation model the polygon includes a Data Source Range and an either a Data Channel or a V
81. or 178 0 0 _ Heated Color 255 0 0 Incomplete Color 128 128 128 Control Color 255 175 175 vv Component Color Powered Color Selected Color Special Color arning Color F Window Arrangement indow Arrangement Single Window ES Close Attribute Descriptions Figure 2 10 ModelEditor Preferences Dialog 2 2 1 General Preferences Preferences in the General category refer to a number of miscallaneous preferences some of which shall be applied to all appropriate plug ins e Connection Size This value sets the size of the connection points which is defaulted to 10 pixels Connection points are graphic shapes providing hints to users as to where a connection to a component can be made Different shapes may indicate how a connection can be made For instance in the TRACE plug in a circle is used to indicate a point that may be used to start a connection A diamond is used to indicate a point that may be used to end a connection Refer to Figure 2 11 Connection points used in the TRACE plug in SNAP User s Manual 14 User Preferences Connection Points Figure 2 11 Connection points used in the TRACE plug in e Default Model Units Selects whether models default to using SI or British units e Double Click Behavior When a user double clicks an object in a view the ModelEditor will either select the object in the Navigator view or open a mini navigator view This option controls which b
82. ows the user select an interactive variable and specify a list of values and corresponding text for each name for a Display Bean Once defined these values can be selected from the Commands sub menu of the right click pop up menu of the bean Selecting any of the menu items in the Commands menu will send the corresponding value to the calculation as an interactive command j 4 Command Menu Editor variable e Figure 7 13 Command Menu Editor The following sections describe the Display Beans included with the Animation plug in broken down by their sub menu location in the Insertion Tool pop up menu Additonal beans may be installed separately or included with other pre processor plug ins Refer to the individual plug in users manuals for for more information on the beans they include 61 SNAP User s Manual Display Beans 7 8 1 Control System And F Control Lk Control Block or O Signal Variable E Trip Figure 7 14 Control System Beans The control systems beans are intended for use in creating logical representations of control systems for animation These beans do not actually perform any logic operations but merely display the value of thier selected data channels 7 8 1 1 And Or Control Figure 7 15 And Or Control Beans The And Or and Control beans shown above are more customized versions of the Single Element bean that can be used to layout rough control systems for animation 7 8 1 2
83. r most current plug ins allow pasting multiple copies and renumbering the components as they are pasted The Shift Control V keyboard shortcut is supported on most platforms e Group Ungroup The grouping feature of 2D views allows the user to create a visual group for a set of selected visual objects annotations display beans etc Once created a visual group is treated as a single object in the view Selecting any part of the group will select the entire group Moving cutting copying etc all affect the entire group Groups can be dissolved at any time by pressing the Ungroup button e Delete This item removes the currently selected item s from the model A confirmation dialog is presented before the actual deletion occurs The deleted objects are NOT saved in the clipboard The Delete keyboard shortcut is supported on most platforms e Align The Align sub menu contains items can be used to line up objects in a view by the objects top 05 bottom LA left amp or right E faces as well as by their horizontal or vertical YE centers e To Front To Back These items move the selected object either to the front or the back of the objects in the view To Front ensures that no other objects will appear on top of the selected objects To Back ensures that the selected objects will not appear on top of other objects e Scale Drawing This item allows the user to change the default scaling of a drawn component Drawn componen
84. r more information on the SNAP applications refer to Chapter 2 The ModelEditor Chapter 4 Job Status Chapter 3 The Configuration Tool Chapter 6 The Calculation Server Chapter 7 The Animation Plug in 1 SNAP User s Manual Chapter 2 The ModelEditor The ModelEditor is the primary SNAP client application With it a user may both design input for analysis codes and display animated representations of calculation results The ModelEditor provides a consistent interface regardless of the analysis code in question 2 1 The ModelEditor User Interface SNAP s ModelEditor user interface is illustrated in Figure 2 1 ModelEditor UI The primary components are labeled and a brief description of each is provided below Model Editor 0 25 1 File Edit Tools Window Help 5 r e Main Toolbars Ola alo gt 4 e ur Oo ga Fills 5 fet Heaters 2 0 3 Pipes 10 Hi Pipe 1 1 bkn loop hot le o EH Pipe 2 2 bkn loop st ge o E Pipe 2 24 bkn loop pump o EX Pipe 11 114 int loop st g o i Pipe 12 124 int loop pu EF Pipe 21 214 int loop acc o EX Pipe 41 414 int loop c le o EX Pipe 42 424 int loop c le eli 43 jrit loop c le __Navigator 848 moon ar Pumps 2 Pipe 1 1 bkn loop hot leg pipe 52 peserinton lt none gt EXP Comments lt none gt Ex Pl Friction Crezen vo1 Lal Main Properties View MA Pine THE NeAcen v P gt Primary system Steam Generators AAA AAA ATA AAA AAA
85. re 2 3 Example Navigator View that there are 33 hydraulic components and two of those components are pumps Note A model s name will appear surrounded by a pair of stars if that model has changes that need to be saved Notice that in Figure 2 3 Example Navigator View that the model unsaved named as such specifically for this example has unsaved changes while W4Loop med does not 5 SNAP User s Manual The ModelEditor User Interface 2 1 4 oleja E TRACE models o unsawed funnamecd j W4Loop med tv4loopnewH E Model Options YE Hydraulic Components 22 o MW Breaks 2 ll Channels 0 Fills 5 fet Heaters 0 o i Pipes 10 o 2 Plenurns 1 67 Pumps 2 o Gr Pump 4 44 bkn loop pump Gr Pump 13 612 int loop pump o Prizers 1 El Separators 0 Single Junctions 0 of Tees 8 4 Turbines 0 O p4 Valves 2 I jet Pumps 0 o ff vessels 1 o M4 Control Systems 10 GE Thermal 48 o e Power Components 1 lA CCFL Models 0 Edit Tools Window Help viel Plug in Node Main Categories Model Node Components th Contains 0 PE Exterior 0 Component o E Connections 94 User defined Connections o fx Numerics 0 Constants and o Views 2 Equations Views Figure 2 3 Example Navigator View The Main Property View The
86. re MO M9 Note At this time only the property CURRENT the current model can be changed e LOGFILE filename The logfile command is used to specify a file where messages are logged The filename should include the full path to the log file e MACRO lt Mn gt filename Where Mn is defined as one of the ten valid model labels numbered MO M9 Where filename is the file name which should include the full path to the file in quotes This command executes the python macro contained in the specified file e LOCK VIEWS lt Mn gt Where Mn is defined as one of the ten valid model labels numbered MO M9 This command will lock all of the views for the specified model The current models views will be locked if the model label is not specified e UNLOCK VIEWS lt Mn gt Where Mn is defined as one of the ten valid model labels numbered MO M9 SNAP User s Manual 32 Batch Command Syntax This command will unlock all of the views for the specified model The current models views will be unlocked if the model label is not specified Plug in Specific Commands In addition to those commands listed above each ModelEditor code plug in can support plug in specific batch commands Plug in specific batch commands must be prefixed with the plug in ID of the plug in that will interpret 1t For example a TRACE import command would look like the following TRACE IMPORT ASCII_FULL trace_model inp Inline File Arguments Some plug in spec
87. ring and is not supported by all plug ins e Show Create Views Dialog When set to true a Create Views dialog will be displayed for each model imported into the ModelEditor e Show Welcome Dialog This option controls the appearance of the welcome dialog at the ModelEditor startup e Always Use Anti Aliasing When set to true all drawings in 2D Views will be anti aliased some drawings are always anti aliased Anti aliasing greatly improves the appearance of most drawings by smoothing the curves and rough edges Anti aliasing incurs a performance cost so turning this off may result in better 2D View scrolling and repaint performance e Xpdf Executable Sets the location of the xpdf executable used to display PDFs on UNIX systems This option is not available on Windows installations of SNAP 2 2 2 Color This section lists the different colors assigned to various components inside of a view There are two ways to modify a color preference The first is to click on the box displaying the color as it would appear and select a new color from the drop down menu Second a user can click on the text field to the left of the color box which displays the color as three integers under the RBG color scheme Changing these numbers and pressing Enter will change the color to the corresponding color in the RBG scheme 2 2 3 Window Arrangement This option can be set to single or multiple When set to multiple window arrangement the message
88. rt Tool drop down menu under the Annotations sub menu Fill State Controller Pressure Void Fraction Figure 2 17 Annotations Example The Views item also appears in the Annotation menu for convenience This item creates an embedded view icon that can be used to drill down to the view it represents Annotation O Ellipse Control Systems a image I Exterior A Line Hydraulic Components Y Polygon Numerics d Thermal O Rectangle T Text Annotation views Figure 2 18 Adding Annotations from the View Toolbar The following types of annotations are included with the ModelEditor and available for use in any view More information about the specific properties of each annotation type can be found in the pop up help buttons to the right of each property in the Main Properties View Ellipse The ellipse or Elliptical Annotation is a very simple rounded shape with an optional filled center When inserting an ellipse left clicking will insert an ellipse of the default size To insert an ellipse of a specific size left click and drag to create a rubber band box that is approximately the desired size and release the mouse button The following properties can be specified for an Elliptical Annotation e Height The vertical height of the annotation in pixels e Width The horizontal width of the annotation in pixels SNAP User s Manual 20 Image Line Creating a Model Fill Background When this property is set
89. s open detailed custom dialogs for editing components and for selecting other model components where appropriate Current Selection Il Channel 1 5 2 Attribute Group General Display Options Disabled omponent Marne unnamed i Help Buttons hannel Number z Custom Editors AH 0 etted Perimeter 125 7 in nominal channel The nominal channel area Soren 0 AE O e gt We aan ce eases ba Attribute Descriptions Figure 2 4 Example Property View Note A separate Property View can be opened for individual components by double clicking on the component in either the Navigator or a 2D View The same separate Property View can also be opened by selecting the Properties item from the right click pop up menu of the component in either location 2 1 5 2D Views 2D views are a convenient way to visualize a model Model components can be laid out on the view in a logical fashion and connections between components can be created and modified in an easy graphical manner Views also support annotation features including text and simple graphic shapes allowing the user to build an image that represents the model of interest in a clear and visually appealing fashion For more detailed information on annotations see Section 2 3 3 Creating Annotations A 2D View can be embedded in other views to allow the user to drill down into mor
90. stJob out idx FILE OUTPUT_RDX TestJob out rdx FILE OUTPUT TestJob out FILE RESTART _IN TestJob rst FILE RESTART TestJob tpr FILE _RST_DUMP TestJob dmp FILE SCREEN_IDX TestJob screen idx FILE SCREEN TestJob screen FILE TRACEIN TestJob tsp FILE TRCDIF TestJob dif FILE TRCEXT TestJob extr FILE TRCH20 TestJob h2o FILE TRCINP TestJob echo FILE TRCSNI TestJob sni FILE TRCSNO TestJob sno FILE TRCSTATS TestJob stats CJFs created by external applications must include the following e CJF The header in the correct format e NAME The name of the job including only letters numbers underscores and hyphens e PLUGIN The plug in ID of the plug in that will be used to access this job e g RELAPS TRACE COBRA EXTDATA e FILE _MUX The multiplexed data file used by this job SNAP User s Manual 80 Index A analysis codes 1 C Calculation Server demux executable 40 executables 39 check model main menu 4 checking for updates 36 configuration Calculation Server 37 general properties 36 saving 36 web support 40 F file operations main menu 4 main toolbars 4 J jEdit export from main menu 4 M main property view 6 attribute groups 6 cuomponent selection button 7 custom editor button 7 disabled check box 7 help button 6 memory toolbar 4 models name 5 N navigator 5 plug in node 5 pop up menus 5 P prop
91. stack specific properties 1 Opaque Nodes When this is set to False nodes that do not have channels specified will be transparent 2 Draw Outline When this is set to true a line border will be drawn in the foreground color around each element in the stack and around the entire stack 7 8 4 12 Vessel Rings Figure 7 45 Vessel Rings Bean The Vessel Rings Bean is a series of concentric circles each divided into azimuthal sectors The Rings may have any number of rings and each ring may have any number of azimuthal sectors Each azimuthal sector is assigned a volume number and the first sector may include an offset angle indicating where it begins around the circle Optionally regions that have no volume number may be transparent appearing as a void in the volume 7 8 4 13 Volume Stack This bean is a 2 dimensional stack of Single Volume beans This bean differs from the Stacked Element only in that Volume IDs are selected for each element rather than channel names 73 SNAP User s Manual 74 Chapter 8 Using the jEdit Plug in jEdit is a pure Java programmer s text editor that was chosen for use with the SNAP system because of its stability and multitude of features The built in support for syntax highlighting definitions and extensible plug in architecture make it a very valuable tool when working with ASCII formatted input files For a detailed listing of jEdit s available features see the jEdit homepage at http jed
92. t will be animated by the bean Display beans that use a single data channel will most often use the channel selector shown in Figure 7 12 Channel Selection Dialog Beans that use multiple data channels such as the Axial Plot bean include more customized selectors for the bean type SNAP User s Manual 60 Display Beans Available Channels Showing 166 of 5764 possible httemp 336000217 httemp 336000301 httemp 3360003517 httemp 336000401 httemp 336000417 httemp 336000301 Figure 7 12 Channel Selection Dialog e Volume ID The Volume ID property is used by some Display Beans to to animate sets of data channels based on the current type of the Range selected for the bean This is most often used for properties such as void fraction liquid temperature and fluid conditions where the data channel names can be implied based on the Volume ID and range type In these cases the client code plug in for the analysis code being animated is responsible for determining the required data channels Note Beans that use the Volume ID property do not use the Channel Name property and vice versa e Tooltip Text This is the tooltip that is displayed when the mouse is over the bean Optionally this tooltip text can be a valid HTML document but if so it must include the lt htm1 gt and lt html gt tags e Command Menu The command menu an easy way to send interactive commands to a calculation during animation This feature all
93. te These items allow view templates to be imported and exported for a view A View Template is a file that contains the annotations component locations etc required to reproduce a view inside of another similar model This allows detailed 2D views to be duplicated easily between models This can also be used to preserve complex views for a model that must be modified outside of the ModelEditor and re imported e Trim Excess Canvas This feature removes the unused canvas space inside a view This allows a view to be set to a very large size by the during the initial creation and layout and trimmed down to the minimum required size when complete e Export to jEdit This item exports the current model to the jEdit text editor Refer to Section 3 2 1 General Properties for more information about configuring jEdit for use by the ModelEditor SNAP User s Manual 12 User Preferences 2 1 6 The Message Window The Message Window displays a running list of error warning alert and notice messages Processes such as saving a file or checking a model will produce messages in this window Buttons located along the right side of this window are used to clear the window export selected messages to a file or copy selected messages to the clipboard Warning Error Motice A ME Es Copy F Tee 18 Loop closure is wolated along the following path 18 gt 28 gt 18 Clear Ba Loop Closure Failed max error 2 186595 145371091 m p
94. the local server to startup when needed by local client applications When not activated No the user will be prompted to startup the server instead Client applications are considered local only 1f they are running on the same computer as the server referred to as localhost and running as the same user as the server This property will enable the local server to startup automatically e when submitting a job e when browsing the local server via Job Status e when selecting a run for an animation from the local server e when connecting an animation to the local server Activating the Start Server Automatically preference enables the Server Idle Time preference Server Idle Time The maximum amount of time in minutes that the Calculation Server will stay active while no clients are connected Specifying O for this value will prevent the server from shutting down automatically Note that the Calculation Server must be restarted for this value to take effect Use Fixed Port Port When set to Yes the Calculation Server will always be started listening to a specified port Setting this value to No indicates that the Calculation Server should use the first available port 1t finds Setting this value to No 1s recommended Changing this property does not take effect until the Calculation Server has been restarted The port number that the Calculation Server will listen on when Use Fixed Port is set to Yes This is also
95. the model To this end User Defined Constants Variables and Functions are provided The use and capability of each is detailed in the following sections The general use of numerics e A user defined constant is created to hold the value of particular properties e g a cell s diameter and length e A user defined function is created to calculate additional values e g a cell s area and volume e A user defined variable is created to hold the result of the calculation e The appropriate model properties are set to the user defined constants and variables defined With the above usage any change to the user defined constants would cause the user defined functions to be executed to update the user defined variables thus updating the model properties that were set to use the constants and variables To create a new UDN first expand the Navigator node Numerics for the current model Then right click on the User Constants User Variables or User Functions node to open the pop up menu for that Category Select the New item from the pop up menu to create a new numeric of that type 2 4 1 Constants and Variables User Defined Contants UDC are symbolic names that may be used in place of entering floating point values for model parameters These constants are useful for holding values that will be SNAP User s Manual 26 User Defined Numerics changed for parametric runs A Parametric export means that variables that are ide
96. the only time that the Port parameter is available Changing this property does not take effect until the Calculation Server has been restarted SNAP User s Manual 38 Configuration Tool Properties Max Concurrent Jobs Sets the maximum number of jobs that the Calculation Server will execute simultaneously Any other jobs submitted after this maximum has been reached will wait in a job queue for the first available opening Logging Level This parameter determines the level of detail used in writing information to the calculation log files Maximum Log Size The maximum size in bytes of the log files created by the calculation server After reaching this limit the current log file will be renamed calculation_server_1 log and logging will continue in a new calculation_server log An unlimited log file size can be set by specifying O for the maximum size Changing this property does not take effect until the Calculation Server has been restarted Executables The executable definitions for the Calculation Server To submit a job to the Calculation Server for a particular plug in at least one executable must be defined for that plug in To add an executable l Click the E edit button next to the Executables attribute This will open the Edit Executables dialog and allow the executables to be added removed and modified 2 Click the Add button near the center of the dialog This will create a new executable in the list in t
97. tically the section called Start Server Automatically The Target Folder must be selected next by pressing the 5 button This will open a folder selector for the selected server If the target server is the local calculation server then the mount and unmount folder pop up items will be available in this folder selector Refer to Section 4 3 Root Folders for a more detailed description of root folders A Select The Target Folde r E Selected Folder Tutorial o Al localhost 5 006 gt c Tutorial Figure 5 2 Target Folder Selector The next section of the dialog is Run Options This section includes Name Priority Interactive and Start Paused Name is the requested job name If no name is specified by un checking the check box to the left then a name will be automatically generated using the plug in name and the current date time If a job already exists with the requested name an overwrite confirmation will be shown to allow the existing job to be deleted before submission Note Additional run options may be included by the server code plug in These plug in specific options will appear just below the Start Paused option For example the TRACE plug in includes the No Dif No Rand and Run Stats boolean run options not shown The Priority property controls the order that jobs will be started on the Calculation Server Higher priority jobs larger priority will be started before lower priority jobs The I
98. ting TRACE models Pipes are located in the Hydraulic Components category while User Constants are located under Numerics Once the appropriate component type has been selected the button to the left of the drop down menu button changes to the icon of that component type and the view cursor changes into a crosshair Left click within the 2D View to insert the component This may open a completion dialog for the component before it is inserted into the View The Select Tool will be automatically activated after the insertion is complete to allow the newly created component to be moved or resized Holding the control key when left clicking to insert a component will leave the Insert Tool active allowing multiple components to be created without reactivating the Insert Tool for each SNAP User s Manual 18 Creating a Model Annotation Control Systems ICE Exterior Hydraulic Components Breaks Thermal d A Fills fet Heaters E4 Pipes 3 Plenums Gr Pumps 7 Prizers Ed Separators lt Single Junctions dh Tees Turbines tt Valves A Jet Pumps ft Vessels Figure 2 15 Adding TRACE Components from the View Toolbar The second notable method of inserting a component involves the Navigator as illustrated for a Fill component within a TRACE model in Figure 2 16 Adding TRACE Components from the Navigator First expand the component category of the desired component in the example this is Hydraulic Components Next right
99. tive arrowhead size can be specified as well as the line color f 1 i i i i i 1 1 i 1 i i i i i i 1 1 1 m m m m ee ee ee es ed yY e m i i e e e Figure 2 19 Line Annotation Examples Inserting a line annotation is a process of defining the line segments that will make up the line The first left click will begin the line Moving the mouse will show that a rubber band line is drawn to the previous point in the line Left clicking again at another location will create a line segment and begin drawing the rubber band line to that location Additional left clicks will create 21 SNAP User s Manual Creating a Model more line segments Double clicking with the left mouse button will complete the last segment and insert the line annotation using the defined segments At any point during the insertion process the right mouse button can be used to remove the previously added point If there is only a single point defined then this will cancel the line insertion Once inserted the points that make up a line may be relocated by left clicking and dragging the red rectangular handle around the point In addition the right click pop up menu of the line includes the Add Point and Remove Point menu items The Add Point item can be used to add a new relocatable point anywhere on the line The Remove Point item can be used to remove all but the first and last points of a line Note that the Remove Point item is only avail
100. to True the ellipse will paint its center using the Background Color specified When this property 1s set to False the center of the ellipse will be transparent Background Color The color used to fill the center of the ellipse when Fill Background is True Outline Color The color used to paint the outline of the ellipse Line Thickness The thickness of the line drawn around the outline of the ellipse The image annotation allows an image to be displayed inside a view and it is inserted with a simple left click Newly created image annotations will display the default light bulb image The following properties can be specified for an Image Annotation Height The vertical height of the annotation in pixels Width The horizontal width of the annotation in pixels Border An optional border can be specified for an image annotation Etched line and beveled borders are available using the provided border editor Image The Image property is used to select the image to display Once selected this image data will be loaded directly into the annotation and stored with the view Tooltip Text The image annotation includes optional tooltip text This text 1s displayed when hovering the mouse over the image Some simple HTML tags may be specified for this property but must be surrounded by lt html gt lt html gt tags Line annotations are lines with optional filled or hollow arrow heads and dashing The line thickness and rela
101. ts may be scaled by length and width Adjusting the sliders in the Scale Drawing dialog will cause the on screen display of the object to update to reflect the new scale The user may also choose to simply enter the scaling factors by hand in the available text boxes This scaling only affects the visual display of the component the underlying geometry data is unchanged Note In some cases it may be more convenient to use the 2D View scaling described in Section 2 3 4 Component Display Scaling SNAP User s Manual 10 The ModelEditor User Interface gt scale Drawing Length Scale Factor 4 96 Width Scale Factor 6 76 Preserve Ratio Figure 2 7 Scale Drawing Dialog Organize If more then one object is selected the Organize menu item may be used This item will apply the code plug in s layout algorithm to try to arrange the selected items in a visually clear way Drawing organization is a plug in specific operation that may not be supported by all code plug ins Redraw Sometimes the graphical views display is not automatically updated when a change to the model is made in another view This item will cause the current view to be redrawn to reflect the current state of the model and its components Print View Menu The items in this menu allow the view to be printed The Entire View item will print the entirety of the view regardless of the current zoom scale or pan location The Current Perspective item wi
102. ulation Servers refer to Section 4 4 Adding a Remote Server e Remove Server Removes the server currently selected in the Job Navigator e Exit Exits the application View e Job Table Check Boxes Various columns in the Job Table can be hidden or shown with the check boxes found in the View menu e Refresh Refreshes the status of all components in both the Job Navigator and the Job Panel Tools The tools menu contains entries specific to the currently selected job e Console Output Displays the Console View detailing the status of the selected job This option is only available for calculations that are currently active i e running interactive paused etc e View Output Displays a list of viewable files for the selected job For some jobs this list may be empty This option is only available when the job has been loaded e Plot Opens the selected job file for plotting The application used to open the file is specified by the AcGrace Executable property in the Configuration Tool see Section 3 2 2 Calculation Server Properties This option is only available when the job has been loaded e Demultiplex Produces a demultiplexed copy of the selected job file The application used to demultiplex the file is specified by the DeMUX Executable property of a plug in executable see Plug In DeMUX Executables This option is only available when the job has been loaded 43 SNAP User s Manual Root Folders
103. y user interface e MESSAGE message Where message contains a quoted string to be displayed to the used The MESSAGE command can be used to display a single quoted message to the user in a popup dialog with an OK button This batch command will stop the batch file process until the user presses OK e CHECK_MODEL This performs a model check in an identical manner to the Check Model button on the main toolbar This is useful for a batch verification of a large number of models e EXIT The exit command is used to close the ModelEditor This should be used at the end of a batch file to ensure that the ModelEditor process does not continue running If the batch file contains the show command this will close the user interface as well e OPEN lt Mn gt filename Where Mn is defined as one of the ten valid model labels numbered MO M9 The open command is used to open a MED med file in the ModelEditor Upon opening the new model becomes the current model Optionally the user may declare that the model inside that file should be identified with one of the ten labels Acceptable values for the label field are MO through M9 Until that model is closed it may be accessed using its label in following batch commands The last parameter is the file name and should include the full path to the file e SAVE lt Mn gt filename Where Mn is defined as one of the ten valid model labels numbered MO M9 31 SNAP User s Manual Batch Comma

Download Pdf Manuals

Related Search

Related Contents

LE SPANC mode d`emploi - Communauté de communes des 3    Manual del Propietario  Cisco IPS License SA500  FUNAI FP206G Owner's Manual  Lepow X Combined Type Power Bank  Bosch Appliances Home Security System LBB 4172 User's Manual  FBL-20601-LS17  RelacaoItens15303305000232015000  LINEAR ACTUATORS AND ELECTRONICS  

Copyright © All rights reserved. Failed to retrieve file