Deși nu putem introduce fiecare funcție și clasă PyTorch (iar informațiile ar putea deveni depășite rapid), documentația API și tutorialele și exemplele suplimentare oferă o astfel de documentație. Această secțiune oferă câteva îndrumări despre cum să explorați API-ul PyTorch.
import torch
Pentru a ști ce funcții și clase pot fi apelate într-un modul, invocăm funcția dir. De exemplu, putem (interoga toate proprietățile din modul pentru generarea de numere aleatorii):
print(dir(torch.distributions))
În general, putem ignora funcțiile care încep și se termină cu __ (obiecte speciale în Python) sau funcțiile care încep cu un singur _ (de obicei funcții interne). Pe baza numelor funcțiilor sau atributelor rămase, am putea risca o presupunere că acest modul oferă diverse metode pentru generarea de numere aleatorii, inclusiv eșantionarea din distribuția uniformă (uniform), distribuția normală (normal) și distribuția multinomială (multinomial).
Pentru instrucțiuni specifice despre cum să utilizați o anumită funcție sau clasă, putem invoca funcția help. Ca exemplu, să [explorăm instrucțiunile de utilizare pentru funcția ones a tensorilor].
help(torch.ones)
Din documentație, putem vedea că funcția ones creează un nou tensor cu forma specificată și setează toate elementele la valoarea 1. Ori de câte ori este posibil, ar trebui să (rulați un test rapid) pentru a vă confirma interpretarea:
torch.ones(4)
În caietul Jupyter, putem folosi ? pentru a afișa documentul într-o altă fereastră. De exemplu, list? va crea un conținut aproape identic cu help(list), afișându-l într-o nouă fereastră de browser. În plus, dacă folosim două semne de întrebare, cum ar fi list??, va fi afișat și codul Python care implementează funcția.
Documentația oficială oferă o mulțime de descrieri și exemple care depășesc această carte. Subliniem cazuri de utilizare importante care vă vor ajuta să începeți rapid cu probleme practice, mai degrabă decât completitudinea acoperirii. De asemenea, vă încurajăm să studiați codul sursă al bibliotecilor pentru a vedea exemple de implementări de înaltă calitate ale codului de producție. Făcând acest lucru, veți deveni un inginer mai bun, pe lângă faptul că veți deveni un om de știință mai bun.