MultiPhysicsVault/.raw/AbaqusAnalysisUserGuide2/AbaqusAnalysisUserGuide2_153.md

20.2.8 aStudy=ParStudy(): Create a parametric study.

Products: Abaqus/Standard Abaqus/Explicit

This command is used to create a parametric study. It must precede any other scripting commands that refer to the parametric study.

Reference:

• “Scripting parametric studies,” Section 20.1.1

Command:

a \text { Study } = \text { ParStudy } (\text { par } = , \text { name } = , \text { verbose } = , \text { directory } =)

Required data:

par

Set par equal to the sequence of independent input parameters selected for the parametric study. This sequence must be given inside parentheses or brackets and must contain independent parameter names enclosed by matching quotation marks and separated by commas; for example, (’par1’, ’par2’, ’par3’) or [’par1’, ’par2’, ’par3’]. If only one parameter is to be listed, its name can be given enclosed by matching quotation marks; for example, ’par1’.

Optional data:

name

Set name equal to the name of the parametric study; the name must be enclosed in matching quotation marks. If a name is not specified, its value defaults to the name of the Python script file that contains the parametric study commands.

verbose

Set verbose equal to the symbolic token OFF to suppress the printing of comment and warning messages. The default is verbose=ON.

directory

Set directory equal to the symbolic token ON to select that subdirectories of the current directory are used to organize the files of the parametric study. A subdirectory will be created for each design that is analyzed. The default is directory=OFF.

20.2.9 aStudy.report(): Report parametric study results.

Products: Abaqus/Standard Abaqus/Explicit

This command is used to report results gathered across the designs of a parametric study.

Reference:

• “Scripting parametric studies,” Section 20.1.1

Command:

aStudy.report (token, results= , par= , designSet= , variations=, truncation= , additional data)

Tokens:

FILE

Use this token to specify that results are to be written to an ASCII file as a table with the relevant headings.

PRINT

Use this token to specify that results are to be printed as a table with the relevant headings. Since the results are printed to the default output device (the screen), you may wish to limit the number of columns in a table so as to make the table readable.

XYPLOT

Use this token to specify that results are to be written to an ASCII file as a table without headings. This table can subsequently be read by the Visualization module in Abaqus/CAE to display X–Y plots of result and parameter values.

Required data:

results

Set results equal to the sequence of result names to be reported; this sequence must be enclosed by parentheses or brackets. For example, results=(’e33_sinv.1’, ’e52_strain’, ’n25_u.3’), where ’e33_sinv.1’ is the Mises stress of element 33 (Mises is the first component of the SINV record), ’e52_strain’ are all the strain components of element 52, and ’n25_u.3’ is the third component of displacement of node 25. This example assumes that the three results above

were gathered in previous gather commands by requesting the SINV, E, and U variable identifier keys, respectively.

Optional data:

par

Set par equal to the name of the parameter or the sequence of parameters to be included in the report table. 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, all parameters in the parametric study are included in the report table.

designSet

Set designSet equal to the name of the design set whose results are to be included in the report table; this name must be enclosed by matching quotation marks.

If designSet is omitted, results for all design sets in the parametric study are included in the report table.

variations

Set variations equal to ON to indicate that the first column of the report table must show the names of the designs being reported. Set variations equal to OFF to indicate that the names of the designs being reported are not to be given in the first column of the report table.

If variations is omitted, the column of design names is not included in the report table.

truncation

Set truncation equal to ON to indicate that the data of the report table must be reported with limited precision. Set truncation equal to OFF to indicate that the data of the report table must be reported with full precision.

If truncation is omitted, the data of the report table are reported with limited precision.

Additional data for FILE and XYPLOT:

Required data:

file

Set file equal to the name of the file to which the report table is to be written. The file name must be enclosed by matching quotation marks.

20.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:

• “Scripting parametric studies,” Section 20.1.1

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.].

About SIMULIA

Dassault Systèmes SIMULIA applications, including Abaqus, Isight, Tosca, and Simulation Lifecycle Management, enable users to leverage physics-based simulation and high-performance computing to explore real-world behavior of products, nature, and life. As an integral part of Dassault Systèmes’ 3DEXPERIENCE platform, SIMULIA applications accelerate the process of making highly informed, mission-critical design and engineering decisions before committing to costly and time-consuming physical prototypes. www.3ds.com/simulia

Our 3DEXPERIENCE Platform powers our brand applications, serving 12 industries, and provides a rich portfolio of industry solution experiences.

Dassault Systèmes, the 3DEXPERIENCE Company, provides business and people with virtual universes to imagine sustainable innovations. Its world-leading solutions transform the way products are designed, produced, and supported. Dassault Systèmes’ collaborative solutions foster social innovation, expanding possibilities for the virtual world to improve the real world. The group brings value to over 170,000 customers of all sizes in all industries in more than 140 countries. For more information, visit www.3ds.com.

flowchart

Circular diagram illustrating the integration of 3D modeling apps, information intelligence apps, and simulation apps, with associated platform icons and labels.