Skip to content

README.md

Latest commit

 

History

History
46 lines (33 loc) · 1.7 KB

README.md

File metadata and controls

46 lines (33 loc) · 1.7 KB

Task Utility Scripts

These scripts generate metadata and statistics for task libraries. They work with any task directory — point --tasks-folder at your own library the same way RoboLab uses them internally.

For full documentation and usage examples, see Task Libraries.

Generate task metadata (JSON, CSV, README table)

python robolab/tasks/_utils/generate_task_metadata.py \
    --tasks-folder /path/to/your/tasks \
    --output-folder /path/to/your/tasks/_metadata \
    --subfolders pick_place stacking

If --tasks-folder is omitted, defaults to TASK_DIR (the built-in task library). If --subfolders is omitted, scans all subfolders.

View task statistics

python robolab/tasks/_utils/compute_task_statistics.py \
    --metadata-file /path/to/your/tasks/_metadata/task_metadata.json

# Full comprehensive report
python robolab/tasks/_utils/compute_task_statistics.py --verbose

# Individual sections
python robolab/tasks/_utils/compute_task_statistics.py --objects     # Object frequency
python robolab/tasks/_utils/compute_task_statistics.py --subtasks    # Subtask complexity
python robolab/tasks/_utils/compute_task_statistics.py --episodes    # Episode length analysis
python robolab/tasks/_utils/compute_task_statistics.py --difficulty   # Difficulty scoring
python robolab/tasks/_utils/compute_task_statistics.py --by-scene    # Tasks grouped by scene

# Save report to file
python robolab/tasks/_utils/compute_task_statistics.py --verbose --save

Programmatic access

load_task_info.py provides importable helpers for extracting metadata from task classes:

from robolab.tasks._utils.load_task_info import extract_task_metadata