import{s as ws,n as Is,o as cs}from"../chunks/scheduler.f7e1785c.js";import{S as As,i as ds,g as a,s as n,r as f,A as ms,h as y,f as l,c as t,j as js,u as S,x as U,k as Cs,y as hs,a as M,v as b,d as Q,t as D,w as v}from"../chunks/index.9f8f0838.js";import{C as x}from"../chunks/CodeBlock.b3510e34.js";import{H as gs,E as qs}from"../chunks/EditOnGithub.5a9bb8c5.js";function Es(ns){let u,V,B,Z,i,k,o,ts=`L’un des plus grands défis auxquels sont confrontés les ensembles de données audio est leur taille.
Une seule minute d’audio non compressé de qualité CD (44,1 kHz, 16 bits) occupe un peu plus de 5 Mo de stockage. En règle générale, un jeu de données audio contient des heures d’enregistrements.
Dans les sections précédentes, nous avons utilisé un très petit sous-ensemble de jeux de données audio MINDS-14, mais les jeux de données audio typiques sont beaucoup plus volumineux.
Par exemple, la configuration <code>xs</code> (la plus petite) de <a href="https://huggingface.co/datasets/speechcolab/gigaspeech" rel="nofollow">GigaSpeech de SpeechColab</a> ne contient que 10 heures de données d’entraînement, mais prend plus de 13 Go d’espace de stockage pour le téléchargement et la préparation.
Alors, que se passe-t-il lorsque nous voulons nous entraîner sur un split plus grand ?
La configuration <code>xl</code> complète du même jeu de données contient 10 000 heures de données d’entraînement, nécessitant plus de 1 To d’espace de stockage.
Pour la plupart d’entre nous, cela dépasse largement les spécifications d’un disque dur typique. Devons-nous débourser et acheter du stockage supplémentaire ? Ou existe-t-il un moyen de nous entraîner sur ces ensembles de données sans contraintes d’espace disque ?`,z,T,as=`🤗 <em>Datasets</em> vient à la rescousse en proposant le mode <a href="https://huggingface.co/docs/datasets/stream" rel="nofollow">streaming</a>.
Le streaming nous permet de charger les données progressivement au fur et à mesure que nous itérons sur le jeu de données. Plutôt que de télécharger l’ensemble du jeu de données en une seule fois, nous chargeons le jeu de données un exemple à la fois.
Nous itérons sur le jeu de données, chargeant et préparant des exemples à la volée lorsqu’ils sont nécessaires. De cette façon, nous ne chargeons que les exemples que nous utilisons, et non ceux que nous ne sommes pas !
Une fois que nous avons terminé avec un exemple d’exemple, nous continuons à itérer sur le jeu de données et chargeons le suivant.
Le mode streaming présente trois avantages principaux par rapport au téléchargement simultané de l’ensemble du jeu de données :`,_,J,ys="<li>Espace disque : les exemples sont chargés en mémoire un par un au fur et à mesure que nous itérons sur l’ensemble de données. Étant donné que les données ne sont pas téléchargées localement, il n’y a pas d’espace disque requis, vous pouvez donc utiliser des jeux de données de taille arbitraire.</li> <li>Temps de téléchargement et de traitement: les ensembles de données audio sont volumineux et nécessitent beaucoup de temps pour être téléchargés et traités. Avec le streaming, le chargement et le traitement se font à la volée, ce qui signifie que vous pouvez commencer à utiliser le jeu de données dès que le premier exemple est prêt.</li> <li>Expérimentation facile : vous pouvez expérimenter sur une poignée d’exemples pour vérifier que votre script fonctionne sans avoir à télécharger l’ensemble du jeu de données.</li>",R,p,Us=`Il y a une mise en garde au mode streaming. Lors du téléchargement d’un jeu de données complet sans streaming, les données brutes et les données traitées sont enregistrées localement sur le disque.
Si nous voulons réutiliser ce jeu de données, nous pouvons charger directement les données traitées à partir du disque, en sautant les étapes de téléchargement et de traitement.<br/>
Par conséquent, nous ne devons effectuer les opérations de téléchargement et de traitement qu’une seule fois, après quoi nous pouvons réutiliser les données préparées.`,L,r,us=`Avec le mode streaming, les données ne sont pas téléchargées sur le disque. Ainsi, ni les données téléchargées ni les données prétraitées ne sont mises en cache.
Si nous voulons réutiliser le jeu de données, les étapes de streaming doivent être répétées, avec les fichiers audio chargés et traités à nouveau à la volée.
Pour cette raison, il est conseillé de télécharger des jeux de données que vous êtes susceptible d’utiliser plusieurs fois.`,F,j,is="Comment activer le mode streaming ? Facile! Il suffit de définir <code>streaming=True</code> lorsque vous chargez votre jeu de données. Le reste sera pris en charge pour vous :",Y,C,$,w,os=`Tout comme nous avons appliqué des étapes de prétraitement à un sous-ensemble téléchargé de MINDS-14, vous pouvez effectuer le même prétraitement avec un jeu de données en streaming exactement de la même manière.
La seule différence est que vous ne pouvez plus accéder à des échantillons individuels à l’aide de l’indexation Python (c’est-à-dire <code>gigaspeech[&quot;train&quot;][sample_idx]</code>).
Au lieu de cela, vous devez itérer sur le jeu de données. Voici comment accéder à un exemple lors de la diffusion en continu d’un jeu de données :`,W,I,G,c,Ts="<strong>Sortie :</strong>",X,A,H,d,Js="Si vous souhaitez prévisualiser plusieurs exemples d’un grand jeu de données, utilisez <code>take()</code> pour obtenir les $n$ premiers éléments. Prenons les deux premiers exemples dans le jeu de données gigaspeech :",O,m,P,h,ps="<strong>Sortie :</strong>",K,g,ss,q,rs=`Le mode streaming peut faire passer vos recherches au niveau supérieur : non seulement les plus grands jeux de données vous sont accessibles mais vous pouvez facilement évaluer les systèmes sur plusieurs jeux de données en une seule fois sans vous soucier de votre espace disque.
Par rapport à l’évaluation sur un seul jeu de données, l’évaluation multi-jeux de données donne une meilleure mesure des capacités de généralisation d’un système de reconnaissance vocale (cf. <em>End-to-end Speech Benchmark</em> (ESB)).`,es,E,ls,N,Ms;return i=new gs({props:{title:"Streaming de données audio",local:"streaming-de-données-audio",headingTag:"h1"}}),C=new x({props:{code:"Z2lnYXNwZWVjaCUyMCUzRCUyMGxvYWRfZGF0YXNldCglMjJzcGVlY2hjb2xhYiUyRmdpZ2FzcGVlY2glMjIlMkMlMjAlMjJ4cyUyMiUyQyUyMHN0cmVhbWluZyUzRFRydWUp",highlighted:'gigaspeech = load_dataset(<span class="hljs-string">&quot;speechcolab/gigaspeech&quot;</span>, <span class="hljs-string">&quot;xs&quot;</span>, streaming=<span class="hljs-literal">True</span>)',wrap:!1}}),I=new x({props:{code:"bmV4dChpdGVyKGdpZ2FzcGVlY2glNUIlMjJ0cmFpbiUyMiU1RCkp",highlighted:'<span class="hljs-built_in">next</span>(<span class="hljs-built_in">iter</span>(gigaspeech[<span class="hljs-string">&quot;train&quot;</span>]))',wrap:!1}}),A=new x({props:{code:"JTdCJTBBJTIwJTIwJTIwJTIwJTIyc2VnbWVudF9pZCUyMiUzQSUyMCUyMllPVTAwMDAwMDAzMTVfUzAwMDA2NjAlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJzcGVha2VyJTIyJTNBJTIwJTIyTiUyRkElMjIlMkMlMEElMjAlMjAlMjAlMjAlMjJ0ZXh0JTIyJTNBJTIwJTIyQVMlMjBUSEVZJ1JFJTIwTEVBVklORyUyMCUzQ0NPTU1BJTNFJTIwQ0FOJTIwS0FTSCUyMFBVTEwlMjBaQUhSQSUyMEFTSURFJTIwUkVBTExZJTIwUVVJQ0tMWSUyMCUzQ1FVRVNUSU9OTUFSSyUzRSUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMmF1ZGlvJTIyJTNBJTIwJTdCJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIycGF0aCUyMiUzQSUyMCUyMnhzX2NodW5rc18wMDAwJTJGWU9VMDAwMDAwMDMxNV9TMDAwMDY2MC53YXYlMjIlMkMlMEElMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjAlMjJhcnJheSUyMiUzQSUyMGFycmF5KCUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCU1QjAuMDAwNTE4OCUyQyUyMDAuMDAwODU0NDklMkMlMjAwLjAwMDEyMjA3JTJDJTIwLi4uJTJDJTIwMC4wMDEyNTEyMiUyQyUyMDAuMDAwNzYyOTQlMkMlMjAwLjAwMDM2NjIxJTVEJTBBJTIwJTIwJTIwJTIwJTIwJTIwJTIwJTIwKSUyQyUwQSUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMCUyMnNhbXBsaW5nX3JhdGUlMjIlM0ElMjAxNjAwMCUyQyUwQSUyMCUyMCUyMCUyMCU3RCUyQyUwQSUyMCUyMCUyMCUyMCUyMmJlZ2luX3RpbWUlMjIlM0ElMjAyOTQxLjg5JTJDJTBBJTIwJTIwJTIwJTIwJTIyZW5kX3RpbWUlMjIlM0ElMjAyOTQ1LjA3JTJDJTBBJTIwJTIwJTIwJTIwJTIyYXVkaW9faWQlMjIlM0ElMjAlMjJZT1UwMDAwMDAwMzE1JTIyJTJDJTBBJTIwJTIwJTIwJTIwJTIydGl0bGUlMjIlM0ElMjAlMjJSZXR1cm4lMjB0byUyMFZhc3NlbGhlaW0lMjAlN0MlMjBDcml0aWNhbCUyMFJvbGUlM0ElMjBWT1glMjBNQUNISU5BJTIwJTdDJTIwRXBpc29kZSUyMDQzJTIyJTJDJTBBJTIwJTIwJTIwJTIwJTIydXJsJTIyJTNBJTIwJTIyaHR0cHMlM0ElMkYlMkZ3d3cueW91dHViZS5jb20lMkZ3YXRjaCUzRnYlM0R6cjJuMWZMVmFzVSUyMiUyQyUwQSUyMCUyMCUyMCUyMCUyMnNvdXJjZSUyMiUzQSUyMDIlMkMlMEElMjAlMjAlMjAlMjAlMjJjYXRlZ29yeSUyMiUzQSUyMDI0JTJDJTBBJTIwJTIwJTIwJTIwJTIyb3JpZ2luYWxfZnVsbF9wYXRoJTIyJTNBJTIwJTIyYXVkaW8lMkZ5b3V0dWJlJTJGUDAwMDQlMkZZT1UwMDAwMDAwMzE1Lm9wdXMlMjIlMkMlMEElN0Q=",highlighted:`{
    <span class="hljs-string">&quot;segment_id&quot;</span>: <span class="hljs-string">&quot;YOU0000000315_S0000660&quot;</span>,
    <span class="hljs-string">&quot;speaker&quot;</span>: <span class="hljs-string">&quot;N/A&quot;</span>,
    <span class="hljs-string">&quot;text&quot;</span>: <span class="hljs-string">&quot;AS THEY&#x27;RE LEAVING &lt;COMMA&gt; CAN KASH PULL ZAHRA ASIDE REALLY QUICKLY &lt;QUESTIONMARK&gt;&quot;</span>,
    <span class="hljs-string">&quot;audio&quot;</span>: {
        <span class="hljs-string">&quot;path&quot;</span>: <span class="hljs-string">&quot;xs_chunks_0000/YOU0000000315_S0000660.wav&quot;</span>,
        <span class="hljs-string">&quot;array&quot;</span>: <span class="hljs-built_in">array</span>(
            <span class="hljs-selector-attr">[0.0005188, 0.00085449, 0.00012207, ..., 0.00125122, 0.00076294, 0.00036621]</span>
        ),
        <span class="hljs-string">&quot;sampling_rate&quot;</span>: <span class="hljs-number">16000</span>,
    },
    <span class="hljs-string">&quot;begin_time&quot;</span>: <span class="hljs-number">2941.89</span>,
    <span class="hljs-string">&quot;end_time&quot;</span>: <span class="hljs-number">2945.07</span>,
    <span class="hljs-string">&quot;audio_id&quot;</span>: <span class="hljs-string">&quot;YOU0000000315&quot;</span>,
    <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;Return to Vasselheim | Critical Role: VOX MACHINA | Episode 43&quot;</span>,
    <span class="hljs-string">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.youtube.com/watch?v=zr2n1fLVasU&quot;</span>,
    <span class="hljs-string">&quot;source&quot;</span>: <span class="hljs-number">2</span>,
    <span class="hljs-string">&quot;category&quot;</span>: <span class="hljs-number">24</span>,
    <span class="hljs-string">&quot;original_full_path&quot;</span>: <span class="hljs-string">&quot;audio/youtube/P0004/YOU0000000315.opus&quot;</span>,
}`,wrap:!1}}),m=new x({props:{code:"Z2lnYXNwZWVjaF9oZWFkJTIwJTNEJTIwZ2lnYXNwZWVjaCU1QiUyMnRyYWluJTIyJTVELnRha2UoMiklMEFsaXN0KGdpZ2FzcGVlY2hfaGVhZCk=",highlighted:`gigaspeech_head = gigaspeech[<span class="hljs-string">&quot;train&quot;</span>].take(<span class="hljs-number">2</span>)
<span class="hljs-built_in">list</span>(gigaspeech_head)`,wrap:!1}}),g=new x({props:{code:" ",highlighted:`[
    {
        <span class="hljs-string">&quot;segment_id&quot;</span>: <span class="hljs-string">&quot;YOU0000000315_S0000660&quot;</span>,
        <span class="hljs-string">&quot;speaker&quot;</span>: <span class="hljs-string">&quot;N/A&quot;</span>,
        <span class="hljs-string">&quot;text&quot;</span>: <span class="hljs-string">&quot;AS THEY&#x27;RE LEAVING &lt;COMMA&gt; CAN KASH PULL ZAHRA ASIDE REALLY QUICKLY &lt;QUESTIONMARK&gt;&quot;</span>,
        <span class="hljs-string">&quot;audio&quot;</span>: {
            <span class="hljs-string">&quot;path&quot;</span>: <span class="hljs-string">&quot;xs_chunks_0000/YOU0000000315_S0000660.wav&quot;</span>,
            <span class="hljs-string">&quot;array&quot;</span>: array(
                [
                    <span class="hljs-number">0.0005188</span>,
                    <span class="hljs-number">0.00085449</span>,
                    <span class="hljs-number">0.00012207</span>,
                    ...,
                    <span class="hljs-number">0.00125122</span>,
                    <span class="hljs-number">0.00076294</span>,
                    <span class="hljs-number">0.00036621</span>,
                ]
            ),
            <span class="hljs-string">&quot;sampling_rate&quot;</span>: <span class="hljs-number">16000</span>,
        },
        <span class="hljs-string">&quot;begin_time&quot;</span>: <span class="hljs-number">2941.89</span>,
        <span class="hljs-string">&quot;end_time&quot;</span>: <span class="hljs-number">2945.07</span>,
        <span class="hljs-string">&quot;audio_id&quot;</span>: <span class="hljs-string">&quot;YOU0000000315&quot;</span>,
        <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;Return to Vasselheim | Critical Role: VOX MACHINA | Episode 43&quot;</span>,
        <span class="hljs-string">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.youtube.com/watch?v=zr2n1fLVasU&quot;</span>,
        <span class="hljs-string">&quot;source&quot;</span>: <span class="hljs-number">2</span>,
        <span class="hljs-string">&quot;category&quot;</span>: <span class="hljs-number">24</span>,
        <span class="hljs-string">&quot;original_full_path&quot;</span>: <span class="hljs-string">&quot;audio/youtube/P0004/YOU0000000315.opus&quot;</span>,
    },
    {
        <span class="hljs-string">&quot;segment_id&quot;</span>: <span class="hljs-string">&quot;AUD0000001043_S0000775&quot;</span>,
        <span class="hljs-string">&quot;speaker&quot;</span>: <span class="hljs-string">&quot;N/A&quot;</span>,
        <span class="hljs-string">&quot;text&quot;</span>: <span class="hljs-string">&quot;SIX TOMATOES &lt;PERIOD&gt;&quot;</span>,
        <span class="hljs-string">&quot;audio&quot;</span>: {
            <span class="hljs-string">&quot;path&quot;</span>: <span class="hljs-string">&quot;xs_chunks_0000/AUD0000001043_S0000775.wav&quot;</span>,
            <span class="hljs-string">&quot;array&quot;</span>: array(
                [
                    <span class="hljs-number">1.43432617</span>e-03,
                    <span class="hljs-number">1.37329102</span>e-03,
                    <span class="hljs-number">1.31225586</span>e-03,
                    ...,
                    <span class="hljs-number">-6.10351562</span>e-05,
                    <span class="hljs-number">-1.22070312</span>e-04,
                    <span class="hljs-number">-1.83105469</span>e-04,
                ]
            ),
            <span class="hljs-string">&quot;sampling_rate&quot;</span>: <span class="hljs-number">16000</span>,
        },
        <span class="hljs-string">&quot;begin_time&quot;</span>: <span class="hljs-number">3673.96</span>,
        <span class="hljs-string">&quot;end_time&quot;</span>: <span class="hljs-number">3675.26</span>,
        <span class="hljs-string">&quot;audio_id&quot;</span>: <span class="hljs-string">&quot;AUD0000001043&quot;</span>,
        <span class="hljs-string">&quot;title&quot;</span>: <span class="hljs-string">&quot;Asteroid of Fear&quot;</span>,
        <span class="hljs-string">&quot;url&quot;</span>: <span class="hljs-string">&quot;http//www.archive.org/download/asteroid_of_fear_1012_librivox/asteroid_of_fear_1012_librivox_64kb_mp3.zip&quot;</span>,
        <span class="hljs-string">&quot;source&quot;</span>: <span class="hljs-number">0</span>,
        <span class="hljs-string">&quot;category&quot;</span>: <span class="hljs-number">28</span>,
        <span class="hljs-string">&quot;original_full_path&quot;</span>: <span class="hljs-string">&quot;audio/audiobook/P0011/AUD0000001043.opus&quot;</span>,
    },
]`,wrap:!1}}),E=new qs({props:{source:"https://github.com/huggingface/audio-transformers-course/blob/main/chapters/fr/chapter1/streaming.mdx"}}),{c(){u=a("meta"),V=n(),B=a("p"),Z=n(),f(i.$$.fragment),k=n(),o=a("p"),o.innerHTML=ts,z=n(),T=a("p"),T.innerHTML=as,_=n(),J=a("ul"),J.innerHTML=ys,R=n(),p=a("p"),p.innerHTML=Us,L=n(),r=a("p"),r.textContent=us,F=n(),j=a("p"),j.innerHTML=is,Y=n(),f(C.$$.fragment),$=n(),w=a("p"),w.innerHTML=os,W=n(),f(I.$$.fragment),G=n(),c=a("p"),c.innerHTML=Ts,X=n(),f(A.$$.fragment),H=n(),d=a("p"),d.innerHTML=Js,O=n(),f(m.$$.fragment),P=n(),h=a("p"),h.innerHTML=ps,K=n(),f(g.$$.fragment),ss=n(),q=a("p"),q.innerHTML=rs,es=n(),f(E.$$.fragment),ls=n(),N=a("p"),this.h()},l(s){const e=ms("svelte-u9bgzb",document.head);u=y(e,"META",{name:!0,content:!0}),e.forEach(l),V=t(s),B=y(s,"P",{}),js(B).forEach(l),Z=t(s),S(i.$$.fragment,s),k=t(s),o=y(s,"P",{"data-svelte-h":!0}),U(o)!=="svelte-1xb8q90"&&(o.innerHTML=ts),z=t(s),T=y(s,"P",{"data-svelte-h":!0}),U(T)!=="svelte-1xjhwjf"&&(T.innerHTML=as),_=t(s),J=y(s,"UL",{"data-svelte-h":!0}),U(J)!=="svelte-kin8t"&&(J.innerHTML=ys),R=t(s),p=y(s,"P",{"data-svelte-h":!0}),U(p)!=="svelte-19m2f15"&&(p.innerHTML=Us),L=t(s),r=y(s,"P",{"data-svelte-h":!0}),U(r)!=="svelte-8ytelj"&&(r.textContent=us),F=t(s),j=y(s,"P",{"data-svelte-h":!0}),U(j)!=="svelte-diojnx"&&(j.innerHTML=is),Y=t(s),S(C.$$.fragment,s),$=t(s),w=y(s,"P",{"data-svelte-h":!0}),U(w)!=="svelte-1g75mi3"&&(w.innerHTML=os),W=t(s),S(I.$$.fragment,s),G=t(s),c=y(s,"P",{"data-svelte-h":!0}),U(c)!=="svelte-dbzevp"&&(c.innerHTML=Ts),X=t(s),S(A.$$.fragment,s),H=t(s),d=y(s,"P",{"data-svelte-h":!0}),U(d)!=="svelte-6md0dr"&&(d.innerHTML=Js),O=t(s),S(m.$$.fragment,s),P=t(s),h=y(s,"P",{"data-svelte-h":!0}),U(h)!=="svelte-dbzevp"&&(h.innerHTML=ps),K=t(s),S(g.$$.fragment,s),ss=t(s),q=y(s,"P",{"data-svelte-h":!0}),U(q)!=="svelte-1gshfjf"&&(q.innerHTML=rs),es=t(s),S(E.$$.fragment,s),ls=t(s),N=y(s,"P",{}),js(N).forEach(l),this.h()},h(){Cs(u,"name","hf:doc:metadata"),Cs(u,"content",fs)},m(s,e){hs(document.head,u),M(s,V,e),M(s,B,e),M(s,Z,e),b(i,s,e),M(s,k,e),M(s,o,e),M(s,z,e),M(s,T,e),M(s,_,e),M(s,J,e),M(s,R,e),M(s,p,e),M(s,L,e),M(s,r,e),M(s,F,e),M(s,j,e),M(s,Y,e),b(C,s,e),M(s,$,e),M(s,w,e),M(s,W,e),b(I,s,e),M(s,G,e),M(s,c,e),M(s,X,e),b(A,s,e),M(s,H,e),M(s,d,e),M(s,O,e),b(m,s,e),M(s,P,e),M(s,h,e),M(s,K,e),b(g,s,e),M(s,ss,e),M(s,q,e),M(s,es,e),b(E,s,e),M(s,ls,e),M(s,N,e),Ms=!0},p:Is,i(s){Ms||(Q(i.$$.fragment,s),Q(C.$$.fragment,s),Q(I.$$.fragment,s),Q(A.$$.fragment,s),Q(m.$$.fragment,s),Q(g.$$.fragment,s),Q(E.$$.fragment,s),Ms=!0)},o(s){D(i.$$.fragment,s),D(C.$$.fragment,s),D(I.$$.fragment,s),D(A.$$.fragment,s),D(m.$$.fragment,s),D(g.$$.fragment,s),D(E.$$.fragment,s),Ms=!1},d(s){s&&(l(V),l(B),l(Z),l(k),l(o),l(z),l(T),l(_),l(J),l(R),l(p),l(L),l(r),l(F),l(j),l(Y),l($),l(w),l(W),l(G),l(c),l(X),l(H),l(d),l(O),l(P),l(h),l(K),l(ss),l(q),l(es),l(ls),l(N)),l(u),v(i,s),v(C,s),v(I,s),v(A,s),v(m,s),v(g,s),v(E,s)}}}const fs='{"title":"Streaming de données audio","local":"streaming-de-données-audio","sections":[],"depth":1}';function Ss(ns){return cs(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Bs extends As{constructor(u){super(),ds(this,u,Ss,Es,ws,{})}}export{Bs as component};
