Metadata-Version: 2.1
Name: osyris
Version: 2.2.2
Summary: A package to visualize AMR data from the RAMSES code
Home-page: https://github.com/nvaytet/osyris
Author: Neil Vaytet
Author-email: neil.vaytet@esss.se
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/nvaytet/osyris/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

<table><tr><td>
<h1>Osyris</h1>
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.
</td><td>
<img src="https://github.com/nvaytet/osyris/blob/main/docs/images/logo_osyris.png" width="200" />
</td></tr></table>

### Documentation ###

The documentation for `osyris` is hosted on
[Readthedocs](https://osyris.readthedocs.io).

### Installation ###

```sh
pip install osyris
```

### A short example ###

You can download the sample data
[here](https://github.com/nvaytet/osyrisdata/archive/refs/heads/main.zip).

Plot a 2D histogram of the cell magnetic field versus the gas density.

```python
import osyris
data = osyris.Dataset(71, scale="au", path="data").load()
osyris.plot.histogram(data["hydro"]["density"], data["hydro"]["B_field"],
                      norm="log", loglog=True)
```

Create a 2D gas density slice 100 au wide through the plane normal to ``z``,
with velocity vectors overlayed as arrows, once agains using ``layers``:

```python
ind = np.argmax(data["hydro"]["density"])
center = data["amr"]["xyz"][ind.values]
osyris.plane({"data": data["hydro"]["density"], "norm": "log"}, # layer 1
             {"data": data["hydro"]["velocity"], "mode": "vec"}, # layer 2
             dx=50 * osyris.units("au"),
             origin=center,
             direction="z")
```

### Have a problem or need a new feature? ###

Submit an issue on [Github](https://github.com/nvaytet/osyris/issues).

### Contributors ###

* Neil Vaytet (StarPlan/NBI)
* Tommaso Grassi (StarPlan/NBI)
* Matthias Gonzalez (CEA Saclay)
* Troels Haugbolle (StarPlan/NBI)
* Lucas Beeres

### Logo credit ###

[Icon vector created by frimufilms - www.freepik.com](https://www.freepik.com/free-photos-vectors/icon)


