ansys.mapdl.core.Mapdl.create#

Mapdl.create(fname='', ext='', **kwargs)#

Opens (creates) a macro file.

Mechanical APDL Command: *CREATE

Warning

This command must be run using non_interactive. Please visit Unsupported Interactive Commands for further information.

Parameters:

fnamestr: File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name. Do not use a directory path if file is to be read with the macro Name option of the use command.
extstr: Filename extension (eight-character maximum). Ext should not be used if file is to be read with the macro Name option of the use command.

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

Argument Descriptions

fname : str - File name and directory path (248 characters maximum, including the characters

needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name. Do not use a directory path if file is to be read with the macro

Name option of the use command.

ext : str - Filename extension (eight-character maximum). Ext should not be used if file

is to be read with the macro: Name option of the use command.

See the use command for a discussion of macros. All commands following the create command, up to the end command, are written to the specified file without being executed. An existing file of the same name, if any, will be overwritten. Parameter values are not substituted for parameter names in the commands when the commands are written to the file. Use cfwrite to create a file if this is desired. The resulting macro may be executed with a use command (which also allows parameters to be passed into the macro) or a input command (which does not allow parameters to be passed in). Several macros may be stacked into a library file ( ulib ). You cannot use create within a DO loop.

This command is valid in any processor.