Data Sharing Specification

Data sharing is NiDB is accomplished by creating a data package at the sending site, and importing the package at the receiving site. The package is a tarball (.tar.gz) file which contains the data, meta-data, and site information. The format for the package is described below. It can contain multiple subjects, studies, and series.

  • .tar.gz
    • site.xml
    • S1234ABC(subject UID)
      • subject.xml
      • enrollment.xml
      • N(study number)
        • studyN.xml
        • N1 (series number)
          • seriesN1.xml
          • data (dicom, parrec, nifti, eeg, etc…)
          • qa (for MR only)
            • qa.xml
            • qa data
          • thumb.gif, thumb.png (thumbnails of data)
        • N2 (series number)
          • seriesN2.xml
          • data (dicom, parrec, nifti, eeg, etc…)
          • qa (for MR only)
          • thumb.gif, thumb.png (thumbnails of data)
site.xml
Field Datatype Description
site_uuid string Site UUID. generated by site at installation
site_name string Name
site_address string Institution address
site_contact string email or phone number
subject.xml
Field Datatype Description
birthdate YYYY-MM-DD birthdate (may be empty; 0000-00-00; 1776-07-04; 1000-01-01; or null)
gender character possible values: M (male); F (female); O (other); U (unknown) or null
ethnicity1 string possible values 'hispanic' 'nothispanic' or empty
ethnicity2 string possible values: 'indian' 'asian' 'black' 'islander' 'white' or empty
height decimal height in cm
weight decimal weight in kg
handedness character possible values R (right); L (left); A (ambidextrous); U (unknown) or empty
education integer passible values 0(Unknown) 1(Grade School) 2(Middle School) 3(High School/GED) 4(Trade School) 5(Associates Degree) 6(Bachelors Degree) 7(Masters Degree) 8(Doctoral Degree)
uid string original UID of subject in the exporting site's database
uuid string MD5 hash generated from the concatenation of name-birthdate-gender and removal of spaces and nonalphanumeric characters. Can be compared against existing subjects in receiving site to detect duplicates by name/dob/sex.
enrollment.xml
Field Datatype Description
enroll_subgroup string subgroup for this subject in the enrolled project such as 'control' 'patient' etc
study.xml
Field Datatype Description
study_num integer Study number
study_desc string study description
study_alternateid string alternate ID for the study
study_modality string modality
study_datetime datetime study date/time
study_ageatscan integer age at study in years
study_height decimal height in cm
study_weight decimal weight in kg
study_bmi decimal Body-mass index
study_performingphysician string
study_site string unique equipment code name
study_institution string institution where the study was performed
study_notes string any notes relevent to the study
study_radreadfindings string any radiological reading incidental findings
series.xml
Field
Series fields are dependent on the modality of the table they come from
qa.xml
Field Datatype Description
io_snr decimal Inside/outside SNR
pv_snr decimal Per-voxel SNR (4D only)
move_min(x/y/z) decimal Minimum (negative) movement in mm in the x/y/z directions (4D only)
move_max(x/y/z) decimal Maximum (positive) movement in mm in the x/y/z directions (4D only)
acc_min(x/y/z) decimal Minimum (negative) acceleration (derivative) in mm in the x/y/z directions (4D only)
acc_max(x/y/z) decimal Maximum (positive) acceleration (derivative) in mm in the x/y/z directions (4D only)
rot_min(p/r/y) decimal Minimum (negative) rotation in radians in the pitch/roll/yaw directions (4D only)
rot_max(p/r/y) decimal Maximum (positive) rotation in radians in the pitch/roll/yaw directions (4D only)
motion_rsq decimal Motion artifact estimation for 3D images

Leave a Reply

Your email address will not be published. Required fields are marked *

*


2 × = sixteen

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>