org.cytoscape.model.subnetwork
Interface CyRootNetwork

All Superinterfaces:

CyDisposable, CyIdentifiable, CyNetwork

public interface CyRootNetwork
extends CyNetwork

CyRootNetwork is an interface for managing Cytoscape's meta-network implementation. While most applications (and users!) will treat each CyNetwork created within Cytoscape as an independent network, beginning with Cytoscape 3.0, Cytoscape has provided a mechanism for implementing a more complex meta-network structure that can be used for a variety of other use cases, including implementing subnetworks and shared nodes between subnetworks. Beyond the concepts and methods provided by CyNetwork a meta-network adds three new concepts:

• A CyRootNetwork is a CyNetwork that adds methods for maintaining the meta-network. All CyNodes and CyEdges in all CySubNetworks that are part of this CyRootNetwork.
• A CySubNetwork is a set of nodes and edges that comprise a sub-network of a CyRootNetwork. A CySubNetwork may be thought of as a projection of the graph implemented by the CyRootNetwork.

  
  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.
  

  Field Summary

  static String	SHARED_ATTRS The name of the table containing the attributes shared by all subnetworks of this root network.
  static String	SHARED_DEFAULT_ATTRS The name of the table that enables sharing default attributes with all subnetworks.
  static String	SHARED_INTERACTION The name of the shared interaction column found in the SHARED_ATTRS table.
  static String	SHARED_NAME The name of the shared name column found in the SHARED_ATTRS table.

  Fields inherited from interface org.cytoscape.model.CyNetwork

  DEFAULT_ATTRS, HIDDEN_ATTRS, LOCAL_ATTRS, NAME, SELECTED

  Fields inherited from interface org.cytoscape.model.CyIdentifiable

  SUID

  Method Summary

  CySubNetwork	addSubNetwork() Create an empty CySubNetwork.
  CySubNetwork	addSubNetwork(Iterable<CyNode> nodes, Iterable<CyEdge> edges) Create a CySubNetwork containing the specified CyNodes and CyEdges.
  CySubNetwork	addSubNetwork(Iterable<CyNode> nodes, Iterable<CyEdge> edges, SavePolicy policy) Create a CySubNetwork containing the specified CyNodes and CyEdges.
  CySubNetwork	addSubNetwork(SavePolicy policy) Create an empty CySubNetwork which can have a different save policy from that of this root network, as long as the root network's policy is not SavePolicy.DO_NOT_SAVE.
  boolean	containsNetwork(CyNetwork n) Returns true if the network to be checked is a subnetwork of this root network and returns false otherwise.
  CySubNetwork	getBaseNetwork() The initial network of CyNodes and CyEdges.
  CyTable	getSharedEdgeTable() Returns the edge table shared by all subnetworks.
  CyTable	getSharedNetworkTable() Returns the network table shared by all subnetworks.
  CyTable	getSharedNodeTable() Returns the node table shared by all subnetworks.
  List<CySubNetwork>	getSubNetworkList() Will return A list of all CySubNetworks contained in this root network.
  void	removeSubNetwork(CySubNetwork sub) Removes the subnetwork from the root network, but not the nodes and edges contained in the subnetwork.

  Methods inherited from interface org.cytoscape.model.CyNetwork

  addEdge, addNode, containsEdge, containsEdge, containsNode, getAdjacentEdgeIterable, getAdjacentEdgeList, getConnectingEdgeList, getDefaultEdgeTable, getDefaultNetworkTable, getDefaultNodeTable, getEdge, getEdgeCount, getEdgeList, getNeighborList, getNode, getNodeCount, getNodeList, getRow, getRow, getSavePolicy, getTable, removeEdges, removeNodes

  Methods inherited from interface org.cytoscape.model.CyIdentifiable

  getSUID

  Methods inherited from interface org.cytoscape.model.CyDisposable

  dispose

  Field Detail

  SHARED_ATTRS

  static final String SHARED_ATTRS

  The name of the table containing the attributes shared by all subnetworks of this root network. Direct use of this table is discouraged!

  See Also:

  Constant Field Values

  SHARED_DEFAULT_ATTRS

  static final String SHARED_DEFAULT_ATTRS

  The name of the table that enables sharing default attributes with all subnetworks. Direct use of this table is discouraged!

  See Also:

  Constant Field Values

  SHARED_NAME

  static final String SHARED_NAME

  The name of the shared name column found in the SHARED_ATTRS table. This column value will be updated any time the value of the CyNetwork.NAME column in a default table is set. The purpose of this column is to serve as a join key for virtual columns to be added to the shared table.

  See Also:

  Constant Field Values

  SHARED_INTERACTION

  static final String SHARED_INTERACTION

  The name of the shared interaction column found in the SHARED_ATTRS table. This column value will be updated any time the value of the CyNetwork.EDGE column in a default table is set.

  See Also:

  Constant Field Values

  Method Detail

  addSubNetwork

  CySubNetwork addSubNetwork()

  Create an empty CySubNetwork. The new subnetwork is created with the same save policy of its root network. If you want to set a different save policy to the new subnetwork, just use addSubNetwork(SavePolicy).

  Returns:

  The created CySubNetwork.

  addSubNetwork

  CySubNetwork addSubNetwork(SavePolicy policy)

  Create an empty CySubNetwork which can have a different save policy from that of this root network, as long as the root network's policy is not SavePolicy.DO_NOT_SAVE.

  Parameters:

  policy - the save policy to follow during the life-cycle of the CyNetwork.

  Returns:

  The created CySubNetwork.

  Throws:

  IllegalArgumentException - if the save policy of this root network is SavePolicy.DO_NOT_SAVE, and the policy argument is not the same.

  addSubNetwork

  CySubNetwork addSubNetwork(Iterable<CyNode> nodes,
                             Iterable<CyEdge> edges)

  Create a CySubNetwork containing the specified CyNodes and CyEdges. The nodes and edges must already exist in this root network. Nodes defining the source and target of edges that have not yet been added to the subnetwork will be added. The new subnetwork is created with the same save policy of its root network. If you want to set a different save policy to the new subnetwork, just use addSubNetwork(Iterable, Iterable, SavePolicy).

  Parameters:

  nodes - The nodes to be added to the network. May be null or empty.

  edges - The edges to be added to the network. May be null or empty.

  Returns:

  The created CySubNetwork.

  addSubNetwork

  CySubNetwork addSubNetwork(Iterable<CyNode> nodes,
                             Iterable<CyEdge> edges,
                             SavePolicy policy)

  Create a CySubNetwork containing the specified CyNodes and CyEdges. The nodes and edges must already exist in this root network. Nodes defining the source and target of edges that have not yet been added to the subnetwork will be added. The new CySubNetwork can have a different save policy from that of this root network, as long as the root network's policy is not SavePolicy.DO_NOT_SAVE.

  Parameters:

  nodes - The nodes to be added to the network. May be null or empty.

  edges - The edges to be added to the network. May be null or empty.

  policy - the save policy to follow during the life-cycle of the CyNetwork.

  Returns:

  The created CySubNetwork.

  Throws:

  IllegalArgumentException - if the save policy of this root network is SavePolicy.DO_NOT_SAVE, and the policy argument is not the same.

  removeSubNetwork

  void removeSubNetwork(CySubNetwork sub)

  Removes the subnetwork from the root network, but not the nodes and edges contained in the subnetwork.

  Parameters:

  sub - the CySubNetwork to remove.

  getSubNetworkList

  List<CySubNetwork> getSubNetworkList()

  Will return A list of all CySubNetworks contained in this root network.

  Returns:

  A list of all CySubNetworks contained in this root network.

  getBaseNetwork

  CySubNetwork getBaseNetwork()

  The initial network of CyNodes and CyEdges. Every root network began with something, and this network is that something.

  Returns:

  the CySubNetwork that the root network began with.

  containsNetwork

  boolean containsNetwork(CyNetwork n)

  Returns true if the network to be checked is a subnetwork of this root network and returns false otherwise. Will return false if the network is null.

  Parameters:

  n - The network to be checked.

  Returns:

  true if the network to be checked is a subnetwork of this root network and returns false otherwise or if the network is null.

  getSharedNetworkTable

  CyTable getSharedNetworkTable()

  Returns the network table shared by all subnetworks. The columns of this table are automatically made into virtual columns of the DEFAULT network table of each subnetwork of this root network.

  Returns:

  the network table shared by all subnetworks.

  getSharedNodeTable

  CyTable getSharedNodeTable()

  Returns the node table shared by all subnetworks. The columns of this table are automatically made into virtual columns of the DEFAULT node table of each subnetwork of this root network.

  Returns:

  the network table shared by all subnetworks.

  getSharedEdgeTable

  CyTable getSharedEdgeTable()

  Returns the edge table shared by all subnetworks. The columns of this table are automatically made into virtual columns of the DEFAULT edge table of each subnetwork of this root network.

  Returns:

  the network table shared by all subnetworks.