Add inherit='all_coords' option to DataTree.to_dataset()

[aladinor]

• ClosesDatatree does not inherit non-dimension coordinates #10812
• Tests added
• User visible changes (including notable bug fixes) are documented in whats-new.rst

Summary

Adds inherit='all' option to DataTree.to_dataset() so users can inherit all parent coordinates, not just indexed ones.

Currently, DataTree only inherits indexed (dimension) coordinates from parent nodes. Non-index coordinates are silently dropped during inheritance. This PR extends the inherit parameter from bool to bool | Literal["all", "indexes"]:

• True / "indexes" — inherit only indexed coordinates (default, backward compatible)
• "all" — inherit all coordinates, including non-index coordinates
• False — node-only coordinates

Motivation: inheriting non-index coordinates

As described in #10812, non-index coordinates defined on a parent node are not inherited by child nodes. This is a common need in projects like xradar, where non-index coordinates such as latitude, longitude, and altitude are stored on the root node and need to be accessible on child sweep nodes:

importnumpyasnpimportxarrayasxrroot=xr.Dataset(
{"volume_number": ("time", [1, 2])},
coords={
"time": np.array(["2026-01-01", "2026-01-02"], dtype="datetime64[ns]"),
"latitude": 36.74,
"longitude": -98.13,
"altitude": 378.0,
},
)
child=xr.Dataset(
{"temperature": (["time", "x"], np.random.rand(2, 3))},
coords={"x": [0, 1, 2]},
)
dt=xr.DataTree.from_dict({"/": root, "sweep_0": child})
# Before: latitude, longitude, altitude are not inheriteddt["sweep_0"].to_dataset(inherit=True)
# After: all parent coords including non-index ones are availabledt["sweep_0"].to_dataset(inherit="all")

See also: openradar/xradar#337

Implementation

• Added _coord_variables_all property on DataTree (like _coord_variables but inherits all parent coords, not just indexed ones)
• Added _resolve_inherit() helper to centralize inherit parameter validation and dispatch
• Updated to_dataset() and _to_dataset_view() to use the new helper

cc @kmuehlbauer

[kmuehlbauer]

@aladinor Thanks, this is LGTM! Would be great if participants of #10812 could chime in on the implementation here.

cc @shoyer@TomNicholas

[kmuehlbauer]

I'm inclined to get this in soon, latest after dev meeting tomorrow, as this is blocking a quite long chain of PR over at https://github.com/openradar/xradar.

Please add any suggestions or comments. Thanks!

[shoyer]

Implementation-wise this looks fine to me, but maybe we should call it inherit='all_coords' or inherit='coords'? inherit='all' sounds like it inherits data variables.

[aladinor]

Thanks, @shoyer, for your feedback. I'll do "all_coords", which seems to be more accurate/explicit.

[kmuehlbauer]

Thanks @aladinor! Thanks All for reviews and suggestions.