# coarray-num-images, Qcoarray-num-images

Specifies the default number of images that can be used to run a coarray executable.

## Syntax

Linux: | -coarray-num-images=n

macOS: | None

Windows: | /Qcoarray-num-images:n

## Arguments

n

  Is the default number of images. The limit is determined from the system configuration.

## Default

OFF | The number of images is determined at run-time.

## Description

This option specifies the default number of images that can be used to run a coarray executable.

This option has no affect unless you also specify the [Q]coarray option. This option is required to create the coarray executable.

You can specify option [Q]coarray-num-images to specify the default number of images that can be used to run a coarray executable. If you do not specify that option, you get the number of execution units on the current system.

Note that when a setting is specified in environment variable FOR_COARRAY_NUM_IMAGES, it overrides the compiler option setting.

## IDE Equivalent

Visual Studio: Language > Coarray Images

## Alternate Options

None

Parent topic: Advanced Optimization Options

## See Also

coarray, Qcoarray compiler option