Main Content

Specify Your Parallel Settings

You can access your parallel settings in one of the following ways:

  • On the Home tab in the Environment section, select Parallel > Parallel Settings

    Before R2025a: Select Parallel > Parallel Preferences

  • Click the desktop pool indicator icon, and select Parallel Settings.

    Before R2025a: Click the desktop pool indicator icon and select Parallel Preferences

  • In the command window, enter preferences.

    preferences

    In the left pane of the Settings window, select Parallel Computing Toolbox.

The settings window displays the Parallel Computing Toolbox settings.

You can control your parallel settings as follows:

  • Default Profile — Choose the profile you want to use. The default profile is Processes. For more information, see Add and Modify Cluster Profiles.

  • Before R2023a: Preferred number of workers — Specify the number of workers in your parallel pool. The actual pool size is limited by licensing, cluster size, and cluster profile settings. For more details, see Factors That Affect Pool Size. For the Processes profile, do not choose a preferred number of workers larger than 512. See also Add and Modify Cluster Profiles. Check your access to cloud clusters from the Parallel > Discover Clusters menu.

  • Automatically create a parallel pool — If a parallel pool is not open, some functionality in Parallel Computing Toolbox™ and other products will automatically create a parallel pool, including:

    When these functions are used, select Automatically create a parallel pool to create a pool automatically. If you select this option, you do not need to open a pool manually using the parpool function. To learn more about automatic parallel support, see Run MATLAB Functions with Automatic Parallel Support.

    If this option is not selected, a pool is not open, and you use any Parallel Computing Toolbox functionality, your code will run on the client.

  • Shut down and delete a parallel pool — To shut down a parallel pool automatically if the pool has been idle for the specified amount of time, use the IdleTimeout setting. If you use the pool (for example, using parfor or parfeval), the timeout counter is reset. When the timeout is about to expire, a tooltip on the desktop pool indicator warns you and allows you to reset the timer. Note that modifying this setting changes the IdleTimeout of any already started pool.

See Also

Topics