You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The abbreviation (up to 8 alphanumeric characters) used to represent the string ``String`` . If
35
-
``Abbr`` is the same as an existing Mechanical APDL command, the abbreviation overrides. Avoid using an
36
-
``Abbr`` which is the same as an Mechanical APDL command.
33
+
cmd : str
34
+
User-defined command name. Only the first four characters are significant. Must not conflict
35
+
with any Mechanical APDL command name or any user unknown-command macro name.
37
36
38
-
string : str
39
-
String of characters (60 maximum) represented by ``Abbr`` . Cannot include a $ or any of the
40
-
commands :ref:`c`, :ref:`com`, :ref:`gopr`, :ref:`nopr`, :ref:`quit`, :ref:`ui`, or
41
-
:ref:`end` . Parameter names and commands of the :ref:`do` and Use the :ref:`if` groups may not
42
-
be abbreviated. If ``String`` is blank, the abbreviation is deleted. To abbreviate multiple
43
-
commands, create an "unknown command" macro or define ``String`` to execute a macro file (
44
-
:ref:`use` ) containing the desired commands.
37
+
srnum : str
38
+
User subroutine number (1 to 10) programmed for this command. For example, the command
39
+
:ref:`ucmd` ,MYCMD,3 will execute subroutine USER03 whenever the command MYCMD is entered. Use a
40
+
blank command name to disassociate ``SRNUM`` from its command. For example, :ref:`ucmd` ,,3
41
+
removes MYCMD as a command.
45
42
46
43
Notes
47
44
-----
48
-
Once the abbreviation ``Abbr`` is defined, you can issue it at the beginning of a command line and follow it with a blank (or with a comma and appended data), and the program will substitute the string ``String`` for ``Abbr`` as the line is executed. Up to 100 abbreviations may exist at any time and are available throughout the program. Abbreviations may be redefined or deleted at any time.
49
-
50
-
Use :ref:`starstatus` to display the current list of abbreviations. For abbreviations repeated with :ref:`repeat`, substitution occurs before the repeat increments are applied. There are a number of abbreviations that are predefined by the program (these can be deleted by using the blank ``String`` option described above). Note that ``String`` will be written to the ``File.LOG`` .
51
-
52
-
This command is valid in any processor.
45
+
Assigns a user-defined command name to a user-programmable (system-dependent) subroutine. This
46
+
feature allows user-defined commands to be programmed into Mechanical APDL. Once programmed, this command
47
+
can be input to the program like other commands, and can also be included in the Mechanical APDL start-up
48
+
file. Up to 10 subroutines are available for user-defined commands (USER01 to USER10). You must
49
+
have system permission, system access, and knowledge to write, compile, and link the appropriate
50
+
subprocessors into Mechanical APDL at your site. All routines should be written in FORTRAN. For more
51
+
information about FORTRAN compilers, refer to either the `Ansys, Inc. Windows Installation Guide <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/installation/win_product_table.html>`_ or the `Ansys, Inc. Linux Installation Guide <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/installation/lin_product_table.html>`_ for
52
+
details specific to your platform or operating system. The USER01 routine is commented and should
53
+
be listed from the distribution media (system dependent) for more details. Issue :ref:`ucmd` ,STAT
54
+
to list all user-defined command names. Because a user-programmed command is a nonstandard use of
55
+
the program, the verification of any Mechanical APDL run incorporating these commands is your
56
+
responsibility. In any contact with Mechanical APDL customer support regarding the performance of a custom
57
+
version of Mechanical APDL, explicitly state that a user-programmable feature has been used. See `User-
* ``NEW`` - Replace current abbreviation set with these abbreviations (default).
68
-
69
-
* ``CHANGE`` - Extend current abbreviation set with these abbreviations, replacing any of
70
-
the
71
-
same name that already exist.
78
+
* ``NEW`` - Replace current abbreviation set with these abbreviations (default).
79
+
* ``CHANGE`` - Extend current abbreviation set with these abbreviations, replacing any of the same
80
+
name that already exist.
72
81
73
82
fname : str
74
-
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.
75
-
The file name defaults to ``Jobname`` .
83
+
File name and directory path (248 characters maximum, including the characters needed for the
84
+
directory path). An unspecified directory path defaults to the working directory; in this case, you
85
+
can use all 248 characters for the file name. The file name defaults to ``Jobname``.
76
86
77
87
ext : str
78
-
Filename extension (eight-character maximum).
79
-
The extension defaults to ABBR if ``Fname`` is blank.
88
+
Filename extension (eight-character maximum). The extension defaults to ABBR if ``Fname`` is blank.
80
89
81
90
Notes
82
91
-----
83
-
The abbreviation file may have been written with the :ref:`abbsav` command. Do not issue :ref:`abbres` ,NEW while inside an executing abbreviation. Doing so will cause all data for the executing abbreviation to be deleted.
84
-
85
-
This command is valid in any processor.
92
+
The abbreviation file may have been written with the :ref:`abbsav` command. Do not issue
93
+
:ref:`abbres` ,NEW while inside an executing abbreviation. Doing so will cause all data for the
94
+
executing abbreviation to be deleted. This command is valid in any processor.
86
95
"""
87
-
command=f"ABBRES,{lab}"
96
+
command=f"ABBRES,{lab},{fname},{ext}"
88
97
returnself.run(command, **kwargs)
89
98
90
-
defabbsav(self, lab="", **kwargs):
91
-
r"""Writes the current abbreviation set to a coded file.
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.
104
-
The file name defaults to ``Jobname`` .
106
+
abbr : str
107
+
The abbreviation (up to 8 alphanumeric characters) used to represent the string ``String``. If
108
+
``Abbr`` is the same as an existing Mechanical APDL command, the abbreviation overrides. Avoid using an
109
+
``Abbr`` which is the same as an Mechanical APDL command.
105
110
106
-
ext : str
107
-
Filename extension (eight-character maximum).
108
-
The extension defaults to ABBR if ``Fname`` is blank.
111
+
string : str
112
+
String of characters (60 maximum) represented by ``Abbr``. Cannot include a $ or any of the
113
+
commands :ref:`c`, :ref:`com`, :ref:`gopr`, :ref:`nopr`, :ref:`quit`, :ref:`ui`, or
114
+
:ref:`end`. Parameter names and commands of the :ref:`do` and Use the :ref:`if` groups may not
115
+
be abbreviated. If ``String`` is blank, the abbreviation is deleted. To abbreviate multiple
116
+
commands, create an "unknown command" macro or define ``String`` to execute a macro file (
117
+
:ref:`use` ) containing the desired commands.
109
118
110
119
Notes
111
120
-----
112
-
Existing abbreviations on this file, if any, will be overwritten. The abbreviation file may be read with the :ref:`abbres` command.
113
-
121
+
Once the abbreviation ``Abbr`` is defined, you can issue it at the beginning of a command line and
122
+
follow it with a blank (or with a comma and appended data), and the program will substitute the
123
+
string ``String`` for ``Abbr`` as the line is executed. Up to 100 abbreviations may exist at any
124
+
time and are available throughout the program. Abbreviations may be redefined or deleted at any
125
+
time. Use :ref:`starstatus` to display the current list of abbreviations. For abbreviations
126
+
repeated with :ref:`repeat`, substitution occurs before the repeat increments are applied. There
127
+
are a number of abbreviations that are predefined by the program (these can be deleted by using the
128
+
blank ``String`` option described above). Note that ``String`` will be written to the ``File.LOG``.
User-defined command name. Only the first four characters are significant. Must not conflict
128
-
with any Mechanical APDL command name or any user unknown-command macro name.
129
-
130
-
srnum : str
131
-
User subroutine number (1 to 10) programmed for this command. For example, the command
132
-
:ref:`ucmd` ,MYCMD,3 will execute subroutine USER03 whenever the command MYCMD is entered. Use a
133
-
blank command name to disassociate ``SRNUM`` from its command. For example, :ref:`ucmd` ,,3
134
-
removes MYCMD as a command.
135
-
136
-
Notes
137
-
-----
138
-
Assigns a user-defined command name to a user-programmable (system-dependent) subroutine. This feature allows user-defined commands to be programmed into Mechanical APDL. Once programmed, this command can be input to the program like other commands, and can also be included in the Mechanical APDL start-up file.
139
-
140
-
Up to 10 subroutines are available for user-defined commands (USER01 to USER10). You must have system permission, system access, and knowledge to write, compile, and link the appropriate subprocessors into Mechanical APDL at your site.
141
-
142
-
All routines should be written in FORTRAN. For more information about FORTRAN compilers, refer to either the `Ansys, Inc. Windows Installation Guide <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/installation/win_product_table.html>`_ or the `Ansys, Inc. Linux Installation Guide <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/installation/lin_product_table.html>`_ for details specific to your platform or operating system.
143
-
144
-
The USER01 routine is commented and should be listed from the distribution media (system dependent) for more details.
145
-
146
-
Issue :ref:`ucmd` ,STAT to list all user-defined command names.
141
+
lab : str
142
+
Label that specifies the write operation:
147
143
148
-
Because a user-programmed command is a nonstandard use of the program, the verification of any Mechanical APDL run incorporating these commands is your responsibility. In any contact with Mechanical APDL customer support regarding the performance of a custom version of Mechanical APDL, explicitly state that a user-programmable feature has been used.
144
+
* ``ALL`` - Write all abbreviations (default).
149
145
150
-
See `User-Programmable Features (UPFs) <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/ans_adv/Hlp_G_ADV7_1.html#aRzouq21ldm>`_ `Guide to User-Programmable Features <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/ans_prog/ansysprog_aero_fullycoupled.html>`_
146
+
fname : str
147
+
File name and directory path (248 characters maximum, including the characters needed for the
148
+
directory path). An unspecified directory path defaults to the working directory; in this case, you
149
+
can use all 248 characters for the file name. The file name defaults to ``Jobname``.
151
150
152
-
See :ref:`ulib` for another way of defining user commands.
151
+
ext : str
152
+
Filename extension (eight-character maximum). The extension defaults to ABBR if ``Fname`` is blank.
153
153
154
-
This command is valid only at the Begin Level.
154
+
Notes
155
+
-----
156
+
Existing abbreviations on this file, if any, will be overwritten. The abbreviation file may be read
157
+
with the :ref:`abbres` command. This command is valid in any processor.
0 commit comments