Pose
L327class Pose(object)One right-handed SI pose expressed in the explicitly named frame.
| 字段 | 类型 | 默认值 |
|---|---|---|
| frame_id | str | — |
| xyz_m | tuple[float, float, float] | — |
| quat_xyzw | tuple[float, float, float, float] | — |
fastsim.api.scene 的当前公共 Python API;签名从 vNext AST 直接提取。
源码 src/fastsim/api/scene.pyclass Pose(object)One right-handed SI pose expressed in the explicitly named frame.
| 字段 | 类型 | 默认值 |
|---|---|---|
| frame_id | str | — |
| xyz_m | tuple[float, float, float] | — |
| quat_xyzw | tuple[float, float, float, float] | — |
class Twist(object)Linear and angular velocity expressed in one explicitly named frame.
| 字段 | 类型 | 默认值 |
|---|---|---|
| frame_id | str | — |
| linear_m_s | tuple[float, float, float] | — |
| angular_rad_s | tuple[float, float, float] | — |
class EntityDescriptor(object)Path-free static facts for one compiled scene entity.
| 字段 | 类型 | 默认值 |
|---|---|---|
| entity_id | str | — |
| authored_name | str | — |
| kind | str | — |
| enabled | bool | — |
| component_identity | str | — |
| component_version | str | — |
| link_ids | tuple[str, ...] | () |
| frame_ids | tuple[str, ...] | () |
| geometry_ids | tuple[str, ...] | () |
| control_resource_groups | tuple[str, ...] | () |
class LinkDescriptor(object)Backend-neutral relationship facts for one articulation or rigid link.
| 字段 | 类型 | 默认值 |
|---|---|---|
| link_id | str | — |
| entity_id | str | — |
| authored_name | str | — |
| frame_id | str | — |
| parent_link_id | str | None | None |
| geometry_ids | tuple[str, ...] | () |
class JointDescriptor(object)One physical scalar articulation axis in declared execution order.
| 字段 | 类型 | 默认值 |
|---|---|---|
| joint_id | str | — |
| authored_name | str | — |
| parent_link_id | str | — |
| child_link_id | str | — |
| joint_type | str | — |
| axis_frame_id | str | — |
| axis_xyz | tuple[float, float, float] | — |
| position_unit | str | — |
| lower | float | None | — |
| upper | float | None | — |
| max_velocity | float | None | None |
| max_effort | float | None | None |
class ArticulationDescriptor(object)Ordered physical joint facts for any articulation, robot or otherwise.
| 字段 | 类型 | 默认值 |
|---|---|---|
| entity_id | str | — |
| joints | tuple[JointDescriptor, ...] | — |
Physical axis IDs in provider-declared order, never name-inferred.
Authored physical joint names in provider-declared order.
class SceneQuery(object)A bounded, deterministic intersection filter for scene reads.
| 字段 | 类型 | 默认值 |
|---|---|---|
| entity_ids | tuple[str, ...] | () |
| link_ids | tuple[str, ...] | () |
| kinds | tuple[str, ...] | () |
| enabled | bool | None | None |
class SceneCatalogSnapshot(object)Immutable deterministic static scene projection for one generation.
| 字段 | 类型 | 默认值 |
|---|---|---|
| run_id | str | — |
| plan_digest | str | — |
| generation | int | — |
| catalog_revision | int | — |
| content_sha256 | str | — |
| entities | tuple[EntityDescriptor, ...] | — |
| links | tuple[LinkDescriptor, ...] | — |
| articulations | tuple[ArticulationDescriptor, ...] | — |
class EntityState(object)Dynamic state of the entity asset-root frame. ``pose`` is the imported asset/model root pose. For USD backends this is the spawned entity Prim pose; articulation root-link poses are exposed only through :class:`LinkState`.
| 字段 | 类型 | 默认值 |
|---|---|---|
| entity_id | str | — |
| pose | Pose | — |
| twist | Twist | — |
class LinkState(object)当前源码未提供公开 docstring。
| 字段 | 类型 | 默认值 |
|---|---|---|
| link_id | str | — |
| pose | Pose | — |
| twist | Twist | — |
class ArticulationState(object)Compact physical joint state in the descriptor's declared axis order.
| 字段 | 类型 | 默认值 |
|---|---|---|
| entity_id | str | — |
| joint_ids | tuple[str, ...] | — |
| positions | tuple[float, ...] | — |
| velocities | tuple[float, ...] | — |
| position_units | tuple[str, ...] | — |
| velocity_units | tuple[str, ...] | — |
class AttachmentState(object)One portable attachment relationship without a native constraint handle.
| 字段 | 类型 | 默认值 |
|---|---|---|
| attachment_id | str | — |
| parent_entity_id | str | — |
| child_entity_id | str | — |
| parent_frame_id | str | — |
| child_frame_id | str | — |
| parent_T_child | Pose | — |
| geometry_ids | tuple[str, ...] | — |
| parent_link_id | str | None | None |
| child_link_id | str | None | None |
class SceneStateSnapshot(object)Compact scene state committed atomically at exactly one authority tick.
| 字段 | 类型 | 默认值 |
|---|---|---|
| run_id | str | — |
| generation | int | — |
| sim_tick | int | — |
| sim_time_s | float | — |
| sequence | int | — |
| captured_monotonic_ns | int | — |
| world_revision | int | — |
| catalog_revision | int | — |
| catalog_content_sha256 | str | — |
| attachment_revision | int | — |
| entity_states | tuple[EntityState, ...] | — |
| link_states | tuple[LinkState, ...] | — |
| articulation_states | tuple[ArticulationState, ...] | — |
| attachments | tuple[AttachmentState, ...] | — |
class SceneDeltaKind(StrEnum)当前源码未提供公开 docstring。
class SceneDelta(object)One bounded scene change; no geometry payload is permitted by shape.
| 字段 | 类型 | 默认值 |
|---|---|---|
| run_id | str | — |
| generation | int | — |
| sim_tick | int | — |
| sim_time_s | float | — |
| sequence | int | — |
| captured_monotonic_ns | int | — |
| base_sequence | int | — |
| previous_world_revision | int | — |
| world_revision | int | — |
| previous_catalog_revision | int | — |
| catalog_revision | int | — |
| previous_catalog_content_sha256 | str | None | — |
| catalog_content_sha256 | str | None | — |
| previous_attachment_revision | int | — |
| attachment_revision | int | — |
| kind | SceneDeltaKind | — |
| added_entities | tuple[EntityDescriptor, ...] | () |
| removed_entity_ids | tuple[str, ...] | () |
| added_links | tuple[LinkDescriptor, ...] | () |
| removed_link_ids | tuple[str, ...] | () |
| added_articulations | tuple[ArticulationDescriptor, ...] | () |
| removed_articulation_entity_ids | tuple[str, ...] | () |
| entity_states | tuple[EntityState, ...] | () |
| link_states | tuple[LinkState, ...] | () |
| articulation_states | tuple[ArticulationState, ...] | () |
| attachments | tuple[AttachmentState, ...] | () |
| removed_attachment_ids | tuple[str, ...] | () |
| resync_required | bool | False |
validate_scene_state_against(catalog: SceneCatalogSnapshot, state: SceneStateSnapshot) -> NoneValidate one committed state against its exact scoped static catalog.
validate_scene_delta_against(catalog: SceneCatalogSnapshot, state: SceneStateSnapshot, delta: SceneDelta) -> NoneValidate a delta's base identity before a provider applies its payload.
class SceneQueryErrorCode(StrEnum)当前源码未提供公开 docstring。
class SceneQueryError(RuntimeError)Typed bounded failure from ``fastsim.scene.query@3``.
class SceneDeltaSubscription(Protocol)当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
class SceneQueryService(Protocol)Capability-scoped read-only entity catalog and committed state.
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。
当前源码未提供公开 docstring。