Arbejde med datasæt
Hver teleoperationssession på AY-Robots skaber struktureret demonstrationsdata i LeRobot-formatet, de facto-udvekslingsformatet for manipulationsdata. Denne side forklarer, hvad der er i et datasæt, hvordan du inspicerer og kuraterer episoder i dashboardet, hvordan fletning fungerer, og hvordan markedspladsen passer ind.
Sidst opdateret 2026-08-09
LeRobot-datasætformatet
AY-Robots gemmer alle demonstrationsdata i LeRobot-datasætformatet, som vedligeholdes af Hugging Face. Den praktiske fordel er portabilitet: et datasæt optaget her indlæses direkte i LeRobot-baseret træningskode, og datasæt optaget andre steder i samme format kan uploades og bruges på platformen uden konvertering.
Et datasæt er en samling af episoder. Én episode er ét komplet forsøg på en opgave, fra en defineret starttilstand til det punkt, hvor du stoppede optagelsen. På disken deles en episode op på tre typer filer: en Parquet-fil med de numeriske streams, én videofil per kamera og metadata, der binder det hele sammen.
| Sti | Indhold |
|---|---|
| data/.../episode_XXXXXX.parquet | Én Parquet-fil per episode: frame-for-frame-tidsstempler, observationstilstand og handlinger |
| videos/... | Én MP4 per kamera per episode, frame-tilpasset med Parquet-dataene |
| meta/info.json | Metadata på datasætniveau: robottype, fps, featureskema samt antal episoder og frames |
| meta/episodes.jsonl | Én linje per episode med dens indeks, længde og den opgave, den tilhører |
| meta/tasks.jsonl | De natursprogede opgavestrenge, som episoder refererer til via indeks |
Featureskemaet i info.json er det, træningskode læser for at forstå dine data: hvilke observationsnøgler der findes, deres former og optagelsesraten. To datasæt er kun kompatible, hvis deres skemaer stemmer overens, hvilket er præcis, hvad fletningsvalideringen tjekker.
Ledværdier er procenter, ikke grader
Alle ledværdier i AY-Robots-datasæt er LeRobot-normaliserede: hver værdi går fra -100 til 100 og repræsenterer en procentdel af det pågældende leds kalibrerede område, ikke en vinkel i grader. En værdi på 0 er midten af det kalibrerede område, -100 og 100 er dets grænser.
Servoernes nulpunkter varierer mellem fysiske arme, så rå vinkler fra to SO-100-enheder beskriver forskellige positioner. At normalisere til det kalibrerede område gør optagelser sammenlignelige på tværs af arme og er, hvad LeRobot-træningspipelines forventer. Har du brug for vinkler til dit eget værktøj, så konverter ud fra dine kalibreringsdata; platformen gemmer ikke grader.
Skydatasæt i dashboardet
Dashboard > Datasets viser dine skydatasæt med episodeantal, filstørrelser og indsamlingsstatus. Datasæt oprettes automatisk, når en teleoperationssession optager data, og du kan også oprette ét eksplicit og fylde det ved at uploade optagelser fra desktopklienten.
- Opret: nye datasæt dukker automatisk op fra sessioner, eller opret ét tomt og upload til det.
- Omdøb: skift visningsnavnet når som helst; ændringen rører ikke selve dataene.
- Slet: fjerner datasættet og alle dets episoder og filer. Sletning er permanent, så download et arkiv først, hvis du kan komme til at få brug for dataene igen.
Episodebrowseren
At åbne et datasæt tager dig til episodebrowseren. Hver episode har en videoafspiller til sine kamerastreams og synkroniserede ledgrafer, der plotter de normaliserede ledværdier gennem episoden. At spole i videoen flytter grafmarkøren med den, hvilket gør det hurtigt at få øje på problemer: en rykvis tilgang viser sig som udsving i graferne, et mislykket greb ses i griberkanalen, før du overhovedet ser videoen.
Episodemærker: Success, Recovery, Failure
Hver episode kan bære ét af tre mærker. Success markerer en ren demonstration af opgaven. Recovery markerer en episode, hvor noget gik galt midtvejs, og du rettede det; disse er værdifulde, fordi de lærer en policy at komme på ret spor igen. Failure markerer episoder, der ikke nåede målet, og som normalt bør holdes ude af træningen. At mærke undervejs, mens du gennemgår, er langt billigere end at fejlfinde en policy, der stille har lært af dårlige demonstrationer.
Fletning af datasæt
Fletning kombinerer flere optagelser til ét større datasæt, for eksempel en uges sessioner på samme opgave eller optagelser fra to kalibrerede arme. Fletningen tager flere tar.gz-arkiver, hver indeholdende ét LeRobot-datasæt, og producerer ét samlet datasæt med genindekserede episoder.
- 1Forbered arkiverne
Hvert input skal være et komplet LeRobot-datasæt pakket som et tar.gz-arkiv, inklusive dets meta-mappe. Delvise arkiver uden info.json kan ikke valideres og afvises.
- 2Upload flere arkiver
I Dashboard > Datasets starter du en fletning og vælger alle de tar.gz-arkiver, du vil kombinere, i ét trin.
- 3Validering
Platformen tjekker, at fps, featureskemaet og robot_type stemmer overens på tværs af alle input. Hvis blot ét af de tre afviger, afvises fletningen med uoverensstemmelsen navngivet, fordi et kombineret datasæt med inkonsistente streams stille ville ødelægge træningen.
- 4Gennemgå resultatet
Det flettede datasæt vises på din liste med det kombinerede episodeantal. Åbn episodebrowseren, og stikprøvetjek nogle episoder fra hver kilde, før du træner på det.
De tre kompatibilitetsregler er bevidst strenge. Uoverensstemmelser i billedrate ændrer betydningen af hvert tidstrin, skemaafvigelser bryder loaders helt, og blanding af robottyper giver et datasæt, som ingen enkelt policy kan handle på. Har du brug for at kombinere data fra forskellige arme af samme model, er det fint: robot_type refererer til modellen, ikke den fysiske enhed.
Markedspladsen for datasæt
Markedspladsen lader dig købe datasæt optaget af andre og sælge dine egne. Købte datasæt ankommer til dit dashboard i samme LeRobot-layout som dine egne optagelser, så de fungerer med episodebrowseren, fletning og træning uden ekstra trin.
Sælger du, så kurater før du lister. Gennemgå episoderne, mærk dem ærligt, og sørg for, at opgavestrengene beskriver, hvad der reelt sker i optagelserne. En køber, der vurderer dit datasæt, ser den samme episodebrowser som dig, og datasæt med rene mærker og konsistente demonstrationer er mere værd end rå dumps af alt, du nogensinde har optaget.
Ofte stillede spørgsmål
Hvor stor er en typisk episode?▾
Cirka 5 til 15 MB for en 10 til 20 sekunder lang episode med to kameraer ved 30 fps, afhængigt af scenens kompleksitet. Et seriøst datasæt med et par hundrede episoder lander i de lave gigabyte.
Kan jeg downloade mine datasæt?▾
Ja. Datasæt kan downloades som arkiver fra dashboardet. Da layoutet er standard LeRobot, virker downloadet direkte med LeRobot-værktøjer og din egen træningskode.
Kan jeg flette datasæt fra forskellige robottyper?▾
Nej. Fletningen kræver, at fps, featureskemaet og robot_type stemmer overens på tværs af alle input. Data fra to forskellige fysiske arme af samme model kan flettes, forudsat at begge arme var kalibrerede.
Viser ledgraferne grader?▾
Nej. Alle ledværdier er LeRobot-normaliserede til intervallet -100 til 100, udtrykt som en procentdel af hvert leds kalibrerede område. Det er også præcis, hvad der gemmes i Parquet-filerne.
Hvad sker der, når jeg sletter et datasæt?▾
Datasættet og alle dets episoder, videoer og metadata fjernes permanent. Der er ingen fortryd, så download et arkiv først, hvis du ikke er sikker.
Træn ACT, Diffusion Policy, SmolVLA og GR00T-finjusteringer på dine teleoperationsdatasæt i skyen, og kør derefter den trænede policy på din egen arm.
Installer AY-Robots-desktopappen på macOS, Windows eller Linux, optag SO-100-episoder med det guidede forløb, eksporter LeRobot-data, og brug CLI'et og MCP.