py4cytoscape.networks.create_subnetwork

create_subnetwork(nodes=None, nodes_by_col='SUID', edges=None, edges_by_col='SUID', exclude_edges=False, subnetwork_name=None, network=None, base_url='http://127.0.0.1:1234/v1')[source]

Copies a subset of nodes and edges into a newly created subnetwork.

Parameters

  • nodes (list) – list of node names or keyword: selected, unselected or all. Default is currently selected nodes.

  • nodes_by_col (str) – name of node table column corresponding to provided nodes list; default is ‘SUID’

  • edges (list) – list of edge names or keyword: selected, unselected or all. Default is currently selected edges.

  • edges_by_col (str) – name of edge table column corresponding to provided edges list; default is ‘SUID’

  • exclude_edges (bool) – whether to exclude connecting edges; default is FALSE

  • subnetwork_name (str) – name of new subnetwork to be created; default is to add a numbered suffix to source network name

  • network (SUID or str or None) – Name or SUID of a network or view. Default is the “current” network active in Cytoscape.

  • base_url (str) – Ignore unless you need to specify a custom domain, port or version to connect to the CyREST API. Default is http://127.0.0.1:1234 and the latest version of the CyREST API supported by this version of py4cytoscape.

Returns

The SUID of the new subnetwork

Return type

int

Raises

  • ValueError – if server response has no JSON

  • CyError – if network name or SUID doesn’t exist

  • requests.exceptions.RequestException – if can’t connect to Cytoscape or Cytoscape returns an error

Examples

>>> create_subnetwork(nodes='all') # choose all selected and unselected nodes
1477
>>> create_subnetwork(edges='selected') # choose only nodes whose edges are selected, and include those edges
1477
>>> create_subnetwork(nodes=['RAP1', 'HIS4', 'PDC1', 'RPL18A'], nodes_by_col='COMMON', subnetwork_name=base_name+'xx')

1477