
Calling Sequence


DrawSubgroupLattice(G, opts)
DrawSubgroupLattice(sgl, opts)


Parameters


G



group data structure

opts



(optional) equations of the form keyword or keyword = value, as explained below

sgl



subgroup lattice data structure





Options



Specifying assignlattice = x causes Maple to assign the subgroup lattice of G to the name x. If x already has an assigned value, it will typically be necessary to use quotes to prevent evaluation of x: one can do so by specifying assignelements = 'x'.

•

vertexcolor = color and edgecolor = color


These two options control the color for subgroups not specified by any of the following options, and the color with which the edges are colored, respectively. The default is white for the vertex color and gray for the edge color. The colors need to be specified in a way that is recognized by ColorTools[Color]. Maple also accepts the alternative spellings vertexcolour and edgecolour.

•

highlight = subgroup, or list of subgroups, or list of equations


The highlight option can be used to visually highlight one or a few subgroups by drawing the vertices that correspond to them in a particular color. The highlight option can be specified in multiple ways; in the following explanation, H1, H2, H3, H4 are subgroups of G and color1, color2 are colors recognized by ColorTools[Color]:

–

it can be a single subgroup H1,

–

it can be an equation H1 = color1,

–

it can be an equation [H1, H2, H3] = color1,

–

it can be a list of multiple entries of the previous three forms, such as [H1, [H2, H3] = color1, H4 = color2]


In all these cases, each subgroup Hi can be replaced by a subgroup series object consisting of subgroups of G (such as a LowerCentralSeries object).


Subgroups can be specified as group data structures for which the parent group is G, or as sets of generators.


Subgroups specified in the highlight option with an associated color will have the corresponding vertices highlighted in that color. Any subgroup that is specified in the highlight option, but has no associated color (such as H1 in the last example), will be highlighted in red. Subgroups not mentioned in the highlight option will be colored according to the vertexcolor option.


Colors of vertices can also be specified by the normal, center, or derived options described below. If multiple options specify the color for a single subgroup, then the priorities are as follows: highlight overrules center, center overrules derived, and derived overrules vertexcolor.


If you wish to supply an equation as the value of the option, then be aware that highlight = H1 = color1 will not be parsed correctly; the easiest way around that is to parenthesize the equation, as highlight = (H1 = color1).

•

center or center = color or center = true or center = false


Specifying this option is the same as including Center(G) = "LightBlue" or Center(G) = color in the highlight option. Specifying center = false colors the center in the same way as other subgroups. The default is center = true, if the group supports the Center operation.

•

normal or normal = color or normal = true or normal = false


Specifying this option is the same as including H = "LightGreen" or H = color in the highlight option, for every normal subgroup H of G. (Normal subgroups can be recognized visually as being the only ones in their conjugacy class.) Specifying normal = false colors the normal subgroups in the same way as other subgroups. The default is normal = true.

•

derived or derived = color or derived = true or derived = false


Specifying this option is the same as including H = "red" or H = color in the highlight option, for every group H in the derived series of G. Specifying derived = false colors these subgroups in the same way as other subgroups. The default is derived = false.

•

indices or indices = true or indices = false


If the option indices = true or indices is specified, then every edge in the subgroup lattice graph, corresponding, say, to an inclusion of a subgroup H1 into a subgroup H2, is labeled with the index of H1 in H2. If indices = false is specified (the default) there are no labels on edges.

•

directed = true or false


If the option directed = true or directed is specified, then every edge in the subgroup lattice graph is directed from the smaller to the larger subgroup. If directed = false is specified (the default) then this is not the case.

•

labels = integers or labels = zuppos or labels = none or labels = ids


By default, each vertex is labeled with a single integer: the position of the corresponding subgroup in the list of subgroups obtained by calling convert(sgl, list) (see the SubgroupLattice help page for details). This behavior is explicitly specified by including the option labels = integers.


If you specify the option labels = none, the vertices will not be labeled. This option has no effect when combined with the output = graph option.


Alternatively, each vertex can be labeled with multiple integers. These integers correspond to the zuppos generating the corresponding subgroup H (the zuppos are ordered in a certain way and the integers correspond to the positions of the zuppos that generate H in the list of all zuppos). This allows for easy visual verification of the inclusion relations. This behavior is specified by including the option labels = zuppos. For more details about zuppos, see the SubgroupLattice help page.


The last alternative is that each vertex is labeled with its subgroup identity as determined by IdentifySmallGroup, with the size and number of the group separated by a slash ($\mathrm{`/`}$). For example, the cyclic group with six elements is the second group of that order; it would get label $\mathrm{6/2}$. This is obtained by using the option labels = ids.

•

output = graph or output = plot


By default, this command returns a graphical representation of the subgroup lattice: a plot data structure for the corresponding graph. This behavior is explicitly specified by including the option output = plot.


Alternatively, if the option output = graph is specified, then this command returns the corresponding graph data structure itself, generated using the GraphTheory package. Its structure can then be examined or the display finetuned. In order to display the resulting graph, call the GraphTheory[DrawGraph] command.


The given expression is typeset as the title above the subgroup lattice. This option is ignored if output = graph is specified.


The title is printed with this font. The font is specified as explained in plot/options. This option is ignored if output = graph is specified.



Description


•

The command DrawSubgroupLattice accepts a finite group G, calls the SubgroupLattice command in order to compute the subgroup lattice of G, and returns a plot of that subgroup lattice. Alternatively, you can pass it a subgroup lattice data structure you had computed before.

•

The subgroup lattice is displayed as a graph with a vertex for each subgroup of G and an edge between two subgroups H1 and H2 if H1 is a subgroup of H2 and there are no subgroups in between. The vertices are drawn in horizontal layers corresponding to the layer structure described on the SubgroupLattice help page. Furthermore, in each layer, conjugacy classes of subgroups have their vertices spaced closer together than subgroups that are not conjugate.



Examples


>

$\mathrm{with}\left(\mathrm{GroupTheory}\right)\:$

Consider a group of order 48.
>

$\mathrm{g1}\u2254\mathrm{SmallGroup}\left(48\,8\right)$

${\mathrm{g1}}{\u2254}{\mathrm{<\; a\; permutation\; group\; on\; 48\; letters\; with\; 5\; generators\; >}}$
 (1) 
We view its subgroup lattice.
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g1}\right)$

Alternatively, we can highlight the subgroups given by each of the generators of the group. We see that some of the generators are redundant: they are contained in supergroups that are generated by other generators.
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g1}\,'\mathrm{highlight}'=\mathrm{map}\left(\mathrm{`\{\}`}\,\mathrm{Generators}\left(\mathrm{g1}\right)\right)\right)$

Let's take a look at the lower central series of $\mathrm{g1}$. The two invocations of $\mathrm{DrawSubgroupLattice}$ are equivalent.
>

$\mathrm{lcs}\u2254\mathrm{LowerCentralSeries}\left(\mathrm{g1}\right)$

 (2) 
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g1}\,'\mathrm{highlight}'=\left[\mathrm{seq}\left(i\,i=\mathrm{lcs}\right)\right]\right)$

>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g1}\,'\mathrm{highlight}'=\mathrm{lcs}\right)$

Try a different group, of order 24. We represent it as a Cayley table group.
>

$\mathrm{g2}\u2254\mathrm{Group}\left(\mathrm{CayleyTable}\left(\mathrm{SmallGroup}\left(24\,1\right)\right)\right)$

${\mathrm{g2}}{\u2254}{\mathrm{<\; a\; Cayley\; table\; group\; with\; 24\; elements\; >}}$
 (3) 
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g2}\right)$

We can highlight the derived series members instead of the center and the other normal subgroups, and assign the subgroup lattice data structure to a variable $l$.
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g2}\,'\mathrm{derived}'\,'\mathrm{center}=\mathrm{false}'\,'\mathrm{normal}=\mathrm{false}'\,'\mathrm{assignlattice}=l'\,'\mathrm{title}'=''Derived\; subgroup''\,'\mathrm{titlefont}'=\left[''HELVETICA''\,10\right]\right)$

$\left[\begin{array}{c}{\mathrm{subgroup\; lattice}}\\ {8}{\mathrm{conjugacy\; classes}}\\ {10}{\mathrm{subgroups}}\end{array}\right]$
 (4) 
With the $\mathrm{labels}$ option, we can show the zuppos in each subgroup. With the $\mathrm{indices}$ option, we can show the index of each subgroup in each of its direct supergroups.
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g2}\,'\mathrm{labels}=\mathrm{zuppos}'\,'\mathrm{indices}'\right)$

Alternatively, we can use the $\mathrm{labels}$ option to show the small group identity of each subgroup.
>

$\mathrm{DrawSubgroupLattice}\left(\mathrm{g2}\,'\mathrm{labels}=\mathrm{ids}'\right)$

Finally, by requesting the output as a graph data structure, we can enable display in 3D.
>

$\mathrm{g3}\u2254\mathrm{SmallGroup}\left(60\,9\right)$

${\mathrm{g3}}{\u2254}\u27e8\left({1}{\,}{2}{\,}{3}\right)\left({4}{\,}{8}{\,}{12}\right)\left({5}{\,}{9}{\,}{13}\right)\left({6}{\,}{11}{\,}{22}\right)\left({7}{\,}{24}{\,}{14}\right)\left({10}{\,}{15}{\,}{23}\right)\left({16}{\,}{25}{\,}{31}\right)\left({17}{\,}{27}{\,}{39}\right)\left({18}{\,}{41}{\,}{32}\right)\left({19}{\,}{28}{\,}{34}\right)\left({20}{\,}{30}{\,}{44}\right)\left({21}{\,}{46}{\,}{35}\right)\left({26}{\,}{33}{\,}{40}\right)\left({29}{\,}{36}{\,}{45}\right)\left({37}{\,}{48}{\,}{55}\right)\left({38}{\,}{57}{\,}{51}\right)\left({42}{\,}{50}{\,}{58}\right)\left({43}{\,}{60}{\,}{53}\right)\left({47}{\,}{52}{\,}{56}\right)\left({49}{\,}{54}{\,}{59}\right){\,}\left({1}{\,}{4}{\,}{16}{\,}{19}{\,}{5}\right)\left({2}{\,}{8}{\,}{25}{\,}{28}{\,}{9}\right)\left({3}{\,}{12}{\,}{31}{\,}{34}{\,}{13}\right)\left({6}{\,}{17}{\,}{37}{\,}{42}{\,}{20}\right)\left({7}{\,}{18}{\,}{38}{\,}{43}{\,}{21}\right)\left({10}{\,}{26}{\,}{47}{\,}{49}{\,}{29}\right)\left({11}{\,}{27}{\,}{48}{\,}{50}{\,}{30}\right)\left({14}{\,}{32}{\,}{51}{\,}{53}{\,}{35}\right)\left({15}{\,}{33}{\,}{52}{\,}{54}{\,}{36}\right)\left({22}{\,}{39}{\,}{55}{\,}{58}{\,}{44}\right)\left({23}{\,}{40}{\,}{56}{\,}{59}{\,}{45}\right)\left({24}{\,}{41}{\,}{57}{\,}{60}{\,}{46}\right){\,}\left({1}{\,}{6}\right)\left({2}{\,}{10}\right)\left({3}{\,}{14}\right)\left({4}{\,}{17}\right)\left({5}{\,}{20}\right)\left({7}{\,}{23}\right)\left({8}{\,}{26}\right)\left({9}{\,}{29}\right)\left({11}{\,}{24}\right)\left({12}{\,}{32}\right)\left({13}{\,}{35}\right)\left({15}{\,}{22}\right)\left({16}{\,}{37}\right)\left({18}{\,}{40}\right)\left({19}{\,}{42}\right)\left({21}{\,}{45}\right)\left({25}{\,}{47}\right)\left({27}{\,}{41}\right)\left({28}{\,}{49}\right)\left({30}{\,}{46}\right)\left({31}{\,}{51}\right)\left({33}{\,}{39}\right)\left({34}{\,}{53}\right)\left({36}{\,}{44}\right)\left({38}{\,}{56}\right)\left({43}{\,}{59}\right)\left({48}{\,}{57}\right)\left({50}{\,}{60}\right)\left({52}{\,}{55}\right)\left({54}{\,}{58}\right){\,}\left({1}{\,}{7}\right)\left({2}{\,}{11}\right)\left({3}{\,}{15}\right)\left({4}{\,}{18}\right)\left({5}{\,}{21}\right)\left({6}{\,}{23}\right)\left({8}{\,}{27}\right)\left({9}{\,}{30}\right)\left({10}{\,}{24}\right)\left({12}{\,}{33}\right)\left({13}{\,}{36}\right)\left({14}{\,}{22}\right)\left({16}{\,}{38}\right)\left({17}{\,}{40}\right)\left({19}{\,}{43}\right)\left({20}{\,}{45}\right)\left({25}{\,}{48}\right)\left({26}{\,}{41}\right)\left({28}{\,}{50}\right)\left({29}{\,}{46}\right)\left({31}{\,}{52}\right)\left({32}{\,}{39}\right)\left({34}{\,}{54}\right)\left({35}{\,}{44}\right)\left({37}{\,}{56}\right)\left({42}{\,}{59}\right)\left({47}{\,}{57}\right)\left({49}{\,}{60}\right)\left({51}{\,}{55}\right)\left({53}{\,}{58}\right)\u27e9$
 (5) 
>

$\mathrm{graph3}\u2254\mathrm{DrawSubgroupLattice}\left(\mathrm{g3}\,'\mathrm{labels}=\mathrm{zuppos}'\,'\mathrm{directed}'\,'\mathrm{highlight}'=\left[\mathrm{g3}\,\varnothing \right]\,'\mathrm{vertexcolor}=\mathrm{DarkGrey}'\,'\mathrm{edgecolor}=\mathrm{DarkGrey}'\,'\mathrm{output}=\mathrm{graph}'\right)$

${\mathrm{graph3}}{\u2254}{\mathrm{Graph\; 1:\; a\; directed\; unweighted\; graph\; with\; 20\; vertices\; and\; 40\; arc(s)}}$
 (6) 
>

$\mathrm{GraphTheory}:\mathrm{DrawGraph}\left(\mathrm{graph3}\,'\mathrm{dimension}=3'\,'\mathrm{style}=\mathrm{spring}'\right)$



Compatibility


•

The GroupTheory[DrawSubgroupLattice] command was introduced in Maple 17.



