# LGF_NthRoot (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Die Funktion berechnet die n-te Wurzel aus dem Aktualwert einer Variablen.

Die Wurzel ist folgendermaßen definiert:

result = \sqrt[root]{value} = value^{\frac{1}{root}}

In STEP 7 (TIA Portal) ergibt sich folgende Formel:

result = value ** (1 / root)

### Baustein Schnittstelle

| LGF_NthRoot (FC) |
--- | --- | ---
LReal |  |  | value |  | Ret_Val |  |  | LReal
LReal |  |  | root |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
value | LReal | Wert aus dem die Wurzel berechnet werden soll.
root | LReal | Wurzel Exponent

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | LReal | Rückgabe der N-ten Wurzel vom Übergabewert
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Abarbeitung ohne Fehler beendet
16#8200 | ERR_NEG_VAR Error: Neagtive Werte für den Wurzel Exponenten sind nicht definieert (Teil der Komplexen Zahlen)

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 19.08.2015 | First released version
| 1.0.1 | Siemens Industry Online Support
| 02.01.2017 | Upgrade: TIA Portal V14 Update 1
| 1.0.2 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 1.0.3 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 1.0.4 | Simatic Systems Support
| 17.01.2019 | Calculation changed
| 1.0.9 | Simatic Systems Support
| 13.11.2019 | Renamed from "LGF_XRoot" to "LGF_NthRoot" Regions, comments and constants are added
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 12.11.2020 | Insert documentation