Configuring ArrayFire Environment

- Main Page
- Tutorials
- Functions
- Release Notes
- Examples

Configuring ArrayFire Environment

This page lists environment and runtime configurations that will help enhance your experience with ArrayFire.

# Environment Variables

The following are useful environment variable that can be used with ArrayFire.

## AF_PATH

This is the path with ArrayFire gets installed, ie. the includes and libs are present in this directory. You can use this variable to add include paths and libraries to your projects.

## AF_CUDA_DEFAULT_DEVICE

Use this variable to set the default CUDA device. Valid values for this variable are the device identifiers shown when af::info is run.

1 AF_CUDA_DEFAULT_DEVICE=1 ./myprogram_cuda

Note: af::setDevice call in the source code will take precedence over this variable.

## AF_OPENCL_DEFAULT_DEVICE

Use this variable to set the default OpenCL device. Valid values for this variable are the device identifiers shown when af::info is run.

1 AF_OPENCL_DEFAULT_DEVICE=1 ./myprogram_opencl

Note: af::setDevice call in the source code will take precedence over this variable.

## AF_DISABLE_GRAPHICS

Setting this variable will disable window creation when graphics functions are being called. Simply setting this variable will disable functionality, any value will suffice. Disabling window creation will disable all other graphics calls at runtime as well.

This is a useful enviornment variable when running code on servers and systems without displays. When graphics calls are run on such machines, they will print warning about window creation failing. To suppress those calls, set this variable.

## AF_PRINT_ERRORS

When AF_PRINT_ERRORS is set to 1, the exceptions thrown are more verbose and detailed. This helps in locating the exact failure.

1 AF_PRINT_ERRORS=1 ./myprogram_opencl