Postprocess menu ~~~~~~~~~~~~~~~~ The most options of CompassFEM Postprocess are available in its menu. In this section all these options are described. .. figure:: img/post_menu_img.png :align: center CompassFEM Postprocess menu. The most options available in this postprocess can be used from this menu. Start and End ------------- :guilabel:`Start` and :guilabel:`Start traditional post` open CompassFEM postprocess and GiD postprocess respectively. :guilabel:`End` menu option closes postprocess and opens GiD preprocess again. In order to toggle between pre and postprocess the following icon in the main toolbar must be pressed: .. figure:: img/pre-post_button.png Only `binary2` and `ASCII` result formats can be read in CompassFEM postprocess, so that if `binary` result format has been selected when analysis was performed, a dialog box will appear to open `Traditional postprocess`. Open GUI -------- It shows the :guilabel:`Postprocess data tree`. .. figure:: img/postprocess_data_tree.png :scale: 80% :align: center :guilabel:`Postprocess data tree` is opened using :guilabel:`Open GUI` menu option. Toolbar: |open_gui_button_ref| .. |open_gui_button_ref| image:: img/open_gui_button.png The toolbar button shows the :guilabel:`Postprocess data tree` if it is hidden and hides if it is visible. Clear ----- It removes all information in postprocess such as meshes, results an other elements as information boxes. .. _create_cut_plane: Create cut plane ---------------- A panel appears in :guilabel:`Postprocess data tree` that allows to cut a volume or a surface. It is possible to define the cut plane by three ways: .. figure:: img/cut_plane_pane.png :align: center :scale: 80% Cut plane panel. It is possible to define the cut plane by three ways: - `In screen`: picking two points in the screen a line will be created. The plane will contain this line. If this option is used, It must be chosen to use global axis as a normal vector to the cutting plane, or chosen the cutting plane is orthogonal to the current view. - `Three points`: the cut plane will be defined by three points. - `Two points`: the cut plane will contain the two defined points and will be orthogonal to current view. .. figure:: img/example_cut_plane.png :align: center Cut plane example. Contextual menu ^^^^^^^^^^^^^^^ If a solid of shell element is selected with the right button of the mouse, contextual menu will have an option for creating cut planes. .. figure:: img/menu_contextual_cut_plane.png :align: center Cut plane contextual menu option. Cut plane preferences ^^^^^^^^^^^^^^^^^^^^^ Please, see :ref:`Preferences data tree manual ` for more information about the cut plane preferences on the panel. Create isosurface ----------------- This option draws a surface or a line passing through all the points which have the same selected result's value inside a volume mesh, or surface mesh. For doing it, a result must be chosen and a value must be indicated to create a isosurface. .. figure:: img/isosurface_pane.png :align: center :scale: 80% Isosurface panel. It is necessary to chose a result of the list and enter a value within the range of the result values. .. figure:: img/example_isosurface.png :align: center :scale: 80% Example of isosurface. Velocity of 1 m/s. Create flow patterns -------------------- Postprocess allows to create flow patterns when there are fluid results. At least, it is necessary a fluid velocity result, but there can be fluid density result too. There are three types of flow pattern that can be created. Following, these three types are described. Types of flow patterns ^^^^^^^^^^^^^^^^^^^^^^ .. _postprocess_streamlines: Streamlines """"""""""" :guilabel:`Postprocess >> Create flow patterns >> Streamlines` Streamlines are a family of curves that are instantaneous tangent to the velocity vector of the flow. These show the direction a fluid element will travel in at any point in time. .. figure:: img/example_streamlines.png :scale: 60% :align: center Front view of streamline at 101 s. Pathlines """"""""" :guilabel:`Postprocess >> Create flow patterns >> Pathlines` Pathlines are the trajectories that individual fluid particles follow. These can be thought of as a "recording" of the path a fluid element in the flow takes over a certain period. The direction the path takes will be determined by the streamlines of the fluid at each moment in time. .. figure:: img/example_pathline.png :scale: 60% :align: center Front view of pathlines. Particle tracking """"""""""""""""" :guilabel:`Postprocess >> Create flow patterns >> Particle tracking` Particle tracking is the observation of the motion of individual particles within a fluid. Below an example of particles tracking, which have used the following parameters, is shown: - Average of particles volume: :math:`1\ mm^3` - Standard deviation of particles volume: :math:`0.05\ mm^3` - Average Drag coefficient: :math:`0.5` - Density of particles: :math:`1010\ kg/m^3` - Density of fluid: :math:`1000\ kg/m^3` - Activate bounce: `true` - Initial velocity: `Use fluid velocity` - Gravity: :math:`(0, 0, -1.0)\ Magnitude:\ 9.80665\ m/s^2` .. figure:: img/example_particle_tracking.png :scale: 60% :align: center Front view of particle tracking calculated with parameters shown above. Creation and management of flow patterns ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ It is possible to draw flow patterns in two ways: 1. Selecting a mesh with the right button of the mouse and flow pattern option of contextual menu. The selected mesh must be the fluid domain or be related to the fluid domain (for example the inlet). If the chosen mesh is the fluid domain and it is plane, it must be in the Z plane. .. figure:: img/flow_pattern_contextual_menu.png :align: center :scale: 80% Contextual menu to create flow pattern. 2. Selecting the menu option. This menu option allows to choose the type of flow pattern, streamline, pathline or particle tracking. A pane placed in the postprocess data tree allows to configure the flow pattern: 1. First of all it is necessary to select the scope of the flow pattern to create, `Single particle` or `Area`. a) `Single particle`: a flow pattern of a particle will be drawn. If the flow pattern tool is selected by the contextual menu, the initial position of the particle will be the point where the mesh was selected. The initial coordinates are shown in the frame when this option is selected and it can be changed using the button at the right of the coordinates. The coordinates units are the same of the mesh ones. On the other hand, if the flow pattern tool is selected by the menu, the particle coordinates must be selected using the button. b) `Area`: this option allows to create an area filled of particles. For using this option, a plane mesh must be selected (for example the inlet or a cut mesh). If flow pattern tool is selected using the contextual menu, the selected mesh will be used for creating the filled area of particles. If the menu is used, a mesh must be selected using the button at the right of the Plane mesh name. A boundary square around the mesh is calculated and it is filled of particles. The spacing between particles must be defined in the frame. The unit of the spacing is the same of the mesh one. 2. The next selector allows to choose the type of flow pattern to create. Although a type of flow pattern was selected using the menu, it is possible to change the type of flow pattern using this selector. 3. According to the type of flow pattern different options are available: a) Streamline: a step time must be chosen among all steps calculated by the program. .. figure:: img/streamlines_panel.png :align: center :scale: 80% Streamline panel. It is necessary to choose a step value to create streamlines of this step. b) Pathline: there are not more options. .. figure:: img/pathlines_panel.png :align: center :scale: 80% Pathline panel. It is necessary to choose a step value to create streamlines of this step. c) Particle Tracking: there are four groups of parameters: .. figure:: img/part_tracking_panel.png :align: center :scale: 80% Particle tracking panel. Particle parameters: if `Single particle` option is selected, the particle parameters will be: * Volume * Density * Drag coefficient Area parameters: if `Area` option is selected, the particle parameters will be: * Volume average of the particles * Standard deviation * Density * Drag coefficient average The volume of each particle will be a random number from a Gauss distribution, and its drag coefficient will be calculated according its volume and the drag coefficient average. * Bounce: If this option is selected, particles will bounce off the mesh limit. * Fluid density: - Use density result: if there is a fluid density result selected in preferences (see Annex II: About the postprocess results file) Use density result can be selected or not. If not, Use density result cannot be selected. If it is unselected, a fluid density value must be defined. These values will be used for all particle tracking, thus it is strongly recommended to define these values for the first flow pattern and not to change them during all session. * Initial Velocity: - Use fluid velocity: if this option is selected the initial velocity of the particles will be the fluid velocity in their initial positions. If not, initial velocity of particles has to be defined by the user. These values will be used for all particle tracking therefore it is strongly recommended to defined these values for the first flow pattern and not to change them during all session. * Gravity: It is necessary to define gravity to calculate particle tracking. If this value is changed, then all particle tracking defined previously are removed. .. figure:: img/part_tracking_gravity.png :scale: 80% :align: center Gravity for particle tracking panel. If this value is changed, then all particle tracking defined previously are removed. When all parameters are configured, the flow pattern is created. New point meshes are created for pathlines and particle tracking and for each step of streamline selected. Moreover, new results of displacement and velocity are created using the same classification. .. figure:: img/Mesh_Results_Panel_Flow_Pattern.png :align: center Meshes and results panels with meshes and results of created flow patterns. .. figure:: img/example_flow_pattern.png :align: center Example of pathlines in a Abdominal Aortic Aneurysms Flow patterns preferences ^^^^^^^^^^^^^^^^^^^^^^^^^ There are some preferences related to flow patterns in Preferences selector. Please, see :ref:`Preferences data tree manual ` for more information about the flow patterns preferences on the panel. Create copy mesh ---------------- :guilabel:`Postprocess >> Copy mesh` Copy mesh allows to copy a mesh, a group of meshes or a set of elements of a mesh and apply a movement or symmetry to copied elements. The new meshes inherit the results of the original meshes. This command is very useful when the model used for calculating the results is a half or a fourth of the real model, and it is necessary to show the results of the complete model. For example, the following model is calculated using the half of the real model. Therefore, both meshes are copied and a symmetry movement is applied. Below, the imported meshes from preprocessor (green) and the copied meshes (red). .. figure:: img/copy_mesh_example.png :align: center Example of copy mesh. The green ones are the original meshes and th red ones are the copied meshes. If a result is shown, it can see how the new meshes have inherited the results. .. figure:: img/copy_mesh_results_example.png :align: center Example of copy mesh with results. The new meshes inherit the results of the original meshes. A mesh, several selected meshes or a set of elements of a mesh can be copied, and it is possible to apply a linear movement or a symmetry. .. figure:: img/copy_mesh_panel.png :align: center Copy mesh panel. It is possible to copy a mesh, a group of meshes or a set of elements of a mesh, and apply a geometry transformation (movement or symmetry) Contextual menu ^^^^^^^^^^^^^^^ If an element of a mesh (beam, shell or solid) is selected with the right button of mouse, the contextual menu will have an option for copying meshes. :guilabel:`Contextual menu >> Mesh >> Copy` .. figure:: img/contextual_menu_copy_meshes.png :align: center Contextual menu to copy meshes. It appears if a mesh element (beam, shell or solid) is selected with cursor. Mesh information ---------------- :guilabel:`Postprocess >> Mesh information` This command shows information of the following entities: * Point * Node * Element * Minimum and maximum result * Mesh .. figure:: img/mesh_information_panel.png :align: center Mesh information panel. It allows to get information about points, nodes, elements, etc.... Depending on the selected item, the panel has different options. If the selected entity type is `Point`, `Node`, `Element` or `Minimum and maximum result`, the most important information options are: * `Signal`: it is useful to find an entity in the screen. * `Information box`: an information box is shown with information of the entity as its position or its result value (if a result had been selected before using this option). * `Detailed information`: more information of the selected entity can be show with this option, for example, the area or the volume of a mesh. .. figure:: img/detailed_information.png :align: center Detailed information of a mesh. It is possible to know detailed information of `Point`, `Node`, `Element` or `Minimum and maximum result` * `Rotation center`: * `Time graph`: if the performed analysis is dynamic or nonlinear, this option creates a graph with the selected result information evolution in a point, node, element or the minimum and maximum result. .. figure:: img/time_graph.png :scale: 80% :align: center Time graph of the selected result at a point and its contextual menu. `Contextual menu of Time graph` allows to modify physical appearance of the graph, export and import. Advanced menu has several options and one of them allows to calculate Fourier transform of the time graph. When `Fourier transform graph` is selected, a dialog window allows configuring its appearance. .. figure:: img/Fourier_dialog_window.png :scale: 80% :align: center `Fourier graph dialog`. it allows to configure the graph. `Fourier transform` will calculate from X initial value to first change of X increment, since it is possible to calculate `Fourier transform` if X increment is constant. .. figure:: img/Fourier_graph.png :scale: 80% :align: center When `Fourier graph dialog` is closed, a new graph is created with the `Fourier transform` of the original graph. If the entity type is a Mesh, the most important information options are: * `List entities`: it allows to create lists of nodes (coordinates of all nodes), elements, or result value of all nodes. It is necessary to select a result previously to show the result value of nodes or elements. It is also possible to export the shown list to file. .. figure:: img/list_entities.png :align: center List entities window. It allows to create lists of nodes (coordinates of all nodes), elements, or result value of all nodes. * `Mesh quality`: it shows the quality of a selected mesh, for example the minium and maximum angle. This option is not available por linear and hexahedra meshes. .. figure:: img/mesh_quality.png :align: center Mesh quality window. It shows the minimum and maximum angle and a graph of element angles. This option is not available por linear and hexahedra meshes. * `Hide elements`: it allows to hide a selected group of elements. When this option is closed, then the hiden elements are shown another time. Contextual menu ^^^^^^^^^^^^^^^ If an element is selected with the right button of the mouse, contextual menu will have several options for knowing mesh information. * `Point information`: it gives an information box about mesh entities and results when pressing on a point (data about the point and the result over it). Moreover, more detailed information can be shown when clicking on the box, also data on nodes and Gauss points, integrations over sets (both in global and local axes), local axes drawing, etc. For surfaces, local axes will have z' axe as normal. For lines, x' axe will be tangent to line. For line cuts, z' axe will also be normal to surface. * `Node information`: it gives information about the coordinates of the selected node. :guilabel:`Contextual menu >> Mesh >> Mesh information`: it opens the `Mesh information` panel with the mesh options. .. figure:: img/contextual_menu_mesh_information.png :align: center Contextual menu allows to select `Point information`, `Node information` and `Mesh information`. Create text box ---------------- :guilabel:`Postprocess >> Create text box` A text box is shown at the bottom of the screen with the selected combination loadcase, result and, if it is possible the time step or load step. .. figure:: img/text_box.png :align: center Text box with the selected combination loadcase, result and, if it is possible the time step or load step. It is shown at the bottom of the screen. Frequencies ----------- :guilabel:`Postprocess >> Frequencies` This options is only available when a modal analysis has been opened in Postprocess. It opens a dialog box with frequencies and modal mass participation of calculated frequencies. Please, see :doc:`Ramseries Dynamic Conditions manual <../ramseries/chap6_dynamicConditions.rst>` to know how configure a modal analysis. .. figure:: img/frequency_dialog.png :align: center Frequencies and modal mass window. It is only available in modal analysis. Computer animations ------------------- :guilabel:`Postprocess >> Computer animations` Once Postprocess is opened with a results file loaded, some animation templates are available in the `Postprocess >> Computer animations` menu. .. figure:: img/menu_animations.png :scale: 60% :align: center Postprocess menu with the available animations. In this menu there are as many animations available as there are xml files in the folder `folder_distribution/problemtypes/compassfem.gid/animations` It is important to note that the `animations` folder (`problemtypes/compassfem.gid/animations`) of the installation directory offers various default template files in XML format which are provided to be used for creating new animations automatically. Furthermore, it is possible to add new template files into the `animations` folder of the installation directory for designing special animations in other particular models. Nowadays, the following animations are available: * `Seakeeping animation` * `Towing animation` * `Windturbine nacelle` * `Windturbine nacelle seakeeping` If the user opens the `problemtypes/compassfem.gid/animations` folder he will notice that there are xml files that do not appear in the `Postprocess >> Computer animations` menu. Each of the files contains the following text: .. code-block:: Each animation file with enabled=1 is added in the menu. Therefore, the user can activate the most useful animations. Seakeeping animation ^^^^^^^^^^^^^^^^^^^^ It is possible to perform animations with multiple bodies (100 or 200 or more). To perform this animation, it is necessary to open a model calculated by SeaFEM with as many body meshes and body results as bodies must be moved in the animations. Body meshes files must be named according this pattern `BodyN.msh` where `N` is the number of the body. Similarly, body movement results files must be named according this pattern `BodyMovements_animations_N.res` where `N` is also the number of the body. However, the first body movement results file must be named `BodyMovements_animations.res`. All these files must be stored in the SeaFEM analysis folder. When :guilabel:`Postprocess >> Computer animations >> Seakeeping animation` is selected, All bodies meshes and movement results are read and animation is created. .. figure:: img/example_multiple_bodies_animation.png :align: center Example of multiple bodies animation. If `Play` button is pressed, bodies are moved. Compose reactions ----------------- :guilabel:`Postprocess >> Compose reactions` This command is available for structural models. It calculates total reactions in a model. When this menu option is selected, the following window is opened: .. figure:: img/react_selection_panel.png :align: center This panel allows to select nodes, elements or meshes. In this context, this selection will be used to compose reactions. When `List result` is selected, then all reactions and their sum is shown: .. figure:: img/compose_reactions.png :align: center `List entities' window shows nodes with reactions, and their sum.