Google Colab - Documentare il tuo codice

Poiché la cella del codice supporta la sintassi completa di Python, puoi usare Python commentsnella finestra del codice per descrivere il codice. Tuttavia, molte volte è necessario qualcosa di più di semplici commenti basati su testo per illustrare gli algoritmi di ML. ML utilizza pesantemente la matematica e per spiegare questi termini ed equazioni ai lettori è necessario un editor che supporti LaTex, un linguaggio per le rappresentazioni matematiche. Colab fornisceText Cells per questo scopo.

Una cella di testo contenente poche equazioni matematiche tipicamente utilizzate in ML è mostrata nello screenshot qui sotto:

Andando avanti in questo capitolo, vedremo il codice per generare l'output di cui sopra.

Le celle di testo vengono formattate utilizzando markdown- un semplice linguaggio di markup. Vediamo ora come aggiungere celle di testo al tuo quaderno e aggiungere ad esso del testo contenente equazioni matematiche.

Esempi di markdown

Esaminiamo alcuni esempi di sintassi del linguaggio di markup per dimostrare le sue capacità.

Digita il testo seguente nella cella Testo.

This is **bold**.
This is *italic*.
This is ~strikethrough~.

L'output dei comandi precedenti viene visualizzato sul lato destro della cella come mostrato qui.

Equazioni matematiche

Aggiungere un Text Cell sul tuo taccuino e inserisci la seguente sintassi markdown nella finestra di testo -

$\sqrt{3x-1}+(1+x)^2$

Vedrai il rendering immediato del codice markdown nel pannello di destra della cella di testo. Questo è mostrato nello screenshot qui sotto -

Colpire Enter e il codice markdown scompare dalla cella di testo e viene mostrato solo l'output renderizzato.

Proviamo un'altra equazione più complicata come mostrato qui -

$e^x = \sum_{i = 0}^\infty \frac{1}{i!}x^i$

L'output renderizzato viene mostrato qui per una rapida consultazione.

Codice per equazioni di esempio

Ecco il codice per le equazioni di esempio mostrate in uno screenshot precedente:

Constraints are
   - $3x_1 + 6x_2 + x_3 =< 28$
   - $7x_1 + 3x_2 + 2x_3 =< 37$
   - $4x_1 + 5x_2 + 2x_3 =< 19$
   - $x_1,x_2,x_3 >=0 $

The trial vector is calculated as follows:
- $u_i(t) = x_i(t) + \beta(\hat{x}(t) − x_i(t)) + \beta \sum_{k = 1}^{n_v}(x_{i1,k}(t) − x_{i2,k}(t))$
$f(x_1, x_2) = 20 + e - 20exp(-0.2 \sqrt {\frac {1}{n} (x_1^2 + x_2^2)}) - exp (\frac {1}{n}(cos(2\pi x_1) + cos(2\pi x_2))$

$x ∈ [-5, 5]$
>$A_{m,n} =
   \begin{pmatrix}
   a_{1,1} > a_{1,2} > \cdots > a_{1,n} \\
   a_{2,1} > a_{2,2} > \cdots > a_{2,n} \\
   \vdots > \vdots > \ddots > \vdots \\
   a_{m,1} > a_{m,2} > \cdots > a_{m,n}
   \end{pmatrix}$

La descrizione della sintassi completa del markup va oltre lo scopo di questo tutorial. Nel prossimo capitolo vedremo come salvare il tuo lavoro.