LocalEvaluate

✖
`LocalEvaluate`

✖

LocalEvaluate[expr]

gives the result of evaluating expr using your current default local Wolfram Language kernel.

✖

LocalEvaluate[ker, expr]

gives the result of evaluating expr using the kernel specified by ker.

✖

LocalEvaluate[{ker₁,ker₂,…},expr]

gives a list of the results of evaluating expr using each of the kernels ker_i.

✖

LocalEvaluate[ker,expr,h]

wraps the head h around the result produced before returning it.

Details and Options

LocalEvaluate has attribute HoldAll.
LocalEvaluate[expr] uses the kernel given by $DefaultLocalKernel
LocalEvaluate has the following option:
IncludeDefinitions True whether to automatically include dependencies
With IncludeDefinitionsTrue, definitions required for the evaluation of expr will automatically be sent to the kernel.
With IncludeDefinitions->False, definitions required for the evaluation of expr must be loaded and evaluated explicitly during the evaluation of expr.
Kernels are specified using RemoteKernelObject, or short string forms.
The following local or remote kernel string forms are recognized:

	"ssh://user@hostname:port/path"	a kernel on the given machine, accessed using SSH
	"ssh://hostname"	use the default path, user and port on the given machine
	"hostname"	equivalent to "ssh://hostname"
	"wstp://server:port/pool"	a kernel on a WSTPServer
	"wstp://server"	use the default port and kernel pool
	"Local"	the default local kernel
	"localhost"	a kernel on the same machine
	"file:///path/to/wolfram"	the given kernel on the same machine
	"https://www.wolframcloud.com/"	a kernel in the Wolfram Cloud

The path in "ssh://hostname/path" or "file:///path" is the absolute path of a suitable kernel command.
SSH cannot ask for passwords interactively. Keys can be specified, or an SSH password agent can be used.

Examples

open allclose all

Basic Examples (4)Summary of the most common use cases

Launch a local kernel and evaluate some of its properties:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-tw9cgt

Out[1]=1

Launch a specific kernel given by its absolute path:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-ltrcaq

Out[1]=1

Each instance of LocalEvaluate launches a new kernel, which is discarded after the evaluation:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-7yr4h2

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-9cmmdm

Out[2]=2

The same evaluation can be performed on several kernels:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-56gc2c

Out[1]=1

Scope (3)Survey of the scope of standard use cases

Local Kernels (3)

Connect to the default kernel the same machine where the request is made:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-i6na6w

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-edh608

Out[2]=2

Use a specific local kernel, given by its absolute path in a file URL:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-v4py1y

Out[1]=1

Use a specific local kernel, given by its relative path:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-rk1263

Out[1]=1

Generalizations & Extensions (1)Generalized and extended use cases

A result received is normally evaluated further on the receiving side:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-n1phxz

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-ty8n3y

Out[2]=2

Prevent the evaluation of the result received by wrapping it in Hold:

In[3]:=3

✖

https://wolfram.com/xid/09b6bxu2s-9c8jgx

Out[3]=3

Options (1)Common values & functionality for each option

IncludeDefinitions (1)

By default, necessary definitions for an evaluation are sent to the remote kernel:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-s4wgnl

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-6s01lq

Out[2]=2

Without these definitions, no evaluation takes place on the remote kernel:

In[3]:=3

✖

https://wolfram.com/xid/09b6bxu2s-yvm6k5

Out[3]=3

Properties & Relations (2)Properties of the function, and connections to other functions

Use the kernel given by $DefaultLocalKernel:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-k85psu

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-ovbilm

Out[2]=2

Given the same kernel specification, LocalEvaluate and RemoteEvaluate behave the same:

In[1]:=1

✖

https://wolfram.com/xid/09b6bxu2s-hu2qs2

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/09b6bxu2s-1t84dz

Out[2]=2

Top