Google Colab - Документирование вашего кода

Поскольку ячейка кода поддерживает полный синтаксис Python, вы можете использовать Python commentsв окне кода, чтобы описать ваш код. Однако часто для иллюстрации алгоритмов машинного обучения вам потребуется нечто большее, чем просто текстовые комментарии. ML широко использует математику, и для объяснения этих терминов и уравнений вашим читателям вам понадобится редактор, поддерживающий LaTex - язык математических представлений. Colab предоставляетText Cells для этого.

Текстовая ячейка, содержащая несколько математических уравнений, обычно используемых в машинном обучении, показана на снимке экрана ниже.

По мере продвижения в этой главе мы увидим код для генерации вышеуказанного вывода.

Текстовые ячейки форматируются с использованием markdown- простой язык разметки. Давайте теперь посмотрим, как добавить текстовые ячейки в записную книжку и добавить в нее текст, содержащий математические уравнения.

Примеры Markdown

Давайте рассмотрим несколько примеров синтаксиса языка разметки, чтобы продемонстрировать его возможности.

Введите следующий текст в текстовую ячейку.

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

Вывод вышеуказанных команд отображается в правой части ячейки, как показано здесь.

Математические уравнения

Добавить Text Cell в свой блокнот и введите следующий синтаксис уценки в текстовом окне -

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

Вы увидите немедленную визуализацию кода уценки на правой боковой панели текстовой ячейки. Это показано на скриншоте ниже -

Ударил Enter и код уценки исчезает из текстовой ячейки, и отображается только визуализированный результат.

Давайте попробуем другое более сложное уравнение, как показано здесь -

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

Отрендеренный результат показан здесь для вашего быстрого ознакомления.

Код для примеров уравнений

Вот код для примеров уравнений, показанных на предыдущем снимке экрана:

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}$

Описание полного синтаксиса разметки выходит за рамки этого руководства. В следующей главе мы увидим, как сохранить вашу работу.