{"id":27558,"library":"xarray-datatree","title":"xarray-datatree","description":"Provides hierarchical tree-like data structures (DataTree) for xarray, enabling nested datasets. Currently at version 0.0.15, with slow development and no stable release. It is experimental and may have breaking changes between minor versions.","status":"active","version":"0.0.15","language":"python","source_language":"en","source_url":"https://github.com/xarray-contrib/datatree","tags":["xarray","hierarchical","data-tree","nested-datasets"],"install":[{"cmd":"pip install xarray-datatree","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"DataTree extends xarray datasets; must be installed","package":"xarray","optional":false},{"reason":"For reading/writing netCDF files with groups","package":"netcdf4","optional":true}],"imports":[{"note":"Old import path (pre-0.0.11) was xarray_datatree; now datatree.","wrong":"from xarray_datatree import DataTree","symbol":"DataTree","correct":"from datatree import DataTree"}],"quickstart":{"code":"from datatree import DataTree\nimport xarray as xr\n# Create a nested tree\ndt = DataTree.from_dict({\n    \"/\": xr.Dataset({\"x\": [1, 2]}),\n    \"/subgroup\": xr.Dataset({\"y\": [3, 4]})\n})\nprint(dt)","lang":"python","description":"Create a simple hierarchical DataTree from a dict of Datasets."},"warnings":[{"fix":"Use `from datatree import DataTree` instead of `from xarray_datatree import DataTree`.","message":"Import path changed from xarray_datatree to datatree in version 0.0.11. Old imports will raise ModuleNotFoundError.","severity":"breaking","affected_versions":">=0.0.11"},{"fix":"Pin version strictly and test upgrades carefully.","message":"API is highly unstable; no backward compatibility guarantees. Expect interfaces to change between minor versions.","severity":"breaking","affected_versions":"all"},{"fix":"Use explicit encoding settings or check netCDF file after writing.","message":"Operations like `dt.to_netcdf()` may drop existing variables if dataset passed has different encoding. Always validate roundtrip.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use `from datatree import DataTree`.","cause":"Import path renamed to 'datatree' in version 0.0.11.","error":"ModuleNotFoundError: No module named 'xarray_datatree'"},{"fix":"Use `dt.tree.children` or iterate over `dt.subtree`; check documentation for current API.","cause":"The children property was removed or renamed in later versions.","error":"AttributeError: 'DataTree' object has no attribute 'children'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}