Cytoscape 3.0.1 API

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.


Cytoscape 3.0.1 API

Copyright 2011 Cytoscape Consortium. All rights reserved.