Source code for isaaclab_newton.physics.featherstone_manager

# Copyright (c) 2022-2026, The Isaac Lab Project Developers (https://github.com/isaac-sim/IsaacLab/blob/main/CONTRIBUTORS.md).
# All rights reserved.
#
# SPDX-License-Identifier: BSD-3-Clause

"""Featherstone Newton manager."""

from __future__ import annotations

import inspect

from newton import Model
from newton.solvers import SolverFeatherstone

from .featherstone_manager_cfg import FeatherstoneSolverCfg
from .newton_manager import NewtonManager



[docs]
class NewtonFeatherstoneManager(NewtonManager):
    """:class:`NewtonManager` specialization for the Featherstone solver.

    Always uses Newton's :class:`CollisionPipeline` for contact handling.
    """

    @classmethod
    def _build_solver(cls, model: Model, solver_cfg: FeatherstoneSolverCfg) -> None:
        """Construct :class:`SolverFeatherstone` and populate the base-class slots.

        Featherstone always uses Newton's :class:`CollisionPipeline` and steps
        with separate input/output states, so the flags are fixed.
        """
        valid = set(inspect.signature(SolverFeatherstone.__init__).parameters) - {"self", "model"}
        kwargs = {k: v for k, v in solver_cfg.to_dict().items() if k in valid}
        NewtonManager._solver = SolverFeatherstone(model, **kwargs)
        NewtonManager._use_single_state = False
        NewtonManager._needs_collision_pipeline = True