ozzy logo

Ozzy is a data visualization and data wrangling Python package 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.

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. Currently available: openPMD, OSIRIS, and LCODE.

  • Labeled dimensions (thanks to xarray)

    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.

  • No file size too large (thanks to Dask)

    Chunking and lazy-loading of large data files are handled automatically by xarray and Dask.

  • Flexible

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

  • Beautiful plots with one line of code

    Ozzy lays the groundwork using the dataset's metadata.

Installation

[!IMPORTANT] Ozzy requires Python >= 3.10.

A detailed guide is available in the "Installation" page of the documentation.

We highly recommend installing ozzy in its own virtual environment.

conda (recommended)

conda install --channel=conda-forge ozzy-pic

pip

python3 -m pip install ozzy-pic

Head to the documentation page to see some examples of how to get started.

Documentation

All the documentation can be found at https://mtrocadomoreira.github.io/ozzy.

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 and/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 ozzy.plot 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.

More information about the colour libraries used by ozzy can be found in the "Plotting" section of the User Guide.

License

Copyright © 2024 Mariana Moreira - All Rights Reserved

You may use, distribute and modify this code under the terms of the MIT License.

The plotting submodule of ozzy (ozzy.plot) also bundles a few different fonts under the SIL Open Font License (OFL), which is a free and open-source license. The full text of these licenses is included for each font in the fonts directory (src/ozzy/fonts/). See more details about the bundled fonts and their copyright notices in the "License" section of the documentation.

ozzy icon

  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

  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. ↩

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.1.7)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for marianam from gravatar.com marianam

Credits

Author: Mariana Moreira

License expression

MIT
View SPDX License List

Requires

Python <3.15, >=3.11

Provides Extra

interactive

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ozzy_pic-2.1.6.tar.gz (9.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ozzy_pic-2.1.6-py3-none-any.whl (9.4 MB view details)

Uploaded Python 3

File details

Details for the file ozzy_pic-2.1.6.tar.gz.

File metadata

  • Download URL: ozzy_pic-2.1.6.tar.gz
  • Upload date:
  • Size: 9.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ozzy_pic-2.1.6.tar.gz
Algorithm Hash digest
SHA256 ea8ae46517b98f4e0a2a5b715c714c5e83c6d89afc771315046c056fed2602a9
MD5 0a18e0e1449f92a98b1924c5cf404b68
BLAKE2b-256 4219ecb88f09c49bc69e111a27a38d0897e70ad869207dfe30fe7ff222641580

See more details on using hashes here.

File details

Details for the file ozzy_pic-2.1.6-py3-none-any.whl.

File metadata

  • Download URL: ozzy_pic-2.1.6-py3-none-any.whl
  • Upload date:
  • Size: 9.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ozzy_pic-2.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 f5401d374e77ee90e5223f1e6d93dd8b0bf6de91eba3ee2297689d0088ecdc83
MD5 a7d2a3ec68e9f76cc77deaffc5467cd6
BLAKE2b-256 3bfc885f34827885c94b0f9bb689db460e823f6a7d8cb12d6241bfe2fd01c326

See more details on using hashes here.

Release history Release notifications | RSS feed

2.1.7

2 files

This release

2.1.6 This release

2 files

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.1

2 files

2.0.0

2 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.9

2 files

1.2.7

2 files

1.2.6

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.2

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

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