Facets is a Windows-native program, so it will not run in "DOS Mode". But it can be started from the DOS prompt in an MS-DOS window under Windows. Facets can be included in batch files with Batch=Yes.

 

To Run Facets:

Either enter:

C:> FACETS

The program will ask you for the name of your specification file with

Specification file name:

then type in the name of the specification file you want, e.g.,

KCT.txt

the program will ask you for the name of your analysis output file with

Output file name:

then press enter or type the name of the output file you want, e.g.,

KCTOUT.txt

The analysis will commence and run to its conclusion.

 

Or enter:

C:> FACETS specfile

where specfile is the name of your specification file, e.g., KCT.txt

the program will ask you for the name of your analysis output file with

Output file name:

then type the name of the output file you want, e.g.,

KCTOUT.txt

The analysis will commence and run to its conclusion.

 

Or enter:

C:> FACETS specfile outputfile

where specfile is the name of your specification file, e.g., KCT.txt

and outputfile is the name of your analysis output file, e.g., KCTOUT.txt

The analysis will commence and run to its conclusion.

 

Or, for advanced users, enter:

C:> FACETS specfile outputfile specification=value specification=value ..

where

specfile is the name of your specification file,

outputfile (optional) is the name of the file to hold your results,

specification=value are a list of specifications like the specification file.

 

The specifications entered here take priority over those in the specification file. All specifications are allowed here except Labels=, Model= and Rating (or partial credit) scale=.

Data= must be followed by a file name.

 

For entries on the DOS command line, blanks are used as separators. Blanks are not allowed within specifications. This is correct:

C:> FACETS KCT.txt ITER=3 TITLE=SHORT-TEST

But, TITLE=SHORT TEST is incorrect due to the blank between SHORT and TEST.

 

Example1:

When doing multiple runs from different data sets with similar format, it can be convenient to set up one standard specification file. In this example, STANDARD.CTL is the name of my Facets specification file. I want to analyze 4 similarly formatted data sets, DATA1, DATA2, DATA3, DATA4. The write their results into 4 output files, DATA1OUT.txt, DATA2OUT.txt, DATA3OUT.txt, DATA4OUT.txt:

 

C:\FACETS> FACETS STANDARD.CTL DATA1OUT.txt DATA=DATA1 TITLE=DATA1

C:\FACETS> FACETS STANDARD.CTL DATA2OUT.txt DATA=DATA2 TITLE=DATA2

C:\FACETS> FACETS STANDARD.CTL DATA3OUT.txt DATA=DATA3 TITLE=DATA3

C:\FACETS> FACETS STANDARD.CTL DATA4OUT.txt DATA=DATA4 TITLE=DATA4

 

Example 2: Batch-mode processing

Use Notepad, or such like, to create a ".bat", file, e.g., myrun.bat

This is a text file (with line breaks) containing instructions, such as:

 

START /w FACETS STANDARD.CTL DATA1OUT.txt BATCH=YES DATA=DATA1 TITLE=DATA1

START /w FACETS STANDARD.CTL DATA2OUT.txt BATCH=YES DATA=DATA2 TITLE=DATA2

START /w FACETS STANDARD.CTL DATA3OUT.txt BATCH=YES DATA=DATA3 TITLE=DATA3

START /w FACETS STANDARD.CTL DATA4OUT.txt BATCH=YES DATA=DATA4 TITLE=DATA4

 

Note: START /w launches FACETS sequentially, not all at the same time. (If your version of Windows does not understand START /w, then remove it from each line.)

Batch=Yes is required to avoid Facets asking for user intervention.

 

Then launch this ".bat" file at the DOS prompt:

 

C:\FACETS> myrun (Enter)

 

Facets will run 4 times, in background (or as much in background as Windows permits.)