# pylint: skip-file
"""
UBC Eye Movement Data Analysis Toolkit
Generic Participant Class
Created on 2011-09-25

@author: skardan
"""
import string
from skgaze.EMDAT.data_structures import *
import skgaze.EMDAT.params as params
from skgaze.EMDAT.Scene import Scene
import skgaze.EMDAT.Recording as Recording



class Participant():
    """
    A class that holds the information for one Participant in the experiment
    """

    def __init__(self, pid, eventfile, datafile, fixfile, segfile, log_time_offset = None, aoifile = None, prune_length= None, 
                 require_valid_segs = True, auto_partition_low_quality_segments = False):
        """Inits BasicParticipant class
        Args:
            pid: Participant id
            
            eventfile: a string containing the name of the "Event-Data.tsv" file for this participant
            
            datafile: a string containing the name of the "all-Data.tsv" file for this participant
            
            fixfile: a string containing the name of the "Fixation-Data.tsv" file for this participant
            
            segfile: a string containing the name of the '.seg' file for this participant
            
            log_time_offset: If not None, an integer indicating the time offset between the 
                external log file and eye tracking logs
            
            aoifile: If not None, a string conatining the name of the '.aoi' file 
                with definitions of the "AOI"s.
            
            prune_length: If not None, an integer that specifies the time 
                interval (in ms) from the begining of each Segment in which
                samples are considered in calculations.  This can be used if, 
                for example, you only wish to consider data in the first 
                1000 ms of each Segment. In this case (prune_length = 1000),
                all data beyond the first 1000ms of the start of the "Segment"s
                will be disregarded.
                
            require_valid_segs: a boolean determining whether invalid "Segment"s
                will be ignored when calculating the features or not. default = True 
                
            auto_partition_low_quality_segments: a boolean indicating whether EMDAT should 
                split the "Segment"s which have low sample quality, into two new 
                sub "Segment"s discarding the largest gap of invalid samples.
            
        Yields:
            a Participant object
        """
        self.pid = pid
        self.require_valid_segments = require_valid_segs

    def export_features(self, featurelist=None, aoifeaturelist=None, aoifeaturelabels = None,
                        id_prefix = False, require_valid = True):
        """Returns feature names and their values for this Participant
        
        Args:
            featurelist: if not None, a list of strings containing the name of the features to be
                returned
            
            aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 
            aoifeaturelabels: if not None, a list of AOI related features to be returned.
            *Note: while aoifeaturelist is a subset of features that will be returned for all 
            "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature
            of the form: [AOI name]_[feature name]
            For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'  

            id_prefix: a boolean determining if the method should also export the participant id 
            
            require_valid: a boolean determining if only valid segments should be used when
            calculating the features. default = True
            
        Returns:
            featnames: a list of feature names sorted alphabetically
            featvals: a corresponding list of feature values
            e.g.
            featnames = ['fixationrate', 'length', 'meanabspathangles']
            featvals  = [0.00268522882294', '1529851', '1.60354714212']
        """
        data = []
        featnames = []
        if id_prefix:
            featnames.append('Part_id')
        featnames.append('Sc_id')
        first = True
        for sc in self.scenes:
            if not sc.is_valid and require_valid:
                print("User %s:Scene %s dropped because of 'require_valid'" %(self.id,sc.scid))
                continue
            sc_feats = []
            if id_prefix:
                sc_feats.append(self.id)
            sc_feats.append(sc.scid)
            fnames, fvals = sc.get_features(featurelist = featurelist,
                                           aoifeaturelist = aoifeaturelist, 
                                           aoifeaturelabels = aoifeaturelabels)
            if first: featnames += fnames
            sc_feats += fvals
            first = False
            data.append(sc_feats)            

        return featnames, data

    def export_features_tsv(self, featurelist=None, aoifeaturelist=None, id_prefix = False, 
                            require_valid = True):
        """Returns feature names and their values for this Participant in a tab separated format
        
        Args:
            featurelist: if not None, a list of strings containing the name of the features to be
                returned
            
            aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 

            id_prefix: a boolean determining if the method should also export the participant id.
             
            
            require_valid: a boolean determining if only valid segments should be used when
            calculating the features. default = True
            
        Returns:
            A two-line string with the first line having the feature names sorted alphabetically
            and separated by a tab '/t', and the second line containing the corresponding values
            separated by a tab '/t'
            For example:
            fixationrate    length    meanabspathangles
            0.00268522882294    1529851    1.60354714212
        """
        featnames, data  = self.export_features(featurelist, aoifeaturelist = aoifeaturelist, 
                                                id_prefix = id_prefix, require_valid = require_valid)
        ret = ''
        for t in featnames:
            ret += t + '\t'
        ret += '\n'
        for t in data:
            for item in t:
                ret += str(item) + '\t'
            ret += '\n'
        return ret
    
    def print_(self):
        """Outputs all feature names and their values for this Participant to the console        
        """       
        def format_list(list,leng=None):
            """
            """
            out=''
            if leng == None:
                maxlen=0
                for j in list:
                    st = repr(j)
                    if len(st) > maxlen:
                        maxlen = len(st)
                for j in list:
                    out+= repr(j).rjust(maxlen+1)
                return out,maxlen+1
            else:
                for j in list:
                    st = repr(j)
                    out+= st.rjust(leng)
                return out,leng
 
        print("PID:",self.id)
        
        for seg in self.segments:
            featnames = []
            if not seg.is_valid:
                continue
            seg_feats = []
            featnames.append('seg_id')
            seg_feats.append(seg.segid)
            fnames, fvals = seg.get_features()
            featnames += fnames
            seg_feats += fvals
            o,l= format_list(featnames)
            print(o)
            print(format_list(seg_feats,l))
            
        for sc in self.scenes:
            featnames = []
            if not sc.is_valid:
                continue
            sc_feats = []
            featnames.append('sc_id')
            sc_feats.append(sc.scid)
            fnames, fvals = sc.get_features()
            featnames += fnames
            sc_feats += fvals
            o,l= format_list(featnames)
            print(o)
            print(format_list(sc_feats,l))
    

def read_participants(segsdir, datadir, prune_length = None, aoifile = None):
    """Placeholder for a method that generates Participant objects for each participant 
    in the experiment 
    """
    participants = []
    raise Exception("You should override the default Participant.read_participants method!")
    return participants

def export_features_all(participants, featurelist = None, aoifeaturelist = None, aoifeaturelabels=None,
                         id_prefix = False, require_valid = True):
    """Returns feature names and their values for a list of "Participant"s
    
    Args:
        participants: a list of "Participant"s
        featurelist: if not None, a list of strings containing the name of the features to be
            returned
        
        aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 
        aoifeaturelabels: if not None, a list of AOI related features to be returned.
        *Note: while aoifeaturelist is a subset of features that will be returned for all 
        "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature
        of the form: [AOI name]_[feature name]
        For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'  

        id_prefix: a boolean determining if the method should also export the participant id 
        
        require_valid: a boolean determining if only valid segments should be used when
        calculating the features. default = True
        
    Returns:
        featnames: a list of feature names sorted alphabetically
        featvals: a corrsponding list of feature values
        e.g.
        featnames = ['fixationrate', 'length', 'meanabspathangles']
        featvals  = [0.00268522882294', '1529851', '1.60354714212']
    """
    data = []
    featnames = []
    if participants:
        for p in participants:
            if not(p.is_valid()):
                print("user",p.id,"was not valid")
                continue
            fnames, fvals = p.export_features(featurelist=featurelist, aoifeaturelist=aoifeaturelist, 
                                              aoifeaturelabels = aoifeaturelabels,
                                              id_prefix=id_prefix, require_valid = require_valid)
            featnames = fnames
            data += fvals
    else:
        raise NameError('No participants were passed to the function')
    
    return featnames, data

def write_features_tsv(participants, outfile, featurelist = None, aoifeaturelist =  None, 
                       aoifeaturelabels=None, id_prefix = False):
    """Returns feature names and their values for a list of "Participant"s in a tsv-format file
    
    This method writes to a multi-line tab separated values (tsv) file with the first 
    line having the feature names sorted alphabetically and separated by a tab '/t',
    and the rest of the lines containing the corresponding values for each participant
    separated by a tab '/t'
    For example:
    fixationrate    length    meanabspathangles
    0.0026852294    1529851    1.60354714212
    0.00456324344    453455    1.74324423
    
    Args:
        participants: a list of "Participant"s
        outfile: a string containing the name of the output file
        featurelist: if not None, a list of strings containing the name of the features to be
            returned
        
        aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 

        id_prefix: a boolean determining if the method should also export the participant id 
        
        require_valid: a boolean determining if only valid segments should be used when
        calculating the features. default = True
    """
    fnames, fvals = export_features_all(participants, featurelist =  featurelist, 
                                        aoifeaturelabels = aoifeaturelabels,
                                        aoifeaturelist = aoifeaturelist, id_prefix=id_prefix)
    
    with open(outfile, 'w') as f:
        f.write(string.join(fnames, '\t') + '\n')
        for l in fvals:
            f.write(string.join(map(str, l), '\t') + '\n')

def partition(segfile):
    """
    Placeholder for a method that generates the scenes based on some external log files and/or 'Event-Data.tsv" files
    """
    raise Exception("You should override the default Participant.partition method!")
    return

def test_validity():
    """
    Placeholder for a method that tests the quality of the eye data for each Participant
    """
    return

def read_events(evfile):
    """Returns a list of Event objects read from an 'Event-Data.tsv' file.

    Args:
        evfile: a string containing the name of the 'Event-Data.tsv' file exported from 
            Tobii software
    
    Returns:
        a list of Event objects
    """
    with open(evfile, 'r') as f:
        lines = f.readlines()

    return map(Event, lines[(params.EVENTSHEADERLINES+params.NUMBEROFEXTRAHEADERLINES):])

# pylint: skip-file
"""
UBC Eye Movement Data Analysis Toolkit
Generic Participant Class
Created on 2011-09-25

@author: skardan
"""
import string
from skgaze.EMDAT.data_structures import *
import skgaze.EMDAT.params as params
from skgaze.EMDAT.Scene import Scene
import skgaze.EMDAT.Recording as Recording



class Participant():
    """
    A class that holds the information for one Participant in the experiment
    """

    def __init__(self, pid, eventfile, datafile, fixfile, segfile, log_time_offset = None, aoifile = None, prune_length= None, 
                 require_valid_segs = True, auto_partition_low_quality_segments = False):
        """Inits BasicParticipant class
        Args:
            pid: Participant id
            
            eventfile: a string containing the name of the "Event-Data.tsv" file for this participant
            
            datafile: a string containing the name of the "all-Data.tsv" file for this participant
            
            fixfile: a string containing the name of the "Fixation-Data.tsv" file for this participant
            
            segfile: a string containing the name of the '.seg' file for this participant
            
            log_time_offset: If not None, an integer indicating the time offset between the 
                external log file and eye tracking logs
            
            aoifile: If not None, a string conatining the name of the '.aoi' file 
                with definitions of the "AOI"s.
            
            prune_length: If not None, an integer that specifies the time 
                interval (in ms) from the begining of each Segment in which
                samples are considered in calculations.  This can be used if, 
                for example, you only wish to consider data in the first 
                1000 ms of each Segment. In this case (prune_length = 1000),
                all data beyond the first 1000ms of the start of the "Segment"s
                will be disregarded.
                
            require_valid_segs: a boolean determining whether invalid "Segment"s
                will be ignored when calculating the features or not. default = True 
                
            auto_partition_low_quality_segments: a boolean indicating whether EMDAT should 
                split the "Segment"s which have low sample quality, into two new 
                sub "Segment"s discarding the largest gap of invalid samples.
            
        Yields:
            a Participant object
        """
        self.pid = pid
        self.require_valid_segments = require_valid_segs

    def export_features(self, featurelist=None, aoifeaturelist=None, aoifeaturelabels = None,
                        id_prefix = False, require_valid = True):
        """Returns feature names and their values for this Participant
        
        Args:
            featurelist: if not None, a list of strings containing the name of the features to be
                returned
            
            aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 
            aoifeaturelabels: if not None, a list of AOI related features to be returned.
            *Note: while aoifeaturelist is a subset of features that will be returned for all 
            "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature
            of the form: [AOI name]_[feature name]
            For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'  

            id_prefix: a boolean determining if the method should also export the participant id 
            
            require_valid: a boolean determining if only valid segments should be used when
            calculating the features. default = True
            
        Returns:
            featnames: a list of feature names sorted alphabetically
            featvals: a corresponding list of feature values
            e.g.
            featnames = ['fixationrate', 'length', 'meanabspathangles']
            featvals  = [0.00268522882294', '1529851', '1.60354714212']
        """
        data = []
        featnames = []
        if id_prefix:
            featnames.append('Part_id')
        featnames.append('Sc_id')
        first = True
        for sc in self.scenes:
            if not sc.is_valid and require_valid:
                print("User %s:Scene %s dropped because of 'require_valid'" %(self.id,sc.scid))
                continue
            sc_feats = []
            if id_prefix:
                sc_feats.append(self.id)
            sc_feats.append(sc.scid)
            fnames, fvals = sc.get_features(featurelist = featurelist,
                                           aoifeaturelist = aoifeaturelist, 
                                           aoifeaturelabels = aoifeaturelabels)
            if first: featnames += fnames
            sc_feats += fvals
            first = False
            data.append(sc_feats)            

        return featnames, data

    def export_features_tsv(self, featurelist=None, aoifeaturelist=None, id_prefix = False, 
                            require_valid = True):
        """Returns feature names and their values for this Participant in a tab separated format
        
        Args:
            featurelist: if not None, a list of strings containing the name of the features to be
                returned
            
            aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 

            id_prefix: a boolean determining if the method should also export the participant id.
             
            
            require_valid: a boolean determining if only valid segments should be used when
            calculating the features. default = True
            
        Returns:
            A two-line string with the first line having the feature names sorted alphabetically
            and separated by a tab '/t', and the second line containing the corresponding values
            separated by a tab '/t'
            For example:
            fixationrate    length    meanabspathangles
            0.00268522882294    1529851    1.60354714212
        """
        featnames, data  = self.export_features(featurelist, aoifeaturelist = aoifeaturelist, 
                                                id_prefix = id_prefix, require_valid = require_valid)
        ret = ''
        for t in featnames:
            ret += t + '\t'
        ret += '\n'
        for t in data:
            for item in t:
                ret += str(item) + '\t'
            ret += '\n'
        return ret
    
    def print_(self):
        """Outputs all feature names and their values for this Participant to the console        
        """       
        def format_list(list,leng=None):
            """
            """
            out=''
            if leng == None:
                maxlen=0
                for j in list:
                    st = repr(j)
                    if len(st) > maxlen:
                        maxlen = len(st)
                for j in list:
                    out+= repr(j).rjust(maxlen+1)
                return out,maxlen+1
            else:
                for j in list:
                    st = repr(j)
                    out+= st.rjust(leng)
                return out,leng
 
        print("PID:",self.id)
        
        for seg in self.segments:
            featnames = []
            if not seg.is_valid:
                continue
            seg_feats = []
            featnames.append('seg_id')
            seg_feats.append(seg.segid)
            fnames, fvals = seg.get_features()
            featnames += fnames
            seg_feats += fvals
            o,l= format_list(featnames)
            print(o)
            print(format_list(seg_feats,l))
            
        for sc in self.scenes:
            featnames = []
            if not sc.is_valid:
                continue
            sc_feats = []
            featnames.append('sc_id')
            sc_feats.append(sc.scid)
            fnames, fvals = sc.get_features()
            featnames += fnames
            sc_feats += fvals
            o,l= format_list(featnames)
            print(o)
            print(format_list(sc_feats,l))
    

def read_participants(segsdir, datadir, prune_length = None, aoifile = None):
    """Placeholder for a method that generates Participant objects for each participant 
    in the experiment 
    """
    participants = []
    raise Exception("You should override the default Participant.read_participants method!")
    return participants

def export_features_all(participants, featurelist = None, aoifeaturelist = None, aoifeaturelabels=None,
                         id_prefix = False, require_valid = True):
    """Returns feature names and their values for a list of "Participant"s
    
    Args:
        participants: a list of "Participant"s
        featurelist: if not None, a list of strings containing the name of the features to be
            returned
        
        aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 
        aoifeaturelabels: if not None, a list of AOI related features to be returned.
        *Note: while aoifeaturelist is a subset of features that will be returned for all 
        "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature
        of the form: [AOI name]_[feature name]
        For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'  

        id_prefix: a boolean determining if the method should also export the participant id 
        
        require_valid: a boolean determining if only valid segments should be used when
        calculating the features. default = True
        
    Returns:
        featnames: a list of feature names sorted alphabetically
        featvals: a corrsponding list of feature values
        e.g.
        featnames = ['fixationrate', 'length', 'meanabspathangles']
        featvals  = [0.00268522882294', '1529851', '1.60354714212']
    """
    data = []
    featnames = []
    if participants:
        for p in participants:
            if not(p.is_valid()):
                print("user",p.id,"was not valid")
                continue
            fnames, fvals = p.export_features(featurelist=featurelist, aoifeaturelist=aoifeaturelist, 
                                              aoifeaturelabels = aoifeaturelabels,
                                              id_prefix=id_prefix, require_valid = require_valid)
            featnames = fnames
            data += fvals
    else:
        raise NameError('No participants were passed to the function')
    
    return featnames, data

def write_features_tsv(participants, outfile, featurelist = None, aoifeaturelist =  None, 
                       aoifeaturelabels=None, id_prefix = False):
    """Returns feature names and their values for a list of "Participant"s in a tsv-format file
    
    This method writes to a multi-line tab separated values (tsv) file with the first 
    line having the feature names sorted alphabetically and separated by a tab '/t',
    and the rest of the lines containing the corresponding values for each participant
    separated by a tab '/t'
    For example:
    fixationrate    length    meanabspathangles
    0.0026852294    1529851    1.60354714212
    0.00456324344    453455    1.74324423
    
    Args:
        participants: a list of "Participant"s
        outfile: a string containing the name of the output file
        featurelist: if not None, a list of strings containing the name of the features to be
            returned
        
        aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s. 

        id_prefix: a boolean determining if the method should also export the participant id 
        
        require_valid: a boolean determining if only valid segments should be used when
        calculating the features. default = True
    """
    fnames, fvals = export_features_all(participants, featurelist =  featurelist, 
                                        aoifeaturelabels = aoifeaturelabels,
                                        aoifeaturelist = aoifeaturelist, id_prefix=id_prefix)
    
    with open(outfile, 'w') as f:
        f.write(string.join(fnames, '\t') + '\n')
        for l in fvals:
            f.write(string.join(map(str, l), '\t') + '\n')

def partition(segfile):
    """
    Placeholder for a method that generates the scenes based on some external log files and/or 'Event-Data.tsv" files
    """
    raise Exception("You should override the default Participant.partition method!")
    return

def test_validity():
    """
    Placeholder for a method that tests the quality of the eye data for each Participant
    """
    return

def read_events(evfile):
    """Returns a list of Event objects read from an 'Event-Data.tsv' file.

    Args:
        evfile: a string containing the name of the 'Event-Data.tsv' file exported from 
            Tobii software
    
    Returns:
        a list of Event objects
    """
    with open(evfile, 'r') as f:
        lines = f.readlines()

    return map(Event, lines[(params.EVENTSHEADERLINES+params.NUMBEROFEXTRAHEADERLINES):])

# pylint: skip-file UBC Eye Movement Data Analysis Toolkit Generic Participant Class Created on 2011-09-25  @author: skardan A class that holds the information for one Participant in the experiment Inits BasicParticipant class         Args:             pid: Participant id                          eventfile: a string containing the name of the "Event-Data.tsv" file for this participant                          datafile: a string containing the name of the "all-Data.tsv" file for this participant                          fixfile: a string containing the name of the "Fixation-Data.tsv" file for this participant                          segfile: a string containing the name of the '.seg' file for this participant                          log_time_offset: If not None, an integer indicating the time offset between the                  external log file and eye tracking logs                          aoifile: If not None, a string conatining the name of the '.aoi' file                  with definitions of the "AOI"s.                          prune_length: If not None, an integer that specifies the time                  interval (in ms) from the begining of each Segment in which                 samples are considered in calculations.  This can be used if,                  for example, you only wish to consider data in the first                  1000 ms of each Segment. In this case (prune_length = 1000),                 all data beyond the first 1000ms of the start of the "Segment"s                 will be disregarded.                              require_valid_segs: a boolean determining whether invalid "Segment"s                 will be ignored when calculating the features or not. default = True                               auto_partition_low_quality_segments: a boolean indicating whether EMDAT should                  split the "Segment"s which have low sample quality, into two new                  sub "Segment"s discarding the largest gap of invalid samples.                      Yields:             a Participant object Returns feature names and their values for this Participant                  Args:             featurelist: if not None, a list of strings containing the name of the features to be                 returned                          aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s.              aoifeaturelabels: if not None, a list of AOI related features to be returned.             *Note: while aoifeaturelist is a subset of features that will be returned for all              "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature             of the form: [AOI name]_[feature name]             For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'                id_prefix: a boolean determining if the method should also export the participant id                           require_valid: a boolean determining if only valid segments should be used when             calculating the features. default = True                      Returns:             featnames: a list of feature names sorted alphabetically             featvals: a corresponding list of feature values             e.g.             featnames = ['fixationrate', 'length', 'meanabspathangles']             featvals  = [0.00268522882294', '1529851', '1.60354714212'] Returns feature names and their values for this Participant in a tab separated format                  Args:             featurelist: if not None, a list of strings containing the name of the features to be                 returned                          aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s.               id_prefix: a boolean determining if the method should also export the participant id.                                        require_valid: a boolean determining if only valid segments should be used when             calculating the features. default = True                      Returns:             A two-line string with the first line having the feature names sorted alphabetically             and separated by a tab '/t', and the second line containing the corresponding values             separated by a tab '/t'             For example:             fixationrate    length    meanabspathangles             0.00268522882294    1529851    1.60354714212 Outputs all feature names and their values for this Participant to the console Placeholder for a method that generates Participant objects for each participant      in the experiment Returns feature names and their values for a list of "Participant"s          Args:         participants: a list of "Participant"s         featurelist: if not None, a list of strings containing the name of the features to be             returned                  aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s.          aoifeaturelabels: if not None, a list of AOI related features to be returned.         *Note: while aoifeaturelist is a subset of features that will be returned for all          "AOI"s, aoifeaturelabels contains the exact AOI feature name, i.e., a feature         of the form: [AOI name]_[feature name]         For example for an AOI called 'graph', aoifeaturelabels may contain 'graph_fixationrate'            id_prefix: a boolean determining if the method should also export the participant id                   require_valid: a boolean determining if only valid segments should be used when         calculating the features. default = True              Returns:         featnames: a list of feature names sorted alphabetically         featvals: a corrsponding list of feature values         e.g.         featnames = ['fixationrate', 'length', 'meanabspathangles']         featvals  = [0.00268522882294', '1529851', '1.60354714212'] Returns feature names and their values for a list of "Participant"s in a tsv-format file          This method writes to a multi-line tab separated values (tsv) file with the first      line having the feature names sorted alphabetically and separated by a tab '/t',     and the rest of the lines containing the corresponding values for each participant     separated by a tab '/t'     For example:     fixationrate    length    meanabspathangles     0.0026852294    1529851    1.60354714212     0.00456324344    453455    1.74324423          Args:         participants: a list of "Participant"s         outfile: a string containing the name of the output file         featurelist: if not None, a list of strings containing the name of the features to be             returned                  aoifeaturelist: if not None, a list of features to be returned for each of the "AOI"s.           id_prefix: a boolean determining if the method should also export the participant id                   require_valid: a boolean determining if only valid segments should be used when         calculating the features. default = True Placeholder for a method that generates the scenes based on some external log files and/or 'Event-Data.tsv" files Placeholder for a method that tests the quality of the eye data for each Participant Returns a list of Event objects read from an 'Event-Data.tsv' file.      Args:         evfile: a string containing the name of the 'Event-Data.tsv' file exported from              Tobii software          Returns:         a list of Event objects