OOF2: The Manual

3.16. Analysis

The analysis page provides tools to examine the state of the physical system modelled by a given mesh. The data can be output directly, for examination or plotting by other software, or it can be examined by one of the provided statistical tools.

Figure 3.25. The Analysis Page

The Analysis Page

The anatomy of the page is shown in Figure 3.25. It begins with widgets for choosing which Mesh will be the source of the data. Below the Mesh Chooser is the Time Control, which selects the time at which the data will be extracted from the Mesh. The main part of the page consists of four panes, Output, Operation, Domain, and Sampling, which define the analysis operation. At the bottom of the page are the Named Analysis pane, which allows analysis settings to be saved and restored; the Destination pane, which determine where the results of the analysis are displayed or stored, and the Go button, which performs the analysis.

Time Control

Figure 3.26 shows the Time Controls from Figure 3.25. The central box displays the selected time. A new time can be selected by simply typing it into the box, or by using the buttons on either side. The buttons can only change the values to times that are stored in the Mesh, but any time between the Mesh's earliest and latest times can be typed into the central box. If the box contains a time that's not stored, the analysis will be based on interpolated Field values.

Figure 3.26. The Time Control Widgets

The Time Control Widgets

Output Pane

This pane selects the output data which will be sampled on the mesh. The result is one of the available output types. The buttons at the top of the pane, labelled Scalar and Aggregate, determine whether the pull-down menus below them list the scalar outputs (e.g, a component of a Field or Flux) or aggregate outputs (e.g, all of the components of a Field or Flux).

Operation Pane

The operation pane determines what actually happens when the Go button is pressed. The operation is one of the OOF.Mesh.Analyze menu items.

Domain Pane

The region or subset of the Mesh on which the operation should be performed is selected here. The selection will be one of the Domain types.

When the domain is set to Cross Section, the pane will look like Figure 3.27. Cross sections are lines drawn through the Microstructure. They may begin and end on interior points or on edges. Existing cross sections may be selected with the chooser. New cross sections may be defined with the New button, which brings up a dialog box in which the coordinates of the endpoints must be typed. New cross sections can also be created graphically using the Mesh Cross Section toolbox in the Graphics window.

The remaining buttons, Copy, Edit, Rename, and Remove do what you would expect them to do. When a cross section is removed from the chooser here, it is also removed from the Mesh Cross Section toolbox.

Figure 3.27. The Cross Section Widget

The Cross Section Widget

Sampling Pane

Outputs cannot in general be evaluated directly on the domains, they have to be evaluated at particular points on the mesh, and depending on the desired operation, the resulting pointwise data may need to be combined in some way.

The pull-down menu in the sampling pane selects a set of points on which to evaluate the output, and the result is one of the SampleSet objects.

Note that the available sample sets will depend on the current settings of the Domain and Operation panes.

Named Analyses Pane

The Named Analyses pane assigns a name to the current settings of the Output, Operation, Domain, and Sampling panes and allows those settings to be reloaded into the panes or to be used as a Scheduled Output during time evolution computations. The

As shown in Figure 3.28, the Named Analysis pane consists of a button labeled Create/Delete/etc… and a pull-down menu named Current.

Figure 3.28. The Named Analysis Pane

The Named Analysis Pane

Clicking the Create/Delete/etc… button brings up a pop-up menu containing these options:

  • Create….  Create a new Named Analysis using the current settings of the Output, Operation, Domain, and Sampling panes. A dialog box will appear asking for a name, which may be selected automatically. Clicking OK creates the Named Analysis.

    The new name must be unique among all Named Analyses on all Meshes, including any Named Analyses created on the Boundary Analysis page. If the name is not unique, <x> will be appended to it, where x is an integer.

  • Save….  Save the definitions of the Named Analyses to a file. A file chooser dialog will appear. The names list in the dialog contains all of the Named Analyses. The selected ones will be saved when the OK is pressed. Multiple names can be selected by shift-clicking in the list.

  • Delete….  A dialog box will appear listing all of the Named Analyses. Selecting one and clicking OK will delete it.

The pulldown menu labelled Current displays the name of the current settings of the Output, Operation, Domain, and Sampling panes. If no name has been assigned to the current configuration, the menu label will be blank. Selecting a name in the menu will switch the panes to the selected configuration.

Destination Pane

The Destination pane determines where the data generated by the analysis tool will be written. Data can appear in the message window, in a previously specified file, or in a new file.

The components of the pane are:

  • Destination Chooser.  The pull-down menu at the top of the pane selects a previously defined destination. Initially, the menu only contains <Message Window>.

  • New….  The New… button brings up a file selector dialog box. The mode parameter is a WriteMode and can be set to write or append. If the file already exists, write changes to OVERWRITE, to make sure you notice. Preexisting content in files opened in OVERWRITE mode will be deleted.

    If the selected file has already been used for output in this OOF2 session, the new data will be appended to it, even if it was opened in write or OVERWRITE mode, unless it has been rewound.

  • Rewind.  After rewinding an output file, any new data written to the file will overwrite its previous contents. The file will not be cleared until new data is written. This operation has no effect on <Message Window>.

  • Clear.  Remove all of the files from the list, except for the <Message Window>. Afterwards, any files opened will be treated as if they're new, so data will be overwritten if they're opened in write or OVERWRITE mode.

A file opened in the Destination pane is handled identically to a file opened as an OutputStream in the Scheduled Output page. An OutputStream created on that page will appear as a predefined destination on this page. Rewinding a file there and on this page have the same effect.

The format of the output file can be adjusted by the OOF.Settings.Output_Formatting menu in the main OOF2 window.