From 9a0425a3a6cf91ce4c28d71d9b04908018cf8c85 Mon Sep 17 00:00:00 2001 From: Anthony Remazeilles Date: Fri, 3 Apr 2020 19:03:10 +0200 Subject: [PATCH] use table for format spec --- .gitignore | 3 +- data_format.adoc | 107 +++++++++++++++++++++++++++++++---------------- 2 files changed, 73 insertions(+), 37 deletions(-) diff --git a/.gitignore b/.gitignore index 0b84df0..2623dd6 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ -*.html \ No newline at end of file +*.html +.vscode \ No newline at end of file diff --git a/data_format.adoc b/data_format.adoc index 0e84685..ac4a70f 100644 --- a/data_format.adoc +++ b/data_format.adoc @@ -119,14 +119,21 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. **File structure**: -* 1st column: time-stamp (units: milliseconds). -* 1st row: header with M+1 labels were M = number of angles considered. -* From 2nd row: angle values, each corresponding to one time sample. +.Joint angle file structure +[options="header"] +|================ +| time | r_hip_x | r_hip_y | r_hip_z | r_knee_x | r_knee_y | r_knee_z | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +|================ -**Header labels**: 1st-column label: “time”. -All other labels: see ‘Angle definition’ section. -**Units**: Degrees +.Joint angle file unit +[options="header"] +|================ +| time | r_hip_x | r_hip_y | r_hip_z | r_knee_x | r_knee_y | r_knee_z | ... | ... | ... +| `msec` | `deg` | `deg` | `deg` | `deg` | `deg` | `deg` | ... | ... | ... +|================ === Joint torques file @@ -139,14 +146,20 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. **File structure**: -* 1st column: time-stamp (units: milliseconds). -* 1st row: header with (3*M)+1 labels were M = number of joints. -* From 2nd row: torque values, each corresponding to one time sample. - -**Header labels**: 1st-column label: “time”. -All other labels: see the ‘Angle definition’ section. +.Joint torque file structure +[options="header"] +|================ +| time | r_hip_x | r_hip_y | r_hip_z | r_knee_x | r_knee_y | r_knee_z | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +|================ -**Units**: Nm +.Wrench file unit +[options="header"] +|================ +| time | r_hip_x | r_hip_y | r_hip_z | r_knee_x | r_knee_y | r_knee_z | ... | ... | ... +| `msec` | `Nm` | `Nm` | `Nm` | `Nm` | `Nm` | `Nm` | ... | ... | ... +|================ === Joint centers 3D trajectories file @@ -159,14 +172,23 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. **File structure**: -* 1st column: time-stamp (units: milliseconds). -* 1st row: header with (3*M)+1 labels were M = number of joints. -* From 2nd row: 3D trajectories, each corresponding to one time sample. -**Header labels**: 1st-column label: “time”. -All other labels: see the Figure 2. +.3D joint center file structure +[options="header"] +|================ +| time | r_ankle_x | r_ankle_y | r_ankle_z | r_knee_x | r_knee_y | r_knee_z | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... +|================ + +.3D joint center unit +[options="header"] +|================ +| time | r_ankle_x | r_ankle_y | r_ankle_z | r_knee_x | r_knee_y | r_knee_z | .. +| `msec` | `mm` | `mm` | `mm` | `mm` | `mm` | `mm` | ... | ... | ... +|================ -**Units**: Millimeters +Possible labels are listed on Figure <>. [[fig:df_joint_center_label]] .Labels of Joints centers @@ -191,7 +213,6 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. | ... | ... | ... | ... | ... | ... | ... |================ -**Units**: .Wrench file unit [options="header"] |================ @@ -211,19 +232,23 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. **File structure**: -* 1st column: time-stamp (units: milliseconds). -* 1st row: 9+1 labels. -* From 2nd row: GRF, each corresponding to one time sample. - -**Header labels**: 1st-column label: “time”. -Other labels: +.Ground Reaction Forces file structure +[options="header"] +|================ +| time | f_x | f_y | f_z | p_x | p_y | p_z | t_x | t_y | t_z +| ... | ... | ... | ... | ... | ... | ... | ... | ... +| ... | ... | ... | ... | ... | ... | ... | ... | ... +|================ -* force: `F_x` , `F_y` , `F_z` -* centre of pressure: `P_x`, `P_y`, `P_z` -* moment: `T_x` , `T_y` , `T_z` +where `f` stands for force, `p` for the center of pressure, and `t` for torques. +.Ground Reaction Forces file unit +[options="header"] +|================ +| time | f_x | f_y | f_z | p_x | p_y | p_z | t_x | t_y | t_z +| `msec` | `N` | `N` | `N` | `m` | `m` | `m` | `N.m` | `N.m` | `N.m` +|================ -**Units**: Newtons, meters and Nm === Electromyography file @@ -234,15 +259,25 @@ Use appropriate leading zeros for R and N to ensure proper ordering of files. **File format**: .csv -**File structure**: -* 1st column: time-stamp (units: milliseconds). -* 1st row: k+1 labels, with K = number of muscles. -* From 2nd row: EMG, each corresponding to one time sample. +.EMG file structure +[options="header"] +|================ +| time | label_1 | ... | labeli | ... +| ... | ... | ... | ... | ... +| ... | ... | ... | ... | ... +|================ -**Header labels**: 1st-column label: “time”. -All other labels: see the Figure 2. +where `label_i` is to be a tag described in table <>. + +.EMG file unit +[options="header"] +|================ +| time | label_1 | ... | labeli | ... +| `ms` | `mV` | `mV` | `mV` | `mV` +|================ +[[tab:emg_tags]] .List of EMG muscles and labels considered. [options="header"] |================