aStudy.sample() | ||||
|
| |||
ProductsAbaqus/StandardAbaqus/Explicit
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.
-
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.].