BAli-Phy executes C++ functions much more quickly than it executes Haskell functions. To add a “builtin” C++ operation to bali-phy’s Haskell code, you must add the C++ code for the operation to one of the C++ files in the src/builtins/ directory. You must also tell the Haskell interpreter how to call this function by declaring it one of Haskell modules in the modules/ directory.

A builtin is declared via the following syntax:

For example, the Haskell function `poisson_density`

is declared with the following line from modules/Distributions.hs:

The first two arguments specify the Haskell name (`poisson_density`

) and the number of arguments in Haskell (`2`

). The C++ function name is derived from the third argument (`poisson_density`

) by adding `builtin_function_`

in front. So the C++ function will be called `builtin_function_poisson_density`

. The last argument specifies which loadable module contains the C++ function. Since this function is in the module “Distribution”, its source code goes in src/builtins/Distribution.cc.

The C++ function for a builtin must be defined in one of the C++ files in the src/builtins directory, and the function name must begin with `builtin_function_`

. The function must also be declared `extern "C"`

(to avoid name mangling).

For example, the poisson density function is written in src/builtins/Distribution.cc as follows:

```
extern "C" closure builtin_function_poisson_density(OperationArgs& Args)
{
double mu = Args.evaluate(0).as_double();
int n = Args.evaluate(1).as_int();
return { poisson_pdf(mu,n) };
}
```

Input:

- The function takes a single
`OperationArgs& Args`

argument. - The
`n`

th argument is fetched by calling`Args.evaluate(n)`

, and is of type`expression_ref`

(src/computation/expression/expression_ref.H) - The
`expression_ref`

can be converted to`int`

,`double`

, or`log_double_t`

using the methods`.as_int()`

,`.as_double()`

and`.as_log_double()`

.

Output:

- The function returns a
`closure`

object (src/computation/closure.H) - A closure can be created from a
`double`

or`int`

. Here an explicit conversion is invoked by surrouding a`log_double_t`

with curly braces.

`log_double_t`

This is a positive real number represented in terms of its logarithm. Operators have been defined so that you can multiply, add, subtract, and divide this type.

`Object`

All C++ objects are accessed from Haskell inherit from this type.

`expression_ref`

An expression ref is basically either an atomic value or an Object followed by a list of `expression_ref`

s

See src/computation/expression/expression_ref.H

`closure`

A closure is an `expression_ref`

with an environment.