 Magma - Maple Programming Help

Home : Support : Online Help : Mathematics : Algebra : Magma : Magma/Format

Magma

 Format
 format a magma as text for inclusion in a document

 Calling Sequence Format( m ) Format( m, options )

Parameters

 m - a magma to format options - zero or more options of the form format = fmt or labels = lbls.

Options

 • The format option is used to specify the output format desired. Its value may be chosen from among those shown in the following table.

 text plain text, the default latex formatted as a LaTeX table html formatted as an HTML table mathml formatted as a MathML table wiki formatted as a MediaWiki table

 • Use the labels option to specify names for the members of the magma other than small integers. The value of the labels option must be either a string, or a list of strings.  If a string is provided, then its length must be equal to the order of the magma, and the individual characters in the string will be used as element names, in the order given.  If a list of strings is provided, then the number of its members must be equal to the order of the magma, and each string in the list will be used as element names, in the order given. You can use markup within these strings consistent with the output format chosen.  For example, a list of labels of the form [ "$a$", "$b$", "$c$" ] may be given for LaTeX output.

Description

 • The Format command formats a magma (as an operation table) to a string in any one of several supported formats.  This is meant to be a tool for including small magmas in documents such as papers, e-mail or web pages.
 • The formatted magma is returned as a string of text formatted using the selected format. You can use the printf command (with the %s conversion specifier) to print the string.  Alternatively, the returned text may be written to a file.

Examples

 > with( Magma ):

Create a small magma  with five members to be formatted.

 > N := 5:
 > m := RandomMagma( N );
 ${m}{≔}\left[\begin{array}{ccccc}{4}& {2}& {1}& {2}& {5}\\ {4}& {5}& {2}& {2}& {3}\\ {2}& {2}& {1}& {3}& {1}\\ {4}& {1}& {1}& {2}& {4}\\ {5}& {3}& {2}& {3}& {5}\end{array}\right]$ (1)

The default is to format the magma as plain text.

 > printf( "%s\n", Format( m ) );
 4 2 1 2 5  4 5 2 2 3  2 2 1 3 1  4 1 1 2 4  5 3 2 3 5
 > printf( "%s\n", Format( m, 'format' = "text" ) ); # equivalent
 4 2 1 2 5  4 5 2 2 3  2 2 1 3 1  4 1 1 2 4  5 3 2 3 5

Use LaTeX to include the formatted magma in a paper or book.

 > printf( "%s\n", Format( m, 'format' = 'latex' ) );
 \begin{smallmatrix}4&2&1&2&5\\ 4&5&2&2&3\\ 2&2&1&3&1\\ 4&1&1&2&4\\ 5&3&2&3&5 \end{smallmatrix}

Use HTML, MathML or MediaWiki for inclusion in a web page.

 > printf( "%s\n", Format( m, 'format' = 'html' ) );

42125
45223
22131
41124
53235
 > printf( "%s\n", Format( m, 'format' = 'mathml' ) );
 4212545223221314112453235
 > printf( "%s\n", Format( m, 'format' = 'wiki' ) );
 {| border="1" |- |4 || 2 || 1 || 2 || 5 |- |4 || 5 || 2 || 2 || 3 |- |2 || 2 || 1 || 3 || 1 |- |4 || 1 || 1 || 2 || 4 |- |5 || 3 || 2 || 3 || 5 |}

Display the magma using letters instead of small integers for its elements.

 > with( StringTools ):
 > printf( "%s\n", Format( m, 'labels' = Iota( "a" .. "z" )[ 1 .. N ] ) );
 d b a b e  d e b b c  b b a c a  d a a b d  e c b c e
 > printf( "%s\n", Format( m, 'format' = "latex", 'labels' = map( Fence, Explode( Iota( "a" .. "z" )[ 1 .. N ] ), "$", "$" ) ) );
 \begin{smallmatrix}$d$&$b$&$a$&$b$&$e$\\$d$&$e$&$b$&$b$&$c$\\$b$&$b$&$a$&$c$&$a$\\$d$&$a$&$a$&$b$&$d$\\$e$&$c$&$b$&$c$&$e$ \end{smallmatrix}

Compatibility

 • The Magma[Format] command was introduced in Maple 15.