Skip to main content

ABQ-FLOW

Modular batch-processing framework for Abaqus FEA based on python. Typed job specs, strategy-pattern workflows, fault-tolerant parallel execution, resource-aware scheduling — no more hand-crafted launch scripts.

License Version python

English | 简体中文

Features

  • ⚒️ Strategy-pattern workflows: compose preparation, extraction, and simulation steps into reusable pipelines
  • 📗 Typed configuration: JobSpec dataclasses validate before execution, no silent KeyError at runtime
  • 🔒 Fault-tolerant parallel execution: ProcessPoolExecutor + JobOutcome envelope; one failed job won't kill the batch
  • 💻 Extensible: register custom preparation strategies without modifying framework code

Installation

Install from PyPI:

pip install ABQflow

If you want the optional abqpy integration path:

pip install "ABQflow[abqpy]"

If you manage environments with Pixi:

pixi add --pypi ABQflow

Prerequisites: Abaqus (with abaqus on PATH), Python ≥ 3.9. abqpy is optional and only needed when you want to run eligible scripts through plain python instead of the Abaqus kernel.

Packaging

Build a source distribution and wheel locally with:

python -m build

Then upload the artifacts from dist/ to TestPyPI or PyPI.

How to use?

Single parameterized job

from ABQflow import BatchAbaqusProcessor, JobSpec, PreparationSpec, HookSpec

spec = JobSpec(
    job_name = "planar_stress_odb",
    workflow = "modular",
    preparation = PreparationSpec(
        kind = "inp_based",
        source_path = "./examples/cae_file/planar_stress_template.inp",
        params = {
            "youngs_modulus": 210000,
            "load_magnitude": 2000,
        }
    ),
    post_extraction = [
        HookSpec(
            script_path = "./examples/extraction_scripts/get_max_stress_mises.py",
            tasks = [
                {"result_name": "max_stress_mises",},
                {"result_name": "max_displacement",},
            ]
        )
    ]
)

processor_odb = BatchAbaqusProcessor(
    batch_data = [spec],
    base_output_dir = os.path.join(CWD, "examples/01_SingleParameterizedJob/output"),
    cpus_per_job = 4,
    duplicate_mode = "overwrite",
    abaqus_exe = ABAQUS_CAE,
)
outcomes = processor.run_batch(num_parallel_jobs=1)

for oc in outcomes:
    print(f"{oc.job_name}: {oc.status} → {oc.results}")

License

MIT License | See LICENSE for more details

Metadata

Release files for ABQflow 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ABQflow 0.6.0
File Size Uploaded Provenance Actions
abqflow-0.6.0.tar.gz 532.1 kB With provenance Details for abqflow-0.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ABQflow 0.6.0
File Interpreter ABI Platform Actions
abqflow-0.6.0-py3-none-any.whl Python 3 none any Details for abqflow-0.6.0-py3-none-any.whl

Total release size: 659.4 kB

Release files / abqflow-0.6.0.tar.gz

Download URL abqflow-0.6.0.tar.gz
Size 532.1 kB
Tags Source
SHA-256 checksum
How to use checksums
81697b1cf4a0c0cd95874aba523dbd8e24349007c78bd6376fc61fc64d9854d9
BLAKE2b-256 checksum
How to use checksums
1204dcbea70ea82339195c8c6bf9b6dfc56d562c222acc7a57cb242e9ce9f508
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / abqflow-0.6.0-py3-none-any.whl

Download URL abqflow-0.6.0-py3-none-any.whl
Size 127.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e337104d927d50e3de33b2af30fd7b7ef64239f22f7bb5dcfb41d9dc7e3759c0
BLAKE2b-256 checksum
How to use checksums
d0f08fba17a532d4996f3eb0a037d39896cc6e48905f90d722e95732c5f65aba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Security for ABQflow 0.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for abqflow-0.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page