--- a
+++ b/README.md
@@ -0,0 +1,81 @@
+<h1>A dataset for the investigation of upper limb torque prediction from EMG signals</h1>
+
+<h2>Creators</h2>
+<ul>
+  <li>Quesada, Lucas (Contact person)<sup>1, 2</sup></li>
+  <li>Verdel, Dorian (Researcher)<sup>3</sup></li>
+  <li>Bruneau, Olivier (Supervisor)<sup>4</sup></li>
+  <li>Berret, Bastien (Supervisor)<sup>1, 2</sup></li>
+  <li>Amorim, Michel-Ange (Supervisor)<sup>1, 2</sup></li>
+  <li>Vignais, Nicolas (Supervisor)<sup>5, 6</sup></li>
+</ul>
+
+<h2>Description</h2>
+
+<h3>Motivation</h3>
+<p>
+EMG-driven exoskeleton assistance requires the use of intention detection models to associate electromyographic signals with some feature of human movement, such as angular position, velocity, or joint torque. The goal of this dataset is to provide data that allows the benchmarking of such models for a variety of movements.
+</p>
+
+<h3>Short description</h3>
+<p>
+This dataset includes kinematic, dynamic and electromyographic data from 17 participants (11 males, age 28.2 ± 7 years, height 175.4 ± 7 cm, weight 70 ± 11 kg). These data were collected during the performance of a sagittal plane upper limb tracking task for single joint (elbow flexion/extension) and multiple joint (elbow and shoulder flexion/extension).
+</p>
+
+<h3>Methodology</h3>
+<p>
+A detailed description of the data collection methodology can be found here:
+<a href="https://www.biorxiv.org/content/10.1101/2024.01.11.575155v1" target="_blank">https://www.biorxiv.org/content/10.1101/2024.01.11.575155v1</a>
+</p>
+
+<h3>Data Description</h3>
+<p>
+The dataset consists of 17 folders, one for each participant. Inside each folder you will find:
+</p>
+<ul>
+  <li>A metadata file (<code>SXX.json</code>) containing information about the subject: age, sex, weight, height, and upper limb masses and lengths.</li>
+  <li>An OpenSim model file (<code>scaledModel.osim</code>) containing a scaled upper limb model of the given subject.</li>
+  <li>A <strong>MVC</strong> folder containing EMG data from maximal voluntary contraction trials.</li>
+  <li>A <strong>SJ</strong> folder containing trial folders for the single joint condition (elbow flexion/extension).</li>
+  <li>A <strong>MJ</strong> folder containing test folders for the multi-joint condition (elbow and shoulder flexion/extension).</li>
+</ul>
+
+<h3>EMG Data</h3>
+<p>
+The files containing EMG data have the following header:
+</p>
+<pre><code>TIME, DELTAnt, DELTMed, DELTPost, PECT, LATI, TRILong, TRILat, TRIMed, BICLong, BICShort, BRA, BRD</code></pre>
+<p>
+This corresponds to a time stamp and EMG signals from the anterior, median and posterior deltoids, pectoralis major, latissimus dorsi, long, lateral and median triceps, long and short biceps, brachioradialis and brachialis.
+</p>
+
+<h3>MVC Data</h3>
+<p>
+The <strong>MVC</strong> folder contains two files: <code>emgMVCElbow.csv</code> and <code>emgMVCShoulder.csv</code>. They were collected during the realization of maximum voluntary contraction tasks and contain raw EMG data sampled at 2 kHz.
+</p>
+
+<h3>Trial Data</h3>
+
+<h4>Single-joint condition</h4>
+<p>Each single-joint trial contains 5 files:</p>
+<ul>
+  <li><code>emgFilt.csv</code>: Filtered EMG signals (20–450 Hz bandpass filter, rectification, 3Hz lowpass, normalized with MVC), sampled at 100 Hz.</li>
+  <li><code>emgRaw.csv</code>: Raw EMG signals, sampled at 2 kHz.</li>
+  <li><code>humanPositions.csv</code>: Angular position of the elbow in radians, sampled at 100 Hz.</li>
+  <li><code>humanVelocities.csv</code>: Angular velocity of the elbow in rad/s, sampled at 100 Hz.</li>
+  <li><code>muscleTorque.csv</code>: Joint torque of the elbow in N·m, sampled at 100 Hz.</li>
+</ul>
+
+<h4>Multi-joint condition</h4>
+<p>Each multi-joint trial contains 5 files:</p>
+<ul>
+  <li><code>emgFilt.csv</code>: Filtered EMG signals, same processing as single-joint, sampled at 100 Hz.</li>
+  <li><code>emgRaw.csv</code>: Raw EMG signals, sampled at 2 kHz.</li>
+  <li><code>humanPositions.csv</code>: Angular positions of the upper limb in radians, sampled at 100 Hz.</li>
+  <li><code>humanVelocities.csv</code>: Angular velocities of the upper limb in rad/s, sampled at 100 Hz.</li>
+  <li><code>muscleTorque.csv</code>: Joint torques of the upper limb in N·m, sampled at 100 Hz.</li>
+</ul>
+
+<p>For multi-joint trials, kinematic and torque files use the following headers:</p>
+<pre><code>TIME, elv_angle, shoulder_elv, shoulder_rot, elbow_flexion, pro_sup, deviation, flexion</code></pre>
+<p>Columns of interest for sagittal plane movements: <code>shoulder_elv</code> (shoulder flexion/extension), <code>elbow_flexion</code> (elbow flexion/extension).</p>