yt_idefix
A maturing yt frontend for Idefix and Pluto, packaged as an extension for yt.
Installation
python -m pip install yt_idefix
Supported formats
| Code | format | supported since | additional dependencies |
|---|---|---|---|
| Idefix | .dmp |
v0.1.0 | |
| Idefix | .vtk |
v0.3.0 | |
| Pluto | .vtk |
v0.9.0 | |
| Pluto | XDMF | v1.1.0 | h5py |
Usage
Integration with yt is seamless. Installing this plugin is all that's required to make yt
compatible with data formats supported by yt_idefix !
Additional arguments to yt.load
The metadata are parsed from data file, definitions header file and inifile when loading dataset.
Definitions header file (definitions.h for Pluto, or definitions.hpp for Idefix) and inifile (pluto.ini and idefix.ini respectively) are discovered automatically if they match default names, are located along with data files, and unique. Otherwise, they can be specified explicitly as paths (either relative to data files or absolute paths) with parameters definitions_header and inifile respectively.
ds = yt.load(
"data.0010.vtk",
definitions_header="../definitions.h",
inifile="example.ini",
)
Geometry is parsed automatically whenever possible, but as a last resort, it can also be specified as a keyword argument (possible values are "cartesian", "spherical", "cylindrical" and "polar").
ds = yt.load("data.0010.vtk", geometry="spherical")
The data are loaded as physical quantities with units. The default unit system is cgs in yt. Data is always interpreted as dimensionful.
For Pluto simulation, metadata is retrieved from definitions.h and pluto.ini to guess the proper on-disk units automatically.
Units may also be provided at runtime using the units_override argument
ds = yt.load(
"data.0010.vtk",
units_override={
"length_unit": (100.0, "au"),
"mass_unit": yt.units.mass_sun,
},
)
Note that other units will also be changed for consistency (Pluto).
Displayed units can also be controled using the unit_system argument.
Accepted values are "cgs" (default), "mks" and "code".
ds = yt.load("data.0010.vtk", unit_system="mks")
With Pluto data, units not specified with units_override will be derived consistently with given units, within the following rules:
- Temperature unit cannot be overridden (always set to Kelvin)
- No more than three units can be overridden at once (overconstrained systems are never validated for simplicity)
- When given less than three overrides, base units in Pluto (ordered: velocity_unit, density_unit, length_unit) are assumed
- The following combinations are not allowed
{"magnetic_unit", "velocity_unit", "density_unit"},
{"velocity_unit", "time_unit", "length_unit"},
{"density_unit", "length_unit", "mass_unit"}
yt is able to provide some derived fields from existed fields, e.g., "cell_volume". Fields related to element species can be created according to primordial abundances of H and He, through default_species_fields ("neutral" and "ionized") parameters.
ds = yt.load("data.0010.vtk", default_species_fields="ionized")
Conventions on field names
Field names of on-disk fields for density, pressure, velocity and magnetic field components are always normalized to upper case, even if Pluto may use lowercase in some versions.
>>> ds.field_list
[('pluto-vtk', 'PRS'),
('pluto-vtk', 'RHO'),
('pluto-vtk', 'VX1'),
('pluto-vtk', 'VX2'),
('pluto-vtk', 'VX3')]
This normalization is only applied to non-user-defined outputs and Pluto's ion fraction outputs.
1 maintainer
Release files for yt-idefix 2.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yt_idefix-2.4.3.tar.gz | 37.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yt_idefix-2.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 76.9 kB
Release files / yt_idefix-2.4.3.tar.gz
| Download URL | yt_idefix-2.4.3.tar.gz |
|---|---|
| Size | 37.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3fdb7ddf6f5b4594aee20479485f63305fbf82027e64af97f621d831c2e074d2
|
|
BLAKE2b-256 checksum How to use checksums |
ed366db57f5ec34e5cfc29a4ffdaef91eeac7848821bb474ec4feae8c44dd72e
|
| 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 Jun 3, 2026.
Transparency logRelease files / yt_idefix-2.4.3-py3-none-any.whl
| Download URL | yt_idefix-2.4.3-py3-none-any.whl |
|---|---|
| Size | 39.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc07aeb46e26d4154a758923081f1cfc829b47e5e4f56dfac1b5b166e40d32bc
|
|
BLAKE2b-256 checksum How to use checksums |
0aa3b21bd54cbaa7433edcd1a5ff7624ec39c22a08fab9580c63acb207937ec6
|
| 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 Jun 3, 2026.
Transparency log
