1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN"> 2<HTML><HEAD> 3 <TITLE>User's Reference - ChangeGroupMember</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="refgu024.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD> 31 <TD colspan=2><A href="refgu026.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="HDRCHGGRME" ></A>ChangeGroupMember</H3> 39 <P><STRONG>Category</STRONG> 40 <P> 41<A HREF="refgu008.htm#HDRCATSTR">Structuring</A> 42<P><STRONG>Function</STRONG> 43<P>Insert, rename, or delete a member of an existing group 44<P><STRONG>Syntax</STRONG> 45<PRE> 46<STRONG>changed</STRONG> = ChangeGroupMember(<STRONG>data, operation, id, newmember, newtag</STRONG>); 47</PRE> 48<P><STRONG>Inputs</STRONG> 49<BR> 50<TABLE BORDER> 51<TR> 52<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name 53</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type 54</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default 55</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description 56</TH></TR><TR> 57<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>data</STRONG></TT> 58</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">group 59</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none 60</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">input group object 61</TD></TR><TR> 62<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>operation</STRONG></TT> 63</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string 64</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none 65</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">how to alter the group member 66</TD></TR><TR> 67<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>id</STRONG></TT> 68</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer 69</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none 70</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">index or name of existing group 71member 72</TD></TR><TR> 73<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>newmember</STRONG></TT> 74</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">object 75</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">operation dependent 76</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">new or replacement group member 77</TD></TR><TR> 78<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>newtag</STRONG></TT> 79</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar or string 80</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">no default 81</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">new series position or member 82name 83</TD></TR></TABLE> 84<P><STRONG>Outputs</STRONG> 85<BR> 86<TABLE BORDER> 87<TR> 88<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name 89</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type 90</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description 91</TH></TR><TR> 92<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>changed</STRONG></TT> 93</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">group 94</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">group with one member changed 95</TD></TR></TABLE> 96<P><STRONG>Functional Details</STRONG> 97<P> 98This module allows you to replace or insert a member of an existing 99group. 100<TABLE CELLPADDING="3"> 101<TR VALIGN="TOP"><TD><P><B><TT><STRONG>data</STRONG></TT> 102</B></TD><TD><P>is the group to be modified 103</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>operation</STRONG></TT> 104</B></TD><TD><P>is the operation to perform on the specified member of 105<TT><STRONG>data</STRONG></TT>. If <TT><STRONG>data</STRONG></TT> is a series 106group, then <TT><STRONG>operation</STRONG></TT> must be one of "insert 107before", "replace", "insert after", or "delete". If 108<TT><STRONG>data</STRONG></TT> is any other kind of group, then 109<TT><STRONG>operation</STRONG></TT> must be one of "insert", 110"replace", "delete". 111Note that for most applications, the order of members in a group is not 112important, and the order of members in a group is not guaranteed to be 113maintained by modules in Data Explorer unless the group is a Series. 114</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>id</STRONG></TT> 115</B></TD><TD><P>is the index (from 0 to n-1, where n is the number of members 116of <TT><STRONG>data</STRONG></TT>) or name of an existing member of 117<TT><STRONG>data</STRONG></TT> 118</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>newmember</STRONG></TT> 119</B></TD><TD><P>is the new or replacement object to be placed 120in <TT><STRONG>data</STRONG></TT> 121</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>newtag</STRONG></TT> 122</B></TD><TD><P>is the series position or member name for 123<TT><STRONG>newmember</STRONG></TT>. If <TT><STRONG>data</STRONG></TT> is a 124series, 125this parameter is required. 126</TD></TR></TABLE> 127<P><STRONG>Components</STRONG> 128<P> 129This module does not modify any components of the input 130<TT><STRONG>data</STRONG></TT>. 131<P><STRONG>Example Visual Programs</STRONG> 132<PRE> 133ManipulateGroups.net 134</PRE> 135<P><STRONG>See Also</STRONG> 136<P> 137<A HREF="refgu026.htm#HDRCHGGRTY">ChangeGroupType</A>, 138<A HREF="refgu029.htm#HDRCOLLECT">Collect</A>, 139<A HREF="refgu032.htm#HDRCOLLECS">CollectSeries</A>, 140<A HREF="refgu031.htm#HDRCOLLECN">CollectNamed</A>, 141<A HREF="refgu030.htm#HDRMULTIGR">CollectMultiGrid</A> 142 <P> 143 <HR> 144 <DIV align="center"> 145 <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> 146 </DIV> 147 <DIV align="center"> 148 <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> 149 <P></P> 150 </DIV> 151 </BODY></HTML> 152