genstat

Background and rationale

GenStat is a versatile computer program for statistical analysis. Analyses can be preformed using a menu-driven user interface. During these interactive sessions an input stream of GenStat code is created, which can be saved as a record or for reuse with or without modification. Saved GenStat code can be submitted as batch jobs. Flow control directives can be incorporated into these jobs, as GenStat is a feature-rich scripting language. GenStat code can also be written directly and run without using the interactive interface.

Although the GenStat interactive interface provides code highlighting, there is no simple way to enhance the presentation of code from saved input streams or in batch jobs incorporated into reports or teaching materials.

Pygments provides a simple way to highlight code files on systems running Python. The highlighted code can be saved in a number of formats, including HTML, RTF, LaTeX and ANSI sequences. MoinMoin provides a parser called highlight that uses Pygments internally. This can be used to display highlight GenStat code either in a parser section or embedded attachments.

Description

A Pygments highlighting lexer for GenStat Release 10.

Usage

As parser section

{{{#!highlight genstat
JOB "Example GenStat code"
UNIT [NVALUES=3] Plot
READ [PRINT=data,errors] Plot,RootWt,ShootWt
2 23.4 34.5
1 43.2 54.3 
3 34.2 45.3:
CALC [s] MeanPlantWt = vmean(RootWt+ShootWt)
PRINT MeanPlotMean
STOP
}}}

renders as:

Syntax highlighting not supported for 'genstat', see HelpOnParsers.

   1 JOB "Example GenStat code"
   2 UNIT [NVALUES=3] Plot
   3 READ [PRINT=data,errors] Plot,RootWt,ShootWt
   4 2 23.4 34.5
   5 1 43.2 54.3 
   6 3 34.2 45.3:
   7 CALC [s] MeanPlantWt = vmean(RootWt+ShootWt)
   8 PRINT MeanPlotMean
   9 STOP

As embedded attachment

The MoinMoin configuration file wikiconfig.py must include:

   1 import mimetypes
   2 
   3 mimetypes.add_type("text/x-genstat", ".gen", True)

Attachments must be named *.gen. See under Example below.

Download & Release Notes

Download	Release Version	Moin Version	Release Notes
genstat.py	1.0	1.9.2

Installation

The lexer file genstat.py needs to be copied to:

/lib/python2.4/site-packages/MoinMoin/support/pygments/lexers

or your equivalent.

Alternatively, the content of the lexer file genstat.py can be copied into a builtin lexer, such as other.py, in the same location.

The script _mapping.py needs to be run in that location to map in the new lexer before MoinMoin can find it.

The GenStat lexer has not been submitted to Pygments yet. This will be considered after further testing, and if so, in future it might ship with installations of Pygments and MoinMoin.

Example

" Example DGRA-7: Drawing a weather map

      This example draws a map of Great Britain with wind speed and
      direction indicated at various points."

FILEREAD [NAME='%gendir%/examples/DGRA-7.DAT'] X,Y
XAXIS 1; LOWER=0; UPPER=7000; MARK=!(0,1000...7000)
YAXIS 1; LOWER=0; UPPER=10000; MARK=!(0,1000...10000)
FRAME [GRID=xy] 1; YLOWER=0; YUPPER=1; XLOWER=0; XUPPER=0.7
PEN 1; SYMBOL=0; METHOD=open; JOIN=given; LINESTYLE=1
DGRAPH [KEYWINDOW=0; TITLE='Wind speed'] Y; X

" Add arrows of different sizes and angles at different places"
DELETE [REDEFINE=yes] Y,X
SCALAR N,P; 35,5     " no. units, no. points in shapes "
MATRIX [ROWS=P; COLUMNS=N] XX,YY
DIAGONAL [ROWS=N] Size
POINTER [NVALUES=!T(X,Y)] At,Shape
MATRIX [ROWS=1; COLUMNS=N] Angle,At[]
MATRIX [ROWS=P; COLUMNS=1] Onep,Shape[]; VALUES=!((1)#P),(*)2
READ Shape[]
 0.0  0.0
 0.0  1.0
-0.25 0.75
 0.0  1.0
 0.25 0.75 :
OPEN '%gendir%/examples/DGRA-7A.DAT'; CHANNEL=data7
READ [CHANNEL=data7] At[],Size,Angle
CLOSE data7
CALC Rad = ARCCOS(0.5)/60.0
CALC XX,YY = (Shape['X','Y']*+COS(Angle*Rad)+    \
             (-1,+1)*Shape['Y','X']*+SIN(Angle*Rad))*+(Size)*6    \
             +Onep*+At['X','Y']
VARIATE [P] Xg[1...N],Yg[1...N]
CALC Xg[1...N] = XX$[*;1...N]
CALC Yg[1...N] = YY$[*;1...N]

PEN 1; LINESTYLE=1; SYMBOL=0; METHOD=line; JOIN=given; CLINE=2
DGRAPH [SCREEN=keep; KEYWINDOW=0] Yg[]; Xg[]; PEN=1
"
PEN 1;  LINE=1; CLINE=2; ROT=RADIAN(!(#Angle)); SIZE=!(#Size)/10; SYMBOL=Shape; METH=point; JOIN=given
DGRAPH [SCREEN=keep; KEYWINDOW=0] At['Y']; At['X']; PEN=1"

Example.gen

History

Version 1.0 - 25.03.2011: initial version

Copyright

License

GNU GPL, see COPYING for details.

Known issues and limitations

GenStat Release 13 was issued in March 2010 with new directives, functions and procedures that are not parsed in this version.
MoinMoin does not provide for different highlighting of the full range of token types supported by Pygments. See http://moinmo.in/ParserMarket/Pygments for more ideas about this.

Possible improvements

Recognition and specific highlighting of in-line data following a READ statement could be useful, especially for text or factor structures that happen to use words that coincided with directive, procedure or function names.
An option to allow selection of normalisation (capitalising and expanding of all keywords) could be useful.

Hits: 12179