.. highlight:: us

.. index:: Import von CONVERGE Dateien
.. index:: CONVERGE
.. index:: CONVERGE CFD software
.. index:: *.out Dateien

.. _import-of-converge-files:

Import von CONVERGE Dateien
===========================

Einleitung
----------

Das Add-in rs_converge ist ein Importfilter, mit dem UniPlots
Simulationsergebnisse (:file:`*.out`) der CFD-Software CONVERGE
(https://convergecfd.com/) importieren kann. Optional können Benutzer auch
Eingabe- (:file:`*.in`) und Echo-Dateien (:file:`*.echo`) importieren.

Es gibt fünf Arten von Ausgabedateien: Echo (:file:`*.echo`), Neustart
(:file:`*.rst`), Karte (:file:`map_*.h5`), zellengemittelte Ausgabe
(:file:`*.out`) und zellweise Post (:file:`post_*.h5`).

CONVERGE erstellt Ausgabeverzeichnisse für diese Dateien innerhalb des
Fallverzeichnisses, wie unten gezeigt.

.. image:: S:/uniplot-obj/images/converge-folder-structure.*
	:width: 100%
	
Weitere Informationen und Ressourcen finden CONVERGE-Benutzer im
`CONVERGE download hub <https://hub.convergecfd.com/downloads/category/311-uniplot_for_converge>`_

Kompatibilität
--------------

Das Add-in ist bekanntermaßen mit den folgenden CONVERGE-Versionen kompatibel:

	* CONVERGE 3
	* CONVERGE 4
	* CONVERGE 5

Wenn beim Importieren einer bestimmten Datei Probleme auftreten, wenden Sie sich
bitte an uns.

Installation
------------

* Wählen Sie :ref:`tools-add-in-manager`.

* Markieren Sie das Add-In :guilabel:`CONVERGE`.

* Wählen Sie OK. Beenden Sie UniPlot und starten Sie UniPlot neu.

Die installierten Dateien sollten sich nun unter
:file:`[UniPlot User Directory]\\UniPlot\\AddIn\\rs_converge` directory.

.. list-table::
   :header-rows: 0

   * - rs_converge.ic
     - AddIN UniScript-Datei
   * - OUT_import_filter.ic
     - Import filter UniScript-Datei
   * - IN_import_filter.ic
     - Import filter UniScript-Datei
   * - ECHO_import_filter.ic
     - Import filter UniScript-Datei
   * - rs_converge.icl
     - AddIN in übersetzter Form

Benutzung
---------

* Starten Sie UniPlot.

* Wählen Sie :ref:`dateidaten-importieren`.

* Wählen Sie den Typ :guilabel:`CONVERGE (\*.out;\*.in;\*.echo)` aus.

* Navigieren Sie zu Ihrem Simulationsordner "stream". (Alle Dateien in
  übergeordneten Ordnern können importiert werden. Daher sollten Sie
  möglicherweise Dateien aus dem Ordner "stream" auswählen.)

* Wählen Sie eine beliebige \*.out-Datei aus und klicken Sie auf OK.

* Das Importfenster von UniPlot-CONVERGE wird angezeigt.

  .. image:: S:/uniplot-obj/images/converge-folder-selection-window.*
     :width: 100%

  * Das Fenster besteht aus vier Hauptelementen, die in der folgenden Tabelle
    beschrieben werden.

  .. list-table::
     :header-rows: 1

    * - Abschnitt
      - Beschreibung
    * - Dateiauswahltyp
      - Wählen Sie aus, ob Sie zusätzlich zu den \*.out-Dateien auch die \*.in- und
        \*.echo-Dateien importieren möchten (wir empfehlen, nur mit \*.out-Dateien zu arbeiten).
    * - Ordnerauswahl
      - Wählen Sie den Ordner aus, aus dem Daten importiert werden sollen.
        UniPlot sucht in den ausgewählten Ordnern nach Dateien des ausgewählten
        Typs (nicht rekursive Suche).
    * - Projektname
      - Basiert auf den ausgewählten Ordnern, kann jedoch überschrieben werden.
    * - Dateiliste
      - Zeigt die Liste der Dateien und deren Typen im ausgewählten Ordner an.

* Geben Sie die erforderlichen Informationen ein und klicken Sie auf OK. Der
  Importvorgang wird gestartet.

Erzeugte NC-Datei
-----------------

* Nach dem Import steht die Datei wie gewohnt im DataBrowser zur Verfügung. Die
  Kanäle werden mithilfe der NC2-Dateigruppenfunktion in einer Baumstruktur
  organisiert. Die Struktur sieht wie folgt aus:
  
   * Group name: file_type/orginal_file_name
   * Channel name : file_type/original_file_name/channel_name/[extra information] (extra information is taken from the file, such as bound ID etc...)

History
-------

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2025.3
     - Erste Veröffentlichung

:sub:`id-126914`