.. _postprocessing: Post processing =============== Once a regular analysis has been performed, the user is automatically redirected to the results page. The results page is the starting point to handle the analysis results and provide a wide range of features. General Information ------------------- The General information section is located on the top of the results page and provides useful details on the analysis, like the engine used, the timestep, the Analysis's :term:`degree of complexity` (*aka* :term:`doc`), *etc.* .. _pp_general_info: .. figure:: fig/pp_general_info.png :align: center :alt: Post-processing General Information :figclass: align-center :width: 500pt :class: screenshot Post-processing General Information Section The actions allowed from this section are (numbers refer to :numref:`pp_general_info`): 1. Shortcut to the Project's main page 2. Traceability data: Esonix internal ID and run's author Mail address 3. Technical data: Details on how was calculated the Analysis :term:`doc`, engine considered, door position considered, etc 4. Shortcut to Analysis logs ( :ref:`analysis_logs` ) 5. Relaunch postprocess 6. Dummy connections summary and creation link ( :ref:`dummny_connections` ) 7. Analysis run comments ( :ref:`user_comments` ) .. _analysis_logs: Analysis logs """"""""""""" Logs are an essential point when checking the analysis. It provides informations about the runs execution and feature several messages tagged as: * critical * error * warning * info * debug The log is filtered by default to print only the "warning" and above messages. .. _dummny_connections: Dummy Connections """"""""""""""""" When running a cabin, it is frequent that some :term:`partitions` are completely blind, featuring no :term:`connection` at all. This means that ESonix has no clue about the existence of such a partition and ESonix will therefore miss an :term:`interface`. The user has two strategies as a workaround: 1. [**advised**] Define a dummy connection in the model itself. This means add a connection with, for example, a `vent_area_i_to_j==0`. As a result, ESonix will take this :term:`interface` into account when reducing the envelops, with no effects on real results, since the connection is always closed. 2. Define a dummy connection after the analysis is performed. ESonix will be able to reclaculate the new :term:`interface`'s envelops afterwards. This is however a poor workaround compared to modifying the model, as it would have to be done after each run! however, if by mistake, the dummy connections has been forgotten from the model itself, it can be convenient to create them from the post processing page. For example, if some blind partitions exist between volumes 1 and 3 and 1 and 4, they can be defined by creating dummy connections like in :numref:`pp_dummy_connections_form`. The input cell expects a coma-separated list of volumes. If N dummy connections are to be created, 2xN volumes ID need to be input. "1,3,1,4" would therefore define two dummy connections: "1/3" and "1/4". .. _pp_dummy_connections_form: .. figure:: fig/pp_dummy_connections.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Dummy Interface Creation Form Dummy interface creation form .. _user_comments: User's Comments """"""""""""""" Users comments is a free text allowing the user to store some info about is run. Comments can be created before the run (*cf.* :ref:`advanced_parameters_paragraph` and :numref:`new_run_advanced_parameters`, item 7). They can be modified at any moment. .. _pp_downloads: Downloads --------- The "Downloads" panel gives access, once unfolded, to spreadsheets deliveries: * RAW Model spreadsheet (input) * FILLED Model spreadsheet * DeltaP envelops spreadsheet * Events Chronology and summary spreadsheet .. figure:: fig/pp_downloads.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Downloads panel Unfolded "Downloads" panel .. note:: For all the spreadsheets, index columns are repeated at the end of the grid to provide an easy way to filter the lines RAW Model spreadsheet """"""""""""""""""""" Spreadsheet uploaded by the user for analysis. Useful for traceability to recover the analysis input data. FILLED Model spreadsheet """""""""""""""""""""""" The RAW Model derived spreadsheet, as pre-processed by ESonix. This spreadsheet is useful to check how ESonix has *filled the holes* during the pre-processing phase. DeltaP envelops spreadsheet """"""""""""""""""""""""""" DeltaP envelops spreadsheet is the main delivery spreadsheet. It provides peaks information in several forms, depending on the tab: .. _interface_envelop_tab: Interface envelop tab ''''''''''''''''''''' This tab provides an envelop *per interface* (*i.e.* throughout all the load case) .. _pp_dp_spreadsheet_iface_tab: .. figure:: fig/pp_dp_spreadsheet_iface_tab.png :align: center :figclass: align-center :width: 500pt :class: screenshot :alt: Envelop per interface Envelop per interface The first two columns define the interface: * ``vol_i``: interface's Volume I * ``vol_j``: interface's Volume J The next three columns define the maximum (including negative and positive) peak occuring at the given interface: * ``lcid_absmax``: load case generating the absolute pressure peak for the given interface * ``peak_time [sec]``: time when absolute pressure peak arise * ``peak_value [bar or psi]``: signed maximum Δp occuring on the interface Then for each one of "min" and "max", the same structure is repeated: * ``lcid_min``: load case generating the minimum pressure peak for the given interface * ``time of min dP [sec]``: time when minimum pressure peak arise * ``min dP [bar or psi]``: minimum Δp occuring on the interface * ``lcid_max``: load case generating the maximum pressure peak for the given interface * ``time of max dP [sec]``: time when maximum pressure peak arise * ``max dP [bar or psi]``: maximum Δp occuring on the interface .. note:: "min" values refer to the Δp **from I to J**, whereas "max" values refer to the Δp **from J to I**. From :numref:`pp_dp_spreadsheet_iface_tab`, interface between volumes 1 and 2 (first row) has always a positive pressure pusing from I to J, whatever the load case and time. Load Case envelop tab ''''''''''''''''''''' This tab provides an envelop *per load case* (including all the interfaces). .. _pp_dp_spreadsheet_lc_tab: .. figure:: fig/pp_dp_spreadsheet_lc_tab.png :align: center :figclass: align-center :width: 500pt :class: screenshot :alt: Envelop per load case Envelop per load case The same kind of data as :ref:`interface_envelop_tab` are provided. Load cases detailed tabs '''''''''''''''''''''''' Besides *per interface* and *per load case* envelops tabs, a detailed peak results is provided *per each load case* in the next tabs. Events Chronology and summary spreadsheet """"""""""""""""""""""""""""""""""""""""" Events spreadsheet provides details on events (decompression features opening, sonic flow, *etc.*) occurring in the Aircraft during the rapid decompression event. Two tabs are provided: Events history '''''''''''''' This tab provides chronology of events per load case. .. _pp_event_spreadsheet_hist_tab: .. figure:: fig/pp_events_spreadsheet_hist.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Events chronology Events chronology Connect Activation Matrix ''''''''''''''''''''''''' This tab provides information about events per interface, all load cases included. .. _pp_events_spreadsheet_matrix: .. figure:: fig/pp_events_spreadsheet_matrix.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Events Matrix Events Matrix The first three columns define the interface: * ``vol_i``: interface's Volume I * ``vol_j``: interface's Volume J * ``id``: connection ID as defined in the model spreadsheet The next two columns give the min and max time at which the connection is activated (*i.e.* the decompression feature is released) * ``min_time``: minimum time at which the decompression feature is triggered * ``max_time``: maximum time at which the decompression feature is triggered The next column counts the number of times the feature is activated. * ``#LC active``: number of load cases where the feature is activated. .. note:: A "0" in the ``#LC active`` column would mean that the feature is **never activated** during the simulations, and therefore probably useless. The next N columns (where N is the number of load cases) provide the time at which the decompression feature is activated. * ``time/LC``: Time at which the decompression feature is activated for load case ID . The last columns provide as ever a duplicate index to facilitate filtering. .. _pp_regular_overview: Overview panels --------------- This section provides dynamical overview about the simulation's results. Based on the "deck" parameter provided in the model (*cf.* :ref:`deck`), ESonix organise results per *deck interface*, for example *cargo to cargo*, *cargo to main deck*, *etc.* .. _pp_overview_folded: .. figure:: fig/pp_overview_folded.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Overview panes Folded overview panes Therefore, per *deck interface* are plotted: * the deck interface heatmap * the deck interface histogram .. _pp_heatmap: The deck interface heatmap """""""""""""""""""""""""" The heatmap (as shown in example :numref:`pp_heatmap`) provides a fast overview about the Δp for each interface (X axis) and all load cases (Y axis). .. _pp_heatmap_fig: .. figure:: fig/pp_heatmap.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: DeltaP Heatmap Overview Δp Heatmap overview The Deck Interface Histogram """""""""""""""""""""""""""" The Deck Interface histogram plot per interface (X-axis) the max (i to j-- in blue) and min (j to i -- in red) Δp calculated throughout all the load cases. It is a convenient way for the engineer to check which Δp is to be taken into account for its partition, providing additionally some more details about the direction. .. _pp_histogram: .. figure:: fig/pp_histogram.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: AC dP envelop histogram Aircraft Δp envelops histogram .. _pp_advanced: Advanced post-processing ------------------------ The advanced post-processing Section provides dynamical online tools for deep investigation of the decompression phenomena. It is the section to be familiar with when dealing with optimisation, or solving some major unsustainable Δp. .. _pp_advanced_fig: .. figure:: fig/pp_advanced.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Advanced post processing section Advanced Post-Processing Section Three tools are offered: .. _pp_dynamic_plotter: Dynamic Plotter """"""""""""""" The dynamic plotter plots volume, interfaces and connections data over time. You can select from the top form (:numref:`pp_dyn_plot_form_fig`): 1. Load case to plot 2. Volumes as a coma separated sequence of interest 3. Data to plot .. _pp_dyn_plot_form_fig: .. figure:: fig/pp_dyn_plot_form.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Dynamical Plotting Form Dynamical Plotting Form .. note:: if the number of volumes to plots is uneven and Interfaces data is selected the following error message will occur *"Plotting data from interface requires a single volume OR an even number of volumes"* as the **Interfaces data** is based on a **pair of volumes**. Variables available to plot are: * :math:`P` (Pressure) by *volume* * :math:`T` (Temperature) by *volume* * :math:`\rho` (Volumic mass) by *volume* * :math:`\Delta_P` (Pressure differential) by *interface* * :math:`\dot{m}` (Massflow) by *connection* * :math:`U` (Celerity) by *connection* * :math:`A` (Vent area) by *connection* * :math:`\theta` (Flap opening angle or distance) by *connection* For example, selecting "2,3,2,4" as shown in :numref:`pp_dyn_plot_form_fig`, and selecting Δp, pressures and massflows as values to plot would generate three plots (one per variable): * Pressures for volumes 2, 3 and 4 * Δp for interfaces 2/3 and 2/4 * massflows (:math:`\dot{m}`)for all the connections connecting volumes 2, 3 and 4 .. _pp_dyn_plot_curves_fig: .. figure:: fig/pp_dyn_plot.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Dynamical Plotting Dynamical Plotting As an example, by comparison, selecting "2,3,4,2" (as opposition to "2,3,2,4" plotted in example :numref:`pp_dyn_plot_form_fig`) would invert (symmetrize) Δp for interface 2/4 .. _pp_dyn_plot_curves_inv_fig: .. figure:: fig/pp_dyn_plot_inv.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Dynamical Plotting (2) Dynamical Plotting -- inverted Δp for interface 2/4 .. _postpro_combination_analysis: Combination Analysis --------------------- All the tools available for regular runs are available for Combination Analysis (*cf.* :ref:`combination_analysis`), including sensitivity capacities. .. tip:: It needs to be kept in mind that Combination Analysis load cases result from a load case mapping of the combined nodes as illustrated :numref:`combination_example_table`). Sensitivity analysis -------------------- DeltaP spreadsheet features: Load cases envelop """""""""""""""""" For each load case of the reference node results, max Δp and the relevant interface are identified. For each one of the nodes used to calculate sensitivity, Δp are retrived for the reference critical interface found previously. Statistics are therefore based on those Δp's.