# LGF_CalcDistance_2D (FC / 3.0.1)

Overview

Author: Siemens Digital Industries

## Short description

The function calculates the distance between two points in the plane.

### Block Interface

| LGF_CalcDistance_2D (FC) |
--- | --- | ---
LReal |  |  | x1 |  | Ret_Val |  |  | LReal
LReal |  |  | y1 |  |  |  |  |
LReal |  |  | x2 |  |  |  |  |
LReal |  |  | y2 |  |  |  |  |

### Input parameter

Identifier | Data type | Description
--- | --- | ---
x1 | LReal | X coordinate point 1
y1 | LReal | Y coordinate point 1
x2 | LReal | X coordinate point 2
y2 | LReal | Y coordinate point 2

### Output parameter

Identifier | Data type | Description
--- | --- | ---
Ret_Val | LReal | Calculated distance between the Points

## Functional description

The block calculates the distance between two points in a Cartesian coordinate system. The distance is calculated with the following formula:

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

Figure: Graphical representation

## Change log

Version & Date | Change description
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 06.07.2018 | First released version
| 1.0.1 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 1.0.2 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 1.2.0 | Simatic Systems Support
| 04.10.2019 | renamed from "Distance" to "CalcDistance_2D" Data type changed to LREAL Data type changed to LREAL
| 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