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[{ker1,ker2,…},expr]
gives a list of the results of evaluating expr using each of the kernels keri.
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 IncludeDefinitionsTrue, 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 all close allBasic Examples (4)
Launch a local kernel and evaluate some of its properties:
LocalEvaluate[{$MachineName, $ProcessID, $Version}]Launch a specific kernel given by its absolute path:
LocalEvaluate["file:///usr/local/bin/math130", $Version]Each instance of LocalEvaluate launches a new kernel, which is discarded after the evaluation:
LocalEvaluate[$ProcessID]LocalEvaluate[$ProcessID]The same evaluation can be performed on several kernels:
LocalEvaluate[{"file:///usr/local/bin/wolfram123", "file:///usr/local/bin/wolfram130", "file:///usr/local/bin/wolfram"}, $VersionNumber]Scope (3)
Local Kernels (3)
Connect to the default kernel the same machine where the request is made:
LocalEvaluate[{$MachineName, $ProcessID}]$DefaultLocalKernelUse a specific local kernel, given by its absolute path in a file URL:
LocalEvaluate["file:///usr/local/bin/wolfram130", $Version]Use a specific local kernel, given by its relative path:
LocalEvaluate[KernelConfiguration["localhost", "KernelCommand" -> "wolfram130"], $Version]Generalizations & Extensions (1)
A result received is normally evaluated further on the receiving side:
var = 42;LocalEvaluate[$DefaultLocalKernel, Clear[var];var]Prevent the evaluation of the result received by wrapping it in Hold:
LocalEvaluate[$DefaultLocalKernel, Clear[var];var, Hold]Options (1)
IncludeDefinitions (1)
By default, necessary definitions for an evaluation are sent to the remote kernel:
var = 42;f[x_] := x ^ varLocalEvaluate[$DefaultLocalKernel, f[2], Hold]Without these definitions, no evaluation takes place on the remote kernel:
LocalEvaluate[$DefaultLocalKernel, f[2], Hold, IncludeDefinitions -> False]Properties & Relations (2)
Use the kernel given by $DefaultLocalKernel:
LocalEvaluate[$MachineName]$DefaultLocalKernelGiven the same kernel specification, LocalEvaluate and RemoteEvaluate behave the same:
LocalEvaluate[First[$CommandLine]]RemoteEvaluate[$DefaultLocalKernel, First[$CommandLine]]Text
Wolfram Research (2022), LocalEvaluate, Wolfram Language function, https://reference.wolfram.com/language/ref/LocalEvaluate.html.
CMS
Wolfram Language. 2022. "LocalEvaluate." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/LocalEvaluate.html.
APA
Wolfram Language. (2022). LocalEvaluate. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LocalEvaluate.html