org.cytoscape.group
Interface CyGroupManager

public interface CyGroupManager

The CyGroupManager maintains information about all of the groups an instance of Cytoscape.

Cytoscape Backwards Compatibility (API Interface): We expect that this interface will be used but not implemented by developers using this interface. As such, we reserve the right to add methods to the interface as part of minor version upgrades. We will not remove methods for any changes other than major version upgrades.

Method Summary

void	addGroup(CyGroup group) Registers a group with the group manager.
void	addGroups(List<CyGroup> groups) Registers a list of groups with the group manager.
void	destroyGroup(CyGroup group) Destroy a group.
CyGroup	getGroup(CyNode node, CyNetwork network) Return the group the corresponds to a particular node in a CyNetwork.
Set<CyGroup>	getGroupSet(CyNetwork network) Provides the set of all the groups known to the groups manager in a particular network.
List<CyGroup>	getGroupsForNode(CyNode node) Return the list of CyGroups this node is in.
List<CyGroup>	getGroupsForNode(CyNode node, CyNetwork network) Return the list of CyGroups this node is in for a particular network.
boolean	isGroup(CyNode node, CyNetwork network) Test to see if this node represents a CyGroup in a particular CyNetwork.
void	reset() Releases all currently held references and resources.

Method Detail

getGroupSet

Set<CyGroup> getGroupSet(CyNetwork network)

Provides the set of all the groups known to the groups manager in a particular network.

Parameters:

network - the network to get the groups from. If the network is null, then return only those groups that have been designated as "global" (no referenced network) for this CyRootNetwork

Returns:

the complete set of all the currently known groups in a Cytoscape network

getGroupsForNode

List<CyGroup> getGroupsForNode(CyNode node)

Return the list of CyGroups this node is in.

Parameters:

node - the CyNode we want get the groups for

Returns:

the list of CyGroups the node is in null if it is not in any groups

getGroupsForNode

List<CyGroup> getGroupsForNode(CyNode node,
                               CyNetwork network)

Return the list of CyGroups this node is in for a particular network.

Parameters:

node - the CyNode we want get the groups for

network - the CyNetwork we want to restrict our search to

Returns:

the list of CyGroups the node is in null if it is not in any groups

isGroup

boolean isGroup(CyNode node,
                CyNetwork network)

Test to see if this node represents a CyGroup in a particular CyNetwork.

Parameters:

node - the CyNode to test

network - the CyNetwork to test

Returns:

true if this node represents a group

getGroup

CyGroup getGroup(CyNode node,
                 CyNetwork network)

Return the group the corresponds to a particular node in a CyNetwork.

Parameters:

node - the CyNode to test

network - the CyNetwork to test

Returns:

the CyGroup that corresponds to the node, or null if this group doesn't exist in the network

destroyGroup

void destroyGroup(CyGroup group)

Destroy a group.

Parameters:

group - the CyGroup to remove.

addGroup

void addGroup(CyGroup group)

Registers a group with the group manager. Does nothing if the group is already known to the group manager. Fires GroupAddedEvent.

Parameters:

group - a non-null CyGroup

addGroups

void addGroups(List<CyGroup> groups)

Registers a list of groups with the group manager. Does nothing if the group is already known to the group manager.

Parameters:

groups - a list of CyGroup

reset

void reset()

Releases all currently held references and resources.