• Specifications
• DataAnalysis
• FileAssociation

File Association

1. Setting up the Directory
   1. Transfer EXPORT folder from flash drive, place in MULTIS_trials folder
   2. The autoMatcher.py script will unpack the zipped directory if not already done.
   3. The directory will unpack to the following, do not run before changing subjectID in the fileName.py script.

      • MULTIS_trials

        • MULTIS###-# (Subject folder containing all data)

          • Configuration - Configuration files and subject XML

          • Data - All "tdms" files

          • Ultrasound - All "dicom" files

      • PulseWidths300.csv - contains key to decode file association pulse

      • PythonScripts

        • fileName.py

        • autoMatcher.py

        • manualMatcherFA.py

        • plotterFA.py

        • XMLparser.py

        • dataQuality.py

        • tdsmParserMultis.py

2. Running the file association script (autoMatcher.py)
   1. Install libraries as requested
   2. Change Subject ID to match desired Subject ID

   3. Ensure Plot is True to save all FileAssociation plots

   4. Run script.
   5. Check directory in file browser under the subject folder for the following additions

      • FileAssociation - folder

      • TimeSynchronization.txt - file containing trial numbers and delta T's of accepted trials only

      • MULTIS###-#readme.txt - human readable file which summarizes the file matching

      • DataOverview (if auto matching was 100% successful)

3. Manually Matching
   1. Open the 'MULTIS###-#readme.txt' file
      • Note the Unmatched and Accepted Trials, specifically the binary column
   2. Examine any files beginning with 'NMa', meaning no match found
      1. Locate the start and end pluses, each a burst of two peaks.
      2. Compare the binary of the trial run number to each of the pulse sequences found in the 'NMa' png's. Note the file names of each. At this point, it is known which file each of the missing accepted trial numbers belong to.

   3. Open manualMatcherFA.py.

   4. Change the directory file names in the fileName.py script to each pair of matching files found in step 2.

   5. Run the plotterFA.py script, ensuring iteration is set to zero.
   6. Examine the figure generated.
      1. The pulse extracted from the dicom (bottom of figure) should match the pulse from the tdms file (top of figure). Note the dicom pulse will not always begin at the left most portion of the window as it is a continuous loop in the ultrasound machine.
   7. Run the script
      1. The filename of the dicom and tdms changed appropriately
      2. The trial number and time synch were added to

         • MULTIS###-#readme.txt

         • TimeSynchronization.txt

      3. The updated PNG was added to the FileAssociation folder

      4. The new DataOverview PNG was added to DataOverview