gazeplotter/dist/class/Eye/EyeDeserializer/CsvSegmentedEyeDeserializer.js

Gazeplotter is a Svelte application for visualizing eye-tracking data.

import { AbstractEyeDeserializer } from './AbstractEyeDeserializer.ts';
/**
 * This class is used to deserialize eye data from a CSV file which contains segments.
 * That means it has information about the start and end of each segment.
 */
export class CsvSegmentedEyeDeserializer extends AbstractEyeDeserializer {
    cFrom;
    cTo;
    cParticipant;
    cStimulus;
    cAoi;
    constructor(header) {
        super();
        this.cFrom = this.getIndex(header, 'From');
        this.cTo = this.getIndex(header, 'To');
        this.cAoi = this.getIndex(header, 'AOI');
        this.cParticipant = this.getIndex(header, 'Participant');
        this.cStimulus = this.getIndex(header, 'Stimulus');
    }
    /**
     * Deserializes a single row from a CSV file into a DeserializerOutputType object.
     * This function checks the validity of required fields in the row. It does not store
     * any data in memory beyond the scope of this function.
     *
     * Note: This deserializer assumes all constants represent fixations, which may be subject to change.
     *
     * @param {string[]} row - An array representing a single row from the CSV file.
     *                         Expected to contain values for 'from', 'to', 'aoi', 'participant', and 'stimulus'.
     * @returns {DeserializerOutputType | null} - Returns an object containing deserialized data
     *                                            if the row is valid. If any required field ('from', 'to',
     *                                            'participant', 'stimulus') is empty, returns null.
     */
    deserialize(row) {
        const from = row[this.cFrom];
        const to = row[this.cTo];
        const aoi = row[this.cAoi];
        const participant = row[this.cParticipant];
        const stimulus = row[this.cStimulus];
        if (from === '' || to === '' || participant === '' || stimulus === '') {
            return null;
        }
        return {
            aoi: aoi === '' ? null : [aoi],
            category: 'Fixation',
            start: from,
            end: to,
            participant: participant,
            stimulus: stimulus,
        };
    }
    /**
     * @returns null because this deserializer does not need to finalize anything
     */
    finalize() {
        return null;
    }
}