BUILT-IN MATHEMATICA SYMBOL

CompilationOptions

CompilationOptions
is an option for Compile that specifies settings for the compilation process.

MORE INFORMATION

CompilationOptions applies to the creation of the compiled function.

CompilationOptions accepts lists of settings in the form CompilationOptions.

CompilationOptions can also take the following nested settings:

"ExpressionOptimization"	Automatic	whether to optimize the input expression
"InlineCompiledFunctions"	Automatic	whether to expand the body of nested compiled functions
"InlineExternalDefinitions"	Automatic	whether to use external definitions

Possible values for are:

	False	do not optimize the input expression
	True	optimize the input expression
	Automatic	only use the optimized expression if the compiled function does not make external calls

Possible values for are:

	False	do not inline nested compiled functions
	True	inline nested compiled functions
	Automatic	inline small nested compiled functions

Possible values for are:

	False	do not use external definitions
	True	insert the body of external definitions
	Automatic	use the type of external definitions

EXAMPLES

CLOSE ALL

Basic Examples (1)

Options to control how the compilation runs can be given in a nested form. For example, you can turn off compilation optimizations. This may cause the same computation to be done more than once:

In[1]:=

Out[1]=

Options (3)

The default setting of Automatic optimizes the input expression to avoid computing the same subpart more than once:

If the compiled function needs to make an external call to Mathematica, the default setting of Automatic does not optimize:

Turning off compilation optimizations may cause the same computation to be done more than once:

Setting

to True causes optimization even if the compiled function needs to make an external call to Mathematica:

The default setting of Automatic inlines nested compiled functions if they are small:

A setting of False will avoid inlining the compiled function:

The default setting of Automatic uses the type of external definitions, but makes an external call. In this case the external call fails:

A setting of True will inline the external definition, allowing the computation to proceed without errors:

A setting of False will not inline the external definition and will not use the type information. In this case there is an external call that fails.