Datasetien käyttö

Jokainen AY-Robotsin teleoperointi-istunto tuottaa strukturoitua demonstraatiodataa LeRobot-muodossa, joka on manipulaatiodatan tosiasiallinen vaihtomuoto. Tämä sivu selittää, mitä dataset sisältää, miten episodeja tarkastellaan ja kuratoidaan dashboardissa, miten yhdistäminen toimii ja miten markkinapaikka liittyy kokonaisuuteen.

Viimeksi päivitetty 2026-08-09

LeRobot-datasetin muoto

AY-Robots tallentaa kaiken demonstraatiodatan Hugging Facen ylläpitämässä LeRobot-datasetmuodossa. Käytännön hyöty on siirrettävyys: täällä tallennettu dataset latautuu suoraan LeRobot-pohjaiseen koulutuskoodiin, ja muualla samassa muodossa tallennetut datasetit voidaan ladata alustalle ja käyttää siellä ilman muunnosta.

Dataset on kokoelma episodeja. Yksi episodi on yksi täydellinen yritys tehtävään, määritellystä alkutilasta siihen pisteeseen, jossa lopetit tallennuksen. Levyllä episodi jakautuu kolmenlaisiin tiedostoihin: Parquet-tiedosto numeerisille virroille, yksi videotiedosto per kamera, sekä metadata, joka sitoo kaiken yhteen.

PolkuSisältö
data/.../episode_XXXXXX.parquetYksi Parquet-tiedosto per episodi: kuva kuvalta aikaleimat, havaintotila ja toiminnot
videos/...Yksi MP4 per kamera per episodi, kuvatasolla synkronoitu Parquet-datan kanssa
meta/info.jsonDatasetin tason metadata: robottityyppi, fps, ominaisuusskeema sekä episodien ja kuvien määrät
meta/episodes.jsonlYksi rivi per episodi sen indeksillä, pituudella ja tehtävällä, johon se kuuluu
meta/tasks.jsonlLuonnollisen kielen tehtävämerkkijonot, joihin episodit viittaavat indeksin kautta

info.json-tiedoston ominaisuusskeema on se, mitä koulutuskoodi lukee ymmärtääkseen datasi: mitkä havaintoavaimet ovat olemassa, niiden muodot ja tallennusnopeus. Kaksi datasetiä ovat yhteensopivia vain, jos niiden skeemat täsmäävät, ja juuri sitä yhdistämisen validointi tarkistaa.

Nivelarvot ovat prosentteja, eivät asteita

Kaikki AY-Robotsin datasetien nivelarvot ovat LeRobot-normalisoituja: jokainen arvo vaihtelee välillä -100-100 ja edustaa prosenttiosuutta kyseisen nivelen kalibroidusta alueesta, ei astekulmaa. Arvo 0 on kalibroidun alueen keskikohta, -100 ja 100 ovat sen rajat.

Miksi normalisoidut arvot ovat oikea oletus

Servojen nollakohdat vaihtelevat fyysisten käsivarsien välillä, joten kahden SO-100-yksikön raa'at asteet kuvaavat eri asentoja. Normalisointi kalibroituun alueeseen tekee tallenteista vertailukelpoisia käsivarsien välillä, ja se on se, mitä LeRobot-koulutusputket odottavat. Jos tarvitset asteita omiin työkaluihisi, muunna kalibrointidatasi avulla; alusta ei tallenna asteita.

Pilvidatasetit dashboardissa

Dashboard > Datasets listaa pilvidatasetisi episodimäärineen, tiedostokokoineen ja keräystilanteineen. Datasetit luodaan automaattisesti, kun teleoperointi-istunto tallentaa dataa, ja voit myös luoda yhden nimenomaisesti ja täyttää sen lataamalla tallenteita työpöytäsovelluksesta.

  • Luo: uudet datasetit ilmestyvät istunnoista automaattisesti, tai luo tyhjä ja lataa siihen.
  • Nimeä uudelleen: vaihda näyttönimeä milloin tahansa; muutos ei koske itse dataa.
  • Poista: poistaa datasetin ja kaikki sen episodit ja tiedostot. Poistaminen on pysyvää, joten lataa arkisto ensin, jos saatat tarvita dataa vielä myöhemmin.

Episodiselain

Datasetin avaaminen vie sinut episodiselaimeen. Jokaisessa episodissa on videosoitin sen kameravirroille ja synkronoidut nivelkaaviot, jotka piirtävät normalisoidut nivelarvot episodin ajalta. Videon selaaminen liikuttaa kaavion kursoria mukana, mikä tekee ongelmien havaitsemisesta nopeaa: nykivä lähestyminen näkyy piikkeinä kaavioissa, epäonnistunut tarttuminen näkyy tarraimen kanavassa jo ennen kuin edes katsot videota.

Episodien merkinnät: Success, Recovery, Failure

Jokainen episodi voi kantaa yhtä kolmesta merkinnästä. Success merkitsee tehtävän puhdasta demonstraatiota. Recovery merkitsee episodia, jossa jokin meni pieleen kesken yrityksen ja korjasit sen; nämä ovat arvokkaita, koska ne opettavat policylle, miten palata takaisin oikealle radalle. Failure merkitsee episodeja, jotka eivät saavuttaneet tavoitetta ja jotka pitäisi yleensä jättää koulutuksen ulkopuolelle. Merkitseminen tarkastuksen yhteydessä on paljon halvempaa kuin sellaisen policyn virheenjäljitys, joka on hiljaa oppinut huonoista demonstraatioista.

Datasetien yhdistäminen

Yhdistäminen yhdistää useita tallenteita yhdeksi suuremmaksi datasetiksi, esimerkiksi viikon istunnot samasta tehtävästä tai tallenteet kahdesta kalibroidusta käsivarresta. Yhdistäminen ottaa useita tar.gz-arkistoja, joista jokainen sisältää yhden LeRobot-datasetin, ja tuottaa yhden datasetin, jossa episodit on indeksoitu uudelleen.

  1. 1
    Valmistele arkistot

    Jokaisen syötteen täytyy olla täydellinen LeRobot-dataset pakattuna tar.gz-arkistoksi, mukaan lukien sen meta-hakemisto. Osittaisia arkistoja ilman info.json-tiedostoa ei voida validoida, ja ne hylätään.

  2. 2
    Lataa useita arkistoja

    Aloita yhdistäminen kohdassa Dashboard > Datasets ja valitse kaikki yhdistettävät tar.gz-arkistot yhdellä kertaa.

  3. 3
    Validointi

    Alusta tarkistaa, että fps, ominaisuusskeema ja robot_type täsmäävät kaikissa syötteissä. Jos jokin näistä kolmesta eroaa, yhdistäminen hylätään ja poikkeama nimetään, koska yhdistetty dataset, jossa on epäjohdonmukaisia virtoja, turmelisi koulutuksen huomaamatta.

  4. 4
    Tarkista tulos

    Yhdistetty dataset ilmestyy listaasi yhdistetyllä episodimäärällä. Avaa episodiselain ja pistokoetarkasta muutama episodi kustakin lähteestä ennen kuin koulutat sillä.

Nämä kolme yhteensopivuussääntöä ovat tarkoituksella tiukkoja. Kuvataajuuden erot muuttavat jokaisen aika-askeleen merkityksen, skeemaerot rikkovat latausohjelmat suoraan, ja robottityyppien sekoittaminen tuottaa datasetin, jolla mikään yksittäinen policy ei voi toimia. Jos sinun täytyy yhdistää dataa saman mallin eri käsivarsista, se on ihan sallittua: robot_type viittaa malliin, ei fyysiseen yksikköön.

Datasetien markkinapaikka

Markkinapaikan avulla voit ostaa muiden tallentamia dataseteja ja myydä omiasi. Ostetut datasetit saapuvat dashboardiisi samassa LeRobot-asettelussa kuin omat tallenteesi, joten ne toimivat episodiselaimen, yhdistämisen ja koulutuksen kanssa ilman lisävaiheita.

Jos myyt, kuratoi ennen listaamista. Tarkista episodit, merkitse ne rehellisesti, ja varmista, että tehtävämerkkijonot kuvaavat sitä, mitä tallenteissa todella tapahtuu. Ostaja, joka arvioi datasetiäsi, näkee saman episodiselaimen kuin sinä, ja datasetit, joissa on siistit merkinnät ja johdonmukaiset demonstraatiot, ovat arvokkaampia kuin raa'at kaatopaikat kaikesta koskaan tallentamastasi.

Usein kysytyt kysymykset

Kuinka suuri tyypillinen episodi on?

Noin 5-15 Mt 10-20 sekunnin episodille kahdella kameralla 30 fps:llä, riippuen näkymän monimutkaisuudesta. Vakavasti otettava dataset muutamalla sadalla episodilla asettuu muutamaan gigatavuun.

Voinko ladata datasetini itselleni?

Kyllä. Datasetit voi ladata arkistoina dashboardista. Koska asettelu on tavallinen LeRobot-muoto, lataus toimii suoraan LeRobot-työkalujen ja oman koulutuskoodisi kanssa.

Voinko yhdistää dataseteja eri robottityypeistä?

Et. Yhdistäminen vaatii, että fps, ominaisuusskeema ja robot_type täsmäävät kaikissa syötteissä. Kahden saman mallin eri fyysisen käsivarren dataa voi yhdistää, kunhan molemmat käsivarret oli kalibroitu.

Näyttävätkö nivelkaaviot asteita?

Eivät. Kaikki nivelarvot ovat LeRobot-normalisoituja välille -100-100, ilmaistuna prosenttiosuutena kunkin nivelen kalibroidusta alueesta. Se on myös tarkalleen se, mitä Parquet-tiedostoihin tallennetaan.

Mitä tapahtuu, kun poistan datasetin?

Dataset ja kaikki sen episodit, videot ja metadata poistetaan pysyvästi. Toimintoa ei voi perua, joten lataa arkisto ensin, jos et ole varma.