User's Reference - ChangeGroupType

ChangeGroupType

Category

Structuring

Function

Changes the group type

Syntax

changed = ChangeGroupType(data, newtype, idlist);

Inputs

Name Type Default Description
data group (none) input group object
newtype string (none) type for output group
idlist scalar list or string list input dependent series positions or member names

Name	Type	Default	Description
`data`	group	(none)	input group object
`newtype`	string	(none)	type for output group
`idlist`	scalar list or string list	input dependent	series positions or member names

Outputs

Name Type Description
name type description
changed group different type of group with same members as input

Name	Type	Description
`name`	type	description
changed	group	different type of group with same members as input

Functional Details

ChangeGroupType allows you to change the group type of an input object, for example, change a generic group to a series, or change a series to a multigrid. The output group changed will contain the same members as the input group data. You can also use this module to change the series positions of a Series group.

data
is the input group to be changed.
newtype
is the type for the output group. It must be one of "series", "multigrid", or "generic". Note that any combination of objects can be placed in a generic group, but there are restrictions on the objects which can be placed in a series or multigrid. In these cases, all the members must have the same data type and connection type.
idlist
is the list of series positions or list of member names. The number of items in this list, if given, must be the same as the number of members in data. This parameter is optional. If you are changing the group type to series and do not provide this parameter, the members of the series will automatically be given series positions 0, 1, ..., n-1, where n is the number of members in data.

Components

This module does not change any components of the input object. It changes only the group type.

Example Visual Programs

ManipulateGroups.net

[ OpenDX Home at IBM | OpenDX.org ]

`data`	is the input group to be changed.
`newtype`	is the type for the output group. It must be one of "series", "multigrid", or "generic". Note that any combination of objects can be placed in a generic group, but there are restrictions on the objects which can be placed in a series or multigrid. In these cases, all the members must have the same data type and connection type.
`idlist`	is the list of series positions or list of member names. The number of items in this list, if given, must be the same as the number of members in `data`. This parameter is optional. If you are changing the group type to series and do not provide this parameter, the members of the series will automatically be given series positions 0, 1, ..., n-1, where n is the number of members in `data`.