.. _eseafem_rhino_plugin_man: Rhino E-SeaFEM plugin ===================== The purpose of this plugin is to make it easier for users who typically use Rhinoceros as a design application to export geometry created using this CAD application to the :ref:`E-SeaFEM application`. How to get and install this plugin ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The `Rhino E-SeaFEM` plugin is currently available on `food4Rhino `_. A registered user in food4Rhino can download the `Rhino E-SeaFEM` plugin from the website. .. figure:: img/food4rhino_download.png :align: center :scale: 85% The button directs to the `Downloads` section of the website, where the latest version of the plugin can be downloaded. .. figure:: img/f4r_eseafem_download.png :align: center :scale: 85% The `Install` button is only available for registered users. When it is pressed, Rhinoceros application is started if it had been installed previously and `Package Manager` window is opened showing the `Rhino E-SeaFEM`plugin. It is also possible to open the `Package Manager` window with :guilabel:`Tools > Package Manager` menu option of Rhinoceros and search the plugin. .. figure:: img/Rhino_PackageManager.png :align: center :scale: 85% Pressing `Install` button in the `Package Manager` window, the plugin will be installed and ready to be used. How to get contextual help ^^^^^^^^^^^^^^^^^^^^^^^^^^ When the following menu option in Rhinoceros is executed, then a contextual help panel is opened and help about this plugin and `E-SeaFEM` application is shown: Menu option: :guilabel:`Panels > Help` .. figure:: img/eseafem_rhino_contextual_help.png :scale: 80% :align: center Contextual help about `Rhino E-SeaFEM` plugin available executing the :guilabel:`Panels > Help` Rhinoceros menu How to run this plugin ^^^^^^^^^^^^^^^^^^^^^^ The plugin includes a command called `ESeaFEM` which can be executed from the button contained in the plugin's built-in toolbar or by entering the command in the command line. .. figure:: img/eseafem_rhino_run_plugin.png :scale: 80% :align: center How to download E-SeaFEM application -------------------------------- The first time the command is run, if `E-SeaFEM` is not installed, then a dialog box allows to download E-SeaFEM from `Compass website `_. .. figure:: img/eseafem_rhino_not_installed.png :scale: 80% :align: center How to validate E-SeaFEM application ------------------------------------ The second time the command is run, it is necessary to enter passwords for GID and FULL_ESEAFEM modules according to the :ref:`Getting Started manual ` of `E-SeaFEM`. How to export geometry to E-SeaFEM application ---------------------------------------------- Afterwards, each time the `ESeaFEM` command is executed, the geometry will be exported to IGES format, the E-SeaFEM installation will be started, and the geometry will be imported. According to the :ref:`E-SeaFEM manual`, the geometry must meet other criteria, besides the units, in order to be able to run a wind tunnel simulation. These criteria are not checked when executing the `ESeaFEM` command but are checked by the `E-SeaFEM` application. In case different versions of `E-SeaFEM` are installed, the most recent version shall be run. After verifying the units and exporting the geometry in IGES format, `E-SeaFEM` opens with the imported geometry. .. figure:: img/eseafem_rhino.png :align: center :scale: 100% For more information on how to perform a seakeeping simulation, please visit the :ref:`E-SeaFEM manual`. How to solve problems with geometry export ------------------------------------------ One of the requirements that the geometry must meet in order to be used in `E-SeaFEM` is that it must be a closed volume. If a set of surfaces generated in `Rhinoceros`, which encloses a volume, is exported to `E-SeaFEM`, a volume will be created automatically when the geometry is imported into `E-SeaFEM`. However, if the set of surfaces is not correct, for instance, has gaps or has intersecting surfaces, then an error will occur when trying to create the volume. The following image shows the type of error that will occur. .. figure:: img/error_import_geom.png :align: center :scale: 80% Error that happens when it is not possible to create a volume from the imported geometry. For this reason, it is highly recommended to create a solid with the set of surfaces before executing `Rhino E-SeaFEM` plugin. If it is not possible to create the solid, then it is necessary to correct the errors of geometry, such as, gaps or intersecting surfaces, to make possible a successful export of geometry to `E-SeaFEM` application. .. figure:: img/rhino_solid_creation.png :align: center :scale: 80% It is recommended to create a solid before executing `Rhino E-SeaFEM` plugin. If it is not possible, then it is necessary to correct the errors in geometry to make possible a successful export of geometry to `E-SeaFEM` application.