.. _execution: This document briefly details how user/developers can set up a remote machine on FabSim3 for job submission. How to run a Convection2D and Convection3D (test) Jobs ======================= These examples assume that you have been able to run the basic FabSim examples described in the other documentation files, and that you have built and configured Nektar++ (https://www.nektar.info/) on the target machine, also will be assumed that the location (``Convection2D_exec``) has been specified in the file ``machines_FabNEPTUNE_user.yml``. All the input files required for a Convection2D simulation should be contained in a directory in ``config_files``. A minimal example Convection2D simulation is provided in ``config_files/Convection2d_test1``, to execute this example type: .. code-block:: console fabsim localhost Convection2D_local:convection_2d_test Run Ensemble Examples ===================== Convection2D_ensemble ------------------------ These examples assume that you have been able to run the basic FabSim examples described in the other documentation files, and that you have built and configured Nektar++ (https://www.nektar.info/) on the target machine. To run type: .. code-block:: console fabsim localhost Convection2D_ensemble_local:Convection2D_ensemble_example FabNEPTUNE looks for a directory called ``Convection2D_ensemble_example`` in ``config_files``. It then looks for a sweep directory (by default called ``SWEEP``) that contains a number of input files to iterate through. All the files in ``Convection2D_ensemble_example`` directory and one of the sweep directory files will be copied to the host in separate directories (one for each sweep file) and executed in the normal way. This example runs 3 simulations with different input files, which vary the simulation timestep, using the same topology file. Convection3D_ensemble ------------------------ These examples assume that you have been able to run the basic FabSim examples described in the other documentation files, and that you have built and configured Nektar++ (https://www.nektar.info/) on the target machine. To run type: .. code-block:: console fabsim Convection3D_ensemble_remote:Convection3D_ensemble_example FabNEPTUNE looks for a directory called ``Convection3D_ensemble_example`` in ``config_files``. It then looks for a sweep directory (by default called ``SWEEP``) that contains a number of input files to iterate through. All the files in ``Convection3D_ensemble_example`` directory and one of the sweep directory files will be copied to the host in separate directories (one for each sweep file) and executed in the normal way. This example runs 3 simulations with different input files, which vary the simulation timestep, using the same topology file. EasyVVUQ+FabNEPTUNE =================== These examples assume that you have been able to run the basic FabSim examples described in the other documentation files, and that you have built and configured Nektar++ (https://www.nektar.info/) on the target machine. .. Note:: All the easyvvuq campaign runs and execution, and the results analyse will be done on target machine which can be your localhost or remote HPC machine. The input files needed for this example are found in ``plugins/FabNEPTUNE/config_files/convection_2d_easyvvuq_InRuAn*_QCGPJ``. This directory contains the following files that can be modified for your own purpose: * ``convection_2d_remote.template``: is the convection2d input script in ``convection_2d_easyvvuq_InRuAn*_QCGPJ`` subfolder, EasyVVUQ will substitute certain variables in this file to create the ensemble. * ``campaign_params_remote.yml``: is the configuration file, in ``convection_2d_easyvvuq_InRuAn*_QCGPJ`` subfolder, for EasyVVUQ sampler. If you need different sampler, parameter to be varied, or polynomial order, you can set them in this file. Execution --------- After updating the following files with your credentials .. code-block:: console FabSim3/deploy/machines_user.yml FabSim3/deploy/machines.yml FabSim3/plugins/FabNEPTUNE/machines_FabNEPTUNE_user.yml ```` can be your ``localhost`` or a HPC resources. To run type: .. code-block:: console fabsim localhost Convection2D_init_run_analyse_campaign_local:convection_2d_easyvvuq_InRuAn*_QCGPJ fabsim Convection2D_init_run_analyse_campaign_remote:convection_2d_easyvvuq_InRuAn*_QCGPJ To copy the results back to your local machine type: .. code-block:: console fabsim localhost fetch_results fabsim fetch_results EasyVVUQ+EasySurrogate+FabNEPTUNE ================================= These examples assume that you have been able to run the basic FabSim examples described in the other documentation files, and that you have built and configured Nektar++ (https://www.nektar.info/) on the target machine. .. Note:: All the EasyVVUQ and EasySurrogate campaigns runs and execution, and the results analyse will be done on target machine which can be your localhost or remote HPC machine. The input files needed for this example are found in ``plugins/FabNEPTUNE/config_files/convection_2d_easyvvuq_easysurrogate_InRuAn*_DAS_QCGPJ``. This directory contains the following files that can be modified for your own purpose: * ``convection_2d_remote.template``: is the convection2d input script in ``convection_2d_easyvvuq_easysurrogate_InRuAn*_DAS_QCGPJ`` subfolder, EasyVVUQ will substitute certain variables in this file to create the ensemble. * ``campaign_params_remote.yml``: is the configuration file, in ``convection_2d_easyvvuq_easysurrogate_InRuAn*_DAS_QCGPJ`` subfolder, for EasyVVUQ sampler. If you need different sampler, parameter to be varied, or polynomial order, you can set them in this file. Execution --------- After updating the following files with your credentials .. code-block:: console FabSim3/deploy/machines_user.yml FabSim3/deploy/machines.yml FabSim3/plugins/FabNEPTUNE/machines_FabNEPTUNE_user.yml ```` can be your ``localhost`` or a HPC resources. To run type: .. code-block:: console fabsim localhost Convection2D_init_run_analyse_campaign_local:convection_2d_easyvvuq_easysurrogate_InRuAn1_DAS_QCGPJ fabsim Convection2D_init_run_analyse_campaign_remotel:convection_2d_easyvvuq_easysurrogate_InRuAn1_DAS_QCGPJ fabsim localhost Convection2D_init_run_analyse_campaign_local:convection_2d_easyvvuq_easysurrogate_InRuAn2_DAS_QCGPJ fabsim Convection2D_init_run_analyse_campaign_remote:convection_2d_easyvvuq_easysurrogate_InRuAn2_DAS_QCGPJ To copy the results back to your local machine type: .. code-block:: console fabsim localhost fetch_results fabsim fetch_results .. image:: ../../images/important.png :align: center :alt: important :class: with-shadow :scale: 40