27.2.10 aStudy.sample(): Sample parameters for parametric studies.

Products: ABAQUS/Standard  ABAQUS/Explicit  

This command is used to create samples of the values of the parameters of the study.

Reference

Command:

aStudy.sample (token, additional data)

Tokens:

INTERVAL

Use this token to sample a parameter at equal intervals.

NUMBER

Use this token to sample a given number of values of a parameter.

PRINT

Use this token to print parameter samples.

REFERENCE

Use this token to sample parameter values specified with respect to a reference parameter value.

VALUES

Use this token to sample particular values of a parameter.

Additional data for INTERVAL:

Required data:

interval

Set interval equal to the sampling interval. For a continuous valued parameter, values are sampled at equally spaced intervals based on the numerical value of the parameter. For a discrete valued parameter, values are sampled at equally spaced intervals based on the indexing of the sequence of parameter values.

par

Set par equal to the name of the parameter or the sequence of parameters whose samples are to be printed. If a single parameter is specified, it must be enclosed by matching quotation marks; for example, 'par1'. If a sequence of parameters is specified, it must be given inside parentheses or brackets and must contain parameter names enclosed by matching quotation marks and separated by commas; for example, ('par1', 'par2', 'par3') or ['par1', 'par2', 'par3'].

Optional data:

domain

For a continuous valued parameter, set domain equal to the minimum and maximum values of the parameter separated by a comma and enclosed by parentheses or brackets; for example, (10., 20.) or [10., 20.]. For a discrete valued parameter, set domain equal to the sequence of values that the parameter may have separated by commas and enclosed by parentheses or brackets; for example, (1., 2., 5., 3.) or [1., 2., 5., 3.].

If domain is specified in this command as well as in the define command for this parameter, the domain specification in this command is used for sampling.

If domain is omitted from this command, it must have been specified in the define command.

Additional data for NUMBER:

Required data:

number

Set number equal to the number of equally spaced values to be sampled for the parameter.

par

Set par equal to the name of the parameter or the sequence of parameters whose samples are to be printed. If a single parameter is specified, it must be enclosed by matching quotation marks; for example, 'par1'. If a sequence of parameters is specified, it must be given inside parentheses or brackets and must contain parameter names enclosed by matching quotation marks and separated by commas; for example, ('par1', 'par2', 'par3') or ['par1', 'par2', 'par3'].

Optional data:

domain

For a continuous valued parameter, set domain equal to the minimum and maximum values of the parameter separated by a comma and enclosed by parentheses or brackets; for example, (10., 20.) or [10., 20.]. For a discrete valued parameter, set domain equal to the sequence of values that the parameter may have separated by commas and enclosed by parentheses or brackets; for example, (1., 2., 5., 3.) or [1., 2., 5., 3.].

If domain is specified in this command as well as in the define command for this parameter, the domain specification in this command is used for sampling.

If domain is omitted from this command, it must have been specified in the define command.

Additional data for PRINT:

Optional data:

par

Set par equal to the name of the parameter or the sequence of parameters whose samples are to be printed. If a single parameter is specified, it must be enclosed by matching quotation marks; for example, 'par1'. If a sequence of parameters is specified, it must be given inside parentheses or brackets and must contain parameter names enclosed by matching quotation marks and separated by commas; for example, ('par1', 'par2', 'par3') or ['par1', 'par2', 'par3'].

If par is omitted, parameter samplings are printed for all parameters in the parametric study.

Additional data for REFERENCE:

Required data:

interval

Set interval equal to the sampling interval. For a continuous valued parameter, values are sampled at equally spaced intervals about the reference value based on the numerical value of the parameter. For a discrete valued parameter, values are sampled at equally spaced intervals about the reference value based on the indexing of the sequence of parameter values.

numSymPairs

Set numSymPairs equal to the number of pairs of parameter values to be sampled symmetrically about the reference value of the parameter.

par

Set par equal to the name of the parameter being sampled. This name must be enclosed by matching quotation marks; for example, 'par1'.

Optional data:

domain

For a continuous valued parameter, set domain equal to the minimum and maximum values of the parameter separated by a comma and enclosed by parentheses or brackets; for example, (10., 20.) or [10., 20.]. For a discrete valued parameter, set domain equal to the sequence of values that the parameter may have separated by commas and enclosed by parentheses or brackets; for example, (1., 2., 5., 3.) or [1., 2., 5., 3.].

If domain is specified in this command as well as in the define command for this parameter, the domain specification in this command is used for sampling.

In the case of a discrete valued parameter if domain is omitted from this command, it must have been specified in the define command.

reference

For a continuous valued parameter, set reference equal to the reference value of the parameter. For discrete valued parameters, set reference equal to the index in the sequence of parameter values; indexing starts at zero, so that the first value of the sequence corresponds to index zero and the last value of the sequence corresponds to an index equal to the number of values in the sequence minus one.

If reference is specified in this command as well as in the define command for this parameter, the reference specification in this command is used for sampling.

If reference is omitted from this command, it must have been specified in the define command.

Additional data for VALUES:

Required data:

par

Set par equal to the name of the parameter or the sequence of parameters whose samples are to be printed. If a single parameter is specified, it must be enclosed by matching quotation marks; for example, 'par1'. If a sequence of parameters is specified, it must be given inside parentheses or brackets and must contain parameter names enclosed by matching quotation marks and separated by commas; for example, ('par1', 'par2', 'par3') or ['par1', 'par2', 'par3'].

values

Set values equal to the sequence of parameter values that constitute the sample. This sequence must be given inside parentheses or brackets and must contain values separated by commas; for example, ('CAX4', 'CAX4R', 'CAX4H') or [10., 20., 40.].