course/pr_1175/ru/_app/immutable/nodes/31.f8fcdffa.js

import{s as xe,n as ge,o as ve}from"../chunks/scheduler.893fe8c9.js";import{S as Ce,i as he,e as a,s as i,c as m,h as oe,a as p,d as l,b as s,f as ue,g as $,j as f,k as re,l as be,m as n,n as u,t as r,o as x,p as g}from"../chunks/index.2d09ebb4.js";import{C as _e,H as v,E as we}from"../chunks/MermaidChart.svelte_svelte_type_style_lang.9155aead.js";import{C as Me}from"../chunks/CodeBlock.14a0f027.js";import{C as Te}from"../chunks/CourseFloatingBanner.e3aeab73.js";function de(At){let C,lt,tt,nt,h,it,o,st,b,at,_,Gt="Карточка модели — это файл, который, возможно, так же важен, как файлы модели и токенизатора в репозитории моделей. Это центральное описание модели, обеспечивающее возможность повторного использования другими членами сообщества и воспроизводимость результатов, а также предоставляющее платформу для других участников.",pt,w,Dt="Документирование процесса обучения и оценки помогает другим понять, чего ожидать от модели, а предоставление достаточной информации об использованных данных, а также о проведенной предварительной и постобработке. По карточке модели ясны ограничения, предубеждения и контексты, в которых модель может быть полезна, а в каких случаях окажется бесполезной.",ft,M,Nt="Поэтому создание карточки модели, которая четко определяет вашу модель, является очень важным шагом. Здесь мы даем несколько советов, которые помогут вам в этом. Карточка модели создается с помощью файла <em>README.md</em>, который вы видели ранее, который представляет собой файл Markdown.",mt,T,Ot='Концепция «карточки модели» возникла в результате исследовательского направления Google, впервые представленного в статье [“Model Cards for Model Reporting”] (<a href="https://arxiv.org/abs/1810.03993" rel="nofollow">https://arxiv.org/abs/1810.03993</a>) Маргарет Митчелл и др. Большая часть информации, содержащейся здесь, основана на этом документе, и мы рекомендуем вам ознакомиться с ним, чтобы понять, почему карточки с моделями так важны в мире, который ценит воспроизводимость, возможность повторного использования и честность.',$t,d,Xt="Карточка модели обычно начинается с очень краткого общего обзора того, для чего предназначена модель, за которым следуют дополнительные сведения в следующих разделах:",ut,P,Yt="<li>Описание модели</li> <li>Предполагаемое использование и ограничения</li> <li>Как использовать</li> <li>Ограничения и предубеждения</li> <li>Тренировочные данные</li> <li>Процедура обучения</li> <li>Результаты оценки</li>",rt,c,Zt="Давайте посмотрим, что должен содержать каждый из этих разделов.",xt,L,gt,H,It="Описание содержит основные сведения о модели. Оно включает в себя архитектуру, версию, если модель была представлена в статье - автора, ссылку на оригинальную реализацию (если доступна), автора и общую информацию о модели. Любые авторские права должны быть указаны здесь. В этом разделе также можно упомянуть общую информацию о процедурах обучения, параметрах и важных отказах от ответственности.",vt,j,Ct,y,Jt="Здесь вы описываете варианты использования, для которых предназначена модель, включая языки, области и домены, в которых она может применяться. В этом разделе карты модели также можно документировать те области, которые являются неподходящими для модели.",ht,E,ot,U,Wt="Этот раздел должен включать несколько примеров того, как использовать модель. Это может быть продемонстрировано с использованием функции <code>pipeline()</code>, использованием классов модели и токенизатора, а также любым другим способом, удобным на ваш взгляд.",bt,S,_t,k,Kt="В этой части должно быть указано, на каком наборе данных обучалась модель. Также приветствуется краткое описание набора(ов) данных.",wt,q,Mt,B,te="В этом разделе вы должны описать все важные аспекты обучения, которые полезны с точки зрения воспроизводимости. Раздел включает в себя любую предварительную и постобработку данных, а также такие детали, как количество эпох, на которых была обучена модель, размер батча, скорость обучения и т. д.",Tt,z,dt,Q,ee="Здесь вы должны описать метрики, которые вы используете для оценки, и прочие величины, которые вы замеряете. Напишите, какие метрики использовались, в каком датасете и какое разделение разбиение датасета позволяет легко сравнивать производительность вашей модели с другими моделями.",Pt,F,ct,R,le="Наконец, укажите, насколько хорошо модель работает с набором данных для оценки. Если в модели используется порог принятия решения (threshold)– укажите его, либо предоставьте подробные сведения об оценке при различных порогах для предполагаемого использования.",Lt,V,Ht,A,ne="Ознакомьтесь с несколькими примерами хорошо сделанных карточек моделей:",jt,G,ie='<li><a href="https://huggingface.co/bert-base-cased" rel="nofollow"><code>bert-base-cased</code></a></li> <li><a href="https://huggingface.co/gpt2" rel="nofollow"><code>gpt2</code></a></li> <li><a href="https://huggingface.co/distilbert-base-uncased" rel="nofollow"><code>distilbert</code></a></li>',yt,D,se='Больше примеров от других организаций и компаний доступны: <a href="https://github.com/huggingface/model_card/blob/master/examples.md" rel="nofollow">здесь</a>.',Et,N,Ut,O,ae="Карточки моделей не являются обязательным требованием при публикации моделей, и вам не нужно включать все разделы, описанные выше, при их создании. Однако подробное документирование модели может принести только пользу будущим пользователям, поэтому мы рекомендуем вам заполнить как можно больше разделов в меру своих знаний и способностей.",St,X,kt,Y,pe="Если вы немного изучили Hugging Face Hub, вы должны были заметить, что некоторые модели относятся к определенным категориям: вы можете фильтровать их по задачам, языкам, библиотекам и т. д. Категории, к которым принадлежит модель, идентифицируются в соответствии с метаданными, которые вы добавляете в заголовок карточки модели.",qt,Z,fe='Например, если вы посмотрите на <a href="https://huggingface.co/camembert-base/blob/main/README.md" rel="nofollow">карточку модели <code>camembert-base</code></a>, вы должны увидеть следующие строки в заголовке карточки модели:',Bt,I,zt,J,me="Эти метаданные анализируются Hugging Face Hub, который затем идентифицирует эту модель как французскую модель с лицензией MIT, обученную на наборе данных Oscar.",Qt,W,$e='<a href="https://github.com/huggingface/hub-docs/blame/main/modelcard.md" rel="nofollow">Полная спецификация карточки модели</a> позволяет указать языкы, лицензии, теги, датасеты, метрики, а также результаты валидации модели.',Ft,K,Rt,et,Vt;return h=new _e({props:{containerStyle:"float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"}}),o=new v({props:{title:"Создание карточки модели",local:"создание-карточки-модели",headingTag:"h1"}}),b=new Te({props:{chapter:4,classNames:"absolute z-10 right-0 top-0"}}),L=new v({props:{title:"Описание модели",local:"описание-модели",headingTag:"h3"}}),j=new v({props:{title:"Предполагаемое использование и ограничения",local:"предполагаемое-использование-и-ограничения",headingTag:"h3"}}),E=new v({props:{title:"Как использовать",local:"как-использовать",headingTag:"h3"}}),S=new v({props:{title:"Обучающие данные",local:"обучающие-данные",headingTag:"h3"}}),q=new v({props:{title:"Процедура обучения",local:"процедура-обучения",headingTag:"h3"}}),z=new v({props:{title:"Variable and metrics",local:"variable-and-metrics",headingTag:"h3"}}),F=new v({props:{title:"Результаты валидации",local:"результаты-валидации",headingTag:"h3"}}),V=new v({props:{title:"Пример",local:"пример",headingTag:"h2"}}),N=new v({props:{title:"Примечание",local:"примечание",headingTag:"h2"}}),X=new v({props:{title:"Метаданные карточки модели",local:"метаданные-карточки-модели",headingTag:"h2"}}),I=new Me({props:{code:"LS0tJTBBbGFuZ3VhZ2UlM0ElMjBmciUwQWxpY2Vuc2UlM0ElMjBtaXQlMEFkYXRhc2V0cyUzQSUwQS0lMjBvc2NhciUwQS0tLQ==",highlighted:`<span class="hljs-meta">---</span>
<span class="hljs-attr">language:</span> <span class="hljs-string">fr</span>
<span class="hljs-attr">license:</span> <span class="hljs-string">mit</span>
<span class="hljs-attr">datasets:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">oscar</span>
<span class="hljs-meta">---</span>`,wrap:!1}}),K=new we({props:{source:"https://github.com/huggingface/course/blob/main/chapters/ru/chapter4/4.mdx"}}),{c(){C=a("meta"),lt=i(),tt=a("p"),nt=i(),m(h.$$.fragment),it=i(),m(o.$$.fragment),st=i(),m(b.$$.fragment),at=i(),_=a("p"),_.textContent=Gt,pt=i(),w=a("p"),w.textContent=Dt,ft=i(),M=a("p"),M.innerHTML=Nt,mt=i(),T=a("p"),T.innerHTML=Ot,$t=i(),d=a("p"),d.textContent=Xt,ut=i(),P=a("ul"),P.innerHTML=Yt,rt=i(),c=a("p"),c.textContent=Zt,xt=i(),m(L.$$.fragment),gt=i(),H=a("p"),H.textContent=It,vt=i(),m(j.$$.fragment),Ct=i(),y=a("p"),y.textContent=Jt,ht=i(),m(E.$$.fragment),ot=i(),U=a("p"),U.innerHTML=Wt,bt=i(),m(S.$$.fragment),_t=i(),k=a("p"),k.textContent=Kt,wt=i(),m(q.$$.fragment),Mt=i(),B=a("p"),B.textContent=te,Tt=i(),m(z.$$.fragment),dt=i(),Q=a("p"),Q.textContent=ee,Pt=i(),m(F.$$.fragment),ct=i(),R=a("p"),R.textContent=le,Lt=i(),m(V.$$.fragment),Ht=i(),A=a("p"),A.textContent=ne,jt=i(),G=a("ul"),G.innerHTML=ie,yt=i(),D=a("p"),D.innerHTML=se,Et=i(),m(N.$$.fragment),Ut=i(),O=a("p"),O.textContent=ae,St=i(),m(X.$$.fragment),kt=i(),Y=a("p"),Y.textContent=pe,qt=i(),Z=a("p"),Z.innerHTML=fe,Bt=i(),m(I.$$.fragment),zt=i(),J=a("p"),J.textContent=me,Qt=i(),W=a("p"),W.innerHTML=$e,Ft=i(),m(K.$$.fragment),Rt=i(),et=a("p"),this.h()},l(t){const e=oe("svelte-u9bgzb",document.head);C=p(e,"META",{name:!0,content:!0}),e.forEach(l),lt=s(t),tt=p(t,"P",{}),ue(tt).forEach(l),nt=s(t),$(h.$$.fragment,t),it=s(t),$(o.$$.fragment,t),st=s(t),$(b.$$.fragment,t),at=s(t),_=p(t,"P",{"data-svelte-h":!0}),f(_)!=="svelte-nz57bt"&&(_.textContent=Gt),pt=s(t),w=p(t,"P",{"data-svelte-h":!0}),f(w)!=="svelte-yiujq7"&&(w.textContent=Dt),ft=s(t),M=p(t,"P",{"data-svelte-h":!0}),f(M)!=="svelte-9edp5i"&&(M.innerHTML=Nt),mt=s(t),T=p(t,"P",{"data-svelte-h":!0}),f(T)!=="svelte-1v2ovlj"&&(T.innerHTML=Ot),$t=s(t),d=p(t,"P",{"data-svelte-h":!0}),f(d)!=="svelte-1jn8b6j"&&(d.textContent=Xt),ut=s(t),P=p(t,"UL",{"data-svelte-h":!0}),f(P)!=="svelte-cbsm46"&&(P.innerHTML=Yt),rt=s(t),c=p(t,"P",{"data-svelte-h":!0}),f(c)!=="svelte-1qg7u0q"&&(c.textContent=Zt),xt=s(t),$(L.$$.fragment,t),gt=s(t),H=p(t,"P",{"data-svelte-h":!0}),f(H)!=="svelte-1m9iwmk"&&(H.textContent=It),vt=s(t),$(j.$$.fragment,t),Ct=s(t),y=p(t,"P",{"data-svelte-h":!0}),f(y)!=="svelte-1rlniif"&&(y.textContent=Jt),ht=s(t),$(E.$$.fragment,t),ot=s(t),U=p(t,"P",{"data-svelte-h":!0}),f(U)!=="svelte-f6wt3b"&&(U.innerHTML=Wt),bt=s(t),$(S.$$.fragment,t),_t=s(t),k=p(t,"P",{"data-svelte-h":!0}),f(k)!=="svelte-1hyu640"&&(k.textContent=Kt),wt=s(t),$(q.$$.fragment,t),Mt=s(t),B=p(t,"P",{"data-svelte-h":!0}),f(B)!=="svelte-4cngfy"&&(B.textContent=te),Tt=s(t),$(z.$$.fragment,t),dt=s(t),Q=p(t,"P",{"data-svelte-h":!0}),f(Q)!=="svelte-ivu2lq"&&(Q.textContent=ee),Pt=s(t),$(F.$$.fragment,t),ct=s(t),R=p(t,"P",{"data-svelte-h":!0}),f(R)!=="svelte-6nevjp"&&(R.textContent=le),Lt=s(t),$(V.$$.fragment,t),Ht=s(t),A=p(t,"P",{"data-svelte-h":!0}),f(A)!=="svelte-11iaolh"&&(A.textContent=ne),jt=s(t),G=p(t,"UL",{"data-svelte-h":!0}),f(G)!=="svelte-1fs0egh"&&(G.innerHTML=ie),yt=s(t),D=p(t,"P",{"data-svelte-h":!0}),f(D)!=="svelte-1hthqu9"&&(D.innerHTML=se),Et=s(t),$(N.$$.fragment,t),Ut=s(t),O=p(t,"P",{"data-svelte-h":!0}),f(O)!=="svelte-6vnsq0"&&(O.textContent=ae),St=s(t),$(X.$$.fragment,t),kt=s(t),Y=p(t,"P",{"data-svelte-h":!0}),f(Y)!=="svelte-nlrxie"&&(Y.textContent=pe),qt=s(t),Z=p(t,"P",{"data-svelte-h":!0}),f(Z)!=="svelte-12y29x9"&&(Z.innerHTML=fe),Bt=s(t),$(I.$$.fragment,t),zt=s(t),J=p(t,"P",{"data-svelte-h":!0}),f(J)!=="svelte-1nuu1yk"&&(J.textContent=me),Qt=s(t),W=p(t,"P",{"data-svelte-h":!0}),f(W)!=="svelte-x5z9ld"&&(W.innerHTML=$e),Ft=s(t),$(K.$$.fragment,t),Rt=s(t),et=p(t,"P",{}),ue(et).forEach(l),this.h()},h(){re(C,"name","hf:doc:metadata"),re(C,"content",Pe)},m(t,e){be(document.head,C),n(t,lt,e),n(t,tt,e),n(t,nt,e),u(h,t,e),n(t,it,e),u(o,t,e),n(t,st,e),u(b,t,e),n(t,at,e),n(t,_,e),n(t,pt,e),n(t,w,e),n(t,ft,e),n(t,M,e),n(t,mt,e),n(t,T,e),n(t,$t,e),n(t,d,e),n(t,ut,e),n(t,P,e),n(t,rt,e),n(t,c,e),n(t,xt,e),u(L,t,e),n(t,gt,e),n(t,H,e),n(t,vt,e),u(j,t,e),n(t,Ct,e),n(t,y,e),n(t,ht,e),u(E,t,e),n(t,ot,e),n(t,U,e),n(t,bt,e),u(S,t,e),n(t,_t,e),n(t,k,e),n(t,wt,e),u(q,t,e),n(t,Mt,e),n(t,B,e),n(t,Tt,e),u(z,t,e),n(t,dt,e),n(t,Q,e),n(t,Pt,e),u(F,t,e),n(t,ct,e),n(t,R,e),n(t,Lt,e),u(V,t,e),n(t,Ht,e),n(t,A,e),n(t,jt,e),n(t,G,e),n(t,yt,e),n(t,D,e),n(t,Et,e),u(N,t,e),n(t,Ut,e),n(t,O,e),n(t,St,e),u(X,t,e),n(t,kt,e),n(t,Y,e),n(t,qt,e),n(t,Z,e),n(t,Bt,e),u(I,t,e),n(t,zt,e),n(t,J,e),n(t,Qt,e),n(t,W,e),n(t,Ft,e),u(K,t,e),n(t,Rt,e),n(t,et,e),Vt=!0},p:ge,i(t){Vt||(r(h.$$.fragment,t),r(o.$$.fragment,t),r(b.$$.fragment,t),r(L.$$.fragment,t),r(j.$$.fragment,t),r(E.$$.fragment,t),r(S.$$.fragment,t),r(q.$$.fragment,t),r(z.$$.fragment,t),r(F.$$.fragment,t),r(V.$$.fragment,t),r(N.$$.fragment,t),r(X.$$.fragment,t),r(I.$$.fragment,t),r(K.$$.fragment,t),Vt=!0)},o(t){x(h.$$.fragment,t),x(o.$$.fragment,t),x(b.$$.fragment,t),x(L.$$.fragment,t),x(j.$$.fragment,t),x(E.$$.fragment,t),x(S.$$.fragment,t),x(q.$$.fragment,t),x(z.$$.fragment,t),x(F.$$.fragment,t),x(V.$$.fragment,t),x(N.$$.fragment,t),x(X.$$.fragment,t),x(I.$$.fragment,t),x(K.$$.fragment,t),Vt=!1},d(t){t&&(l(lt),l(tt),l(nt),l(it),l(st),l(at),l(_),l(pt),l(w),l(ft),l(M),l(mt),l(T),l($t),l(d),l(ut),l(P),l(rt),l(c),l(xt),l(gt),l(H),l(vt),l(Ct),l(y),l(ht),l(ot),l(U),l(bt),l(_t),l(k),l(wt),l(Mt),l(B),l(Tt),l(dt),l(Q),l(Pt),l(ct),l(R),l(Lt),l(Ht),l(A),l(jt),l(G),l(yt),l(D),l(Et),l(Ut),l(O),l(St),l(kt),l(Y),l(qt),l(Z),l(Bt),l(zt),l(J),l(Qt),l(W),l(Ft),l(Rt),l(et)),l(C),g(h,t),g(o,t),g(b,t),g(L,t),g(j,t),g(E,t),g(S,t),g(q,t),g(z,t),g(F,t),g(V,t),g(N,t),g(X,t),g(I,t),g(K,t)}}}const Pe='{"title":"Создание карточки модели","local":"создание-карточки-модели","sections":[{"title":"Описание модели","local":"описание-модели","sections":[],"depth":3},{"title":"Предполагаемое использование и ограничения","local":"предполагаемое-использование-и-ограничения","sections":[],"depth":3},{"title":"Как использовать","local":"как-использовать","sections":[],"depth":3},{"title":"Обучающие данные","local":"обучающие-данные","sections":[],"depth":3},{"title":"Процедура обучения","local":"процедура-обучения","sections":[],"depth":3},{"title":"Variable and metrics","local":"variable-and-metrics","sections":[],"depth":3},{"title":"Результаты валидации","local":"результаты-валидации","sections":[],"depth":3},{"title":"Пример","local":"пример","sections":[],"depth":2},{"title":"Примечание","local":"примечание","sections":[],"depth":2},{"title":"Метаданные карточки модели","local":"метаданные-карточки-модели","sections":[],"depth":2}],"depth":1}';function ce(At){return ve(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Ue extends Ce{constructor(C){super(),he(this,C,ce,de,xe,{})}}export{Ue as component};