--- a
+++ b/README.md
@@ -0,0 +1,114 @@
+
+<h1>Effect of Deep Brain Stimulation on Parkinsonian Tremor</h1>
+<p><strong>Published:</strong> August 27, 2001 | <strong>Version:</strong> 1.0.0</p>
+
+<hr>
+
+<h2>Standard Citation</h2>
+
+Goldberger, A., Amaral, L., Glass, L., Hausdorff, J., Ivanov, P.C., Mark, R., ... & Stanley, H.E. (2000).<br>
+PhysioBank, PhysioToolkit, and PhysioNet: Components of a new research resource for complex physiologic signals.<br>
+<em>Circulation [Online].</em> 101(23), pp. e215–e220.
+
+<hr>
+
+<h2>Data Description</h2>
+<p>
+This database contains <strong>rest tremor velocity</strong> recordings of the index finger from <strong>16 subjects</strong> with <strong>Parkinson's disease (PD)</strong> who underwent <strong>deep brain stimulation (DBS)</strong> at one of three targets:
+<ul>
+<li><strong>Vim</strong>: Ventro-intermediate nucleus of the thalamus (n = 3)</li>
+<li><strong>GPi</strong>: Internal Globus Pallidus (n = 7)</li>
+<li><strong>STN</strong>: Subthalamic Nucleus (n = 6)</li>
+</ul>
+</p>
+
+<p>DBS delivers high-frequency stimulation (>100 Hz) to relieve Parkinsonian symptoms such as tremor, rigidity, and dyskinesia.</p>
+
+<hr>
+
+<h2>Experimental Setup</h2>
+<ul>
+<li><strong>Recording method:</strong> Laser velocity transducer directed at the fingertip.</li>
+<li><strong>Testing conditions:</strong>
+    <ul>
+        <li>Two DBS conditions: <em>On</em> and <em>Off</em></li>
+        <li>Two Medication conditions: <em>On</em> (150% morning dose) and <em>Off</em> (≥12 hours off meds)</li>
+        <li>55 recordings under DBS/Medication conditions (~60 seconds each)</li>
+        <li>46 recordings during DBS withdrawal at 15-minute intervals</li>
+    </ul>
+</li>
+<li>Not all subjects completed all test combinations.</li>
+</ul>
+
+<hr>
+
+<h2>Subjects</h2>
+<p>Subjects were divided into two groups:</p>
+<ul>
+<li><strong>Group 1:</strong> High Amplitude Tremor (HAT, Subjects 1–8)</li>
+<li><strong>Group 2:</strong> Low Amplitude Tremor (LAT, Subjects 9–16)</li>
+</ul>
+
+<p><strong>subject_description.txt</strong> includes:</p>
+<ul>
+<li>Age, Gender</li>
+<li>Stimulation target and side (bilateral/unilateral)</li>
+<li>Stimulation frequencies, intensity, and pulse width</li>
+<li>DBS surgery years and medication doses</li>
+</ul>
+
+<hr>
+
+<h2>Filename Structure</h2>
+<p>Filenames indicate experimental conditions as:</p>
+<p><code>[SubjectID][TremorType][DBSCondition][(MinutesSinceDBSStop)][MedicationCondition].[SideTested]</code></p>
+
+<p><strong>Examples:</strong></p>
+<ul>
+<li><code>s6ren.let</code>: STN subject 6, DBS on, medication on, left finger.</li>
+<li><code>v4rof.rit</code>: Vim subject 4, DBS off, medication off, right finger.</li>
+<li><code>g1r30of.rit</code>: GPi subject 1, 30 min after DBS off, medication off, right finger.</li>
+</ul>
+
+<hr>
+
+<h2>Tremor Recording Categories</h2>
+<table border="1" cellspacing="0" cellpadding="5">
+<thead>
+<tr>
+<th>Code</th>
+<th>DBS Condition</th>
+<th>Medication Condition</th>
+<th>HAT recordings</th>
+<th>LAT recordings</th>
+</tr>
+</thead>
+<tbody>
+<tr><td>ren</td><td>DBS on</td><td>Medication on</td><td>5</td><td>8</td></tr>
+<tr><td>ref</td><td>DBS on</td><td>Medication off</td><td>5</td><td>8</td></tr>
+<tr><td>ron</td><td>DBS off</td><td>Medication on</td><td>7</td><td>8</td></tr>
+<tr><td>rof</td><td>DBS off</td><td>Medication off</td><td>6</td><td>8</td></tr>
+<tr><td>r15of</td><td>DBS off 15 min</td><td>Medication off</td><td>3</td><td>8</td></tr>
+<tr><td>r30of</td><td>DBS off 30 min</td><td>Medication off</td><td>4</td><td>8</td></tr>
+<tr><td>r45of</td><td>DBS off 45 min</td><td>Medication off</td><td>3</td><td>8</td></tr>
+<tr><td>r60of</td><td>DBS off 60 min</td><td>Medication off</td><td>4</td><td>8</td></tr>
+</tbody>
+</table>
+
+<p><strong>Total:</strong> HAT: 37 recordings | LAT: 64 recordings</p>
+
+<hr>
+
+<h2>Visual Examples</h2>
+<ul>
+<li><strong>g2.gif</strong>: Tremor under different DBS and medication conditions.</li>
+<li><strong>vlaser.gif</strong>: Laser-based velocity recording setup.</li>
+</ul>
+
+<hr>
+
+<h2>Reference</h2>
+
+Beuter, A., Titcombe, M.S., Richer, F., Gross, C., Guehl, D. (2001).<br>
+<em>Effect of deep brain stimulation on amplitude and frequency characteristics of rest tremor in Parkinson's disease.</em><br>
+Thalamus & Related Systems, 1(3): 203–211.