Code Values Cards for Variables or Factors

Last updated 10 Mar 97

The Code Value file is used by certain CODAP programs to supply replacement text for variables or factors based upon the value of that variable or factor. Each target variable or factor is called a code entry. There is no limit to the number of code entries in a given file, but each entry may have at most 300 code value replacements.

Code Entry ID card

Each code entry in the Codes file must have a line indicating the variable or factor ID, or a range of variable or factor IDs. A blank line is used to separate codes for each entry.

<typ1> <seq1> [ - <typ2> <seq2> ] 

typ1:   cc 01      A literal of 'V', 'C', 'T', or 'F' depending
		   upon the type of variable.
seq1:   cc 02-05   The sequence, or low sequence number if a
		   range is used.
'-':    cc 06      The literal '-', if a range is used
typ2:   cc 07      This must be same as 'typ1'
seq2:   cc 08-11   The high sequence number of the range, if a
		   range is used.

Code Cards

The code cards define the replacement value for any specified value of the entry. There may be up to 300 codes specified for an entry. The first field defines the value up to the first blank, this field may be a maximum of 8 characters long. The remainder of the card defines the replacement value. There cannot be imbedded spaces in the value. Codes cannot be specified for a blank. Although factors are floating point values, they are converted (with rounding) into integer prior to comparison.

<value> <code> 
value:  cc 01-nn     The variable/factor value.
code:   cc nn+2-80   The replacement value.

These cards are typically entered using a text editor and saved in a file where they can be retrieved by file designation for use in such programs as PRTVAR, PRTFAC, PRTCAS, or VARSUM.

Examples 

V0004
0 Male
1 Female
			    [ blank line separates entries ]
V0005
E1 Airman Basic
E2 Airman
E3 A1C
E4 SrA/Sgt

V0033-V0089                 [ Ranges may be used ]
1 Yes
0 No

T0001-T0363                 [ May intermix variables, tasks, and ]
1 Very Much Below Average   [ factors in a single codes file.    ]
2 Much Below Average        [ Programs will only use variables/  ]
3 Below Average             [ tasks/factors needed for the       ]
4 Average                   [ present report.                    ]
5 Above Average
6 Much Above Average
7 Very Much Above Average

F0004
1 Very Low Difficulty       [ May assign multiple values to  ]
2 Very Low Difficulty       [ a single replacement code.     ]
3 Very Low Difficulty
4 Low Difficulty
5 Average Difficulty
6 High Difficulty
7 Very High Difficulty
8 Very High Difficulty
9 Very High Difficulty
When using codes in producing printed reports it is important to remember to allow sufficient room for printing the longest replacement value. This is typically accomplished by including sufficient periods after your "S" on the format card (see PRTVAR, PRTFAC, PRTCAS, and VARSUM). If, for example, one uses the first substitution, V0004 for sex and only allows a single print position, the output report will contain "M"s and "F"s instead of "1"s or "0"s. If one allowed only four positions, one would get "Male" and "Fema" rather than "Female".