Skip to content

docs: add specific data and annotation quality docs - #568

Open
fkhan0520 wants to merge 2 commits into
GaTech-RL2:mainfrom
shotwellai:shotwell/qa-docs
Open

docs: add specific data and annotation quality docs#568
fkhan0520 wants to merge 2 commits into
GaTech-RL2:mainfrom
shotwellai:shotwell/qa-docs

Conversation

@fkhan0520

@fkhan0520 fkhan0520 commented Aug 13, 2026

Copy link
Copy Markdown

Expanded relevant parts of section 2 of CONTRIBUTING_DATA.md into DATA_QUALITY.md and section 8 into ANNOTATIONS.md

Comment thread DATA_QUALITY.md Outdated
| --- | --- | --- |
| Task Type | no more than ~5% navigation · ~10% mobile manipulation · ~85% manipulation | **Navigation:** walking, running, biking<br/>**Mobile Manipulation:** moving dishes from dining room to kitchen **** |
| Dexterity | ~60% doable with a parallel-jaw gripper · ~40% doable by either a parallel-jaw gripper or a dexterous hand | **Parallel Gripper:** pick and place, laundry folding<br/>**Dexterous Hand:** screwing on/off a bottle cap, |
| Environment | X% Kitchen, Y% Industrial, Z% bedroom | TODO |

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rpuns What should we prescribe here in terms of diversity

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gut reaction is that we should monitor this, but it's hard to prescribe bc some vendors will only be able to collect in certain locations, and we don't want to deny their data

Comment thread ANNOTATIONS.md Outdated

As a rule of thumb, all annotation spans should be between 1-10 seconds long. The hand-object rule and the 1-10s rule may disagree in certain cases. Here are some common ones and how to resolve them

| **Action** | **Preferred Span(s)** |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good examples!

Comment thread ANNOTATIONS.md Outdated
@@ -0,0 +1,30 @@
# EgoVerse Annotation Guide

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's have this read a bit more like a gradable rubric, and explain the scoring pattern, ie for each span we'll check x rubric items, and require that num_correct_spans/total_spans > 90% or smth.

Let's also add a small section for our gradable but not failing criteria, like the actions ending exactly when contact is broken

Comment thread DATA_QUALITY.md Outdated

The operator completing the task should abide by the following behavior, regardless of the task, environment, or collection device:

- Hands must be visible in all frames

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rpuns for egoverse should we keep mandating all frames?

Comment thread DATA_QUALITY.md Outdated

| **Dimension** | **Target Mix** | **Notes/Examples** |
| --- | --- | --- |
| Task Type | no more than ~5% navigation · ~10% mobile manipulation · ~85% manipulation | **Navigation:** walking, running, biking<br/>**Mobile Manipulation:** moving dishes from dining room to kitchen **** |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's just get rid of pure navigation entirely and say 15% mobile manip, bc we don't want any biking :)

Comment thread DATA_QUALITY.md Outdated
| --- | --- | --- |
| Task Type | no more than ~5% navigation · ~10% mobile manipulation · ~85% manipulation | **Navigation:** walking, running, biking<br/>**Mobile Manipulation:** moving dishes from dining room to kitchen **** |
| Dexterity | ~60% doable with a parallel-jaw gripper · ~40% doable by either a parallel-jaw gripper or a dexterous hand | **Parallel Gripper:** pick and place, laundry folding<br/>**Dexterous Hand:** screwing on/off a bottle cap, |
| Environment | X% Kitchen, Y% Industrial, Z% bedroom | TODO |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gut reaction is that we should monitor this, but it's hard to prescribe bc some vendors will only be able to collect in certain locations, and we don't want to deny their data

Comment thread DATA_QUALITY.md

The operator completing the task should abide by the following behavior, regardless of the task, environment, or collection device:

- Hands must be visible in 90% of frames

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think @rpuns mentioned this on our call. I forget if it was 1 hand or both hands

Comment thread DATA_QUALITY.md
| **Dimension** | **Target Mix** | **Notes/Examples** |
| --- | --- | --- |
| Task Type | ~15% mobile manipulation · ~85% manipulation | **Navigation:** walking, running, biking<br/>**Mobile Manipulation:** moving dishes from dining room to kitchen |
| Dexterity | ~60% doable with a parallel-jaw gripper · ~40% doable by either a parallel-jaw gripper or a dexterous hand | **Parallel Gripper:** pick and place, laundry folding<br/>**Dexterous Hand:** screwing on/off a bottle cap|

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: removed any mention of environment diversity

Comment thread DATA_QUALITY.md

The episode should depict a task as if it were done by an expert. This means the **task goal is completed without mistakes, wasted actions, idle time, or repetition.** Here are some examples of proficient and non-proficient executions of the X task:

- Proficient:

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SimarKareer @rpuns let me know if you have some handy examples here

Comment thread DATA_QUALITY.md

## Technical Proficiency

The episode should not have any bugs or glitches. Some examples of this include:

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here as well

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants