Lucrul cu seturile de date
Fiecare sesiune de teleoperare pe AY-Robots produce date demonstrative structurate în format LeRobot, formatul de schimb de facto pentru datele de manipulare. Această pagină explică ce conține un set de date, cum să inspectați și să curatoriați episoade în panoul de control, cum funcționează îmbinarea și cum se încadrează piața.
Ultima actualizare 2026-08-09
Formatul setului de date LeRobot
AY-Robots stochează toate datele demonstrative în formatul setului de date LeRobot, întreținut de Hugging Face. Avantajul practic este portabilitatea: un set de date înregistrat aici se încarcă direct în cod de antrenare bazat pe LeRobot, iar seturile de date înregistrate în altă parte, în același format, pot fi încărcate și folosite pe platformă fără conversie.
Un set de date este o colecție de episoade. Un episod este o încercare completă a unei sarcini, de la o stare de start definită până la punctul în care ați oprit înregistrarea. Pe disc, un episod este împărțit în trei tipuri de fișiere: un fișier Parquet cu fluxurile numerice, un fișier video per cameră și metadate care leagă totul.
| Cale | Conținut |
|---|---|
| data/.../episode_XXXXXX.parquet | Un fișier Parquet per episod: marcaje temporale, stare de observație și acțiuni, cadru cu cadru |
| videos/... | Un MP4 per cameră și episod, aliniat la cadru cu datele Parquet |
| meta/info.json | Metadate la nivel de set de date: tipul robotului, fps, schema de feature-uri și numărul de episoade și cadre |
| meta/episodes.jsonl | O linie per episod, cu indexul, lungimea și sarcina căreia îi aparține |
| meta/tasks.jsonl | Textele sarcinilor în limbaj natural, la care episoadele fac referire prin index |
Schema de feature-uri din info.json este ceea ce citește codul de antrenare pentru a înțelege datele dumneavoastră: ce chei de observație există, formele lor și rata de înregistrare. Două seturi de date sunt compatibile doar dacă schemele lor coincid, și exact asta verifică validarea de îmbinare.
Valorile articulațiilor sunt procente, nu grade
Toate valorile articulațiilor din seturile de date AY-Robots sunt normalizate LeRobot: fiecare valoare variază între -100 și 100 și reprezintă un procent din intervalul calibrat al articulației respective, nu un unghi în grade. O valoare de 0 este centrul intervalului calibrat, iar -100 și 100 sunt limitele sale.
Punctele zero ale servomotoarelor diferă între brațele fizice, astfel încât unghiurile brute de la două unități SO-100 descriu poziții diferite. Normalizarea la intervalul calibrat face înregistrările comparabile între brațe și este exact ceea ce așteaptă pipeline-urile de antrenare LeRobot. Dacă aveți nevoie de unghiuri pentru propriile instrumente, convertiți folosind propriile date de calibrare; platforma nu stochează grade.
Seturi de date în cloud în panoul de control
Dashboard > Datasets listează seturile dumneavoastră de date din cloud, cu numărul de episoade, dimensiunile fișierelor și starea colectării. Seturile de date sunt create automat atunci când o sesiune de teleoperare înregistrează date, și puteți crea și unul explicit, apoi îl puteți popula încărcând înregistrări din clientul desktop.
- Creare: seturile de date noi apar automat din sesiuni, sau creați unul gol și încărcați în el.
- Redenumire: schimbați numele afișat oricând; schimbarea nu afectează datele în sine.
- Ștergere: elimină setul de date și toate episoadele și fișierele sale. Ștergerea este permanentă, deci descărcați mai întâi o arhivă dacă ați putea avea nevoie de date din nou.
Browserul de episoade
Deschiderea unui set de date vă duce în browserul de episoade. Fiecare episod are un player video pentru fluxurile sale de la camere și grafice sincronizate ale articulațiilor, care afișează valorile normalizate ale articulațiilor pe parcursul episodului. Derularea videoclipului mișcă și cursorul graficului odată cu el, ceea ce face rapidă identificarea problemelor: o apropiere sacadată apare ca vârfuri în grafice, o prindere eșuată este vizibilă pe canalul gripper-ului chiar înainte de a viziona videoclipul.
Etichete de episod: Success, Recovery, Failure
Fiecare episod poate purta una dintre trei etichete. Success marchează o demonstrație curată a sarcinii. Recovery marchează un episod în care ceva a mers greșit în timpul încercării, iar dumneavoastră ați corectat; astfel de episoade sunt valoroase pentru că învață o policy cum să revină pe drumul cel bun. Failure marchează episoadele care nu au atins obiectivul și, de regulă, ar trebui să rămână în afara antrenării. Etichetarea în timpul revizuirii este mult mai ieftină decât depanarea unei policy care a învățat în tăcere din demonstrații proaste.
Îmbinarea seturilor de date
Îmbinarea combină mai multe înregistrări într-un singur set de date mai mare, de exemplu o săptămână de sesiuni pe aceeași sarcină sau înregistrări de la două brațe calibrate. Îmbinarea acceptă mai multe arhive tar.gz, fiecare conținând un set de date LeRobot, și produce un singur set de date cu episoade reindexate.
- 1Pregătiți arhivele
Fiecare intrare trebuie să fie un set de date LeRobot complet, împachetat ca arhivă tar.gz, inclusiv directorul meta. Arhivele parțiale, fără info.json, nu pot fi validate și sunt respinse.
- 2Încărcați mai multe arhive
În Dashboard > Datasets, porniți o îmbinare și selectați într-un singur pas toate arhivele tar.gz pe care vreți să le combinați.
- 3Validare
Platforma verifică dacă fps, schema de feature-uri și robot_type coincid pe toate intrările. Dacă oricare dintre cele trei diferă, îmbinarea este respinsă cu neconcordanța precizată, pentru că un set de date combinat cu fluxuri inconsistente ar corupe silențios antrenarea.
- 4Revizuiți rezultatul
Setul de date îmbinat apare în lista dumneavoastră cu numărul combinat de episoade. Deschideți browserul de episoade și verificați prin sondaj câteva episoade din fiecare sursă înainte de a antrena pe el.
Cele trei reguli de compatibilitate sunt stricte intenționat. Neconcordanțele de rată de cadre schimbă sensul fiecărui pas temporal, neconcordanțele de schemă strică direct loaderele, iar amestecarea tipurilor de roboți produce un set de date pe care nicio policy singulară nu poate acționa. Combinarea datelor de la brațe diferite ale aceluiași model este, în schimb, în regulă: robot_type se referă la model, nu la unitatea fizică.
Piața de seturi de date
Piața vă permite să cumpărați seturi de date înregistrate de alții și să le vindeți pe ale dumneavoastră. Seturile de date cumpărate ajung în panoul dumneavoastră de control în aceeași structură LeRobot ca și înregistrările proprii, deci funcționează cu browserul de episoade, îmbinarea și antrenarea fără pași suplimentari.
Dacă vindeți, curatoriați înainte de a lista. Revizuiți episoadele, etichetați onest și asigurați-vă că textele sarcinilor descriu ce se întâmplă efectiv în înregistrări. Un cumpărător care evaluează setul dumneavoastră de date vede același browser de episoade ca dumneavoastră, iar seturile de date cu etichete curate și demonstrații consecvente valorează mai mult decât o grămadă brută a tot ce ați înregistrat vreodată.
Întrebări frecvente
Cât de mare este un episod tipic?▾
Aproximativ 5 până la 15 MB pentru un episod de 10 până la 20 de secunde cu două camere la 30 fps, în funcție de complexitatea scenei. Un set de date serios cu câteva sute de episoade ajunge în ordinul câtorva gigabytes.
Îmi pot descărca seturile de date?▾
Da. Seturile de date pot fi descărcate ca arhive din panoul de control. Deoarece structura este LeRobot standard, descărcarea funcționează direct cu instrumentele LeRobot și cu propriul dumneavoastră cod de antrenare.
Pot îmbina seturi de date de la tipuri diferite de roboți?▾
Nu. Îmbinarea necesită ca fps, schema de feature-uri și robot_type să coincidă pe toate intrările. Datele de la două brațe fizice diferite ale aceluiași model pot fi îmbinate, cu condiția ca ambele brațe să fi fost calibrate.
Graficele articulațiilor arată grade?▾
Nu. Toate valorile articulațiilor sunt normalizate LeRobot la intervalul -100 până la 100, exprimate ca procent din intervalul calibrat al fiecărei articulații. Exact asta este stocat și în fișierele Parquet.
Ce se întâmplă când șterg un set de date?▾
Setul de date și toate episoadele, videoclipurile și metadatele sale sunt eliminate permanent. Nu există anulare, deci descărcați mai întâi o arhivă dacă nu sunteți sigur.
Antrenați ACT, Diffusion Policy, SmolVLA și fine-tune-uri GR00T pe seturile de date de teleoperare, apoi rulați policy pe propriul braț robotic.
Instalați aplicația desktop AY-Robots pe macOS, Windows sau Linux, înregistrați episoade SO-100 prin fluxul ghidat și exportați date LeRobot.