Skip to main content

PyRolL Rolling Simulation Framework

PyPI Python Versions License DOI Downloads OpenSSF Best Practices

Welcome to The PyRolL Project!

PyRolL is an OpenSource rolling framework, aimed to provide a fast and extensible base for rolling simulation. The current focus lies on groove rolling in elongation grooves. The core package includes the basic data structures and algorithms. Further functionality is provided via extension packages and model approaches are provided via plugin packages.

Aim and Scope

Publications in the field of groove rolling simulation are, to the authors knowledge, characterized by lack of reproducibility, mainly because often details are missing regarding implementation or numerical solution procedure or the provided equations are erroneous. Very few authors provide their source code alongside their publications. PyRolL aims to change this by providing an open basis for model and methodology development. The PyRolL Core package hosted in this repository is the common base dependency to refer to. Plugins to the core provide model approaches for the partial problems to be described in a rolling simulation, which include mechanical, thermal, material behavior and more. The library of available models is constantly growing and can be extended by everyone. Extensions provide application logic and numerical procedures helping to analyse the subject rolling process regarding its technical feasibility, optimization potential, identity error sources, or, to design a new process. PyRolL is therefore a tool for model developers, either with broad focus or specialists, wishing to try out for example a new physical material model within a real process simulation, as well as for technologists wishing to investigate a concrete process. Currently, there is no click'n'run graphical user interface (GUI) provided, at least basic knowledge of programming in general and Python in particular is needed to use the software. Nevertheless, this is also recommended to leverage the full power of PyRolL.

Documentation

See the documentation to learn about basic concepts and usage. The documentation of version 1.0 can be found here.

Versions

The main branch of this repository contains the code of the version 3.x of PyRolL. Backport branches exist for older versions:

Versioning follows semantic versioning with the following rules:

  • breaking changes of core API only in major versions
  • feature releases with minor versions
  • bugfixes with micro versions
  • plugin versioning shall follow the core in major versions (so plugin v2.x works with core v2.x)

As breaking changes are considered:

  • removal of public API functions / classes
  • non backwards compatible signature changes of public API functions / classes
  • removal of hooks
  • removal of hook implementations in the core
  • changes in hook implementations that would likely break plugin implementations

As features are considered:

  • new public API functions / classes
  • backwards compatible signature changes of public API functions / classes
  • new hooks on existing units / profiles
  • new hook implementations in the core

All other changes not considered as breaking change or feature are considered as bugfixes.

It is recommended to develop new plugins and extensions only for the latest major version.

Principal Changes of Version 3.0 Respective to 2.0

  • Refactoring of the roll pass class inheritance hierarchy to enable for support of asymmetric passes.
  • Introduction of pre- and post-processors to simplify implementation of some models.

Principal Changes of Version 2.0 Respective to 1.0

  • Split of old pyroll package into pyroll-core, pyroll-report, pyroll-export and pyroll-cli.
  • Complete reworking of the hook system.
    • Implementation of own hooking framework and removal of pluggy.
    • Simpler user interface for hook definition and implementation.
    • More orthodox default hook implementations, removal of "basic models".
  • Rework of the object model.
    • Stricter hierarchy of unit classes.
    • Extended possibilities of groove definition.
    • Roll passes with three working rolls.
    • New unit classes: Rotator, PassSequence, ThreeRollPass.
    • Introduction of disk elements for incremental modelling in rolling direction.
    • Nestable units (esp. pass sequences and disk elements).

License

The project is licensed under the BSD 3-Clause license.

Contributing

Feel free to open issues, or, fork and open pull requests, if you want to contribute to the core. If you want to implement model approaches for use with PyRolL, create your own plugin package using our plugin template. To learn how to write plugins and extensions, please read the documentation and refer to the numerous existing plugins and extensions available at the organization's GitHub page.

Policy for Inclusion of Hooks in the Core

Since version 2.0 we try to include as many hooks as possible into the core, to tie down the nomenclature. This seems necessary, since for the same concepts, often different terms exist in literature. To avoid collisions and redundancies, it is better to include these hooks in the core, although some of them may come without implementation. This improves the exchangeability of plugins. If you like a hook to be included in the core, open an issue, or preferably, a pull request with the respective changes. Supply your pull request with fallback implementations of the hook, if any meaningful exist.

From this policy we explicitly exclude hooks, that are solely of use for one model approach, namely "coefficients". They are large in number across the whole plugin landscape, but usually named after the model and of no further use to other plugins. So the benefit from including them in the core is small, while the pollution of the core would be exzessive. If another plugin has to make use of them, just add a dependency for the respective source plugin.

A few examples for clarification:

  • The hooks Profile.surface_temperature and Profile.core_temperature may be of interests to many plugins. The core provides fallbacks which just return self.temperature, which is a good first estimate of those. So plugins modelling surface and thermal effects can easily refer to the respective temperatures, without worrying, if there is a model describing the temperature gradient or not.
  • The hook Profile.freiberg_flow_stress_coefficients from the pyroll-freiberg-flow-stress plugin makes no sense without the Freiberg flow stress model, so it is not included in the core.
  • The hook Profile.thermal_conductivity is a material property useful to many plugins, but no meaningful fallback exists, since there is no default material. So the provision of values or implementations is deferred to the user or developers of material databases.

So the core includes several hooks, that are not used by other core functionality, but provide a save ground for plugins.

Metadata

Release files for pyroll-core 3.1.16

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

Source distribution (sdist)

Source distribution for pyroll-core 3.1.16
File Size Uploaded Provenance Actions
pyroll_core-3.1.16.tar.gz 69.7 kB Without provenance Details for pyroll_core-3.1.16.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyroll-core 3.1.16
File Interpreter ABI Platform Actions
pyroll_core-3.1.16-py3-none-any.whl Python 3 none any Details for pyroll_core-3.1.16-py3-none-any.whl

Total release size: 178.8 kB

Release files / pyroll_core-3.1.16.tar.gz

Download URL pyroll_core-3.1.16.tar.gz
Size 69.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6c0388cdba7161205fe6a6c6a065ee245f6a85e005a7d438e45ce2488a650337
BLAKE2b-256 checksum
How to use checksums
aba1926d0b8ede395108ad41de28cd83d9f82873abc95bd0083f625df4af433c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via Hatch/1.17.1 {"ci":null,"cpu":"arm64","distro":{"name":"macOS","version":"26.5.1"},"implementation":{"name":"CPython","version":"3.13.14"},"installer":{"name":"hatch","version":"1.17.1"},"openssl_version":"OpenSSL 3.0.21 9 Jun 2026","python":"3.13.14","system":{"name":"Darwin","release":"25.5.0"}} HTTPX2/2.9.0

Release files / pyroll_core-3.1.16-py3-none-any.whl

Download URL pyroll_core-3.1.16-py3-none-any.whl
Size 109.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f4ed31dad90b304954d016e63ebfcf4f07b49b6ee9ad97aa914164aed81a233d
BLAKE2b-256 checksum
How to use checksums
dfcee3c77cff009a6e787e34ebf9ad40696c862ecd4c36f777f7b65d6fc59225
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via Hatch/1.17.1 {"ci":null,"cpu":"arm64","distro":{"name":"macOS","version":"26.5.1"},"implementation":{"name":"CPython","version":"3.13.14"},"installer":{"name":"hatch","version":"1.17.1"},"openssl_version":"OpenSSL 3.0.21 9 Jun 2026","python":"3.13.14","system":{"name":"Darwin","release":"25.5.0"}} HTTPX2/2.9.0

Security for pyroll-core 3.1.16

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

3.1.16 This release

2 release files No provenance

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