Differences

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

--- visual3d:documentation:visual_3d_formating:json_formats [2024/06/19 14:04] – created sgranger
+++ visual3d:documentation:visual_3d_formating:json_formats [2026/03/26 15:20] (current) – Cleaned up page. wikisysop
@@ Line 1: / Line 1: @@
-Saving data in JSON (Javascript Object Notation) format is useful for web-based graphing and presentations. JSON is a human-readable format and is typically used to pass data from a web server to a javascript program in a web browser.\\
+====== JSON Formats ======
+The JSON (Javascript Object Notation) format is an incredibly flexible file format that is useful for web-based graphing and presentations. JSON is a human-readable format and is typically used to pass data from a web server to a javascript program in a web browser. Although the JSON format is not specific to motion capture or biomechanics, Visual3D offers limited support for both reading and writing the format.
-The JSON output file from Visual3D can then be parsed and used by a javascript, ES6, or PHP program for use on the web.
+===== Reading JSON Files =====
-\\
+The only JSON file format currently supported to be read in by Visual3D is the markerless motion capture format used in Maple Leafs Sports and Entertainment's [[https://github.com/mlsedigital/SPL-Open-Data|SPL Open Data repository]]. Visual3D will automatically build a model for this data as it does for other markerless motion capture files.
-//This option is only available in Visual3D version 2020.06.01 and later.//\\
-There is an example javascript parsing program available for web graphing of Visual3D data. However, because it requires specialized coding knowledge it is only available by request from C-Motion support.
-\\
+==== Important Notes ====
+Some motion capture vendors, such as [[https://www.qualisys.com/|Qualisys]] and [[visual3d:documentation:third-party:theia|Theia]], allow users to export motion capture data to the JSON format. In the case of following on processing in Visual3D, however, we recommend that users export their motion capture data to the [[visual3d:documentation:c3d_signal_types:c3d_format|C3D format]] instead.
-====== Report Graph Export ======
+===== Writing JSON Files =====
-**The first option is used to export the data used in a report graph.** This requires that you first create your report and graphs ([[Visual3D:Documentation:Reports:Reports_Overview|Documented here]]). Select the report you want to export, and select the JSON output option from the pop-up dialog.
+Visual3D can produce a JSON output file that can then be parsed and used by a javascript, ES6, or PHP program for use on the web. This option is only available in Visual3D version 2020.06.01 and later.
-\\
+The format of the export is different depending on where in Visual3D you generate the export.
-{{exportreport.png}}
-If the mean and standard deviation were displayed in the graph, they will be in the exported data too. The JSON format for mean and std dev are similar to the normal ASCII output in that the 2 X-components are listed first, and then the 2 Y components. The graphed data is listed in X and Y sections together.
+==== Example 1: Report Graph Export ====
-The JSON output is a single array for the graph, with sub-arrays for signal information and for data.
+This example demonstrates how to export data from a report graph to JSON format. This requires that you first create your report and graphs ([[Visual3D:Documentation:Reports:Reports_Overview|Documented here]]).
-\\
+. Select the report you want to export and select the JSON output option from the pop-up dialog.
+{{:exportreport.png}}
+. If the mean and standard deviation were displayed in the graph, they will be in the exported data too. The JSON format for mean and std dev are similar to the normal ASCII output in that the 2 X-components are listed first, and then the 2 Y components. The graphed data is listed in X and Y sections together.
+The JSON output is a single array for the graph, with sub-arrays for signal information and for data.
+<code>
 {"title": "graph_title_here", "graphdata" : [
 {"filename": "C:/Visual3D/Data/Full Body Gait/FullBodyWalking.c3d",
@@ Line 43: / Line 48: @@
 }
 ]}
-====== Export Data As ASCII Command ======
+</code>
-**The more general option** is to use the [[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File|Export_Data_To_ASCII_File]] **pipeline command**. Simply check the JSON format checkbox in the dialog, or un-comment and change the parameter USE JSON FORMAT = TRUE; from the textual interface.
+==== Example 2: Export Data As ASCII Command ====
-The resulting JSON output format for that is:
+The more general option is to use the [[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File|Export_Data_To_ASCII_File]] pipeline command.
+. Simply check the JSON format checkbox in the dialog or un-comment and change the parameter USE JSON FORMAT = TRUE from the textual interface.
+The resulting JSON output format for this export is:
+<code>
 {"Visual3D" : [
 {"filename" : "Mean"
@@ Line 61: / Line 71: @@
 ]}
 ]}
+</code>