djmoffat@718: #!/usr/bin/python
djmoffat@718: 
djmoffat@718: import xml.etree.ElementTree as ET
djmoffat@718: import os # list files in directory
djmoffat@718: import sys # command line arguments
djmoffat@718: import matplotlib.pyplot as plt # plots
djmoffat@718: import matplotlib.patches as patches # rectangles
djmoffat@718: 
djmoffat@718: 
djmoffat@718: # COMMAND LINE ARGUMENTS
djmoffat@718: 
djmoffat@718: assert len(sys.argv)<3, "timeline_view_movement takes at most 1 command line argument\n"+\
djmoffat@718:                         "Use: python timeline_view_movement.py [XML_files_location]"
djmoffat@718: 
djmoffat@718: # XML results files location
djmoffat@718: if len(sys.argv) == 1:
djmoffat@718:     folder_name = "../saves"    # Looks in 'saves/' folder from 'scripts/' folder
djmoffat@718:     print "Use: python timeline_view_movement.py [XML_files_location]"
djmoffat@718:     print "Using default path: " + folder_name
djmoffat@718: elif len(sys.argv) == 2:
djmoffat@718:     folder_name = sys.argv[1]   # First command line argument is folder
djmoffat@718: 
djmoffat@718: # check if folder_name exists
djmoffat@718: if not os.path.exists(folder_name):
djmoffat@718:     #the file is not there
djmoffat@718:     print "Folder '"+folder_name+"' does not exist."
djmoffat@718:     sys.exit() # terminate script execution
djmoffat@718: elif not os.access(os.path.dirname(folder_name), os.W_OK):
djmoffat@718:     #the file does exist but write privileges are not given
djmoffat@718:     print "No write privileges in folder '"+folder_name+"'."
djmoffat@718: 
djmoffat@718: 
djmoffat@718: # CONFIGURATION 
djmoffat@718: 
djmoffat@718: # Folder where to store timelines
djmoffat@718: timeline_folder = folder_name + '/timelines_movement/'    # Stores in 'saves/timelines_movement/' by default
djmoffat@718: 
djmoffat@718: # Font settings
djmoffat@718: font = {'weight' : 'bold',
djmoffat@718:         'size'   : 16}
djmoffat@718: plt.rc('font', **font)
djmoffat@718: 
djmoffat@718: # Colormap for to cycle through
djmoffat@718: colormap = ['b', 'g', 'c', 'm', 'y', 'k']
djmoffat@718: 
djmoffat@718: # figure size
djmoffat@718: fig_width = 25
djmoffat@718: fig_height = 10
djmoffat@718: 
djmoffat@718: 
djmoffat@718: # CODE
djmoffat@718: 
djmoffat@718: # create timeline_folder if not yet created
djmoffat@718: if not os.path.exists(timeline_folder):
djmoffat@718:     os.makedirs(timeline_folder)
djmoffat@718: 
djmoffat@718: # get every XML file in folder
djmoffat@718: for file in os.listdir(folder_name):
djmoffat@718:     if file.endswith(".xml"):
djmoffat@718:         tree = ET.parse(folder_name + '/' + file)
djmoffat@718:         root = tree.getroot()
djmoffat@718:         subject_id = file[:-4] # drop '.xml'
djmoffat@718:         
djmoffat@718:         previous_audioholder_time = 0 # time spent before current audioholder
djmoffat@718:         time_offset = 0 # test starts at zero
djmoffat@718:         
djmoffat@718:         # ONE TIMELINE PER PAGE - make new plot per page
djmoffat@718: 
djmoffat@718:         # get list of all page names
djmoffat@718:         for audioholder in root.findall("./audioholder"):   # iterate over pages
djmoffat@718:             page_name = audioholder.get('id')               # get page name
djmoffat@718:             plot_empty = True                               # check if any data is plotted
djmoffat@718:             
djmoffat@718:             if page_name is None: # ignore 'empty' audio_holders
djmoffat@718:                 print "Skipping empty audioholder name from "+subject_id+"."
djmoffat@718:                 break
djmoffat@718:                 
djmoffat@718:             # subtract total audioholder length from subsequent audioholder event times
djmoffat@718:             audioholder_time_temp = audioholder.find("./metric/metricresult/[@id='testTime']")
djmoffat@718:             if audioholder_time_temp is not None: 
djmoffat@718:                 audioholder_time = float(audioholder_time_temp.text)
djmoffat@718:             else: 
djmoffat@718:                 print "Skipping audioholder without total time specified from "+subject_id+"."
djmoffat@718:                 break
djmoffat@718: 
djmoffat@718:             # get audioelements
djmoffat@718:             audioelements = audioholder.findall("./audioelement")
djmoffat@718:             
djmoffat@718:             # sort alphabetically
djmoffat@718:             data = []
djmoffat@718:             for elem in audioelements: # from http://effbot.org/zone/element-sort.htm
djmoffat@718:                 key = elem.get("id")
djmoffat@718:                 data.append((key, elem))
djmoffat@718:             data.sort()
djmoffat@718:             
djmoffat@718:             N_audioelements = len(audioelements) # number of audio elements for this page
djmoffat@718:             increment = 0 # increased for every new audioelement
djmoffat@718:             
djmoffat@718:             # get axes handle
djmoffat@718:             fig = plt.figure(figsize=(fig_width, fig_height))
djmoffat@718:             ax  = fig.add_subplot(111)
djmoffat@718:             
djmoffat@718:             # for page [page_name], print comments related to fragment [id]
djmoffat@718:             #for tuple in data:
djmoffat@718:             #    audioelement = tuple[1]
djmoffat@718:             for tuple in data:
djmoffat@718:                 audioelement = tuple[1]
djmoffat@718:                 if audioelement is not None: # Check it exists
djmoffat@718:                     audio_id = str(audioelement.get('id'))
djmoffat@718:                     
djmoffat@718:                     # break if no initial position or move events registered
djmoffat@718:                     initial_position_temp = audioelement.find("./metric/metricresult/[@name='elementInitialPosition']")
djmoffat@718:                     if initial_position_temp is None:
djmoffat@718:                         print "Skipping "+page_name+" from "+subject_id+": does not have initial positions specified."
djmoffat@718:                         break
djmoffat@718:                     
djmoffat@718:                     # get move events, initial and eventual position
djmoffat@718:                     initial_position = float(initial_position_temp.text)
djmoffat@718:                     move_events = audioelement.findall("./metric/metricresult/[@name='elementTrackerFull']/timepos")
djmoffat@718:                     final_position = float(audioelement.find("./value").text)
djmoffat@718:                     
djmoffat@718:                     # get listen events
djmoffat@718:                     start_times_global = []
djmoffat@718:                     stop_times_global  = []
djmoffat@718:                     listen_events = audioelement.findall("./metric/metricresult/[@name='elementListenTracker']/event")
djmoffat@718:                     for event in listen_events:
djmoffat@718:                         # get testtime: start and stop
djmoffat@718:                         start_times_global.append(float(event.find('testtime').get('start'))-time_offset)
djmoffat@718:                         stop_times_global.append(float(event.find('testtime').get('stop'))-time_offset)
djmoffat@718:                     
djmoffat@718:                     # display fragment name at start
djmoffat@718:                     plt.text(0,initial_position+0.02,audio_id,color=colormap[increment%len(colormap)]) #,rotation=45
djmoffat@718:                     
djmoffat@718:                     # previous position and time
djmoffat@718:                     previous_position = initial_position
djmoffat@718:                     previous_time = 0
djmoffat@718:                     
djmoffat@718:                     # assume not playing at start
djmoffat@718:                     currently_playing = False # keep track of whether fragment is playing during move event
djmoffat@718:                                         
djmoffat@718:                     # draw all segments except final one
djmoffat@718:                     for event in move_events: 
djmoffat@718:                         # mark this plot as not empty
djmoffat@718:                         plot_empty = False
djmoffat@718:                     
djmoffat@718:                         # get time and final position of move event
djmoffat@718:                         new_time = float(event.find("./time").text)-time_offset
djmoffat@718:                         new_position = float(event.find("./position").text)
djmoffat@718:                         
djmoffat@718:                         # get play/stop events since last move until current move event
djmoffat@718:                         stop_times = []
djmoffat@718:                         start_times = []
djmoffat@718:                         # is there a play and/or stop event between previous_time and new_time?
djmoffat@718:                         for time in start_times_global:
djmoffat@718:                             if time>previous_time and time<new_time:
djmoffat@718:                                 start_times.append(time)
djmoffat@718:                         for time in stop_times_global:
djmoffat@718:                             if time>previous_time and time<new_time:
djmoffat@718:                                 stop_times.append(time)
djmoffat@718:                         # if no play/stop events between move events, find out whether playing
djmoffat@718:                         
djmoffat@718:                         segment_start = previous_time # first segment starts at previous move event
djmoffat@718:                         
djmoffat@718:                         # draw segments (horizontal line)
djmoffat@718:                         while len(start_times)+len(stop_times)>0: # while still play/stop events left
djmoffat@718:                             if len(stop_times)<1: # upcoming event is 'play'
djmoffat@718:                                 # draw non-playing segment from segment_start to 'play'
djmoffat@718:                                 currently_playing = False
djmoffat@718:                                 segment_stop = start_times.pop(0) # remove and return first item
djmoffat@718:                             elif len(start_times)<1: # upcoming event is 'stop'
djmoffat@718:                                 # draw playing segment (red) from segment_start to 'stop'
djmoffat@718:                                 currently_playing = True
djmoffat@718:                                 segment_stop = stop_times.pop(0) # remove and return first item
djmoffat@718:                             elif start_times[0]<stop_times[0]: # upcoming event is 'play'
djmoffat@718:                                 # draw non-playing segment from segment_start to 'play'
djmoffat@718:                                 currently_playing = False
djmoffat@718:                                 segment_stop = start_times.pop(0) # remove and return first item
djmoffat@718:                             else: # stop_times[0]<start_times[0]: upcoming event is 'stop'
djmoffat@718:                                 # draw playing segment (red) from segment_start to 'stop'
djmoffat@718:                                 currently_playing = True
djmoffat@718:                                 segment_stop = stop_times.pop(0) # remove and return first item
djmoffat@718:                                 
djmoffat@718:                             # draw segment
djmoffat@718:                             plt.plot([segment_start, segment_stop], # x-values
djmoffat@718:                                 [previous_position, previous_position], # y-values
djmoffat@718:                                 color='r' if currently_playing else colormap[increment%len(colormap)],
djmoffat@718:                                 linewidth=3
djmoffat@718:                             )
djmoffat@718:                             segment_start = segment_stop # move on to next segment
djmoffat@718:                             currently_playing = not currently_playing # toggle to draw final segment correctly
djmoffat@718:                         
djmoffat@718:                         # draw final segment (horizontal line) from last 'segment_start' to current move event time
djmoffat@718:                         plt.plot([segment_start, new_time], # x-values
djmoffat@718:                             [previous_position, previous_position], # y-values
djmoffat@718:                             # color depends on playing during move event or not:
djmoffat@718:                             color='r' if currently_playing else colormap[increment%len(colormap)], 
djmoffat@718:                             linewidth=3
djmoffat@718:                         )
djmoffat@718:                         
djmoffat@718:                         # vertical line from previous to current position
djmoffat@718:                         plt.plot([new_time, new_time], # x-values
djmoffat@718:                             [previous_position, new_position], # y-values
djmoffat@718:                             # color depends on playing during move event or not:
djmoffat@718:                             color='r' if currently_playing else colormap[increment%len(colormap)], 
djmoffat@718:                             linewidth=3
djmoffat@718:                         )
djmoffat@718:                         
djmoffat@718:                         # update previous_position value
djmoffat@718:                         previous_position = new_position
djmoffat@718:                         previous_time     = new_time
djmoffat@718:                     
djmoffat@718:                     
djmoffat@718:                     
djmoffat@718:                     # draw final horizontal segment (or only segment if audioelement not moved)
djmoffat@718:                     # horizontal line from previous time to end of audioholder
djmoffat@718:                     
djmoffat@718:                     # get play/stop events since last move until current move event
djmoffat@718:                     stop_times = []
djmoffat@718:                     start_times = []
djmoffat@718:                     # is there a play and/or stop event between previous_time and new_time?
djmoffat@718:                     for time in start_times_global:
djmoffat@718:                         if time>previous_time and time<audioholder_time-time_offset:
djmoffat@718:                             start_times.append(time)
djmoffat@718:                     for time in stop_times_global:
djmoffat@718:                         if time>previous_time and time<audioholder_time-time_offset:
djmoffat@718:                             stop_times.append(time)
djmoffat@718:                     # if no play/stop events between move events, find out whether playing
djmoffat@718:                     
djmoffat@718:                     segment_start = previous_time # first segment starts at previous move event
djmoffat@718:                     
djmoffat@718:                     # draw segments (horizontal line)
djmoffat@718:                     while len(start_times)+len(stop_times)>0: # while still play/stop events left
djmoffat@718:                         # mark this plot as not empty
djmoffat@718:                         plot_empty = False
djmoffat@718:                         if len(stop_times)<1: # upcoming event is 'play'
djmoffat@718:                             # draw non-playing segment from segment_start to 'play'
djmoffat@718:                             currently_playing = False
djmoffat@718:                             segment_stop = start_times.pop(0) # remove and return first item
djmoffat@718:                         elif len(start_times)<1: # upcoming event is 'stop'
djmoffat@718:                             # draw playing segment (red) from segment_start to 'stop'
djmoffat@718:                             currently_playing = True
djmoffat@718:                             segment_stop = stop_times.pop(0) # remove and return first item
djmoffat@718:                         elif start_times[0]<stop_times[0]: # upcoming event is 'play'
djmoffat@718:                             # draw non-playing segment from segment_start to 'play'
djmoffat@718:                             currently_playing = False
djmoffat@718:                             segment_stop = start_times.pop(0) # remove and return first item
djmoffat@718:                         else: # stop_times[0]<start_times[0]: upcoming event is 'stop'
djmoffat@718:                             # draw playing segment (red) from segment_start to 'stop'
djmoffat@718:                             currently_playing = True
djmoffat@718:                             segment_stop = stop_times.pop(0) # remove and return first item
djmoffat@718:                             
djmoffat@718:                         # draw segment
djmoffat@718:                         plt.plot([segment_start, segment_stop], # x-values
djmoffat@718:                             [previous_position, previous_position], # y-values
djmoffat@718:                             color='r' if currently_playing else colormap[increment%len(colormap)],
djmoffat@718:                             linewidth=3
djmoffat@718:                         )
djmoffat@718:                         segment_start = segment_stop # move on to next segment
djmoffat@718:                         currently_playing = not currently_playing # toggle to draw final segment correctly
djmoffat@718:                     
djmoffat@718:                     # draw final segment (horizontal line) from last 'segment_start' to current move event time
djmoffat@718:                     plt.plot([segment_start, audioholder_time-time_offset], # x-values
djmoffat@718:                         [previous_position, previous_position], # y-values
djmoffat@718:                         # color depends on playing during move event or not:
djmoffat@718:                         color='r' if currently_playing else colormap[increment%len(colormap)], 
djmoffat@718:                         linewidth=3
djmoffat@718:                     )
djmoffat@718:                     
djmoffat@718: #                     plt.plot([previous_time, audioholder_time-time_offset], # x-values
djmoffat@718: #                         [previous_position, previous_position], # y-values
djmoffat@718: #                         color=colormap[increment%len(colormap)],
djmoffat@718: #                         linewidth=3
djmoffat@718: #                     )
djmoffat@718:                     
djmoffat@718:                     # display fragment name at end
djmoffat@718:                     plt.text(audioholder_time-time_offset,previous_position,\
djmoffat@718:                              audio_id,color=colormap[increment%len(colormap)]) #,rotation=45
djmoffat@718:                         
djmoffat@718:                 increment+=1 # to next audioelement
djmoffat@718:             
djmoffat@718:             last_audioholder_duration = audioholder_time-time_offset
djmoffat@718:             time_offset = audioholder_time
djmoffat@718:             
djmoffat@718:             if not plot_empty: # if plot is not empty, show or store
djmoffat@718:                 # set plot parameters
djmoffat@718:                 plt.title('Timeline ' + file + ": "+page_name)
djmoffat@718:                 plt.xlabel('Time [seconds]')
djmoffat@718:                 plt.xlim(0, last_audioholder_duration)
djmoffat@718:                 plt.ylabel('Rating') # default
djmoffat@718:                 plt.ylim(0, 1) # rating between 0 and 1
djmoffat@718:             
djmoffat@718:                 #y-ticks: labels on rating axis
djmoffat@718:                 label_positions = []
djmoffat@718:                 label_text = []
djmoffat@718:                 scale_tags = root.findall("./BrowserEvalProjectDocument/audioHolder/interface/scale")
djmoffat@718:                 scale_title = root.find("./BrowserEvalProjectDocument/audioHolder/interface/title")
djmoffat@718:                 for tag in scale_tags:
djmoffat@718:                     label_positions.append(float(tag.get('position'))/100) # on a scale from 0 to 100
djmoffat@718:                     label_text.append(tag.text)
djmoffat@718:                 if len(label_positions) > 0: # if any labels available
djmoffat@718:                     plt.yticks(label_positions, label_text) # show rating axis labels
djmoffat@718:                 # set label Y-axis
djmoffat@718:                 if scale_title is not None: 
djmoffat@718:                     plt.ylabel(scale_title.text)
djmoffat@718:             
djmoffat@718:                 #plt.show() # uncomment to show plot; comment when just saving
djmoffat@718:                 #exit()
djmoffat@718:             
djmoffat@718:                 plt.savefig(timeline_folder+subject_id+"-"+page_name+".pdf", bbox_inches='tight')
djmoffat@718:                 plt.close()
djmoffat@718: