An extension module for yt, adding a frontend for Idefix and Pluto
Project description
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.
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").
# Examples
ds = yt.load(
"data.0010.vtk", definitions_header="../definitions.h", inifile="example.ini"
)
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. This frontend can convert data from code units into cgs properly, based on the unit definitions from metadata.
Users are able to choose the unit displayed in two ways, through unit_system ("code", "mks" and "cgs") and units_override(only valid for Pluto).
# Examples on units
ds = yt.load("data.0010.vtk", unit_system="mks")
units_override = dict(length_unit=(100.0, "au"), mass_unit=yt.units.mass_sun)
# Caution that other units will also be changed for consistency!
ds = yt.load("data.0010.vtk", unit_override=unit_override)
With Pluto data, the rest of the system 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.
# Example
ds = yt.load("data.0010.vtk", default_species_fields="ionized")
Convention of field names
The outputs are loaded from disk with field names in uppercase. This normalization is only applied to the standard outputs but user-defined outputs and Pluto's ion fraction outputs.
# Example
ds.field_list
# Output:
# [('pluto-vtk', 'PRS'), # standard output
# ('pluto-vtk', 'RHO'), # standard output
# ('pluto-vtk', 'VX1'), # standard output
# ('pluto-vtk', 'VX2'), # standard output
# ('pluto-vtk', 'VX3'), # standard output
# ('pluto-vtk', 'temp')] # This is a user-defined output
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file yt_idefix-2.3.0.tar.gz.
File metadata
- Download URL: yt_idefix-2.3.0.tar.gz
- Upload date:
- Size: 41.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4fbef3dbc71197c58d4b8b49eb38f28ec4eecc2411aca350c6a7d6c78d20050e |
|
| MD5 | 1c99268ebf644084930dbdb4d6a03e07 |
|
| BLAKE2b-256 | 7b94992ebb61649829541d3744c33ef91c5007feab7c4c60dd5326efcb40292c |
Provenance
File details
Details for the file yt_idefix-2.3.0-py3-none-any.whl.
File metadata
- Download URL: yt_idefix-2.3.0-py3-none-any.whl
- Upload date:
- Size: 40.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 16e2d12abec3fe6384b71afb415be5078963c9d6ca0a71e1eb5f27289d1bb2b7 |
|
| MD5 | 7bf2103aa041919ed4f3726cef6475cf |
|
| BLAKE2b-256 | 23a14109e6f9a77081023bc9e44df7ca833b1a83fad671e256a452b8e62e4fea |
