py4cytoscape.style_bypasses.set_node_label_bypass¶
-
set_node_label_bypass
(node_names, new_labels, network=None, base_url='http://127.0.0.1:1234/v1')[source]¶ Override the label for particular nodes.
This method permanently overrides any default values or mappings defined for this visual property of the node or nodes specified. This method ultimately calls the generic function,
set_node_property_bypass()
which can be used to set any visual property. To restore defaults and mappings, useclear_node_property_bypass()
, see examples.- Parameters
node_names (str or list or int or None) – List of nodes as
list
of node names or SUIDs, comma-separated string of node names or SUIDs, or scalar node name or SUID. Node names should be found in thename
column of thenodes table
.new_labels (str or list) – list of label values or single value
network (SUID or str or None) – Name or SUID of a network. 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://localhost:1234 and the latest version of the CyREST API supported by this version of py4cytoscape.
- Returns
’’
- Return type
str
- Raises
CyError – if node or network name doesn’t exist
requests.exceptions.RequestException – if can’t connect to Cytoscape or Cytoscape returns an error
Examples
>>> set_node_label_bypass(get_node_names(), 'test label') '' >>> set_node_label_bypass(['YDL194W', 'YBR043C'], ['A', 'B'], network='galFiltered.sif') '' >>> set_node_label_bypass('YDL194W, YBR043C', ['A', 'B'], network='galFiltered.sif') '' >>> set_node_label_bypass([1255, 1988], ['A', 'B'], network='galFiltered.sif') '' >>> set_node_label_bypass('1255, 1988', ['A', 'B'], network='galFiltered.sif') '' >>> set_node_label_bypass(1255, 'test label') ''
Note
To identify a node whose name contains a comma, use ‘\’ to escape the comma. For example, ‘node1, node\,2’ identifies ‘node1’ and ‘node,2’.