Command Line Interface
The abqcy
command line is used to compile you Cython code into an object (.obj
) file that can be used by Abaqus.
You can use it in the command line or in a Python script with the abqcy.cli.abqcy
object
(an abqcy.cli.AbqcyCLI
object).
References
The abqcy
command (abqcy.cli.AbqcyCLI
)
$ abqcy
NAME
abqcy - The ``abqcy`` command-line interface.
SYNOPSIS
abqcy COMMAND
DESCRIPTION
The ``abqcy`` command-line interface.
COMMANDS
COMMAND is one of the following:
compile
Compile a Cython script to an Abaqus user subroutine as an object file.
run
Run Abaqus jobs.
The abqcy compile
command (abqcy.cli.AbqcyCLI.compile()
)
$ abqcy compile --help
INFO: Showing help with the command 'abqcy compile -- --help'.
NAME
abqcy compile - Compile a Cython script to an Abaqus user subroutine as an object file.
SYNOPSIS
abqcy compile SCRIPT <flags>
DESCRIPTION
Compile a Cython script to an Abaqus user subroutine as an object file.
POSITIONAL ARGUMENTS
SCRIPT
Type: 'str'
The path to the Cython script to compile.
FLAGS
--exclude=EXCLUDE
Type: Optional['list']
Default: None
When passing glob patterns as ``script``, you can exclude certain module names explicitly by passing them into the ``exclude`` option.
-n, --nthreads=NTHREADS
Type: 'int'
Default: 0
The number of concurrent builds for parallel compilation (requires the ``multiprocessing`` module).
--aliases=ALIASES
Type: Optional['dict']
Default: None
If you want to use compiler directives like ``# distutils: ...`` but can only know at compile time (when running the ``setup.py``) which values to use, you can use aliases and pass a dictionary mapping those aliases
-q, --quiet=QUIET
Type: 'bool'
Default: False
If True, Cython won't print error, warning, or status messages during the compilation.
-f, --force=FORCE
Type: 'bool'
Default: False
Forces the recompilation of the Cython modules, even if the timestamps don't indicate that a recompilation is necessary.
-l, --language=LANGUAGE
Type: Optional['str']
Default: None
To globally enable C++ mode, you can pass ``language='c++'``. Otherwise, this will be determined at a per-file level based on compiler directives. This affects only modules found based on file names. Extension instances passed
--exclude_failures=EXCLUDE_FAILURES
Type: 'bool'
Default: False
For a broad 'try to compile' mode that ignores compilation failures and simply excludes the failed extensions, pass ``exclude_failures=True``. Note that this only really makes sense for compiling ``.py`` files which can also be used without compilation.
--annotate=ANNOTATE
Type: 'bool'
Default: True
Whether to generate an HTML file with annotations, by default True.
Additional flags are accepted.
Additional keyword arguments to pass to the ``cythonize`` function.
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
The abqcy run
command (abqcy.cli.AbqcyCLI.run()
)
$ abqcy run --help
INFO: Showing help with the command 'abqcy run -- --help'.
NAME
abqcy run - Run Abaqus jobs.
SYNOPSIS
abqcy run MODEL <flags>
DESCRIPTION
Run Abaqus jobs.
POSITIONAL ARGUMENTS
MODEL
Type: 'str'
The path to the input file or a Python script to create the input file.
FLAGS
-u, --user=USER
Type: Optional['str']
Default: None
The name of the user subroutine, if it is a Cython/Pure Python script, it will be compiled to an object file automatically. If a companion ``.pxd`` file is found, it will be copied to the output directory along with the Cython/Pure Python script.
-j, --job=JOB
Type: Optional['str']
Default: None
The name of the job, by default the model name without the extension.
-o, --output=OUTPUT
Type: Optional['str']
Default: None
The path to the output directory, by default the current directory.
-p, --post=POST
Type: Optional['str']
Default: None
The Python script to run after finishing the job to post-process the results. In the output script, a placeholder ``{odb}`` will be replaced with the path to the output database file.
-v, --visualization=VISUALIZATION
Type: Optional['str']
Default: None
The Python script to run after finishing the job to visualize the results. Typically, this script will plot a figure based on the data saved by the post-processing script.
Additional flags are accepted.
Additional keyword arguments to pass to the ``abaqus`` command to run the job.
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS