Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:pipeline:signal_commands:interpolate [2024/06/19 12:53] – sgranger
+++ visual3d:documentation:pipeline:signal_commands:interpolate [2025/05/20 13:35] (current) – Cleaned up page for a customer. Still needs to be put into Pipeline project format. wikisysop
@@ Line 1: / Line 1: @@
-{{{{{{if there are unreliable data points (residuals < 0) in any signal it is possible to interpolate these gaps in the data using a spline interpolation.
+====== Interpolate ======
-===== visual3d version 4 =====
+The Interpolate command fills in any gaps in a signal's data using a spline interpolation. This can be useful if there are unreliable data points ([[visual3d:documentation:c3d_signal_types:target_data_type#target_marker_residuals|residuals]] < 0).
-the interpolation procedure performs a least-squares fit of an nth order polynomial to k data points.
+The interpolation procedure performs a least-squares fit of an nth order polynomial to k data points.
-|(x1,t1),...,(xk,tk)|k >= polynomial order + 1||
+<code>
+|(x1,t1),...,(xk,tk)|k >= polynomial order + 1|
+</code>
-\\
+The command is given in text form as:
+<code>
+Interpolate
+/SIGNAL_TYPES=
+! /SIGNAL_NAMES=
+! /SIGNAL_FOLDER=ORIGINAL
+! /RESULT_SUFFIX=
+! /RESULT_FOLDER=PROCESSED
+/MAXIMUM_GAP=
+! /NUM_FIT=3
+! /POLYNOMIAL_ORDER=3
+;
+</code>
+{{:InterpolateDlg2.jpg}}
-|**interpolate**       |                                                                                                                      |
+===== Parameters =====
-|**/signal_types=**    |the type of signal to be processed                                                                                    |
-|**/signal_names=**    |the names of the signals to be processed                                                                              |
-|**/signal_folder=**   |the name of the signal folder                                                                                         |
-|**/num_fit=**         |the number of frames of data before and after the "gap" that are used to calculate the coefficients of the polynomial.|
-|**/polynomial_order=**|the order of the polynomial used.                                                                                     |
-|**/maximum_gap=**     |the maximum number of frames of data that can be replaced with interpolated values.                                   |
-interpolatedlg.png
+^ Parameter ^ Description ^
+| /Signal_Types | The type of signal to be processed. |
+| /Signal_Names | The names of the signals to be processed. |
+| /Signal_Folder | The name of the signal folder. |
+| /Num_Fit | The number of frames of data before and after the "gap" that are used to calculate the coefficients of the polynomial. |
+| /Polynomial_Order | The order of the polynomial used. |
+| /Maximum_Gap | The maximum number of frames of data that can be replaced with interpolated values. |
-dialog that pops up when pipeline selection is edited by double clicking with the left mouse button.
+===== Example: Using an expression =====
-==== using an expression in version 4 ====
+Define the maximum size of the gap based on the POINT frame rate.
-this is considerable more klunky because it requires 3 commands instead of 1:
+{{:InterpolateDlg3.jpg}}
-**evaluate_expression**
-/expression=0.1*parameters::point::rate
-/result_name=rate
-/result_type=metric
-/result_folder=temp
-**;**
-**set_pipeline_parameter_to_data_value**
-/parameter_name=gap
-/signal_types=metric
-/signal_names=rate
-/signal_folder=temp
-! /signal_components=all_components
-**;**
-**interpolate**
-/signal_types=target
-! /signal_names=
-! /signal_folder=original
-! /result_suffix=
-! /result_folder=processed
-/maximum_gap=::gap
-! /num_fit=3
-! /polynomial_order=3
-**;**
-===== visual3d version 5 =====
-in version 5 we permit the three numerical parameters to have expressions.
-**interpolate**
-/signal_types=target
-! /signal_names=
-! /signal_folder=original
-! /result_suffix=
-! /result_folder=processed
-/maximum_gap=0.1*parameters::point::rate
-! /num_fit=3
-! /polynomial_order=3
-**;**
-interpolatedlg2.jpg
-==== using an expression in version 5 ====
-define the maximum size of the gap based on the point frame rate.
-interpolatedlg3.jpg
-}}}}}}