alignment: identical(left,right,center):=center ; The horizontal alignment of the Table in the worksheet. The default value is center.

color: {list(nonnegint),symbol,string,appliable}:=[0,0,0] ; The foreground color for text. The passed value can be either a specified color acceptable to ColorTools:-Color, or a procedure which returns such. A list of nonnegative integers is interpreted as RGB values in a 24-bit 3-channel color space. In the case of a supplied procedure the passed arguments will be M, i, j for the cell in row i and column j. The default value is [0,0,0] which corresponds to black.

exterior: identical(all,none):=all ; Indicates how exterior borders are shown.

fillcolor: {list(nonnegint),symbol,string,appliable}:=[255,255,255] ; The background fill color for the Table cells. The passed value can be either a specified color acceptable to ColorTools:-Color, or a procedure which returns such. A list of nonnegative integers is interpreted as RGB values in a 24-bit 3-channel color space. In the case of a supplied procedure the passed arguments will be M, i, j for the cell in row i and column j. If the first argument to Tabulate is not a DataFrame then the default value for fillcolor is [255,255,255] which corresponds to white. If the first argument to Tabulate is a DataFrame then the default value for fillcolor is a procedure which returns [210,230,255] for the first column or row, and [255,255,235] otherwise.

interior: identical(all,none):=all ; Indicates how internal borders are shown.

output: identical(XML,inline); Specifies whether to insert the formatted output or return the raw XML structure.

plotcomponents: truefalse ; Indicates whether plots are inserted within Plot Components. The default is false. When this option is false plot entries that are not part of expression sequences are inlined within individual Table cells.

recordformat: identical(table,section); Specifies the layout format used for records

typesetting: identical(standard,extended); Specifies the typesetting level. By default the current value returned by interface(typesetting) is used.

weights: {list(nonnegint),Vector(nonnegint)} ; Relative weights for the Table's columns' widths. By default all columns have equal weight.

width: And(realcons,nonnegative):=100.0 ; Indicates the displayed width of the Table as a percentage of the worksheet's width in the case of option widthmode=percentage, or as the number or pixels in the case that option widthmode=pixels. The default is 100% of the displayed worksheet's width.

widthmode: identical(percentage,pixels):=percentage ; Whether the width option's value is interpreted as a percentage of the worksheet's width or as a number of pixels.

The Tabulate command constructs and inserts a worksheet Table from a Matrix, Vector, one or two dimensional Array, DataFrame, list, or list of lists.

The return value of the command is the identity of the inserted parent Table, as a string. The display of the returned value can be suppressed by terminating the statement with a full colon.

Calls to the Tabulate command cannot be nested within each other unless used with the option output=XML and other DocumentTools commands to construct your own content.

Expressions are inserted as typeset 2-D Math, and can be operated upon using context-sensitive operations in the Context Panel.

The inserted Tables will be removed by the main menu action Edit->Remove Output. Pasted copies of the inserted Tables are not removed.

This command inserts the assembly of Tables and Embedded Components into the worksheet using the InsertContent facility. The inserted content is placed after any usual output of the Execution Group in which this command is called. Each Execution Group allows for only one inserted result to exist at any given time. Multiple calls to commands which utilize the InsertContent facility made within the same Execution Group will result in each successive inserted assembly replacing any assembly inserted earlier for that Execution Group.

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

$\mathrm{Tabulate}\left(\left[a\,b\,c\,d\right]\right)\:$

$\mathrm{Tabulate}\left(\left[a\,b\,c\,d\right]\,\mathrm{width}=50\right)\:$

$\mathrm{Tabulate}\left(\mathrm{Vector}\left[\mathrm{column}\right]\left(\left[a\,b\,c\,d\right]\right)\,\mathrm{width}=20\right)\:$

$M≔\mathrm{LinearAlgebra}:-\mathrm{RandomMatrix}\left(6\,2\right)$

$M≔\left[\right]$

$\mathrm{Tabulate}\left(M\,\mathrm{widthmode}=\mathrm{pixels}\,\mathrm{width}=100\right)\:$

$A≔\left[\mathrm{plot}\left(\frac{\sin \left(x\right)}{x}\right)\,\mathrm{Sum}\left(f\left(i\right)\,i=1..N\right)\,\mathrm{plot3d}\left(y^2\sin \left(x\right)\,x=-\mathrm{\pi }..\mathrm{\pi }\,y=-2..2\right)\right]\:$

$\mathrm{Tabulate}\left(A\,\mathrm{width}=60\right)\:$

$\mathrm{Tabulate}\left(A\,\mathrm{width}=60\,\mathrm{plotcomponents}\right)\:$

$\mathrm{Tabulate}\left(M\,\mathrm{widthmode}=\mathrm{pixels}\,\mathrm{width}=100\,\mathrm{exterior}=\mathrm{none}\right)\:$

$\mathrm{Tabulate}\left(A\,\mathrm{width}=60\,\mathrm{interior}=\mathrm{none}\right)\:$

$\mathrm{Tabulate}\left(\left[\mathrm{plot3d}\left(y^2\sin \left(x\right)\,x=-\mathrm{\pi }..\mathrm{\pi }\,y=-2..2\,\mathrm{axis}=\left[\mathrm{color}=\mathrm{cyan}\right]\,\mathrm{orientation}=\left[55\,75\,0\right]\right)\right]\,\mathrm{fillcolor}=''black''\,\mathrm{width}=400\,\mathrm{widthmode}=\mathrm{pixels}\right)\:$

$\mathrm{Tabulate}\left(\left[''Example\; text.''\right]\,\mathrm{color}=\mathrm{red}\,\mathrm{fillcolor}=''LightYellow''\,\mathrm{width}=30\right)\:$

$\mathrm{Tabulate}\left(\left[''Example\; text.''\right]\,\mathrm{color}=''\#FF0000''\,\mathrm{fillcolor}=''LightYellow''\,\mathrm{width}=30\right)\:$

$A≔\mathrm{LinearAlgebra}:-\mathrm{RandomMatrix}\left(3\,4\right)\:$$\mathrm{header}≔⟨a\left|b\right|c|d⟩\:$

$\mathrm{Tabulate}\left(⟨\mathrm{header}\,A⟩\,\mathrm{width}=40\,\mathrm{`=`}\left(\mathrm{fillcolor}\,\left(T\,i\,\mathrm{jj}\right)\mapsto \mathrm{`if`}\left(i=1\,\mathrm{cyan}\,\mathrm{white}\right)\right)\right)\:$

$\mathrm{Tabulate}\left(A\,\mathrm{width}=40\,\mathrm{`=`}\left(\mathrm{fillcolor}\,\left(T\,i\,j\right)\mapsto \mathrm{`if`}\left(\mathrm{irem}\left(j\,2\right)=1\,\mathrm{cyan}\,\mathrm{white}\right)\right)\right)\:$

$P≔\mathrm{ColorTools}:-\mathrm{GetPalette}\left(''css''\right)\:$$T≔\mathrm{table}\left(\left[\mathrm{seq}\left(\mathrm{ColorDescription}\left(c\right)=c\,c=\left[P\left[\right]\right]\right)\,''''=\mathrm{ColorTools}:-\mathrm{Color}\left(''White''\right)\right]\right)\:$$M≔{\mathrm{ArrayTools}:-\mathrm{Reshape}\left(\mathrm{Vector}\left(\left[\mathrm{indices}\left(T\,\mathrm{nolist}\right)\,\mathrm{seq}\left(''''\,i=1..3\cdot 6-\mathrm{numelems}\left(T\right)\right)\right]\right)\,\left[6\,3\right]\right)}^{\mathrm{\%T}}$

$M≔\left[\right]$

$\mathrm{Tabulate}\left(M\&comma;\mathrm{width}=60\&comma;\mathrm{`=`}\left(\mathrm{color}\&comma;\left(M\&comma;i\&comma;j\right)\mapsto \mathrm{`if`}\left(0.4<\mathrm{Luma}\left(T\left[M\left[i,j\right]\right]\right)\&comma;''Black''\&comma;\left[240\&comma;240\&comma;240\right]\right)\right)\&comma;\mathrm{`=`}\left(\mathrm{fillcolor}\&comma;\left(M\&comma;i\&comma;j\right)\mapsto \mathrm{ToRGB24}\left(T\left[M\left[i,j\right]\right]\right)\right)\right)\&colon;$

$L≔\left[\left[''Some\; text''\&comma;\left[y^2\sin \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;y=-2..2\right]\&comma;\mathrm{plot3d}\left(y^2\sin \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;y=-2..2\right)\right]\right]\&colon;$

$\mathrm{Tabulate}\left(L\right)\&colon;$

$\mathrm{Tabulate}\left(L\&comma;\mathrm{width}=60\&comma;\mathrm{alignment}=\mathrm{left}\&comma;\mathrm{weights}=\left[3\&comma;3\&comma;7\right]\right)\&colon;$

$\mathrm{Tabulate}\left(\left[\mathrm{\pi }\&comma;\mathrm{\Gamma }\&comma;\mathrm{sqrt}\left(2\right)\&comma;\mathrm{diff}\left(f\left(x\right)\&comma;x\right)\&comma;\mathrm{BesselJ}\left(0\&comma;x\right)\right]\&comma;\mathrm{width}=50\&comma;\mathrm{typesetting}=\mathrm{standard}\right)\&colon;$

$\mathrm{Tabulate}\left(\left[\mathrm{\pi }\&comma;\mathrm{\Gamma }\&comma;\mathrm{sqrt}\left(2\right)\&comma;\mathrm{diff}\left(f\left(x\right)\&comma;x\right)\&comma;\mathrm{BesselJ}\left(0\&comma;x\right)\right]\&comma;\mathrm{width}=40\&comma;\mathrm{typesetting}=\mathrm{extended}\right)\&colon;$

$\mathrm{genus}≔⟨''Rubus''\&comma;''Vitis''\&comma;''Fragaria''⟩\&colon;$$\mathrm{energy}≔⟨220\&comma;288\&comma;136⟩\&colon;$$\mathrm{carbohydrates}≔⟨11.94\&comma;18.1\&comma;7.68⟩\&colon;$$\mathrm{total\_tons}≔⟨543421\&comma;58500118\&comma;4594539⟩\&colon;$$\mathrm{top\_producer}≔⟨\mathrm{Russia}\&comma;\mathrm{China}\&comma;\mathrm{USA}⟩\&colon;$$\mathrm{DF}≔\mathrm{DataFrame}\left(⟨\mathrm{energy}\left|\mathrm{carbohydrates}\right|\mathrm{total\_tons}\left|\mathrm{top\_producer}\right|\mathrm{genus}⟩\&comma;\mathrm{columns}=\left[\mathrm{Energy}\&comma;\mathrm{Carbohydrates}\&comma;\mathrm{`Total\; Tons`}\&comma;\mathrm{`Top\; Producer`}\&comma;\mathrm{Genus}\right]\&comma;\mathrm{rows}=\left[\mathrm{Raspberry}\&comma;\mathrm{Grape}\&comma;\mathrm{Strawberry}\right]\&comma;\mathrm{datatypes}=\left[\mathrm{integer}\&comma;\mathrm{float}\&comma;\mathrm{integer}\&comma;\mathrm{anything}\&comma;\mathrm{string}\right]\right)$

$\mathrm{DF}≔\left[\right]$

$\mathrm{Tabulate}\left(\mathrm{DF}\&comma;\mathrm{width}=600\&comma;\mathrm{widthmode}=\mathrm{pixels}\right)\&colon;$

$\mathrm{lens}≔\left[4+\max \left(\mathrm{op}\left(\mathrm{`~`}\left[\mathrm{length}\right]\left(\mathrm{RowLabels}\left(\mathrm{DF}\right)\right)\right)\right)\&comma;\mathrm{`~`}\left[\mathrm{`+`}\right]\left(4\&comma;\mathrm{`\; \$`}\&comma;\mathrm{op}\left(\mathrm{`~`}\left[\mathrm{length}\right]\left(\mathrm{ColumnLabels}\left(\mathrm{DF}\right)\right)\right)\right)\right]\&colon;$

$\mathrm{Tabulate}\left(\mathrm{DF}\&comma;\mathrm{width}=\mathrm{add}\left(\mathrm{lens}\right)\cdot 6\&comma;\mathrm{widthmode}=\mathrm{pixels}\&comma;\mathrm{weights}=\mathrm{lens}\&comma;\mathrm{`=`}\left(\mathrm{fillcolor}\&comma;\left(M\&comma;i\&comma;j\right)\mapsto \mathrm{`if`}\left(i=1\mathbf{and}j\ne 1\&comma;''LightBlue''\&comma;\mathrm{`if`}\left(j=1\mathbf{and}i\ne 1\&comma;''LightGreen''\&comma;''White''\right)\right)\right)\right)\&colon;$

$A≔\mathrm{Array}\left(\left[\left[\mathrm{plot}\left(\sin \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[200\&comma;200\right]\right)\&comma;\mathrm{plot}\left(\sin \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[200\&comma;200\right]\&comma;\mathrm{scaling}=\mathrm{constrained}\right)\right]\&comma;\left[\mathrm{plot}\left(\cos \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[200\&comma;200\right]\right)\&comma;\mathrm{plot}\left(\cos \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[200\&comma;200\right]\&comma;\mathrm{scaling}=\mathrm{constrained}\right)\right]\right]\right)\&colon;$

$\mathrm{plots}:-\mathrm{display}\left(A\right)$

$\mathrm{Tabulate}\left(A\&comma;\mathrm{width}=700\&comma;\mathrm{widthmode}=\mathrm{pixels}\&comma;\mathrm{interior}=\mathrm{none}\right)\&colon;$

$A≔\mathrm{Array}\left(\left[\mathrm{plot}\left(\sin \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[300\&comma;200\right]\&comma;\mathrm{scaling}=\mathrm{constrained}\right)\&comma;\mathrm{plot}\left(\cos \left(x\right)\&comma;x=-\mathrm{\pi }..\mathrm{\pi }\&comma;\mathrm{size}=\left[300\&comma;200\right]\&comma;\mathrm{scaling}=\mathrm{constrained}\right)\right]\right)\&colon;$

$\mathrm{Tabulate}\left(A\&comma;\mathrm{width}=700\&comma;\mathrm{widthmode}=\mathrm{pixels}\right)\&colon;$

$\mathrm{str1}≔\mathrm{Tabulate}\left(A\&comma;\mathrm{width}=700\&comma;\mathrm{widthmode}=\mathrm{pixels}\right)\&colon;$

$\mathrm{str1}$

$''Tabulate21''$

$\mathrm{SetProperty}\left(\mathrm{str1}\&comma;\mathrm{exterior}\&comma;\mathrm{none}\right)\&semi;$$\mathrm{SetProperty}\left(\mathrm{str1}\&comma;\mathrm{interior}\&comma;\mathrm{none}\right)$

$R≔\mathrm{Record}\left('\mathrm{shape}'=''cube''\&comma;'\mathrm{size}'\&comma;'\mathrm{color}'\right)\&colon;$

$R:-\mathrm{size}≔\mathrm{Record}\left('\mathrm{width}'=12\&comma;'\mathrm{height}'=16\&comma;'\mathrm{depth}'=8\right)\&colon;$

$R:-\mathrm{color}≔\mathrm{Record}\left('R'=''CC''\&comma;'G'=''CC''\&comma;'B'=''EE''\right)\&colon;$

$\mathrm{Tabulate}\left(R\right)\&colon;$

$\mathrm{Tabulate}\left(R\&comma;'\mathrm{recordformat}'='\mathrm{section}'\right)\&colon;$

The DocumentTools[Tabulate] command was introduced in Maple 2015.

For more information on Maple 2015 changes, see Updates in Maple 2015.

The output and typesetting options were introduced in Maple 2016.

For more information on Maple 2016 changes, see Updates in Maple 2016.

The DocumentTools[Tabulate] command was updated in Maple 2018.

The M parameter was updated in Maple 2018.

The recordformat option was introduced in Maple 2018.

For more information on Maple 2018 changes, see Updates in Maple 2018.