Data Dictionary v1

Table of contents
  1. File Tree
  2. Participant Clinical Measurements and Survey Responses
  3. Electrocardiograms
    1. 12 Lead ECG Waveforms
    2. Single Lead ECG Waveforms
  4. Echocardiogram Videos
    1. Transthoracic Echocardiography (TTE) Views
  5. Fundus Images
  6. Chest X-ray Images

File Tree

.
└── tamil-jpal-multi
    ├── echo
    │   ├── 00
    │   │   ├── 00ab...
    │   │   │   ├── 1.mpg
    │   ... ... ...
    │
    ├── ecg-12-lead
    │   └── waveform
    │       ├── 00
    │       │   ├── 00ab...npz
    │       ... ...
    │
    ├── ecg-single-lead
    │   ├── 00
    │   │   ├── 00ab...npz
    │   ... ... 
    │
    ├── fundus
    │   ├── 00
    │   │   ├── 00ab...
    │   │   │   ├── 1.jpg
    │   ... ... ...
    │
    ├── xray
    │   ├── 00
    │   │   ├── 00ab...jpg
    │   ... ... 
    │
    └── v1
        ├── patient-metrics.csv
        ├── echo-filepath.csv
        ├── ecg-12-lead-filepath.csv
        ├── ecg-single-lead-filepath.csv
        ├── fundus-filepath.csv
        └── xray-filepath.csv

Participant Clinical Measurements and Survey Responses

patient-metrics.csv contains the following medical data.

  • Vitals - Blood Pressure, Pulse rate, Respiratory rate, SPO2
  • Physical measures - Height, Weight, Waist/Hip/Mid-arm Circumference
  • Fitness measures - Endurance test, Grip test
  • Eye Measures - Tonometry, Fundus observations
  • Cognition Score (MMSE short-form)
  • Smoking Status responses
  • Blood test data
  • PHQ 4, Direct loneliness responses
Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 24fc123…
year Year of survey int 2023
verbal_consent Whether verbal consent was provided?
Yes,No
string Yes
age Age of the respondent (value 999 represents age 90 and above) int 60
sex Sex of the respondent
Female,Male
string Female
bp Whether bp was measured?
Yes,No
string Yes
bp_systolic, bp_diastolic Blood pressure in mmHg int 80
pulse Whether pulse rate was measured?
Yes,No
string Yes
pulse_entry Pulse rate in beats per min int 83
resp_rate Whether respiratory rate was measured?
Yes,No
string Yes
resp_rate_entry Respiratory rate in breaths per min int 22
spo2 Whether SPO2 was measured?
Yes,No
string Yes
spo2_entry SPO2 level in % float 98.0
rbs Whether random blood sugar was measured?
Yes,No
string Yes
rbs_entry Random blood sugar in mg/dL float 138.0
height Whether height was measured?
Yes,No
string Yes
height_entry Height in cm float 155.0
weight Whether weight was measured?
Yes,No
string Yes
weight_entry Weight in kg float 60.0
midarm_circum Whether MUAC was measured?
Yes,No
string Yes
midarm_circum_entry Mid-arm circumference in cm float 28.0
waist_circum Whether waist circumference was measured?
Yes,No
string Yes
waist_circum_entry Waist circumference in cm float 88.0
hip_circum Whether hip circumference was measured?
Yes,No
string Yes
hip_circum_entry Hip circumference in cm float 96.0
endurance_test Whether endurance test was conducted?
Yes,No
string Yes
endurance_test_entry Endurance test result in terms of no. of unassisted stands int 11
grip_left, grip_right Whether grip test was conducted, left and right hand?
Yes,No
string Yes
grip_left_entry, grip_right_entry Grip test reading for left and right hand in kg float 16.2
tonometry_lefteye, tonometry_righteye Whether tonometry was conducted, left and right eye?
Yes,No
string Yes
tonometry_lefteye_entry, tonometry_righteye_entry Tonometry reading for left and right eye in mmHg float 17.3
fundus_lefteye, fundus_righteye Whether the fundus examination was conducted, left and right eye?
Yes,No
string Yes
fundus_lefteye_obs, fundus_righteye_obs Observations of the optometrist for left and right eye string
cognition_sf Whether MMSE short-form was conducted?
Yes,No
string Yes
cognition_sf_score Score obtained on the MMSE short-form out of 16 int 13
cognit_impaired Whether the MMSE short-form indicated cognitive impairment?
Yes,No
If the score is <8, the respondent has cognitive impairment
string Yes
       
Hb Hemoglobin in g/dl float 12.3
HbA1c HbA1c in % float 6.0
triglycerides_mg_dl Triglycerides Cholesterol in mg/dl int 177
tot_cholesterol_mg_dl Total Cholesterol in mg/dl int 201
HDL_mg_dl HDL Cholesterol in mg/dl int 42
LDL_mg_dl LDL Cholesterol in mg/dl float 117.0
VLDL_mg_dl VLDL Cholesterol in mg/dl float 35.4
totchol_by_hdl_ratio Total Cholesterol/HDL ratio float 4.8
ldl_by_hdl_ratio LDL/HDL ratio float 2.77
creatinine_mg_dl Serum Creatinine in mg/dl float 0.9
       
literate Whether the respondent is literate?
Yes,No
string Yes
smoking_1 Do you currently smoke tobacco on a daily basis, less than daily, or not at all?
Daily,Less than daily,Not at all,Refused,Don’t know
Source: GATS
string Not at all
smoking_2 Have you smoked tobacco daily in the past?
Yes,No,Refused,Don’t know
Source: GATS
string Yes
smoking_3 In the past, have you smoked tobacco on a daily basis, less than daily, or not at all?
Daily,Less than daily,Not at all,Refused,Don’t know
Source: GATS
string Not at all
  The next four fields correspond to the responses of the 4-item patient health questionnaire on anxiety and depression. Source: PHQ-4
Over the last two weeks, how often have you been bothered by the following problems?
Not at all,Several days,More than half the days,Nearly everyday,Refused,Don't know
   
phq_1 Feeling nervous, anxious or on edge string Not at all
phq_2 Not being able to stop or control worrying string Not at all
phq_3 Feeling down, depressed or hopeless string Not at all
phq_4 Little interest or pleasure in doing things string Not at all
direct_lonely Over the last two weeks, how often have you been feeling lonely?
Not at all,Several days,More than half the days,Nearly everyday,Refused
string Several days
  • Rows: 4,448
  • Columns: 62

Electrocardiograms

This dataset contains electrocardiograms from two different devices. The first device produces a 12 lead ECG with a sample rate of 1000 Hz. The second device produces a single lead ECG with a sample rate of 300 Hz.

12 Lead ECG Waveforms

ecg-12-lead-filepath.csv

Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 00ab…
filepath Path to file string path/to/file
  • Rows: 3,827
  • Columns: 2

The ECG filepaths have the following structure:
ecg-12-lead/waveform/{first two digits of patient_ngsci_id}/{patient_ngsci_id}.npz

The waveform data for each ECG is stored in a separate compressed NumPy file. numpy.load doc. These files contain two arrays.

  • 'waveform' - Raw waveform. Shape: (12, 10000)
  • 'beat_waveform' - Beat waveform derived from the raw waveform data. Shape: (12, various)

Single Lead ECG Waveforms

ecg-single-lead-filepath.csv

Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 00ab…
filepath Path to file string path/to/file
  • Rows: 4,224
  • Columns: 2

The ECG filepaths have the following structure:
ecg-single-lead/{first two digits of patient_ngsci_id}/{patient_ngsci_id}.npz

The waveform data for each ECG is stored in a separate compressed NumPy file. numpy.load doc. These files contain two arrays.

  • 'raw_waveform' - Raw waveform. Shape: (9000,)
  • 'enhanced_waveform' - Enhanced waveform derived from the raw waveform data. Shape: (9000,)

Echocardiogram Videos

echo-filepath.csv

Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 00ab…
echo_view TTE views of video int 1
video_format The format of the video file string MPEG
filepath Path to file string path/to/file
  • Rows: 52,099
  • Columns: 4

The echocardiogram videos are not uniformly formatted. There are three formats: AVI, MPEG, MP4. The filenames of the videos corresponds to one of 13 views, as seen below.

Transthoracic Echocardiography (TTE) Views

  1. PSLAX: 2D
  2. PSLAX: color (for assessing aortic and mitral regurgitation)
  3. PSAX at AOV level: 2D
  4. PSAX at AOV level: color
  5. PSAX at MV level (visualize MV orifice)
  6. PSAX at MV level: Color
  7. PSAX at PAP level
  8. Apical: Four-chamber: 2D (full visualization of atria and ventricles)
  9. Apical: Four-chamber: color mitral regurgitation
  10. Apical: Four-chamber: color tricuspid regurgitation
  11. Apical: Five-chamber: color aortic regurgitation
  12. Subcostal: 2D for interatrial septum
  13. IVC: volume and IVC collapse

Acronyms: AOV, Aortic valve; MV, mitral valve; PAP, papillary muscle; PSAX, parasternal short-axis view; PSLAX, parasternal long-axis view; 2D, two-dimensional

Fundus Images

fundus-filepath.csv

Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 00ab…
image_number The image number int 1
filepath Path to file string path/to/file
  • Rows: 18,445
  • Columns: 3

Most patients have four images. The technicians were instructed to take and save four images per person in the following order: Left disc view, Left macular view, Right disc view, Right macular view.

Chest X-ray Images

xray-filepath.csv

Column Name Description Data Type Example
patient_ngsci_id Unique identifier for each respondent string 00ab…
filepath Path to file string path/to/file
  • Rows: 3,887
  • Columns: 2

Patients will have at most one X-ray.


Copyright © 2021-2023 Nightingale Open Science. All rights reserved.