Main Content

parcluster

Create cluster object

Description

example

c = parcluster returns a cluster object representing the cluster identified by the default cluster profile, with the cluster object properties set to the values defined in that profile. Use a cluster object in functions such as parpool or batch.

example

c = parcluster(profile) returns a cluster object representing the cluster identified by the specified cluster profile, with the cluster object properties set to the values defined in that profile.

Examples

collapse all

This examples shows different ways of creating a cluster object from the default profile.

Find the cluster identified by the default parallel computing cluster profile, with the cluster object properties set to the values defined in that profile.

myCluster = parcluster;

View the name of the default profile and find the cluster identified by it. Open a parallel pool on the cluster.

defaultProfile = parallel.defaultClusterProfile
myCluster = parcluster(defaultProfile);
parpool(myCluster);

Find a particular cluster using the profile named 'MyProfile', and create an independent job on the cluster.

myCluster = parcluster('MyProfile');
j = createJob(myCluster);

Input Arguments

collapse all

Cluster profile, specified as a string scalar or character vector.

You can save modified profiles with the saveProfile or saveAsProfile method on a cluster object. You can create, delete, import, and modify profiles with the Cluster Profile Manager, accessible from the MATLAB desktop Home tab Environment area by selecting Parallel > Create and Manage Clusters. For more information, see Discover Clusters and Use Cluster Profiles.

Example: parcluster('MyCluster')

Data Types: char | string

Introduced in R2012a