1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN"> 2<HTML><HEAD> 3 <TITLE>User's Reference - Stack</TITLE> 4 <META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA 5MINING"> 6 <meta http-equiv="content-type" content="text/html;charset=ISO-8859-1"> 7</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b"> 8 <TABLE width=510 border=0 cellpadding=0 cellspacing=0> 9 <TR> 10 <TD><IMG src="../images/spacer.gif" width=80 height=1></TD> 11 <TD><IMG src="../images/spacer.gif" width=49 height=1></TD> 12 <TD><IMG src="../images/spacer.gif" width=24 height=1></TD> 13 <TD><IMG src="../images/spacer.gif" width=100 height=1></TD> 14 <TD><IMG src="../images/spacer.gif" width=3 height=1></TD> 15 <TD><IMG src="../images/spacer.gif" width=127 height=1></TD> 16 <TD><IMG src="../images/spacer.gif" width=6 height=1></TD> 17 <TD><IMG src="../images/spacer.gif" width=50 height=1></TD> 18 <TD><IMG src="../images/spacer.gif" width=71 height=1></TD> 19 </TR> 20 <TR> 21 <TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD> 22 </TR> 23 <TR> 24 <TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD> 25 <TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD> 26 <TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD> 27 <TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD> 28 </TR> 29 <TR> 30 <TD><A href="refgu145.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD> 31 <TD colspan=2><A href="refgu147.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD> 32 <TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD> 33 <TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD> 34 <TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD> 35 <TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD> 36 </TR> 37 </TABLE> 38 <H3><A name="HDRSTACK" ></A>Stack</H3> 39 <A NAME="IDX720"></A><A NAME="IDX721"></A> 40<P><STRONG>Category</STRONG> 41<P> 42<A HREF="refgu008.htm#HDRCATIAE">Import and Export</A> 43<P><STRONG>Function</STRONG> 44<P> 45Stacks fields or series of fields. 46<P><STRONG>Syntax</STRONG> 47<PRE><STRONG> 48output</STRONG> = Stack(<STRONG>input, dimension</STRONG>); 49</PRE> 50<P><STRONG>Inputs</STRONG> 51<BR> 52<TABLE BORDER> 53<TR> 54<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name 55</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type 56</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default 57</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description 58</TH></TR><TR> 59<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>input</STRONG></TT> 60</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field, field series, 61 62or group 63 64</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none 65</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">data to be stacked 66</TD></TR><TR> 67<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>dimension</STRONG></TT> 68</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or string 69</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0 70</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">dimension in which the data is to 71be stacked 72</TD></TR></TABLE> 73<P><STRONG>Outputs</STRONG> 74<BR> 75<TABLE BORDER> 76<TR> 77<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name 78</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type 79</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description 80</TH></TR><TR> 81<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT> 82</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field 83</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">stacked data 84</TD></TR></TABLE> 85<P><STRONG>Functional Details</STRONG> 86<P> 87This module stacks a series of <I>n</I>-dimensional fields to form 88a single (<I>n</I>+1)-dimensional field. 89You can also use Stack to add a dimension to a single field (e.g., 90"stack" it from 2 dimensions to 3 dimensions). 91Note that Stack does <I>not</I> accept partitioned data as 92<TT><STRONG>input</STRONG></TT>. 93<TABLE CELLPADDING="3"> 94<TR VALIGN="TOP"><TD><P><B><TT><STRONG>input</STRONG></TT> 95</B></TD><TD><P>specifies the object(s) to be stacked. 96The field(s) must have regular connections. 97<BR> 98If the parameter specifies a series, the location of the stacked field 99in the new <TT><STRONG>dimension</STRONG></TT> is equal to the series 100position of that field. 101 102If the parameter specifies a group, then the location 103of each member of the group 104in the new 105<TT><STRONG>dimension</STRONG></TT> will be 0, 1, .... 106 107If the parameter specifies a field (rather than a field series), the 108<I>n</I>-dimensional data is converted to 109(<I>n</I>+1)-dimensional data, with the 110value of the extra dimension set to zero. 111<BR> 112A dimension can be specified by number (from 0 to <I>n</I> 113- 1). 114The first three can also be specified as <I>x</I>, 115<I>y</I>, and <I>z</I>, respectively. 116The default value is dimension 0 (zero). 117</TD></TR></TABLE> 118<P><STRONG>Components</STRONG> 119<P> 120All input components are propagated to the output. 121<P><STRONG>Example Visual Program</STRONG> 122<PRE> 123 124ManipulateGroups.net 125 126</PRE> 127<P><STRONG>See Also</STRONG> 128<P> 129 <A HREF="refgu032.htm#HDRCOLLECS">CollectSeries</A>, 130 <A HREF="refgu144.htm#HDRSLICE">Slice</A>, 131 <A HREF="refgu162.htm#HDRTRANSPO">Transpose</A> 132 <P> 133 <HR> 134 <DIV align="center"> 135 <P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P> 136 </DIV> 137 <DIV align="center"> 138 <P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A> | <A href="http://www.opendx.org/">OpenDX.org</A> ] </FONT></P> 139 <P></P> 140 </DIV> 141 <P></P> 142 </BODY></HTML> 143
