.. highlightlang:: us .. index:: Einheiten-Umrechnung .. _unit-converter: .. _overview-units: Einheiten-Umrechnung ==================== UniPlot kann beim Datenimport (zur Zeit nur :ref:`KiBox-Dateien ` und bei Berechnungen mit dem :ref:`Formelinterpreter ` eine konfigurierbare Einheiten-Umrechnung durchführen. Die Kanäle werden dann entsprechend einer Umwandlungs-Tabelle über eine lineare Skalierung in andere Einheiten umgerechnet. Bei der Einheiten-Umrechnung werden nur Zeichenketten in Tabellen gesucht. Die Zeichenketten können aus beliebigen UNICODE-Zeichen bestehen. Groß-/Kleinbuchstaben werden unterschieden. Leerzeichen werden berücksichtigt. Möchten Sie ``1/s`` in ``1/min`` umrechnen, müssen sich diese beiden Einheiten auch in der Tabelle befinden. Es reicht nicht aus, wenn sich nur ``s`` und ``min`` in der Tabelle befinden. Die units-Tabelle ^^^^^^^^^^^^^^^^^ In der Excel-Datei :ref:``:file:`\\Template\\units.xlsx` befinden sich drei Tabellen "Units", "Alias" und "Channel". Wenn Sie Einheiten ändern möchten, kopieren Sie die Datei in ein anderes Verzeichnis, z. B. in das UniPlot-Benutzerverzeichnis (siehe :ref:`GetUserDirectory`) da die Datei :file:`units.xlsx` im UniPlot-Template-Verzeichnis bei Installation eines Updates überschrieben wird. Der Dateiname kann im Dialog :ref:`tools-formula-configuration` angegeben werden. .. image:: S:/uniplot-obj/images/ToolsFormulaConfiguration-de.* Alternativ können Sie den Dateinamen im UniPlot-Kommandofenster eingeben. Geben Sie dazu im UniPlot-Kommandofenster die beiden folgenden Zeilen ein, damit Ihre geänderte units-Datei von UniPlot verwendet wird. :: s = GetUserDirectory() + "Template/units.xlsx" WriteProfileString("Settings", "unit-converter-file", s); .. _units-units-sheet: Units Tabelle ------------- Die erste Tabelle ("Units") hat sechs Spalten. .. image:: S:/uniplot-obj/images/units.* Dabei ist ``Name = Factor * SI + Offset``, z. B. ``1 mbar = 100 * Pa + 0``. Die Spalte "Preferred" enthält die Zahl ``1`` oder ist leer. Falls die Spalte eine 1 enthält, wird diese Einheit für die Ausgabe verwendet. Beispielsweise steht die 1 in der Tabelle oben bei den Druckeinheiten in der Zeile mit "Common Unit" (gebräuchliche Einheit) gleich bar, dann werden alle Drücke in bar ausgegeben. Möchten Sie, das Drücke in Pa ausgegeben werden, entfernen Sie die 1 in Zeile bar und fügen Sie sie in Zeile mit "Common Unit" gleich Pa ein. .. _units-alias-sheet: Alias Tabelle ------------- Die Tabelle kann für jeden Kanal aus der Spalte ``Common Units`` der Units-Tabelle einen oder mehrere Aliase enthalten. Z. B. ``sec` für ``s``. Die Tabelle enthält drei Spalten: .. image:: S:/uniplot-obj/images/units-alias.* .. _units-channel-sheet: Kanal Tabelle ------------- Die Tabelle definiert für jeden Kanalnamen eine bevorzugte Einheit. Sie enthält drei Spalten mit Kanalnamen, bevorzugter Einheit und Kommentar. .. image:: S:/uniplot-obj/images/units-channel.* Die Kanalnamen in der Tabelle müssen entweder exakt mit einem Namen in der NC-Datei übereinstimmen oder dürfen Platzhalter (Messstellenbezeichner) enthalten. Ein Messstellenbezeichner besteht aus spitzen Winkeln, die einen oder zwei Kleinbuchstaben enthalten. Der Platzhalter ```` kann eine einstellige Zahl im Bereich 1 bis 9 ersetzen. Der Platzhalter ```` kann eine zweistellige Zahl im Bereich 01 bis 99 ersetzen. Der Platzhalter ```` kann eine dreistellige Zahl im Bereich 01 bis 999 ersetzen. Beispiel: Für die vier Kanäle ``pcy1``, ``pcy2``, ``pcy3``, ``pcy4`` kann der Name ``pcy`` in die Channel-Tabelle eingetragen werden. Falls ein Name mehrere Platzhalter enthält, müssen die Platzhalter durch einen Buchstaben oder einen Unterstrich separiert sein, z. B. ``pcy3bank2: pcybank``. Die Platzhalter können in Formeln ebenfalls verwendet werden. Siehe :ref:`formula-location-identifier`. Mit Hilfe der folgenden Funktion können die Einheiten aller Kanäle in SI-Einheiten (*bToSIUnit* = ``TRUE``) oder in die gebräuchlichen Einheiten (*bToSIUnit* = ``TRUE``) konvertiert werden :ref:`nc_convert_units`. UniScript-Schnittstelle ^^^^^^^^^^^^^^^^^^^^^^^ Die UniScript-Schnittstelle zur Einheitenumrechnung befindet sich in :file:`script\\datasets\\units.ic`. .. us.makeindex units, Funktionen zur Einheitenumrechnung .. include:: ../ftab/units.ftab :sub:`id-2069315`