Standalone (Command-Line) Executable

Overview

The psignifit engine source code can be compiled to run as a command-line executable. On the UNIX or DOS command line, it can receive its input through stdin or through named files, in the manner of most command-line utilities. Under Classic MacOS, the utility takes all its input from a text file called "prefs" in its own directory. On the download page, you can download the standalone utility, ready compiled for various platforms. The archive contains:
 

  • the executable
  • sample data file dat
  • sample preferences file prefs
  • documentation file batch_strings.txt explaining the format in which preferences are specified
  • documentation file psych_options.txt explaining each of the options that can be used in preferences files
  • documentation file psych_gloss.txt explaining many of the terms and variable names involved in the fitting and bootstrapping process.
  • legal waffle
  • Release notes/version history

Quick-Start Guide

On MacOS 9.x and below, the flexibility of the standalone application is limited. All its input comes from a text document called "prefs" in the application folder. Edit the "prefs" document, then simply double-click on the application to run.

 

On Windows, the flexibility of the standalone is limited simply because the flexibility of the command-line is limited. It is highly recommded that you download Cygwin, and then use a Cygwin-compiled version of psignifit under the bash or tcsh shells.

 

As a command-line executable, psignifit can accept input in a number of different ways:
 

  • From named text files:
    psignifit dat prefs
  • Entirely from the console:
    psignifit
    (enter data and preferences from the console and then send an EOF character - Ctrl-D in most UNIX shells, Ctrl-Z in DOS)
  • Partly from named text files, partly from the console:
    psignifit dat prefs -
  • Through a pipe:
    cat dat prefs | psignifit
  • Or via a mixture of piped input on stdin and files named on the command line:
    echo "#random_seed 12345" | cat prefs - | psignifit dat -

 
Example dat and prefs are supplied with the standalone distribution. (NB: for the Mac application, the "prefs" file must contain the data too, so there is no separate dat file.

 

See the enclosed help documents for an explanation of the preferences format, a list of available options and a glossary of common terms. Note in particular the #WRITE_... options described in psych_options.txt), which allow different parts of the output to be redirected to named files, or to the standard output. If no #WRITE_... options are specified, then certain matrices are printed to stdout by default - this is the output you will probably see the first time you run the utility, and the parts you are most likely to be interested in are the TH_LIMS and SL_LIMS matrices, whose format is as follows:

Explanation of the LIMS matrix format

#TH_LIMS 
(title denotes that the matrix contains BCa limits on thresholds)
1.62550,
2.44760,
3.24168 
(0.023 confidence level)
 
1.87944,
2.63461,
3.35152
(0.159 confidence level) 
(rows denote confidence
2.31639,
2.92715,
3.64109
(0.841 confidence level)
 levels - default values shown)
2.52740,
3.05343,
3.90114
(0.977 confidence level) 
 
(F=0.2)
 
(F=0.5)
 
(F=0.8)
(columns denote threshold
levels - default values shown)