FACINP: Interface for Factor Input from Text File

Last updated 19 Nov 97

FACINP is an interface to allow non-CODAP files with factor data to be added to a CODAP Task Factor file. This program requires an input layout describing the format and description of the input data. All created factors will have a version name of "FAC".

Program Invocation

The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.


@codap facinp <opt> <ssss> <FE> <CI(layout)> <TT> <TFf>
ssss:     The study number
opt:      (none currently supported)
FE:       Input text file (same as Factor Extract)
CI:       Input file layout description.  It must conform to CODAP
	  layout format.
TT:       Input Task Title file.  
TFf:      Output Task Factor file.  All factors will be added to this file.

Factor Request Cards

These cards are just a list of names of variables from the layout which are to be added to the task factor file. Note that the file is assumed to have exactly one record for each task in the inventory. The appropriately named field will be extracted from each record to form a factor which is as long as the task inventory. This resulting factor will then be written to the output as the requested task factor.


<name>
name:     The actual variable name from the layout.  

These cards are terminated by an end-of-file or @eof image.

Layout Format

There are certain requirements for the layout. The number of characters for each field must be specified in columns 11-14. The variable identifier must be with columns 15-22, and the optional variable description is in columns 23-80.

Sample layout:

T Layout for data from SPSS
   1   4     4 TNUM   Task number
   5   5     1 F001   Factor one
   6  11   6.2 F002   Six characters, with a decimal point
  12  13     2 F003
  14  19     6 G001

Colunms one through ten of the layout file are ignored by FACINP.

Example

@codap facinp * ssss fe000 layout.spss tt001 tf100
F001
F002
TNUM
G001
@EOF>

FACINP will create task factor factors for the requested variables from text file fe000, reading the format specified in "layout.spss".

Back to document index