Differences

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

--- visual3d:documentation:pipeline:file_commands:import_analog_signals_from_amti_ascii_file [2024/06/19 14:00] – created sgranger
+++ visual3d:documentation:pipeline:file_commands:import_analog_signals_from_amti_ascii_file [2025/10/01 14:15] (current) – [Interpreting the File Format] wikisysop
@@ Line 1: / Line 1: @@
-For example a file containing 6 signals would appear as:
+====== Import Analog Signals From AMTI Ascii File ======
+This command will import analog signals in from an ASCII file written out by AMTI force plates, acting on all of the ACTIVE_FILES in the Visual3D Workspace.
+The format of the ASCII file output will be the same for any model of AMTI force plate. Columns 1-6 correspond to the 3 force and 3 moment channels (Fx, Fy, Fz, Mx, My, Mz). The number of rows corresponds to the length of the trial and the sampling frequency. If using multiple force plates all connected during data collection, the number of columns in the ASCII output file would be double. (i.e. Columns 1-6: FP1 Fx, FP1 Fy, FP1 Fz, FP1 Mx, FP1, My, FP1 Mz … Columns 7-12: FP2 Fx, FP2 Fy, etc.)
+<code>
+Import_Analog_Signals_From_Amti_Ascii_File
+! /REPLACE_EXISTING_SIGNALS=TRUE
+/FREQUENCY= the analog frequency
+! /FOLDER=
+;
+</code>
+==== Interpreting the File Format ====
+AMTI's ASCII file format contains 6 signals which, for example, would appear as:
 -0.7106 , 0.0000 , 0.0000 , 0.0000 ,-22.4939 , 11.1253
@@ Line 11: / Line 27: @@
 ......
-Visual3D assigns default signal names.
+Visual3D assigns default signal names to these 6 signals located in the ANALOG::ORIGINAL signal folder:
 A001 , A002 , A003 , A004 , A005 , A006
-\\
+If these names exist in the C3D file already, then Visual3D checks the command's parameter /Replace_Existing_Signals to see if the signal should be replaced. If the signal should not be replaced, the name is incremented again.
-If these names exist in the c3d file already, Visual3D checks the command parameter /Replace_Existing_Signals to see if the signal should be replaced. If the signal should not be replaced, the name is incremented again.
-\\
+==== Important Notes ====
 In order to automate the processing of many files, Visual3D assumes that the ascii file as the same name as the c3d file, but .c3d is replaced with _a.txt
-For example: c3d file = c:/test.c3d
+For example:
+>c3d file = c:/test.c3d
-ascii file = c:/test_a.txt
+>ascii file = c:/test_a.txt
-\\
-The following command acts on all of the ACTIVE_FILES in the Visual3D Workspace.
-<code>
-Import_Analog_Signals_From_Amti_Ascii_File
-! /REPLACE_EXISTING_SIGNALS=TRUE
-/FREQUENCY= the analog frequency
-! /FOLDER=
-;
-</code>
-The command assumes that the user is specifying the analog (sampling) frequency because this information is not contained in the data file.
-The analog frequency must be an integer multiple of the Motion Capture sampling rate. This command does not resample the data.
+The command assumes that the user is specifying the analog (sampling) frequency because this information is not contained in the data file. The analog frequency must be an integer multiple of the Motion Capture sampling rate. This command does not resample the data.
-\\
+If there are more samples of ANALOG data than would fill corresponding frames of motion capture data, then Visual3D will just add the additional frames.
-If there are more samples of Analog data than would fill corresponding frames of MoCap data, Visual3D just adds the additional frames.
 If there are two few frames, the signal is buffered with zeros at the end.
-\\
 [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]