Facform data formatter

The Facform program is provided to help you with awkward file conversions. It can be downloaded from www.winsteps.com/facets.htm or it may be already installed in the Facets folder: Facform.exe with user-manual Facform.pdf.


Example: A three-facet flat data file

Here is the data for an assessment of patient functioning. The performances of ten patients on a specific task were videotaped and rated by a number of raters on 70 items of performance. These data are in file "PATDAT.txt":


001BMT67MWP28                        5555555555555  555  354545555555551         555 55 555555 35554

001DCS67MWP28                        55555 555555 3 555  355445555555553        555 55 555 55 55554


(and so on down to)


010MMO                         555  55555  55555  5 555  555 555 5555  55555 5  5555 5  55555  555 5

010PBG                        45554 555554 555554 5 5554 554 555 55555 5555545   555 54 555554 554 5

^  ^                          ^

1  4                          31  Columns


The keyword list (in file PATIENTkey.txt) converts the flat file into a Facets file:


; File: PATkey.txt

; This converts a flat data file into a Facets file (Comments start with ;)

$Input = PATDAT.txt  ; the flat file

$Spoutput=PATCON.txt ; the file for Facets specifications

$Output = PATFAC.txt ; the file of Facets-formatted data

; three facets


; labels for the facets




; client id number

$Label=1,$S1E3    client number starts in column 1, ends in column 3

; rater label (non-numeric)

$Label=2,,$S4E6    rater "name" starts in column 4, ends in column 6

; count of task number

task=0      ; a user-defined variable to keep track of task number

; location in data record

pointer=30 ;    a user-defined variable to keep track of location in record

; 70 tasks

$Do=70  ; perform the  $Do-$Again loop 70 times

task=task+1 ; increment our "task" number

pointer=pointer+1 ; increment location in record

; current task number

$Label=3,task ; we want this to be the task element number

; current rating

$Rating=$S(pointer)W1 ; rating at location "pointer" has a width of 1 character



After running the following at the DOS prompt:



The Facets-format output file is PATCON.txt


; FACFORM Version No. 1.21

; from Keyword file: PATkey.txt

Facets = 3

Data file = PATFAC.txt

Labels =





(and so on down to)






1=BMT ; Facform assigns element numbers to these "names"



(and so on down to)









(and so on down to)






The resulting Facets specification data file is PATFAC.txt:

Facform has combined observations in sequence by element number into single data records




(and so on down to)




Help for Facets Rasch Measurement Software: www.winsteps.com Author: John Michael Linacre.

For more information, contact info@winsteps.com or use the Contact Form

Facets Rasch measurement software. Buy for $149. & site licenses. Freeware student/evaluation download
Winsteps Rasch measurement software. Buy for $149. & site licenses. Freeware student/evaluation download

State-of-the-art : single-user and site licenses : free student/evaluation versions : download immediately : instructional PDFs : user forum : assistance by email : bugs fixed fast : free update eligibility : backwards compatible : money back if not satisfied
Rasch, Winsteps, Facets online Tutorials


Forum Rasch Measurement Forum to discuss any Rasch-related topic

Click here to add your email address to the Winsteps and Facets email list for notifications.

Click here to ask a question or make a suggestion about Winsteps and Facets software.

Rasch Publications
Rasch Measurement Transactions (free, online) Rasch Measurement research papers (free, online) Probabilistic Models for Some Intelligence and Attainment Tests, Georg Rasch Applying the Rasch Model 3rd. Ed., Bond & Fox Best Test Design, Wright & Stone
Rating Scale Analysis, Wright & Masters Introduction to Rasch Measurement, E. Smith & R. Smith Introduction to Many-Facet Rasch Measurement, Thomas Eckes Invariant Measurement with Raters and Rating Scales: Rasch Models for Rater-Mediated Assessments, George Engelhard, Jr. & Stefanie Wind Statistical Analyses for Language Testers, Rita Green
Rasch Models: Foundations, Recent Developments, and Applications, Fischer & Molenaar Journal of Applied Measurement Rasch models for measurement, David Andrich Constructing Measures, Mark Wilson Rasch Analysis in the Human Sciences, Boone, Stave, Yale
in Spanish: Análisis de Rasch para todos, Agustín Tristán Mediciones, Posicionamientos y Diagnósticos Competitivos, Juan Ramón Oreja Rodríguez
Winsteps Tutorials Facets Tutorials Rasch Discussion Groups


Coming Rasch-related Events
April 10-12, 2018, Tues.-Thurs. Rasch Conference: IOMW, New York, NY, www.iomw.org
April 13-17, 2018, Fri.-Tues. AERA, New York, NY, www.aera.net
May 22 - 24, 2018, Tues.-Thur. EALTA 2018 pre-conference workshop (Introduction to Rasch measurement using WINSTEPS and FACETS, Thomas Eckes & Frank Weiss-Motz), https://ealta2018.testdaf.de
May 25 - June 22, 2018, Fri.-Fri. On-line workshop: Practical Rasch Measurement - Core Topics (E. Smith, Winsteps), www.statistics.com
June 27 - 29, 2018, Wed.-Fri. Measurement at the Crossroads: History, philosophy and sociology of measurement, Paris, France., https://measurement2018.sciencesconf.org
June 29 - July 27, 2018, Fri.-Fri. On-line workshop: Practical Rasch Measurement - Further Topics (E. Smith, Winsteps), www.statistics.com
July 25 - July 27, 2018, Wed.-Fri. Pacific-Rim Objective Measurement Symposium (PROMS), (Preconference workshops July 23-24, 2018) Fudan University, Shanghai, China "Applying Rasch Measurement in Language Assessment and across the Human Sciences" www.promsociety.org
Aug. 10 - Sept. 7, 2018, Fri.-Fri. On-line workshop: Many-Facet Rasch Measurement (E. Smith, Facets), www.statistics.com
Sept. 3 - 6, 2018, Mon.-Thurs. IMEKO World Congress, Belfast, Northern Ireland www.imeko2018.org
Oct. 12 - Nov. 9, 2018, Fri.-Fri. On-line workshop: Practical Rasch Measurement - Core Topics (E. Smith, Winsteps), www.statistics.com


Our current URL is www.winsteps.com

Winsteps® is a registered trademark


John "Mike" Linacre, author of Winsteps, and Jenny use and recommend eco-friendly, safe and effective wellness and beauty products such as skincare