Skip to content

Welcome to§

ozzy logo ozzy logo
PIC simulation data analysis for the lazy and impatient

Ozzy is a data visualization and data wrangling tool geared towards particle-in-cell (PIC) simulations and the plasma physics community. Ozzy's philosophy is to make the analysis of simulation data originating from multiple simulation codes and often contained in large files as easy as possible by building on the powerful features of the xarray package.

Get started

Why ozzy?§

  • Any simulation code

    Read and plot simulation data written by any PIC simulation code. Write the backend to parse the data once and move on.

    Reading files

  • Labeled dimensions

    Think like a physicist, not like a software engineer. You'll never have to wonder which numerical index corresponds to the \(x\) dimension of that array again.

    Indexing

  • Keep the metadata

    Which file was this again? Let the code stay organized so you don't have to. Attributes go where the array goes.

    Data objects

  • No file size too large

    Chunking and lazy-loading of large data files (ugh, right?) are handled automatically by xarray and Dask.

    Data chunking and lazy-loading

  • Fast and furious

    Vectorized operations, fast Pandas-like indexing, and more to make your analysis run even faster.

    Notes on speed

  • Stay flexible

    We embrace xarray and Dask, but you don't have to. Easily manipulate your data as trusty NumPy arrays whenever convenient.

    Data analysis

  • Beautiful plots with one line of code

    Ozzy lays the groundwork using the dataset's metadata.

    Plotting

  • Open Source, MIT

    Ozzy is licensed under MIT and available on GitHub.

    License

Acknowledgment§

Please consider acknowledging ozzy if you use it to produce images or results published in a scientific publication, for example by including the following text in the acknowledgments or citing ozzy's Zenodo reference1:

The data and plots in this publication were processed with ozzy1, a freely available data visualization and analysis package.

In addition, please note that the plotting submodule of ozzy uses two color maps developed by Fabio Crameri (licensed under an MIT license) by default: vik (diverging) and lipari (sequential). These color maps should be acknowledged if used in a published image, for example with:

The Scientific colour map lipari2 is used in this study to prevent visual distortion of the data and exclusion of readers with colour-vision deficiencies3.

See the "Plotting" section of the User Guide for more information.

  1. M. Moreira, “Ozzy: A flexible Python package for PIC simulation data analysis and visualization”. Zenodo, Jul. 16, 2024. doi: 10.5281/zenodo.12752995. ↩↩

  2. F. Crameri, "Scientific colour maps". Zenodo, Oct. 05, 2023. doi: 10.5281/zenodo.8409685. ↩

  3. F. Crameri, G.E. Shephard, and P.J. Heron, "The misuse of colour in science communication". Nat. Commun. 11, 5444 (2020). doi: 10.1038/s41467-020-19160-7. ↩