The Object Database

Screen reference: browse the object catalog and edit your project's anchors, presets and parts.

The Object Database lists the object types you can use and edits your project's copy of one of them. Open it from Object Database in the sidebar or the Annotate Object tile on the home screen.

The list is the mesh-database catalog your organization can see, with your project's copy of a type taking the place of the catalog's where you have one. Types that exist only in your project, and not in the catalog, are not listed.

Edits are saved into your project, never into the catalog. See Adding an object and Anchors.

The screen has two tabs: Annotate Objects and View Database. The list reloads when the window regains focus.

View Database

A card per type, under N objects in database, with:

  • Anchors, Articulation presets and Parts counts,
  • Tagged units, when the type has per-copy tag sets,
  • URDF and object_model.yaml: whether each file is present.

View Details lists the names of the anchors, presets, parts and tagged units. Edit Annotations → opens the type in the editor. ← Back to Database returns to the cards.

Annotate Objects

Pick a type in Object. Types with neither a URDF nor an object model are listed as (missing URDF and YAML) and cannot be picked. The counts next to the picker read N anchors · N presets · N parts.

Picking a type your project has no copy of copies the catalog's URDF and object model into objects/<type>/ on your instance. The copy reaches the cloud project when you save.

The left pane is a 3D view of the object. The right pane is the editor.

Editor header

  • The type name, and unsaved while there are changes not saved to the project.
  • Advanced: shows the Parts and Presets tabs and a few extra controls. Remembered in your browser.

The tabs are Anchors and Motions, plus Parts and Presets with Advanced on. A Joints section with a slider per joint appears under every tab for an object with joints; it moves the object in the 3D view, so you can author anchors on a lid in its open position.

Anchors tab

ControlWhat it does
AnchorPicks the anchor to edit (searchable).
NewStarts a new anchor. Fill in the fields and click Create anchor.
DuplicateCopies the selected anchor under a new name (default <name>_copy).
DeleteRemoves the anchor from the working object after confirmation. Not permanent until Save to Project.
Hide other anchorsShows only the selected anchor in the 3D view. On by default when an object loads.
Name, Parent link, DescriptionThe anchor's fields.
Pose fieldsX (mm), Y (mm), Z (mm), Roll (°), Pitch (°), Yaw (°), in the frame of the object's object anchor. The file stores the pose relative to the parent link.
Zero, Snap 90°, Copy, Paste, Rotate +90°: X / Y / ZPose helpers.
Revert, Apply poseTyped values are held until you apply them; until you type, the fields follow the gizmo in the 3D view. Revert drops typed values.
Grasp switchMakes the anchor a grasp anchor. Width (m) and Standoff (m) are written into the description as grasp: width ... m, standoff ... m. Copy from… copies another anchor's grasp. Gripper preview and Show pre-grasp shadow are viewing aids and are not saved.
Update anchorApplies the edits of the selected anchor to the working object.

The object anchor always exists and cannot be deleted. Its name and parent are fixed and only its rotation is editable: its origin is placed at the (+X, +Y, -Z) corner of the rotated bounding box.

An amber box warns about problems in the loaded file: an object anchor that does not match its bounding-box corner, removed anchor fields, keys outside the schema, and anchors named like tags.

Viz objects shows another object held in the gripper as a visual aid, in Anchored, Free or Frozen mode. It is not saved.

Motions tab

Lists the motions stored on the object (objects/<type>/motions.yaml), or None recorded yet. Selecting one draws its path in the 3D view; you can edit its description, edit or delete keyposes (positions in mm in the object frame, grip in mm) and Delete motion. Changes are saved with Save to Project.

Recording a motion needs a real arm. In the cloud the recorder shows Arm capture is available on a deployed box only. Skills cannot replay stored motions in this release.

Parts tab (Advanced)

A part is a named set of mesh links. Pick a part or + New..., set Name and Description, select links by clicking meshes in the 3D view or in the list, then Create part or Update part. Delete removes it.

Presets tab (Advanced)

An articulation preset is a named set of joint values. Set the joints with the Joints sliders, pick Included joints, then Create preset or Update preset. A default preset always exists.

Saving

ButtonWhat it does
Update anchorApplies the selected anchor's edits. Save to Project is disabled until you do.
DiscardReloads the object from the project files and drops every unsaved edit.
Save to ProjectWrites the whole object (anchors, parts, presets, motions) into objects/<type>/ and commits it to the cloud project as Update object annotations for <type>.

After a save, the next move of a running world uses the new anchors. If someone pushed to the project while you were editing, the save stops with Project changed, refresh and retry. and nothing is committed: reload the page and save again.

Not available in the cloud

On a deployed box with real arms, the editor also offers Arm capture: authoring anchors and grasp widths from the arm's position (From arm, Width from robot), test moves to the pre-approach, reachability dots, and recording motions. None of these are shown in the cloud app.

Related


Did this page help you?