COMPAS CRA

build GitHub - License pip downloads PyPI - Python Version PyPI - Latest Release DOI

Coupled Rigid-Block Analysis (CRA) implementation using COMPAS framework.

developed with ♥ by Gene Ting-Chun Kao

Installation

pip install compas_sandbox

Nothing else is needed on Windows, macOS (Apple Silicon and Intel) or Linux: the wheels bundle a statically linked IPOPT 3.14.19 executable (Eclipse Public License 2.0, MUMPS linear solver, no HSL), built from source by packaging/. See packaging/README.md for how it is built and which licenses apply, and the installation docs for development installs.

To find out more about CRA, please refer to our paper in the CAD Computer-Aided Design journal: https://doi.org/10.1016/j.cad.2022.103216

Coupled Rigid-Block Analysis: Stability-Aware Design of Complex Discrete-Element Assemblies

image

Abstract

The rigid-block equilibrium (RBE) method uses a penalty formulation to measure structural infeasibility or to guide the design of stable discrete-element assemblies from unstable geometry. However, RBE is a purely force-based formulation, and it incorrectly describes stability when complex interface geometries are involved. To overcome this issue, this paper introduces the coupled rigid-block analysis (CRA) method, a more robust approach building upon RBE’s strengths. The CRA method combines equilibrium and kinematics in a penalty formulation in a nonlinear programming problem. An extensive benchmark campaign is used to show how CRA enables accurate modelling of complex three-dimensional discrete-element assemblies formed by rigid blocks. In addition, an interactive stability-aware design process to guide user design towards structurally-sound assemblies is proposed. Finally, the potential of our method for real-world problems are demonstrated by designing complex and scaffolding-free physical models.

Please cite our work if you use CRA in your research

Paper

@article{kao2022coupled,
    title     = {Coupled Rigid-Block Analysis: Stability-Aware Design of Complex Discrete-Element Assemblies},
    author    = {Kao, Gene Ting-Chun and Iannuzzo, Antonino and Thomaszewski, Bernhard and Coros, Stelian and Van Mele, Tom and Block, Philippe},
    journal   = {Computer-Aided Design},
    volume    = {146},
    pages     = {103216},
    year      = {2022},
    publisher = {Elsevier},
    doi       = {10.1016/j.cad.2022.103216},
    url       = {https://doi.org/10.1016/j.cad.2022.103216}
}

Software implementation

@misc{compas-sandbox,
    title  = {{COMPAS CRA}: Coupled Rigid-Block Analysis ({CRA}) for the {COMPAS} framework},
    author = {Kao, Gene Ting-Chun},
    note   = {https://github.com/BlockResearchGroup/compas\_cra},
    year   = {2020-2022},
    doi    = {10.5281/zenodo.7043135},
    url    = {https://doi.org/10.5281/zenodo.7043135},
}

Read the docs

https://github.com/petrasvestartas/compas_sandbox

Examples to reproduce our paper results

See examples in docs or try them in docs/examples.

Project links

Data verified by PyPI on Aug 23, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.7.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for petrasv from gravatar.com petrasv

Credits

Author: Gene Ting-Chun Kao

GitHub Statistics

Data verified by PyPI on Aug 23, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.10

Provides Extra

dev viz

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

compas_sandbox-0.6.1.tar.gz (1.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

compas_sandbox-0.6.1-py3-none-win_amd64.whl (13.6 MB view details)

Uploaded Python 3Windows x86-64

compas_sandbox-0.6.1-py3-none-manylinux_2_28_x86_64.whl (9.7 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

compas_sandbox-0.6.1-py3-none-manylinux_2_28_aarch64.whl (3.7 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

compas_sandbox-0.6.1-py3-none-macosx_11_0_x86_64.whl (3.4 MB view details)

Uploaded Python 3macOS 11.0+ x86-64

compas_sandbox-0.6.1-py3-none-macosx_11_0_arm64.whl (3.1 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file compas_sandbox-0.6.1.tar.gz.

File metadata

  • Download URL: compas_sandbox-0.6.1.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for compas_sandbox-0.6.1.tar.gz
Algorithm Hash digest
SHA256 5a1ed3697a7945163f416d0c285f4661296a0af56eda7ea22ad7bdf65160e3de
MD5 43ace5798f52ae5786cdd1eadf7be0b1
BLAKE2b-256 10551d74c46f1a586576c7dc7305538b44b0e052f584a2afb8a9b97a87e5dd8e

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1.tar.gz:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file compas_sandbox-0.6.1-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for compas_sandbox-0.6.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 2cabed2d1cb79e7ce5b71d8706ea3756fe5dd52b695da179b03c03d2b69cf43c
MD5 f72322f952baefd025c39424f7982822
BLAKE2b-256 beca18ada85e32354d57b28c183df8e343c39c55bfd38ef68835fc99bec36aee

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1-py3-none-win_amd64.whl:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file compas_sandbox-0.6.1-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for compas_sandbox-0.6.1-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f8f4aacd4b207218370f2bbb91d29db74d31571e09e88a17cdf88458701be15a
MD5 ef62347713ff913d74e1488970efb573
BLAKE2b-256 67032317660533e0584271bccc11a0776c9ce419f443873f27418696a8899e80

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1-py3-none-manylinux_2_28_x86_64.whl:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file compas_sandbox-0.6.1-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for compas_sandbox-0.6.1-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 6e62afd4b65677a12476431fde39e071da425e55750fb1efd43b694d0ff13bf5
MD5 11511c1bc7f4ffbf4467b59c6da7eae3
BLAKE2b-256 7af48a0e9418083ee7ebac158a8c74d6a3c7654d69682cda05de02d45fab18cf

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1-py3-none-manylinux_2_28_aarch64.whl:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file compas_sandbox-0.6.1-py3-none-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for compas_sandbox-0.6.1-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 ce6d0d628f310bfe02d602fd73418cdfa24de91ccf4a3adeebc2efda6d4126e6
MD5 3b32677489af5ee7f50abcf9364ede27
BLAKE2b-256 98f8070187d456f1f887bcf48c095fc5497475c4b4fe90b60d0ee29b7c7cf0fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1-py3-none-macosx_11_0_x86_64.whl:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file compas_sandbox-0.6.1-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for compas_sandbox-0.6.1-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 989f1a0eed3e9301c5fb6ce2b81c8a7d2bce8ad8d82ddf74ad1c4b2e94d26ded
MD5 ee721d48ffd8c9519205bde9ebab5957
BLAKE2b-256 9854895e9c2af56278a8cd1cb9753be2833492df2d424fd10a8c300db62514da

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_sandbox-0.6.1-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on petrasvestartas/compas_sandbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.7.6

26 files

0.7.5

26 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.5

6 files

0.6.4

6 files

0.6.3

6 files

0.6.2

6 files

This release

0.6.1 This release

6 files

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