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 Truewhether 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 allclose all

Basic Examples  (4)

Launch a local kernel and evaluate some of its properties:

Launch a specific kernel given by its absolute path:

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

The same evaluation can be performed on several kernels:

Scope  (3)

Local Kernels  (3)

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

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

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

Generalizations & Extensions  (1)

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

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

Options  (1)

IncludeDefinitions  (1)

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

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

Properties & Relations  (2)

Use the kernel given by $DefaultLocalKernel:

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

Wolfram Research (2022), LocalEvaluate, Wolfram Language function, https://reference.wolfram.com/language/ref/LocalEvaluate.html.

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

BibTeX

@misc{reference.wolfram_2025_localevaluate, author="Wolfram Research", title="{LocalEvaluate}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/LocalEvaluate.html}", note=[Accessed: 30-May-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_localevaluate, organization={Wolfram Research}, title={LocalEvaluate}, year={2022}, url={https://reference.wolfram.com/language/ref/LocalEvaluate.html}, note=[Accessed: 30-May-2025 ]}