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.
References
The abqcy
command
$ 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 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 run --help
INFO: Showing help with the command 'abqcy run -- --help'.
NAME
abqcy run - Run Abaqus jobs.
SYNOPSIS
abqcy run INPUT USER <flags>
DESCRIPTION
Run Abaqus jobs.
POSITIONAL ARGUMENTS
INPUT
Type: 'str'
The path to the input file.
USER
Type: 'str'
The name of the user subroutine, if it is a Cython/Pure Python script, it will be compiled to an object file automatically.
FLAGS
-j, --job=JOB
Type: Optional['str']
Default: None
The name of the job, by default the current directory name.
-o, --output=OUTPUT
Type: Optional['str']
Default: None
The path to the output directory, by default the current directory.
-s, --script=SCRIPT
Type: Optional['str']
Default: None
The Python script to run after finishing the job to post-process the results.
Additional flags are accepted.
Additional keyword arguments to pass to the ``abaqus`` command to make the object file.
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS