信息：使用E-DataAid.exe与命令行解释器 [25323]

本文适用于：
E-Prime 3.0

E-Prime 2.0

这已在E-Prime 2.0 版本 2.0.8.72中引入。

详细

DataAid能够导出整个数据文件，并通过常见的命令行解释器运行/导出分析。本文为这两个操作中的每一个都演示了一个从头到尾的示例。这些说明假定所有相关的 .edat3/.emrg3 已存在于已知位置。本文介绍如何为每个操作创建控制文件，E-DataAid 的可用命令行标志是什么，以及如何组合这两个元素以从默认的 Windows 命令行解释器命令提示符执行这两个操作。

E-DataAid 控制文件

若要对这两个操作中的任何一个使用命令行解释器，必须先创建 “Control File.”.txt。因此，本文将这两种类型称为“导出控制文件（Export Control Files）”和“分析运行控制文件（Analysis-Running Control Files）”。每个都需要特定的格式和内容来制定其特定的功能。除了创建控制文件之外，您还需要稍后在命令提示符中引用其确切名称和文件路径。本文底部提供了以下示例控制文件的副本可供下载。

导出控制文件示例

下面是一个示例，显示了用作导出控制文件的.txt文件的格式和典型内容。此示例包含从名为“admin”的 Windows 帐户上的 BasicRT 示例试验导出预先存在的数据文件所需的内容：

Example Export Control File.txt
Inheritance=NULL
InFile=C:\Users\admin\Documents\My Experiments\3.0\Samples\BasicRT\BasicRT-1-1.edat3
OutFile=C:\Users\admin\Documents\My Experiments\3.0\Samples\BasicRT\BasicRT-1-1-Export.txt
ColFlags=1
ColNames=1
Comments=0
BegCommentLine=*
EndCommentLine=*
DataSeparator= ______**
VarSeparator= ______**
BegDataLine=* 
EndDataLine=*
MissingData=*
Unicode=1

注意：上面的示例仅包含星号和下划线作为占位符。“*”的实例反映了参数旁边没有指定任何内容，而“**”的实例反映了按TAB键时的单个缩进。

注意：Unicode 标志仅在 E-Prime 2.0.10.353 及更高版本中可用。

您需要在任何导出控制文件中指定上述十四个参数。第一个参数指定 E-DataAid 中的继承选项，请参阅 E-DATAAID：选项（E-DataAid） [22792]。第二个参数指向预先存在的 .edat3 文件，第三个参数为要将数据导出到的生成的.txt文件指定一个名称以及文件路径。其他参数包括用于从 E-DataAid 中导出文件的正常选项集。有关这些选项的更多信息，请参阅 E-DATAAID：导出数据 [22832]。对于上述示例中这些选项的值，数字“1”等效于选中的复选框，数字“0”等效于未选中的复选框，不指定任何内容表示选择“NULL”或“None”。上面的示例反映了预设的“E-Prime Text File”导出选项的默认设置：

注意：在 E-Prime 3.0 中，您可以自动完成与上述示例相同的数据导出到“E-Prime Text File”，对于 E-Studio 本身中的任何实验，请参阅日志记录：自动生成制表符分隔的数据文件（.csv） [23601]。

分析运行控制文件示例

下面是一个示例，显示了用作分析运行控制文件的.txt文件的格式和典型内容。此示例包含使用 Stroop Task [30142] 中的示例 .anl 文件运行分析所需的内容。此示例假定相关的 .edat3 和 .anl 文件已存在于名为“admin”的 Windows 帐户上的自定义“Stroop”子文件夹（默认的“My Experiments/3.0 父文件夹”）中：

Example Analysis-Running Control File.txt
EPrimeFile:
C:\Users\admin\Documents\My Experiments\3.0\Stroop\Stroop-1-1.edat3
ColumnCheck:
0
AnalysisFiles:
1
C:\Users\admin\Documents\My Experiments\3.0\Stroop\StroopAnalysis.anl
TextDataFile:
1
C:\Users\admin\Documents\My Experiments\3.0\Stroop\StroopAnalysisResults.txt
HeaderFiles:
1
C:\Users\admin\Documents\My Experiments\3.0\Stroop\ExampleStroopHeaderFile.txt

您至少需要在任何“分析运行控制文件”中指定上述十三个参数。运行分析的控制文件可能需要比上述示例更多的参数。第三个参数 ColumnCheck 用于指示预期列的数量（和名称）。正下方行中的示例参数值“0”指定不执行列检查。如果此值不是“0”，则此数值必须与正下方（在“AnalysisFiles”参数之前）的行数匹配，每行都包含您希望在继续之前验证的列的确切名称。

所有其他非数字参数要么指定文件类型，要么指定具有完整文件路径的预先存在的文件名。数值参数指定您期望的每种相应类型的文件数。虽然您一次只能对一个 .edat3 或 .emrg3 文件运行分析，但您可以一次运行多个分析。上面的示例假定您只运行一个分析。对于在“分析运行控制文件”中指定的每个 .anl 文件，需要指定相同数量的文件：A. 导出单个分析结果的生成的.txt数据文件和 B. 生成的“Header”.txt文件。

注：Header.txt文件是换行符分隔的.txt文件，其中包含有关要导出为.txt文件的分析的其他信息。下面是从 Stroop Task [30142] 中的示例 .anl 文件生成的Header.txt文件的通用示例：

Example Stroop Header File.txt
Analysis name: RT by Congruency
Column conditions: Congruency
Row conditions: Subject
Statistics: Stimulus.RT:Mean
Filters: None
Data file: Stroop-1-1.edat3
File does not have data alterations.

本文底部提供了上述Header 文件的副本可供下载。

E-DataAid的命令行标志

下表描述了要与导出和/或运行分析的控制文件关联的特定命令行标志：

Flag	Control File	Description
/e	Export	Load a file and export it from the command line.
/i	Export	Load a file and export it from the command line (compressed format).
/c	Analysis-Running	Get data for a workbook.
/f	Export/Analysis-Running	The path of the control file follows on the command line.

命令提示符示例

任何导出命令都需要：

1. E-DataAid.exe的方向（适用于 E-DataAid 2 或 3），

2. 要加载的标志，然后导出生成的.txt文件（未压缩或压缩），

3. 预先存在的导出控制文件，以及

4. 导出控制文件遵循的文件路径的标志（用引号引起来）。

任何运行分析的命令都需要：

5. E-DataAid.exe的方向（适用于 E-DataAid 2 或 3），

6. 用于获取工作簿数据的标志，

7. 预先存在的分析运行控制文件，以及

8. “分析运行控制文件”所遵循的文件路径的标志（用引号引起来）。

注意：运行分析的命令不需要附加标志来加载，然后导出生成的两个.txt文件。

E-DataAid.exe 的默认文件路径对于 E-DataAid 3是C:\Program Files (x86)\PST\E-Prime 3.0\Program\E-DataAid.exe，对于E-DataAid 2，则为 C:\Program Files (x86)\PST\E-Prime 2.0\Program\E-DataAid.exe。“cd”命令更改命令提示符中的当前目录。这允许您临时指定 E-DataAid 的文件路径，因此您的最终命令可以直接以“E-DataAid.exe”开头。以下是将当前目录从默认用户文件夹更改为名为“admin”的 Windows 帐户上的 E-Prime 3.0\Program 文件夹的示例：