CloudEvaluate

✖
`CloudEvaluate`

✖

CloudEvaluate[expr]

evaluates expr in the cloud and returns the result.

✖

CloudEvaluate[expr,h]

wraps the head h around the result before returning it.

Details and Options

CloudEvaluate has attribute HoldFirst.
CloudEvaluate[expr] automatically includes all definitions needed to evaluate expr, much like CloudSave.
CloudEvaluate has the following option:
CloudBase Automatic what cloud to do the evaluation in

IncludeDefinitions True whether to automatically include dependencies
With IncludeDefinitionsTrue, definitions required for the evaluation of expr will automatically be sent to the cloud through CloudEvaluate.
With IncludeDefinitions->False, definitions required for the evaluation of expr must be loaded and evaluated explicitly during the evaluation of expr.

Examples

open allclose all

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

Search for Mersenne primes in the cloud:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-e6v2oq

Out[1]=1

Evaluate machine-specific settings in the cloud:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-dfggpf

Out[1]=1

Compare to the local result:

In[2]:=2

✖

https://wolfram.com/xid/0b0kh1m430k-ciz4q0

Out[2]=2

Supply a head to be applied to the results of a cloud evaluation:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-m4jaft

Out[1]=1

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

Create a 3D contour plot in the cloud:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-bqu8fs

Out[1]=1

Use the cloud to identify the content of an image:

In[2]:=2

✖

https://wolfram.com/xid/0b0kh1m430k-jrolyl

Out[2]=2

Use the cloud to do image analysis:

In[3]:=3

✖

https://wolfram.com/xid/0b0kh1m430k-kqj0lk

Out[3]=3

Generalizations & Extensions (1)Generalized and extended use cases

Compare held and unheld cloud evaluations of a local variable (note the automatic cloud definition of g has been cleared):

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-59prvk

Out[1]=1

Options (2)Common values & functionality for each option

CloudBase (1)

Evaluate on a specific cloud without changing $CloudBase:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-fq22nh

Out[1]=1

IncludeDefinitions (1)

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-j5yczs

Out[1]=1

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

CloudEvaluate shows any messages raised during the evaluation:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-bzww53

Out[1]=1

However, any other notebook manipulations, such as printed output, are not reproduced:

In[2]:=2

✖

https://wolfram.com/xid/0b0kh1m430k-uh2e5s

In a cloud evaluation, $CloudEvaluation is set to True:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-v43157

Out[1]=1

Individual cloud evaluations typically run in separate processes:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-dnw2ph

Out[1]=1

Using CloudEvaluate during a cloud evaluation always runs in the same process:

In[2]:=2

✖

https://wolfram.com/xid/0b0kh1m430k-efevh

Out[2]=2

Possible Issues (1)Common pitfalls and unexpected behavior

The result of the cloud evaluation is subject to evaluation in the local session. Multiple evaluations can result in multiple messages:

In[1]:=1

✖

https://wolfram.com/xid/0b0kh1m430k-zq32ie

Out[1]=1

Apply the head Hold to prevent the second, local evaluation:

In[2]:=2

✖

https://wolfram.com/xid/0b0kh1m430k-o7h2wu

Out[2]=2

Top