Worlds and objects
Object types, instances, worlds, setups and anchors, and how they fit together.
A skill never contains coordinates. It names objects and places on them, and the platform resolves those names against the world loaded at run time. Five terms carry that:
| Term | What it is | Where it lives |
|---|---|---|
| Object type | A kind of thing: its shape, joints and anchors. wellplate_stand, wellplate_shaker. | objects/<type>/ in your project, or the mesh database |
| Instance | One object of a type in a world, with an id, a display name and a pose. wellplate_stand_1. | The world |
| World | The scene: tables and instances with their poses. | worlds/<id>/ |
| Setup | The robot rig: the arms, their grippers and where their bases stand. | Named by setup in project.json |
| Anchor | A named frame on an object type: a grasp point, a slot, a seat. top_center, slot_1. | The type's object_model.yaml |
How they connect:
- A world places instances of types. The type's files come from your project's
objects/<type>/first, then from the mesh database. One type, many instances: the starter world has twowellplate_standinstances. - Tables are instances of the world too. A world owns its tables; the setup provides none.
- A world is laid out in the frame of one setup: the coordinates are relative to that rig's arm bases.
- A skill receives instances as inputs and asks for anchors by name.
anchor(plate, "grasp_short")returns where that grasp is in the world now.
The usual order of work:
- Get the object types you need into your project, or rely on the catalog.
- Build a world: place instances on the tables and save it.
- Write skills against anchor names, and pick the world when you run.
Pages in this section
File formats
| File | Covers |
|---|---|
worlds/<id>/world_state.json | Starting layouts and saved worlds |
worlds/<id>/live_state.yaml | Tip pointers, seats, per-seat calibration |
objects/<name>/<name>.object_model.yaml | Parts, articulation presets, anchors |
project.json | Default workflow and world, and the setup |
viewer.yaml | Named camera views for zeon look |
Updated 9 days ago
Did this page help you?