///////////////////////////////////////////////////////////////////////////////
// Methods for doing main class job //
///////////////////////////////////////////////////////////////////////////////
#region METHODS
/// <summary>
/// This method exports the fixations of the given <see cref="SampleType"/>
/// to the given File including AOI information.
/// </summary>
/// <param name="options">An <see cref="ExportOptions"/> with options for the file export.</param>
/// <param name="type">The <see cref="SampleType"/> to be exported.</param>
private void Export(ExportOptions options, SampleType type)
{
string tableName = string.Empty;
string fileName = string.Empty;
DataTable dataTable = new DataTable();
switch (type)
{
case SampleType.Gaze:
tableName = "GazeFixations";
dataTable = Document.ActiveDocument.DocDataSet.GazeFixations;
fileName = options.GazeFileName;
break;
case SampleType.Mouse:
tableName = "MouseFixations";
dataTable = Document.ActiveDocument.DocDataSet.MouseFixations;
fileName = options.MouseFileName;
break;
}
bool unknownSubjectFound = false;
string missingSubjectName = string.Empty;
using (StreamWriter exportFileWriter = new StreamWriter(fileName))
{
// Write Documentation
exportFileWriter.WriteLine("# File: " + Path.GetFileName(fileName));
exportFileWriter.WriteLine("# Created: " + DateTime.Today.Date.ToLongDateString() + "," + DateTime.Now.ToLongTimeString());
exportFileWriter.WriteLine("# with: " + Application.ProductName + " Version: " + Document.ActiveDocument.ExperimentSettings.OgamaVersion.ToString(3));
exportFileWriter.WriteLine("# Contents: " + tableName + " table.");
exportFileWriter.WriteLine("# Applies to Projekt:" + Document.ActiveDocument.ExperimentSettings.Name);
exportFileWriter.WriteLine("#");
if (options.ExportFixations)
{
// Write Column Names
foreach (DataColumn dataColumn in dataTable.Columns)
{
exportFileWriter.Write(dataColumn.Caption);
exportFileWriter.Write("\t");
}
}
else
{
// We should export saccades which need some other column descriptions
exportFileWriter.Write("SubjectName");
exportFileWriter.Write("\t");
exportFileWriter.Write("TrialID");
exportFileWriter.Write("\t");
exportFileWriter.Write("TrialSequence");
exportFileWriter.Write("\t");
exportFileWriter.Write("CountInTrial");
exportFileWriter.Write("\t");
exportFileWriter.Write("StartTime");
exportFileWriter.Write("\t");
exportFileWriter.Write("Duration");
exportFileWriter.Write("\t");
exportFileWriter.Write("Distance");
exportFileWriter.Write("\t");
exportFileWriter.Write("Velocity");
exportFileWriter.Write("\t");
exportFileWriter.Write("Validity");
exportFileWriter.Write("\t");
}
if (options.ExportSubjectDetails)
{
exportFileWriter.Write("SubjectCategory");
exportFileWriter.Write("\t");
exportFileWriter.Write("Age");
exportFileWriter.Write("\t");
exportFileWriter.Write("Sex");
exportFileWriter.Write("\t");
exportFileWriter.Write("Handedness");
exportFileWriter.Write("\t");
exportFileWriter.Write("Comments");
exportFileWriter.Write("\t");
DataTable customParams =
Document.ActiveDocument.DocDataSet.ParamsAdapter.GetData();
foreach (DataRow paramRow in customParams.Rows)
{
exportFileWriter.Write(paramRow["Param"]);
exportFileWriter.Write("\t");
}
}
if (options.ExportTrialDetails)
{
exportFileWriter.Write("Trial Name");
exportFileWriter.Write("\t");
exportFileWriter.Write("Trial Category");
exportFileWriter.Write("\t");
exportFileWriter.Write("SlideNr");
exportFileWriter.Write("\t");
}
if (options.ExportAOIDetails)
{
if (options.ExportFixations)
{
exportFileWriter.Write("AOI");
exportFileWriter.Write("\t");
exportFileWriter.Write("AOI group");
exportFileWriter.Write("\t");
}
else
{
exportFileWriter.Write("Saccade Target AOI");
exportFileWriter.Write("\t");
exportFileWriter.Write("Saccade Target AOI group");
exportFileWriter.Write("\t");
}
}
exportFileWriter.WriteLine();
int trialID = -1;
int lastTrialID = -1;
string subjectName = string.Empty;
string lastsubjectName = "LastSubjectKLSMA";
DataView trialsAOIsView = new DataView(Document.ActiveDocument.DocDataSet.AOIs);
SubjectsData subjectData = new SubjectsData();
Dictionary<string, string> subjectParams = new Dictionary<string, string>();
// Sort fixation data
DataView fixationsView = new DataView(dataTable);
fixationsView.Sort = "SubjectName, TrialSequence, CountInTrial ASC";
VGElementCollection trialAOIs = new VGElementCollection();
string category = string.Empty;
string trialName = string.Empty;
PointF lastFixationCenter = PointF.Empty;
long lastFixationEndTime = 0;
int lastFixationDuration = 0;
int countInTrial = 0;
int slideNr = 0;
List<long> slideStartTimes = new List<long>();
foreach (DataRowView dataRow in fixationsView)
{
trialID = (int)dataRow["TrialID"];
// Skip trials that are not selected.
if (!options.CheckedTrialIDs.Contains(trialID))
{
continue;
}
int trialSequence = (int)dataRow["TrialSequence"];
long startTime = (long)dataRow["StartTime"];
int length = (int)dataRow["Length"];
float posX = Convert.ToSingle(dataRow["PosX"]);
float posY = Convert.ToSingle(dataRow["PosY"]);
PointF fixationCenter = new PointF(posX, posY);
subjectName = dataRow["SubjectName"].ToString();
if (!options.CheckedSubjects.Contains(subjectName))
{
continue;
}
if (options.ExportSubjectDetails)
{
if (subjectName != lastsubjectName)
{
subjectData = new SubjectsData();
DataTable subjectsTable = Document.ActiveDocument.DocDataSet.SubjectsAdapter.GetDataBySubject(subjectName);
if (subjectsTable.Rows.Count == 0)
{
unknownSubjectFound = true;
missingSubjectName = subjectName;
continue;
}
// Parse subject information
if (!subjectsTable.Rows[0].IsNull("Age"))
{
subjectData.Age = (int)subjectsTable.Rows[0]["Age"];
}
subjectData.Category = subjectsTable.Rows[0]["Category"].ToString();
subjectData.Comments = subjectsTable.Rows[0]["Comments"].ToString();
subjectData.Handedness = subjectsTable.Rows[0]["Handedness"].ToString();
subjectData.Sex = subjectsTable.Rows[0]["Sex"].ToString();
// Parse custom subject information
subjectParams.Clear();
DataTable subjectParamsTable = Document.ActiveDocument.DocDataSet.SubjectParametersAdapter.GetDataBySubject(subjectName);
foreach (DataRow paramRow in subjectParamsTable.Rows)
{
subjectParams.Add(paramRow["Param"].ToString(), paramRow["ParamValue"].ToString());
}
lastsubjectName = subjectName;
}
}
if (trialID != lastTrialID)
{
slideStartTimes.Clear();
DataTable trialEvents = Document.ActiveDocument.DocDataSet.TrialEventsAdapter.GetDataBySubjectNameTrialSequenceButOnlySlideChangeResponses(subjectName, trialSequence);
foreach (DataRow slideEventRow in trialEvents.Rows)
{
slideStartTimes.Add((long)slideEventRow["EventTime"]);
}
countInTrial = 0;
slideNr = 0;
if (options.ExportTrialDetails || options.ExportAOIDetails)
{
DataTable trialTable = Document.ActiveDocument.DocDataSet.TrialsAdapter.GetDataBySubjectAndTrialID(subjectName, trialID);
if (trialTable.Rows.Count > 0)
{
category = trialTable.Rows[0]["Category"].ToString();
trialName = trialTable.Rows[0]["TrialName"].ToString();
}
string filter = "TrialID=" + trialID + string.Empty;
trialsAOIsView.RowFilter = filter;
lastTrialID = trialID;
trialAOIs.Clear();
foreach (DataRowView row in trialsAOIsView)
{
string strPtList = row["ShapePts"].ToString();
string aoiType = row["ShapeType"].ToString();
string aoiName = row["ShapeName"].ToString();
string shapeGroup = row["ShapeGroup"].ToString();
VGElement aoi = Queries.GetVGElementFromDatabase(aoiType, aoiName, shapeGroup, strPtList);
trialAOIs.Add(aoi);
}
}
}
if (slideStartTimes.Count > (slideNr + 1) && startTime > slideStartTimes[slideNr])
{
slideNr++;
}
if (options.ExportFixations)
{
// Write fixation table content
foreach (object cellValue in dataRow.Row.ItemArray)
{
exportFileWriter.Write(cellValue.ToString());
exportFileWriter.Write("\t");
}
}
else
{
if (countInTrial != 0)
{
// we should export saccades
exportFileWriter.Write(subjectName);
exportFileWriter.Write("\t");
exportFileWriter.Write(trialID);
exportFileWriter.Write("\t");
exportFileWriter.Write(trialSequence);
exportFileWriter.Write("\t");
exportFileWriter.Write(countInTrial);
exportFileWriter.Write("\t");
exportFileWriter.Write(lastFixationEndTime);
exportFileWriter.Write("\t");
int duration = (int)(startTime - lastFixationEndTime);
exportFileWriter.Write(duration);
exportFileWriter.Write("\t");
float distance = VGPolyline.Distance(lastFixationCenter, fixationCenter);
exportFileWriter.Write(distance);
exportFileWriter.Write("\t");
exportFileWriter.Write(distance / duration);
exportFileWriter.Write("\t");
int validity = 0;
if (duration > lastFixationDuration)
{
validity = -1;
}
exportFileWriter.Write(validity);
exportFileWriter.Write("\t");
}
}
if (options.ExportSubjectDetails)
{
if (options.ExportFixations || countInTrial != 0)
{
// Write subject information
exportFileWriter.Write(subjectData.Category);
exportFileWriter.Write("\t");
exportFileWriter.Write(subjectData.Age);
exportFileWriter.Write("\t");
exportFileWriter.Write(subjectData.Sex);
exportFileWriter.Write("\t");
exportFileWriter.Write(subjectData.Handedness);
exportFileWriter.Write("\t");
exportFileWriter.Write(subjectData.Comments);
exportFileWriter.Write("\t");
foreach (string paramValue in subjectParams.Values)
{
exportFileWriter.Write(paramValue);
exportFileWriter.Write("\t");
}
}
}
if (options.ExportTrialDetails)
{
if (options.ExportFixations || countInTrial != 0)
{
// Write trial information
exportFileWriter.Write(trialName != string.Empty ? trialName : "NamelessTrial");
exportFileWriter.Write("\t");
exportFileWriter.Write(category);
exportFileWriter.Write("\t");
exportFileWriter.Write(slideNr);
exportFileWriter.Write("\t");
}
}
if (options.ExportAOIDetails)
{
if (options.ExportFixations || countInTrial != 0)
{
// Retrieve AOI position
string hittedAOIName = string.Empty;
string hittedAOIGroup = string.Empty;
List<string[]> hittedAOIs = Statistics.Statistic.FixationHitsAOI(trialAOIs, dataRow);
if (hittedAOIs.Count == 0)
{
hittedAOIName = "nowhere";
hittedAOIGroup = "nowhere";
}
foreach (string[] aoi in hittedAOIs)
{
// Concatenate hitted AOIs
hittedAOIName += aoi[0] + "#";
hittedAOIGroup += aoi[1] + "#";
}
if (hittedAOIs.Count > 0)
{
hittedAOIName = hittedAOIName.Substring(0, hittedAOIName.Length - 1);
hittedAOIGroup = hittedAOIGroup.Substring(0, hittedAOIGroup.Length - 1);
}
exportFileWriter.Write(hittedAOIName);
exportFileWriter.Write("\t");
exportFileWriter.Write(hittedAOIGroup);
exportFileWriter.Write("\t");
}
}
if (options.ExportFixations || countInTrial != 0)
{
// Write new line for next row.
exportFileWriter.WriteLine();
}
countInTrial++;
lastFixationCenter = fixationCenter;
lastFixationEndTime = startTime + length;
lastFixationDuration = length;
}
}
if (unknownSubjectFound)
{
string message = "At least one fixation of an subject that is not in the database anymore " +
"was found. Subject: '" + missingSubjectName + "'" + Environment.NewLine +
"Please re-run a complete fixation calculation for all subjects.";
ExceptionMethods.ProcessMessage("Old subject fixations found", message);
}
ExceptionMethods.ProcessMessage("Export successful.", "Fixations were successfully exported to file");
}
///////////////////////////////////////////////////////////////////////////////
// Public methods //
///////////////////////////////////////////////////////////////////////////////
#region PUBLICMETHODS
#endregion //PUBLICMETHODS
///////////////////////////////////////////////////////////////////////////////
// Inherited methods //
///////////////////////////////////////////////////////////////////////////////
#region OVERRIDES
/// <summary>
/// Overridden. This method is used to initialize elements that are not
/// initialized in the designer.
/// </summary>
protected override void InitializeCustomElements()
{
base.InitializeCustomElements();
this.exportOptions = new ExportOptions();
PopulateSubjectTreeView(this.trvSubjects);
DataTable table = Document.ActiveDocument.DocDataSet.TrialsAdapter.GetData();
StatisticsModule.FillTreeView(this.trvTrialsDefault, table);
}