Differences

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

--- visual3d:documentation:pipeline:file_commands:modify_point_rate [2024/06/19 12:50] – sgranger
+++ visual3d:documentation:pipeline:file_commands:modify_point_rate [2025/05/22 16:04] (current) – Cleaned up page for a customer. Still needs to be put into Pipeline project format. wikisysop
@@ Line 1: / Line 1: @@
-modify the point and/or analog rate in the c3d file.
+====== Modify Point Rate ======
-some motion capture systems have limits on the point sampling rate. if the user wants to collect analog data using the mocap a/d board, and chooses not to collect point data, the c3d analog rate is still restricted to an artificial (and meaningless) point rate.
+This command allows the user to modify the [[visual3d:documentation:c3d_signal_types:target_data_type|point]] and/or [[visual3d:documentation:c3d_signal_types:analog_data_type|analog rate]] in the [[visual3d:documentation:c3d_signal_types:c3d_format|C3D file]]. Care should be taken when doing this, as the motion capture vendor's metadata for their measurements should not be edited lightly.
-the modify_point_rate command allows the user to modify the rates.
+The motivating use case for this command is the fact that some motion capture systems have limits on the POINT sampling rate. If the user wants to collect ANALOG data using a motion capture A/D board, for example, and chooses not to collect point data then the C3D analog rate is still restricted to an artificial (and meaningless) point rate. The Modify_Point_Rate command allows the user to modify the rates stored within the C3D file to avoid this limitation.
-note that the user should set both the point and the analog rate.
+<code>
+Modify_Point_Rate
+/POINT_RATE=
+/ANALOG_RATE=
+! /OVERWRITE_C3D_FILE=FALSE
+;
+</code>
-for example, to set the point and analog rate to 1600, which will produce an analog ratio of 1.
+Note that the user should set both the POINT and the ANALOG rate with the same command.
+===== Example: Analog Ratio of 1 =====
+For example, to set the Point and Analog rate to 1600, which will produce an analog ratio of 1.
 <code>
-modify_point_rate
+Modify_Point_Rate
-/point_rate=1600
+/POINT_RATE=1600
-/analog_rate=1600
+/ANALOG_RATE=1600
-! /overwrite_c3d_file=false
+! /OVERWRITE_C3D_FILE=FALSE
 ;
 </code>
-this is useful for analog only c3d files because event labels can only be computed at point rate.
+This is useful for analog-only c3d files because [[visual3d:documentation:c3d_signal_types:event_label_data_type|Event Labels]] can only be computed at POINT rate.
+===== See Also =====
-\\
+[[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]
-[[visual3d:documentation:pipeline:general_information:pipeline_commands_reference|back to pipeline commands reference]]