===== Distance Perpendicular To Path =====

The command Distance_Perpendicular_To_Path computes the perpendicular distance from a point along a path (P in the figure below) to a straight path defined as the position at Event1 to position at Event2. In the figure below, the red line is the perpendicular distance from the point P.

{{:On_off_axis_path.gif}}

==== Example: Unnormalized Distance for Target ====

The pipeline command below will calculate the distance travelled by the MID_PSIS [[visual3d:documentation:c3d_signal_types:target_data_type|TARGET]] perpendicular to its path between the [[visual3d:documentation:c3d_signal_types:event_label_data_type|events]] START and STOP. This distance will not be normalized.

<code>
Distance_Perpendicular_To_Path
/SIGNAL_TYPES=TARGET
/SIGNAL_NAMES=MID_PSIS
! /SIGNAL_FOLDER=ORIGINAL
/RESULT_NAME=PSIS_DISTANCE
! /RESULT_FOLDER=PROCESSED
/EVENT_NAME_START=START
/EVENT_NAME_STOP=STOP
/NORMALIZE_TO_DISTANCE=FALSE
;
</code>

==== Notes ====

If the NORMALIZE_TO_DISTANCE parameter is true then the resulting perpendicular distance is divided by the distance along the straight path.

==== See Also ===

Visual3D also contains commands for the [[visual3d:documentation:pipeline:signal_commands:distance_parallel_to_path|Distance Parallel to Path]] and [[visual3d:documentation:pipeline:signal_commands:distance_along_path|Distance Along Path]]. Or return to the [[visual3d:documentation:pipeline:signal_commands:signal_commands_overview|Signal Commands]] overview.