start_ipython_workers(self, workers=None, magic_names=False, qtconsole=False, qtconsole_args=None)

Parameters

workers : list (optional)

A list of worker addresses, defaults to all

magic_names : str or list(str) (optional)

If defined, register IPython magics with these names for executing code on the workers. If string has asterix then expand asterix into 0, 1, ..., n for n workers

qtconsole : bool (optional)

If True, launch a Jupyter QtConsole connected to the worker(s).

qtconsole_args : list(str) (optional)

Additional arguments to pass to the qtconsole on startup.

Returns

iter_connection_info: list

List of connection_info dicts containing info necessary to connect Jupyter clients to the workers.

Start IPython kernels on workers

See Also

Client.start_ipython_scheduler

start ipython on the scheduler

Examples

This example does not not appear to be valid Python Syntax

>>> info = c.start_ipython_workers() # doctest: +SKIP
... %remote info['192.168.1.101:5752'] worker.data  # doctest: +SKIP
{'x': 1, 'y': 100}

This example does not not appear to be valid Python Syntax

>>> c.start_ipython_workers('192.168.1.101:5752', magic_names='w') # doctest: +SKIP
... %w worker.data  # doctest: +SKIP
{'x': 1, 'y': 100}

This example is valid syntax, but we were not able to check execution

>>> c.start_ipython_workers('192.168.1.101:5752', qtconsole=True) # doctest: +SKIP

Add asterix * in magic names to add one magic per worker

This example does not not appear to be valid Python Syntax

>>> c.start_ipython_workers(magic_names='w_*') # doctest: +SKIP
... %w_0 worker.data  # doctest: +SKIP
{'x': 1, 'y': 100}

This example does not not appear to be valid Python Syntax

>>> %w_1 worker.data  # doctest: +SKIP
{'z': 5}

See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

distributed.client.Client.start_ipython_scheduler

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them

---

File: /distributed/client.py#3786
type: <class 'function'>
Commit: