v1.1.2

v1.1.2 (2025-02-17)

Bug Fixes

• Trigger new release to publish Python-3.13-compatible update to PyPI (46d59fc)

---

Detailed Changes: v1.1.1...v1.1.2

v1.1.1

v1.1.1 (2025-02-17)

Bug Fixes

• Update package dependencies so that package works with Python 3.13 (6066a3f)

---

Detailed Changes: v1.1.0...v1.1.1

v1.1.0

v1.1.0 (2025-02-17)

Documentation

• part_mixin: Instruct users to use the function ozzy.utils.axis_from_extent to create the axes Dataset required for bin_into_grid (a156af7)

Features

• plot: Add functions to plot distributions of particle data (06d0869)

Add ozzy.plot.hist and ozzy.plot.hist_proj to easily plot density distributions (histograms) of particle data, taking advantage of the seaborn functions seaborn.histplot and seaborn.jointplot.

Previously it would have been necessary to bin the data first, and then plot, e.g.: python import ozzy as oz import ozzy.plot as oplt # A particle data Dataset ds = oz.Dataset(..., pic_data_type="part") ds_ps = ds.ozzy.get_phase_space(["p2", "x2"]) ds_ps["rho"].plot() While now the following code is enough: python import ozzy as oz import ozzy.plot as oplt ds = oz.Dataset(..., pic_data_type='part') oplt.hist(ds, x="x2", y="p2")

• plot: Add functions to plot distributions of particle data (7c39207)

Add ozzy.plot.hist and ozzy.plot.hist_proj to easily plot density distributions (histograms) of particle data, taking advantage of the seaborn functions seaborn.histplot and seaborn.jointplot.

Previously it would have been necessary to bin the data first, and then plot, e.g.: python import ozzy as oz import ozzy.plot as oplt # A particle data Dataset ds = oz.Dataset(..., pic_data_type="part") ds_ps = ds.ozzy.get_phase_space(["p2", "x2"]) ds_ps["rho"].plot() While now the following code is enough: python import ozzy as oz import ozzy.plot as oplt ds = oz.Dataset(..., pic_data_type='part') oplt.hist(ds, x="x2", y="p2")

Refactoring

• plot: Change ozzy.plot defaults to display a plot grid (703dfd3)

---

Detailed Changes: v1.0.9...v1.1.0

v1.0.9

v1.0.9 (2025-01-28)

Bug Fixes

• utils: One argument of set_attr_if_exists was missing its default value, which was throwing an error e.g. when ds.ozzy.save was called (a3cfe10)

---

Detailed Changes: v1.0.8...v1.0.9

v1.0.8

v1.0.8 (2025-01-24)

Bug Fixes

• accessors: Fft method was throwing error due to data being a chunked Dask array (83329ef)

Documentation

• Small formatting corrections (85a5f71)

---

Detailed Changes: v1.0.7...v1.0.8

v1.0.7

v1.0.7 (2024-11-26)

Bug Fixes

• backends: Fix bug that would throw error when using open_compare with multiple backends and with backend-specific keyword arguments (48d0b14)

Documentation

• Disable instant loading since this causes the feedback widget to only show after reloading the page (25b11d8)

• Update installation instructions (now available on conda-forge) and update package dependencies (especially makedocs-material) (e2c93ce)

v1.0.6

v1.0.6 (2024-11-13)

Bug Fixes

• part_mixin: Expression with double quotes inside double quotes was throwing an error for Python 3.10 (65c7549)

v1.0.5

v1.0.5 (2024-11-13)

Bug Fixes

• core: Remove obsolete argument for backend.parse_data that was being called from ozzy.open_compare and raising an error (2c5fa8e)

Documentation

• Fix some broken links after update (60afa7d)

v1.0.4

v1.0.4 (2024-11-12)

Bug Fixes

• part_mixin: Fix error thrown by bin_into_grid when called on a data object that didn't contain a 't' coordinate (5cd488c)

• lcode_backend: Fix missing-argument error when trying to read beamfile.bin files (776a1a2)

Documentation

• Update documentation (b43f5dc)

• Update "Installation" and "Getting started" page (6c726a5)

• Change heading formatting of changelog template (1bf9a95)

Refactoring

• Change how backend-specific arguments are passed from the open functions to each backend (easier to extend) (825b7ab)

v1.0.0

v1.0.0 (2024-10-22)

Breaking

• refactor: replace statistics.parts_into_grid with dataset method bin_into_grid

Replace statistics.parts_into_grid with a Dataset method called bin_into_grid accessible to particle data (pic_data_type = 'part').

BREAKING CHANGE: statistics.parts_into_grid does not work anymore

Please replace the function statistics.parts_into_grid with the ds.ozzy.bin_into_grid method. As an example, the following code

import ozzy as oz
import ozzy.statistics as stats
import numpy as np

# Create a sample particle dataset
particles = oz.Dataset(
    {
        "x1": ("pid", np.random.uniform(0, 10, 10000)),
        "x2": ("pid", np.random.uniform(0, 5, 10000)),
        "q": ("pid", np.ones(10000)),
    },
    coords={"pid": np.arange(10000)},
    attrs={"pic_data_type": "part"}
)

# Create axes for binning
axes = oz.Dataset(
    coords={
        "x1": np.linspace(0, 10, 101),
        "x2": np.linspace(0, 5, 51),
    },
    attrs={"pic_data_type": "grid"}
)

# Bin into grid, axisymmetric geometry
binned = stats.parts_into_grid(particles, axes, r_var="x2")
grid_data_axisym = particles.ozzy.bin_into_grid(axes, r_var="x2")

should be replaced by

import ozzy as oz
import numpy as np
...
# Bin into grid, axisymmetric geometry
binned = particles.ozzy.bin_into_grid(axes, r_var="x2")
``` ([`093b9bd`](https://github.com/mtrocadomoreira/ozzy/commit/093b9bd81f498a50a48d9aa804dae1dc19168ad0))

### Documentation

* docs: add release notes to website, create custom changelog template ([`2f8de9e`](https://github.com/mtrocadomoreira/ozzy/commit/2f8de9ee1c3b454dcc6db69a0ea637bdff4adcd1))

### Refactoring

* refactor(utils): make str_exists argument of get_attr_if_exists optional ([`5840bc4`](https://github.com/mtrocadomoreira/ozzy/commit/5840bc44884455dbe20508715e52a1cb4321773a))

* refactor: use helper functions to handle DataArray attributes whenever possible ([`5d53830`](https://github.com/mtrocadomoreira/ozzy/commit/5d53830538f88959180e5762b6d4893855d16cc1))