XLOGGRAPH (CCP4: Supported Program)
NAMExloggraph - X-windows tool, a viewer of specially formatted `log' files.
DESCRIPTIONxloggraph belongs to the XCCPJiffy class of simple X11 graphic based programs. xloggraph reads specially formatted log file produced by some of the CCP4 programs, recognises tables and graphs described in it and produces their graphic representation.
NB: the loggraph program offers an alternative to xloggraph.
xloggraph uses an X-window device and has an option to create a PostScript file.
Running the program xloggraph creates a Header window with boxes showing:
REMARK FOR APPLICATION PROGRAMMERS
Syntax of the Graph description in a log file
$TABLE :table name: $GRAPHS :graph1 name:graphtype:column_list: :graph2 name:graphtype:column_list: :graph 3 ...: ... $$ column1_name column2_name ... $$ any_characters $$ numbers $$Where:
Parsing algorithm for the tableTable values (numbers) are read in free format. This implies, that they MUST be separated by space(s) and/or tab(s) and/or newline(s). Parsing is performed on a logical line basis, where a logical line begins with a newline, followed by a number of values corresponding to the number of table columns, an optional comment (any characters) up to the next newline delimiter. The term `logical' is used, because this 'logical' line can consist of several `physical' lines, where newlines between values are treated as ordinary delimiters.
Syntax of the Text description in log file
$TEXT :text name: $$ junk (ignored) text $$any text characters$$
Syntax of the Key Text description in log file
$KEYTEXT :text name: $$any text characters$$keyword_with_values$$ any_characters - are the descriptive text keyword_with_values - is a keyworded format of data
Synatx of Summary description
$SUMMARY :summary_name: $$ any characters $$ :component_type:component_name: :component_type:component_name: ...$$ component_type - is `TEXT` either `KEYTEXT` component_name - is it's nameDue to the single-pass parsing all TEXTs and KEYTEXTs must be defined BEFORE the SUMMARY.
NOTE ON COLOURS AND LINE STYLES - For Users and Programmersxloggraph works in pen graphic mode, each object is painted by a different virtual pen. By definition, xloggraph uses pen1 for for Graph axes and texts, pen2 for 1st graph, pen3 for the second etc. Currently 10 pens are available.
Colour, Line width and Postscript properties of virtual pens are controlled via the entries in X-resource database (see X manual). It is recommended to load X-resources into the X-server database (xrdb). Once the database is loaded, one can optimise it using xrdb to load/merge a personalised set of X-Application Resources.
X pen is controlled by:
XCCPJiffy.graph*draw2d.background: white XCCPJiffy.graph*draw2d.pen1Color: black XCCPJiffy.graph*draw2d.pen1LineWidth: 1 . . . XCCPJiffy.graph*draw2d.pen10Color: indigo XCCPJiffy.graph*draw2d.pen10LineWidth: 1
Postscript pen by:
XCCPJiffy*psPen1Attr: 1 setlinejoin 0.5 setlinewidth  0 setdash . . . XCCPJiffy*psPen10Attr: 1 setlinejoin 0.9 setlinewidth [8 2] 0 setdashTo check your current setting use for instance
xrdb -query | grep XCCPJiffy | more
SEE ALSOloggraph, X (1), xccpjiffy2idraw (1), xrdb (1)
ENVIRONMENTDISPLAY to figure out which display to use.
AUTHORJan Zelinka - York University