PKMAP= customize Table 36 diagnostic maps

PKMAP= can be used to customize Table 36 diagnostic maps. These maps are based on the KIDMAP.

PKMAP= customization

Figure: PKMAP field numbers and positions

Format in Winsteps control file:

PKMAP=* ; inline instructions for the PKMAP output in Table 36

(Field number)= value

....

Format in text file:
use Edit menu

Edit/Create file with NOTEPAD to modify these settings.

In text file, for example:

1D = Yes

Save text file as MyPKMAP.txt in the same folder as the Control file

Specification menu: PKMAP = MyPKMAP.txt

Field code	Values	Meaning
1T-9T = Top headings 1HY, 1H, 1HN = High side of grid 1M = Measure = Middle (ability) 1LY, 1L , 1LN = Low side of grid 1B-9B = Bottom footers 1E-5E = Color explanations	(blank)	do not display the field
	\	blank line
	text	display the text in the field location
	#nnn# (can be included in text)	display the statistic in the field location
1R = Response = Rating	(blank) or text or #nnn# #CODE# #CAT#	(as above) Response code in the data file Scored category number
1G = Grid for PKMAP layout	Top left cell of grid is: HY High measure, Yes reached HN High measure, Not reached LY Low measure, Yes reached LN Low measure, Not reached	Controls layout of the PKMAP by identifying the top left quadrant
1C-5C = Color codes	HTML color codes, e.g., lightgreen #E7C4A3	The color codes for text in the grid cells: 1C = High Yes (Current level) 2C = High No (Next level) 3C = 50-50 4C = Low Yes (Current level) 5C = Low No (Next level)
1P = Placement of response	T = Rasch-Thurstone 50% threshold H or F = Half-point and Full-point thresholds	Vertical measure at which to place a response.
1D = Display all the field numbers	"Y" = Display field numbers and values at start of output	The field codes and their values
1F = Minimum mean-square to report	0 = all mean-squares 1.5 = only persons with infit or outfit mean-squares greater than 1.5 are reported	Selects only Kidmaps for misfitting response strings
1S = Sort instructions	n = Entry number descending N = Entry number ascending m = Measure descending M = Measure ascending f = Mean-square fit descending F = Mean-square fit ascending fI, FI = use Infit mean-square fO, FO = use Outfit mean-square fB, FB = use bigger of both mean-squares a = Alphabetical llabel descending A = Alphabetical label ascending a$S3W10, A$S3W10 = Alphabetical sort on part of person label	Order of the PKMAP Kidmaps in the output table.
Field number not in PKMAP= list	none	(ignored)
Control variable= PSELECT=???A ; selection PDELETE=(list of entry numbers) PDFILE=(file of entry numbers) ASCII=Webpage	value	control variable for the PKMAP display
T36	-	output the Table 36 PKMAPs

#nnn#	Value: 1=-8= Person. 9= Item
#NAME# or #LABEL#	Name or label
#ENTRY#	Entry number
#MEASURE#	Measure (user-rescaled by UMEAN=, USCALE=, UDECIM=)
#COUNT#	Total number of scored responses
#SCORE#	Total raw score
#ERROR#	Standard error of measure (user-rescaled by USCALE=, UDECIM=)
#INMNSQ#	Infit mean-square
#INZSTD#	Standardized Infit statistic: t standardized, locally t standardized, or log-scaled (LOCAL=)
#OUTMNSQ#	Outfit mean-square
#OUTZSTD#	Standardized Outfit statistic: t standardized, locally t standardized, or log-scaled (LOCAL=)
#TITLE#	TITLE= of this analysis
#Y#	Measure-units for each row (line) advance on vertical y-axis.
#$S1W1# #@fieldname#	Display the label substring
##	#
#CENTER#	Center this field (1T-9T and 1B-9B only)

PKMAP= default values for dichotomies (True/False, Multiple-Choice)

PKMAP = *

1D = "No"

1F = "0"

1S = "N"

1T = " Name: #NAME#"

2T = " Ref. Number: #ENTRY# Measure: #MEASURE# S.E. #ERROR# Score: #SCORE#"

3T = " Test: #TITLE#"

4T = "\"

1G = "HY"

1P = "Half-point threshold"

1R = "#ENTRY#.#CAT#"

1HY = "Hard items answered correctly"

1H = "\<b\>\<i\>-Harder-\</b\>\</i\>"

1HN = "Hard items answered incorrectly"

1M = "\XXX\</FONT\>"

1LY = "Easy items answered correctly"

1L = "\<b\>\<i\>-Easier-\</b\>\</i\>"

1LN = "Easy items answered incorrectly"

1B = "\"

2B = "#CENTER#Each row is #Y# logits"

3B = "\"

1E = "\blue\</SPAN\>=Unexpected Yes."

2E = " \orange\</SPAN\>=No."

3E = " \yellow\</SPAN\>=50/50."

4E = " \green\</SPAN\>=Yes."

5E = " \pink\</SPAN\>=Unexpected No."

1C = "lightblue"

2C = "#FFBD91"

3C = "yellow"

4C = "lightgreen"

5C = "pink"

; = = = "default values above. User-set values below."

PKMAP= default values for polytomies (Rating Scale, Partial Credit)

PKMAP = *

1D = "No"

1F = "0"

1S = "N"

1T = " Name: #NAME#"

2T = " Ref. Number: #ENTRY# Measure: #MEASURE# S.E. #ERROR# Score: #SCORE#"

3T = " Test: #TITLE#"

4T = "\"

1G = "HY"

1P = "Full-point threshold"

1R = "#ENTRY#.#CODE#"

1HY = "Hard levels reached"

1H = "\<b\>\<i\>-Higher-\</b\>\</i\>"

1HN = "Hard levels not reached"

1M = "\XXX\</FONT\>"

1LY = "Easy levels reached"

1L = "\<b\>\<i\>-Lower-\</b\>\</i\>"

1LN = "Easy levels not reached"

1B = "\"

2B = "#CENTER#Each row is #Y# logits"

3B = "\"

1E = "\blue\</SPAN\>=Unexpected Yes."

2E = " \orange\</SPAN\>=No."

3E = " \yellow\</SPAN\>=50/50."

4E = " \green\</SPAN\>=Yes."

5E = " \pink\</SPAN\>=Unexpected No."

1C = "lightblue"

2C = "#FFBD91"

3C = "yellow"

4C = "lightgreen"

5C = "pink"

; = = = "default values above. User-set values below."

HTML codes can be used with \< and \> replacing < and >. HTML codes are ignored for text output.

Color: \....\</font\> for HTML colors
or \....\</span\> for the colors defined in 1C, 2C, 3C, 4C, 5C

A list of color names is shown at http://www.w3schools.com/html/html_colornames.asp - Hex values can also be used. These color names and hex values are used for 1C-5C.

Bold: \<b\>...\</b\> but bold for 1M and 1R may cause misalignment. Use a color instead.

Italic: \<i\>...\</i\> but bold for 1M and 1R may cause misalignment. Use a color instead.

Example: Exam5.txt - dichotomy (Yes/No, True/False, Multiple-Choice Question) -

PKMAP (KIDMAP) text output - default settings: ASCII=Yes

PKMAP (KIDMAP) webpage output - default settings: ASCII=Webpage