mkgraph(1)

1mkgraph(1)                       User Commands                      mkgraph(1)
2
3
4

NAME

6       mkgraph - draw the submodule lattice
7

SYNOPSIS

9       mkgraph [OPTIONS] <Name> [<Lower> <Upper>]
10

DESCRIPTION

12       This  program creates a graphical representation of a submodule lattice
13       in PostScript or other formats.  The first argument must be the  module
14       name.   The  mksub(1) program must have been run, because mkgraph reads
15       the ".gra" file created by mksub(1).  If two additional  arguments  are
16       specified,  only  the  modules  between  Lower and Upper are drawn.  If
17       mksub(1) was used in "block mode", only single blocks can be drawn.  In
18       this case, the block number must be specified with -b.
19
20       If  no  other  format is specified, mkgraph produces PostScript output.
21       Submodules are represented by boxes, and each Submodule is linked  with
22       its  maximal  submodules  by a line.  Different line styles are used to
23       distinguish between irreducible constituents.  Each  node  carries  the
24       submodule  number  as found in the Name.out file.  Local submodules are
25       displayed with thick boxes.  The socles are shown as circles instead of
26       boxes,  and  the  radicals are shown in diamond shapes.  The line style
27       represents the irreducible constituent isomorphic to the  factor module
28       represented by the line.  The output is written to Name.ps unless -G is
29       used.
30
31       If the option -G is used, mkgraph creates commands that can be read  by
32       xGAP.
33

OPTIONS

35       -Q     Quiet, no messages.
36
37       -V     Verbose, more messages.
38
39       -T <MaxTime>
40              Set CPU time limit
41
42       -G     Generate GAP/xGAP output on stdout instead of PostScript.
43
44       -b <Block>
45              Select block (use with mksub -b).
46
47       -c <Colors>
48              Set  colors.   Format  is 'name=R/G/B', where name is any of std
49              (standard color),  line  (lines),  sub  (submodule  boxes),  soc
50              (socle  series), rad (radical series), and mnt (mountains).  The
51              R, G, and B values are integers in the range 0-99.
52

IMPLEMENTATION DETAILS

54       The algorithm used to position the nodes (submodules) is  very  simple.
55       In most cases the result is far from optimal, but also much better than
56       a random drawing.  Submodules are  grouped  into  layers  according  to
57       their composition length.  All submodules in one layer are drawn at the
58       same y (vertical) position, and at equidistant x positions.   The  pro‐
59       gram tries to optimize the order of submodules in each layer, such that
60       lines between the submodules become short.
61

INPUT FILES

63       Name.gra
64              Lattice calculated by mksub(1).
65

OUTPUT FILES

67       Name.ps
68              Picture in PostScript format.
69