# LGF_CalcDistance_3D (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industries

## Kurzbeschreibung

Die Funktion berechnet den Abstand zwischen zwei Punkten im 3D Raum.

### Baustein Schnittstelle

| LGF_CalcDistance_3D (FC) |
--- | --- | ---
LReal |  |  | x1 |  | Ret_Val |  |  | LReal
LReal |  |  | y1 |  |  |  |  |
LReal |  |  | z1 |  |  |  |  |
LReal |  |  | x2 |  |  |  |  |
LReal |  |  | y2 |  |  |  |  |
LReal |  |  | z2 |  |  |  |  |

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
x1 | LReal | X Koordinate Punkt 1
y1 | LReal | Y Koordinate Punkt 1
z1 | LReal | Z Koordinate Punkt 1
x2 | LReal | X Koordinate Punkt 2
y2 | LReal | Y Koordinate Punkt 2
z2 | LReal | Z Koordinate Punkt 2

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | LReal | Berechnete Distanz zwischen den Punkten

## Funktionsbeschreibung

Der Baustein berechnet den Abstand zwischen zwei Punkten in einem kartesischen Koordinatensystem. Der Abstand wird mit nachfolgender Formel berechnet:

result = \sqrt[2]{(x_2-x_1)^2+(y_2-y_1)^2+(z_2-z_1)^2}

Abbildung: Graphische Darstellung

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Presales Support
| 04.10.2019 | First released version derivate from "CalcDistance_2D" and extended to 3D
| 3.0.0 | Siemens Industry 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