Skip to main content

Documentation Status Join the chat at https://app.gitter.im/#/room/#osyris-project_community:gitter.im

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)

hist2d

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",
)

map2d

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

Icon vector created by frimufilms - www.freepik.com

Metadata

Release files for osyris 3.2.1

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

Source distribution (sdist)

Source distribution for osyris 3.2.1
File Size Uploaded Provenance Actions
osyris-3.2.1.tar.gz 184.7 kB With provenance Details for osyris-3.2.1.tar.gz

Built distribution (wheel)

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

Total release size: 236.5 kB

Release files / osyris-3.2.1.tar.gz

Download URL osyris-3.2.1.tar.gz
Size 184.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a209979d86928e17755e7c500842a72094a7b6084af5557cce6eb6c54898b141
BLAKE2b-256 checksum
How to use checksums
ea37bb3d13f06d83c35cf5f6d5af1d48aa65993ddf6b136462a49fdb31d04be6
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 Nov 3, 2026.

Transparency log

Release files / osyris-3.2.1-py3-none-any.whl

Download URL osyris-3.2.1-py3-none-any.whl
Size 51.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e0aeca187815f6e869e200cfae590f182bc213c144c3a36d642908fe12cd995a
BLAKE2b-256 checksum
How to use checksums
68aab18dece89bd3c6ce8fe3b1bf2145a9a2c2f3cd90d6e63728066bec21490b
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 Nov 3, 2026.

Transparency log

Security for osyris 3.2.1

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 osyris-3.2.1.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 Nov 3, 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.

Release history Release notifications | RSS feed

This release

3.2.1 This release

2 release files Full 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