Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_compute_power_from_dft_coefficients [2024/06/19 12:51] – sgranger
+++ visual3d:documentation:pipeline:metric_commands:metric_compute_power_from_dft_coefficients [2025/09/22 19:03] (current) – wikisysop
@@ Line 1: / Line 1: @@
-{{{{the power in a signal can be computed from the [[visual3d:documentation:pipeline:metric_commands:metric_compute_dft_coefficients|dft coefficients]].
+====== Metric Compute Power From DFT Coefficients ======
-the form of the dft is as follows:
+The power in a signal can be computed from the [[Visual3D:Documentation:Pipeline:Metric_Commands:Metric_Compute_DFT_Coefficients|DFT coefficients]].
+The form of the DFT is as follows:
 p(t)= p0 + p1 sin(**w** t) + p2 cos(**w** t) + p3 sin(2**w** t) + p4 cos(2 **w** t) + ....
-where **w** = 2 * pi * base_frequency
+where **w** = 2 * PI * Base_Frequency
 the power at a given frequency is given as the sum of the squares of the coefficients.
-for example, the power at the base_frequency is given by (p1^2 + p2^2) the power at 2 * base_frequency is given by (p3^2 + p3^2)
+For example, the power at the Base_Frequency is given by (p1^2 + p2^2) the power at 2 * Base_Frequency is given by (p3^2 + p3^2)
+This can be useful when looking at muscle related signals like EMGs.
+====Pipeline Command====
+The command below is as seen on the Visual3D application, it can be found in the **Pipeline Workshop** within the **Metric** folder.
+<code>
+Metric_Compute_Power_From_DFT_Coefficients
+/SIGNAL_TYPES=
+! /SIGNAL_FOLDER=DFT
+! /SIGNAL_NAMES=
+! /RESULT_FOLDER=DFT
+! /RESULT_SUFFIX=_POWER
+;
+</code>
+Additionally (starting in Visual3D Version 5) the Mean and Median Frequency are computed.
+These two metrics are commonly used to describe changes related to muscle fatigue.
+====Command Parameters====
+- Table with parameters and descriptions (include link to parameter wiki pages if they are available)
+The following table shows the command parameters and descriptions:
+|**SIGNAL_TYPES**|**Specify Signal Types**|
+|**SIGNAL_FOLDER**|**Specify folder containing signals**|
+|**SIGNAL_NAMES**|**Specify names of signals to be processed**|
+|**RESULT_FOLDER**|**Specify destination folder for results**|
+|**RESULT_SUFFIX**|**Specify suffix attached to resulting signals**|
+====Examples====
+===Simple example===
+===Complex example==
-**metric_compute_power_from_dft_coefficients**
+====Notes====
-/signal_types=
-! /signal_names=
-! /signal_folder=dft
-! /result_suffix=_power
-! /result_folder=dft
-**;**
-additional (starting in visual3d version 5) the mean and median frequency are computed.
-these two metrics are commonly used to describe changes related to muscle fatigue.
+=== Signal Components ===
-===== signal components =====
+The resulting Metric signal has two components.
-the resulting metric signal has two components.
+The first component is the frequency.
+The second component is the power at the associated frequency.
+=== Median Frequency ===
-the first component is the frequency.
+The Median Frequency is the Frequency at which the Integral of the Power Spectrum to that Frequency equals half the Integral of the Total Power Spectrum (e.g. divides the power spectrum in two)
-the second component is the power at the associated frequency.
-===== median frequency =====
-the median frequency is the frequency at which the integral of the power spectrum to that frequency equals half the integral of the total power spectrum (e.g. divides the power spectrum in two)
+{{:MedianFrequency.jpg}} where MF = Median Frequency
-medianfrequency.jpg where mf = median frequency
+=== Mean Frequency ===
-===== mean frequency =====
+The Mean Frequency is the Ratio of the Integral of the Frequency*Power over the Integral of the Power.
-the mean frequency is the ratio of the integral of the frequency*power over the integral of the power.
+{{:MeanFrequency.jpg}}
-meanfrequency.jpg
+=== _STATS ===
-===== _stats =====
+An additional result signal appended with _STATS is also created.
-an additional result signal appended with _stats is also created.
+This signal contains the median frequency (component 1) and mean frequency (component 2)
-this signal contains the median frequency (component 1) and mean frequency (component 2)
-}}}}