Osyris
A python visualization utility for RAMSES astrophysical simulations data. Osyris aims to remain portable, lightweight and fast, to allow users to quickly explore and understand their simulation data, as well as produce publication grade figures.
Documentation
The documentation for osyris can be found at https://osyris.readthedocs.io.
Installation
pip install osyris
A short example
You can download the sample data here.
Plot a 2D histogram of the cell magnetic field versus the gas density.
import numpy as np
import osyris
data = osyris.RamsesDataset(8, path="data").load()
osyris.hist2d(data["mesh"]["density"], data["mesh"]["B_field"],
norm="log", loglog=True)
Create a 2D gas density map 2000 au wide through the plane normal to z,
with velocity vectors overlayed as arrows, once again using layers:
ind = np.argmax(data["mesh"]["density"])
center = data["mesh"]["position"][ind]
osyris.map(
data["mesh"].layer("density", norm="log"),
data["mesh"].layer("velocity", mode="vec"),
dx=2000 * osyris.units("au"),
origin=center,
direction="z",
)
Have a problem or need a new feature?
- Bug reports or feature requests should be submitted by opening an issue
- For general discussions or questions about how to do something with
osyris, start a new discussion
Logo credit
1 maintainer
Release files for osyris 3.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| osyris-3.2.0.tar.gz | 184.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| osyris-3.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 235.7 kB
Release files / osyris-3.2.0.tar.gz
| Download URL | osyris-3.2.0.tar.gz |
|---|---|
| Size | 184.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3222bfed58335d115c65660432789a0b760355632be1f8648d73c18f40442b5
|
|
BLAKE2b-256 checksum How to use checksums |
4d47729ed861616b791b412fb09dc294e2202333cdaf89521d60c9d50c764d13
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 10, 2026.
Transparency logRelease files / osyris-3.2.0-py3-none-any.whl
| Download URL | osyris-3.2.0-py3-none-any.whl |
|---|---|
| Size | 51.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b3bb8b30dc59338f9dbe3aee7c7a2fae82439540d0f654552faeae9a0408edb2
|
|
BLAKE2b-256 checksum How to use checksums |
68d82885e55406392e696a6fd4ec3626c6893f9d3b4048c9dcbdfdeb930b2b9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 10, 2026.
Transparency log
