================== Analysis ================== ESonix features three kind of analysis: * Regular * Combination * Sensitivity Regular runs ============ Regular runs are the basic analysis in ESonix. Once a project features several regular runs, the user can perform combination or sensitivity analysis on the top of them. Preparation ----------- A regular run is prepared and run from its father project by clicking on the ``new run``, button as shown in :numref:`blank_project`. The "new run" form is pre-filled with parameters defined during the Project creation (:ref:`create_project_phase`). Basic parameters """""""""""""""" .. _new_run_basic_parameters: .. figure:: fig/new_run_00.png :align: center :alt: new run basic parameters :figclass: align-center :class: screenshot :width: 300pt New run basic parameters Form Basic parameters are (numbers refer to :numref:`new_run_basic_parameters`): 1. ``Model``: XLS/XLSX model filename. 2. ``Units`` Set of units describing the model. SI (modified with bar instead of Pa) or Imperial. 3. ``Engine``: Thermodynamical model (set of equations) to use. 4. ``Polytropic constant``: In case ``polytropic`` engine, or one of its derivative is used, provide the relevant polytropic constant. 5. ``Door positions``: Which initial condition (:term:`configuration`) to use. .. _advanced_parameters_paragraph: Advanced Parameters """"""""""""""""""" By unfolding the "Advanced parameters" panel, additional parameters are shown: .. _new_run_advanced_parameters: .. figure:: fig/new_run_01.png :align: center :alt: new run advanced parameters :figclass: align-center :class: screenshot :width: 200pt New run advanced parameters Form Advanced parameters are (numbers refer to :numref:`new_run_advanced_parameters`): 1. ``timestep``: Simulation time increment. 2. ``sampling``: Data sampling for disk storage. 3. ``timeout``: Simulation maximum time. 4. ``Post-convergence margin``: Margin (in nb of steps) after convergence is reached before stopping calculation. 5. ``Convergence_criteria``: How to calculate convergence. This is a low-influence parameter as most of the time, ``timeout`` will end the calculation before the real convergence is reached. 6. ``Load Cases to run``: Comma separated list of load cases ID to run. This is useful to restrict calculations to a single or a subset of load cases as defined in the model spreadsheet. 7. ``Comments``: Free text. If blank, ESonix will fill it with miscellaneous data. Other parameters are for debugging or comparing with OEM data and shouldn't be tweaked. Launch and evolution of the run ------------------------------- Once ``Go!`` button is pressed, the spreadsheet is sent to the ESonix server, with the relevant parameters. The spreadsheet is preprocessed and checked. If it contains no errors, calculation is automatically fired. .. _combination_analysis: Combination Analysis ==================== Combination analysis provides a mean to *combine* some regular existing nodes. Combination will build a single set of result based on the provided existing nodes. To do so, ESonix will begin by creating a load case mapping. This mapping will renumber existing load cases to avoid clash between models. For example, a combination made of three nodes would be mapped as follows: .. _combination_example_table: .. table:: Example of Combination Laod Cases mapping +--------------------+---------+------------+ | combined Load Case | Node ID | LodCase ID | +====================+=========+============+ | 1001 | A1 | 1001 | +--------------------+ +------------+ | 1002 | | 1002 | +--------------------+ +------------+ | 1003 | | 1003 | +--------------------+---------+------------+ | 1004 | A2 | 1001 | +--------------------+ +------------+ | 1005 | | 1002 | +--------------------+---------+------------+ | 1006 | A3 | 1001 | +--------------------+ +------------+ | 1007 | | 1018 | +--------------------+---------+------------+ This can be read as follows: Load Case 1005 for node A4 (combination of A1, A2 and A3) is actually load case 1002 from Node A2. Once mapping is done, post-processing is performed in the same way as regular runs. All the tools available for regular runs are available for combination nodes, including sensitivity. Opening in Cabin are usually checked with an empty cargo, such as an important mass of air is available in the cargo to be discharged into the cabin. At opposite, when checking an explosion in the cargo itself, it will be more conservative to assume a cargo occupied. :numref:`combination_example` is extracted from :ref:`tuto4` illustrates the latter example. .. _combination_example: .. figure:: fig/sketch_combination_analysis.png :width: 400pt :align: center :alt: Combination analysis examle :figclass: align-center Combination Analysis example The example illustrated :numref:`combination_example` could be addressed by combining two models: one with empty Cargo, one with occupied cargo. The first model would feature load cases for explosions in the main deck only (thus, volumes 1, 2 and 3), while the second one would feature explosion in the cargo (volume 4). The Load Case Mapping would then look like :numref:`combination_example_table2`. .. _combination_example_table2: .. table:: Load Cases mapping relative to :numref:`combination_example` +--------------------+---------+------------+--------------+ | combined Load Case | Node ID | LodCase ID | explosion in | +====================+=========+============+==============+ | 1001 | A1 | 1001 | vol. 1 | +--------------------+ +------------+--------------+ | 1002 | | 1002 | vol. 2 | +--------------------+ +------------+--------------+ | 1003 | | 1003 | vol. 3 | +--------------------+---------+------------+--------------+ | 1004 | A2 | 1001 | vol. 4 | +--------------------+---------+------------+--------------+ .. seealso:: More details about combination analysis may be found in :ref:`tuto4`. .. _sensitivity_analysis: Sensitivity Analysis ==================== .. _sensitivity_form_fig: .. figure:: fig/sensitivity_form.png :align: center :figclass: align-center :width: 400pt :class: screenshot :alt: Sensitivity analysis form Sensitivity Analysis Form