Stability analysis

Use task_type stability to estimate whether a placement or object state is physically stable.

What it answers

If it is placed like this, does it stay put?

task_type: stability

What to send

input.object_idstring

The object whose stability is in question.

input.cad_sceneobject

Geometry including the supporting surfaces. point_cloud_scene also works.

Every field on the request schema is still accepted; these are the ones this task depends on.

What comes back

stability_result.stable

Whether the placement holds.

stability_result.support

Contact area and supporting entities.

stability_result.risks

Constraints that would make it fail.

Example

Terminal

$ curl https://fourechelon.com/api/v1/responses \
    -H "Authorization: Bearer $FOUR_ECHELON_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
$     "model": "rowe-1.0",
$     "input": {
$       "task_type": "stability",
$       "object_id": "fixture",
$       "cad_scene": { "schema": "four-cad.cad_scene.v1", "solids": [] }
$     }
$   }'

Worth knowing

This is a geometric stability estimate over the supplied scene. It is not a rigid-body simulation and carries no dynamic, friction, or material model.