xavr -> PostScript -> xpsview image (2:1 scale) -> xv grabbed image -> gif file -> your browser

You may find that some information was lost on the way...

[diagram template] name default field width:40 height:30 label tsize:2 time_axis unit:s scale:1 pos:0.0 min:-0.2 max:1.2 ampl_axis unit:uV scale:1 pos:0.0 min:5.0 max:-5.0 time_div step:0.2 len:1 ampl_div step:1 len:1 [diagram template] name scale label thide:on time_axis fmt:"%s" ampl_axis fmt:"%s" clear_div time_div step:0.2 len:1 fmt:"%.1f" ampl_div step:1 len:1 fmt:"%.0f" [objects] diagram lab:FP1 x: 38.00 y:144.00 tpl:default diagram lab:SCALE x: 38.00 y:110.00 tpl:scale

This is the most common "plain" case - the "default" data diagrams are very simple (you have to arrange 60 and more of them at one page). There is no axis text and only one division per axis - in the amplitude (here: voltage) axis it is one line per µV, which results in 11 ticks for the whole 10 µV axis. Note that you reach a "negatives up" behavior by assigning the voltage minimum to the axis maximum and reverse. (BTW, you cannot have a reversed time axis in the current version).

Usually we need at least one diagram with axis descriptions. Therefore a additional template named "scale" is defined. This template, as any template, inherits all settings from the "default" template and needs only the differing settings. The differences are:

• the new name "scale", needed to identify the template
• we want not to plot a diagram label, therefore we set label thide:on
• the axes should plot their units, so we add the fmt:"%s", what means that the axis unit: text is plotted
• the divisions are new (we want to plot divisions with values now) so we clear the old divisions and create identical new ones with a format string for the values added.

"Signal Inspector" Graphic Area

"Map Inspector" Graphic Area

Textstyles

  tcol:  color (a valid X color name)
  tfont: font (a valid PostScript font name - case sensitive!)
  tsize: fontsize (in mm)
  tx:    horizontal offset of text anchor point from text origin (in mm)
  ty:    vertical offset of text anchor point from text origin (in mm)
  tah:   horizontal text alignment relative to anchor point
         ("left", "right" or "center")
  tav:   vertical text alignment relative to anchor point
         ("bottom", "top", "center")
  thide: to enable/disable the text output ("off" or "on") 

The figure shows how the text box anchor point is displaced from the text origin coordinates and three of the nine possible alignments of the text box relative to its anchor point.

  Times-Roman
  Times-Italic
  Times-Bold
  Times-BoldItalic
  Helvetica
  Helvetica-Oblique
  Helvetica-Bold
  Helvetica-BoldOblique
  Courier
  Courier-Oblique
  Courier-Bold
  Courier-BoldOblique

  &C  - condition label
  &N  - number of trials/averages
  &M  - mean number of trials of the input averages
        valid for xavr's on-line calculated grand averages only
  &R  - number of rejected trials
  &F  - filename
  &Sx - subject code (first x characters of the filename)
  &Tx - condition code (after first x characters of the filename)
  &I  - index of the file in the current selection
  &L  - channel label

  sel:<placeholder(s)>=<literal>
  sel:<placeholder(s)>=/<regex>/

  sel:"&I&L=/^[14]F/"

Templates

Example

[global defaults]
page        width:297 height:210 grid:5
frame       type:eep hmargin:20 vmargin:9
trace_line  lw:0.25 lcol:black ldash:solid
scale_line  lw:0.15 lcol:black ldash:solid
text        tfont:Helvetica tsize:2
arrow       lw:0.40 lcol:black ldash:solid ang:30 len:3.5

Reference

page
  width:  page width (in mm)
  height: page height (in mm)
  grid:   the snap grid spacing for interactive object placement (in mm)
frame
  type:   "eep" (a thin black frame) or "mpi" (a thick dark-blue frame)
  vmargin:
  hmargin: space between sheet edge and frame line

Example

[diagram template]
name       default
field      width:21 height:14
label      tsize:2 fmt:"%s"
time_axis  unit:s   scale:1 pos:0.0 min:0.3  max:0.6
ampl_axis  unit:uV  scale:1 pos:0.0 min:-5.0 max:5.0
time_div   step:0.2  len:1 fmt:"%.1f"
ampl_div   step:1 len:1 fmt:"%.0f"

Reference

field
  width:  width of the area covering all diagram parts (in mm)
  height: height of the area covering all diagram parts (in mm)
  sel:    channel/file selection
label
  fmt:    printf format string for diagram label output("%s")
  t...:   textstyle parameters for the label string plot
ampl_axis/time_axis
  unit:   unit string (e.g "uV" or "fT")
  scale:  size of the unit above in terms of xavr base units 
          (s for time axis, avr data units for amplitude axis)
  min:    value of left or lower edge of diag (in axis units)
  max:    value of right or upper edge of diag (in axis units)
  pos:    axis position (in units of the other axis)
  l...:   linestyle parameters for the axis line
  fmt:    printf format string for unit string output("%s")
  t...:   textstyle parameters for the unit string 
          (text origin is the upper/right axis end point)
ampl_div/time_div/ttest_div
  step:   spacing between division lines (in axis units)
  pos:    position of a single division/marker line (in axis units)
  len:    length of the division lines (in mm, 0 means whole diagram)
  align:  alignment of division lines relative to axis line
          ("center", "left", "right", "top", "bottom")
  l...:   linestyle parameters for the division line
  fmt:    printf format string for (float) value output ("%.3f")
  t...:   textstyle parameters for the value string
          (text origin is the lower/left endpoint of the division line)
ttest_line
  state:  enable/disable the running ttest prob. diagram("on" or "off")
  height: height of the diagram (in mm)
  min:    start point for probability drawing(in time axis units)
  max:    end point for probability drawing(in time axis units)
ttest_grey
  state:  enable/disable the prob. greyscale bar ("on" or "off")
  height: height of the greyscale bar (in mm)
  min:    start point for probability drawing(in time axis units)
  max:    end point for probability drawing(in time axis units)
  t...:   textstyle parameters for the greyscale legend of the 
          "scale" template (evaluated in PostScript only)

Axis division values are not permitted to cover axis lines and the spacing between division lines must be larger than 3 * division linewidth. Otherwise, nothing is drawn.

The probability axis of the semilogarithmic t-ttest diagram is hard-coded (min:1 max:0.001). Linestyle parameters are inherited from time/ampl axes. Divisions lines (ttest_div) are possible with pos only, not with step.

Map Templates

Example

[map template]
name         default
field        width:60 palette:bluered
time_axis    unit:s  scale:1 fmt:"&C: %.3f .. %.3f %s" tsize:2 ty:5
ampl_axis    unit:uV scale:1 min:-5.5 max:5.5
ampl_div     step:1 lw:0.2
outline      lw:0.2 
sensors      size:1 
legend       height:5 width:40 fmt:"%+.1f"

Reference

field
  width:    width/height of the square covering all map parts (in mm)
  palette:  color palette for amplitude (z-axis) encoding
            (the name of an own map palette or one of
             the predifined palettes "bluered","grey","mapview",
             "spectrum")
  sel:      file selection
  mesh:     for debugging; toggle drawing 0f the triangle mesh (0 or 1)
time_axis
  unit:   time unit string ("s" or "ms")
  scale:  size of the unit above in terms of xavr base units (seconds)
  fmt:    format string for map label output
          (printf placeholders for tmin, tmax and the time axis unit and
          ERP attribute placeholders)
  t...:   textstyle parameters for the label string
          (text origin is the map object position)
ampl_axis
  unit:   amplitude unit string ("uV" or "fT", "z" enables 
          z-standardization)
  scale:  size of the unit above in terms of average data units
  min:    amplitude value assigned to the lower end of the color scale
  max:    amplitude value assigned to the upper end of the color scale
ampl_div
  step:   the amplitude range represented by one color
  l...:   linestyle parameters for the iso... lines 
          (0 means no isolines)
outline
  l...:   linestyle parameters for the outline polygon
sensors
  size:   diameter of the dot which represents the sensor pos. (in mm)
  fmt:    printf format string for sensor label plot ("%s")
  t...:   textstyle parameters for sensor label plot
          (text origin is sensor position)
  l...:   linestyle parameters for sensor dot plot
legend
  height: height of the color scale legend
  width:  width of the color scale legend
  fmt:    printf format string for min/max amplitude values ("%.1f")
  t...:   textstyle parameters for min/max amplitude values

Description

The first line defines the name of the palette. This line is optional. A palette without a name is used for all maps.

It is followed by a list of <color> [<coordinate>] pairs, where <color> can be any valid X color specification and the optional <coordinate> is the relative position of the given color (0.0 - minimum, 1.0 - maximum) in the generated palettes.

The actual palette colors are computed by linear interpolation of the red/green/blue components between these given supporting points. (Eventually, your display hardware gives you only approximations of the requested colors. You need to look at the final PostScript output then.)

Examples

[map palette]
name strange
rgb:00/f0/00  0.0
rgb:00/00/f0  0.2
rgb:00/00/ff  1.0

[map palette]
name bluered
blue
white
red

Legend Template

Example

[legend template]
headline    fmt:"Legend:" x:230 y:100 tsize:4.5
avr_entry   fmt:"&C (n=&N)"           tsize:3.5 len:6
diff_entry  fmt:"&s4 &c - &S4 &C"     tsize:3.5 len:6

Reference

headline
  fmt:    legend headline string
  x:      position of the legend headline text
  y:      position of the legend headline text
  dh:     horizontal distance between entries (in mm), default:0
  dy:     vertical distance between entries (in mm), default:-1.4*fontsize
  t...:   textstyle parameters for the legend strings
avr_entry/diff_entry
  fmt:    legend format string, subject to 
          ERP attribute expansion
  len:    length of the sample line segment (in mm)
  t...:   textstyle parameters for the legend strings

Style Template

Example

[style template]
trace  sel:"&C=rare"     lcol:red  ldash:dotted
trace  sel:"&C=/^freq/"  lcol:blue ldash:solid lw:5

Description

Since xavr allows interactive modifications of objects, it has to reflect such changes into the list. For this reason, whenever you have made such changes and enter the Edit - Configuration... dialog, xavr looks for the [objects] keyword in the file, throws away all stuff that follows and creates a completely new object list from the current internal state.

Therefore, the [objects] section has to be the last section in the file and should contain no special user formattings or comments!

Some object lines are generated as comments. Currently, this are the objects which form the legend. Since they are generated dynamically at each data loading time, it is not necessary to load them at layout creation time. If you are not satisfied with the automatic legend, you can comment out the [legend template], uncomment the legend objets and adapt them as needed. After this you have a static legend in the drawing.

Example

[objects]
text       x:148.00 y:185.00 txt:"Page Title" tsize: 8.00 tah:center
diagram    x: 38.00 y:126.00 tpl:default lab:FZ     
diagram    x: 38.00 y: 58.00 tpl:default lab:PZ     
maplegend  x:176.34 y: 26.46 tpl:default
map        x:172.00 y:108.00 tpl:default tmin: 0.200 tmax: 0.400 file:1
map        x:172.00 y: 38.00 tpl:default tmin: 0.200 tmax: 0.400 file:2

Reference

diagram
  x:
  y:      coordinates of the lower left corner of the diagram (in mm)
  tpl:    name of the assigned diagram template
  lab:    diagram label, the diagram will show the data for this channel
          if no sel:... is specified
  sel:    file/channel selection, overrides the template settings
map
  x:
  y:      coordinates of the lower left corner of the map field (in mm)
  tpl:    name of the assigned map template
  tmin:   start of the time slice for this map (in time_axis units)
  tmax:   stop of the time slice for this map (in time_axis units)
  file:   file selection
          (1 means: this map will show the first loaded/calculated file, 
           2 means: this map will show the second loaded/calculated file,
           ...
           0 means: this map will show the last loaded/calculated file)
  sel:    file selection, overrides file: and the template settings
maplegend
  x:
  y:      coordinates of the lower left corner of the
          map legend color bar(in mm)
  tpl:    name of the assigned map template
line
  x: 
  y:
  x2:
  y2:     coordinates of the line end points (in mm)
  l...:   linestyle parameters
  ang:    opening angle of the arrow head triangle (in degrees)
  len:    length of the arrow head triangle (in mm)
text
  x: 
  y:      coordinates of the text origin point (in mm)
  txt:    text string to be drawed
  t...:   textstyle parameters
epsf
  x: 
  y:      lower left corner of the illustration field (in mm)
  w:      width of the illustration field (in mm)
  h:      height of the illustration field (in mm); unspecified means
          fixed scale, height is computed from width and the EPS file 
          bounding box
  rot:    rotation angle for the included illustration (in deg); 
          unspecified means 0 or -90 (%%Orientation: Landscape)
  name:   name of a strictly conforming EPS file