pyeasyphd 0.3.1__tar.gz → 0.3.3__tar.gz

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyeasyphd
-Version: 0.3.1
+Version: 0.3.3
 Summary: pyeasyphd
 License: GPL-3.0-or-later
 License-File: LICENSE

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/pyeasyphd/data/Templates/TEX/Beamer_Header.tex

@@ -1,6 +1,6 @@
 % \RequirePackage[l2tabu, orthodox]{nag} % https://ctan.org/pkg/nag: Detecting and warning about obsolete LATEX commands
 \RequirePackage{fix-cm} % https://ctan.org/pkg/fix-cm?lang=en: Permit Computer Modern fonts at arbitrary sizes
-\documentclass[10.5pt]{beamer}
+\documentclass[11pt]{beamer}
 
 %------------------------------------------------------------------------------
 % https://www.overleaf.com/learn/latex/Beamer
@@ -51,7 +51,6 @@
 \setbeamertemplate{itemize items}[triangle] % default triangle, cicrle, square, ball
 \setbeamertemplate{enumerate items}[circle] % default triangle, circle, square, ball
 \setbeamertemplate{theorems}[numbered]
-\setbeamertemplate{caption}[numbered]
 \setbeamertemplate{blocks}[rounded][shadow=true]
 \setbeamercolor{block title}{fg=black,bg=cyan!45!white}
 \setbeamercolor{block body}{fg=black,bg=cyan!10!white}

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/pyeasyphd/data/Templates/TEX/Style.tex

@@ -1,15 +1,20 @@
 %------------------------------------------------------------------------------
 %% https://ctan.org/pkg/
 %% Geometry
-\usepackage{geometry}
-% \geometry{a4paper,scale=0.9}
-\usepackage{fancyhdr} % Extensive control of page headers and footers
+\makeatletter
+\@ifclassloaded{beamer}{%
+}{%
+    \usepackage{geometry}
+    \usepackage{fancyhdr} % Extensive control of page headers and footers
+}
+\makeatother
 
 %% Font
 \ifx\cn\undefined
     \usepackage[utf8]{inputenc} % Required for inputting international characters, allow utf-8 input
     \usepackage[T1]{fontenc} % Output font encoding for international characters, use 8-bit T1 fonts
     % \usepackage[default]{sourcesanspro} % https://fonts.adobe.com/fonts/source-sans#fonts-section
+    \usepackage{lmodern} % The Latin Modern family is a recent collection of fonts.
 \else
     \usepackage[UTF8]{ctex}
     \newcommand{\chuhao}{\fontsize{42pt}{1.25\baselineskip}\selectfont}     %初号
@@ -25,8 +30,6 @@
     \newcommand{\liuhao}{\fontsize{7.875pt}{1.25\baselineskip}\selectfont}  %六号
     \newcommand{\qihao}{\fontsize{5.25pt}{1.25\baselineskip}\selectfont}    %七号
 \fi
-\usepackage{microtype} % Subliminal refinements towards typographical perfection
-\usepackage{lmodern} % The Latin Modern family is a recent collection of fonts.
 
 %% Algorithm
 % https://www.overleaf.com/learn/latex/Algorithms
@@ -79,19 +82,19 @@
 
 %% Math
 \usepackage{bm} % https://www.ctan.org/pkg/bm
-\usepackage{amsmath} % https://www.ctan.org/pkg/amsmath
-\usepackage{amsfonts} % https://www.ctan.org/pkg/amsfonts
+% \usepackage{amsmath} % https://www.ctan.org/pkg/amsmath
+% loads amsmath automatically
+\usepackage{mathtools} % https://www.ctan.org/pkg/mathtools. Based on amsmath.
+% \usepackage{amsfonts} % https://www.ctan.org/pkg/amsfonts
+% loads amsfonts automatically
 \usepackage{amssymb} % https://latexstudio.net/hulatex/package/maths-1.htm. Contained in amsfonts.
 \usepackage{amsthm} % https://www.ctan.org/pkg/amsthm. Facilitates the kind of theorem setup typically needed in AMS Publications.
-\usepackage{mathrsfs}
+\usepackage{mathrsfs} % \mathscr
 \usepackage{csquotes} % Provides advanced facilities for inline and display quotations.
-\usepackage{siunitx} % Ensure that the combined mathematical meaning of the value plus unit combination is clear.
-\usepackage{mathtools} % https://www.ctan.org/pkg/mathtools. Based on amsmath.
 \usepackage{nicefrac} % Compact symbols for 1/2, etc.
 
 %% Color
 % cyan, magenta, darkgray, lightgray, brown, orange, lime, purple, teal, violet and pink
-\usepackage{color}
 \usepackage{xcolor} % The package allows rows and columns to be coloured, and even individual cells.
 \usepackage{colortbl} % Fill color
 
@@ -101,14 +104,8 @@
 \usepackage{float} % Improves the interface for defining floating objects such as figures and tables.
 
 %% Figure
-\usepackage{graphicx}
-\usepackage{graphics}
-\graphicspath{{./}
-{./figure/}{./figures/}{./image/}{./images/}{./graphics/}{./graphic/}{./pictures/}{./picture/}
-{./Figure/}{./Figures/}{./Image/}{./Images/}{./Graphics/}{./Graphic/}{./Pictures/}{./Picture/}
-{./fig}{./figs}{./img}{./imgs}
-{./Fig}{./Figs}{./Img}{./Imgs}
-}
+\usepackage{graphicx} % no need for \usepackage{graphics}
+\graphicspath{{./}{./figures/}{./images/}{./figs}{./imgs}}
 \usepackage{pgf} % PGF is a macro package for creating graphics.
 \usepackage{wrapfig}
 \usepackage{standalone}
@@ -239,11 +236,5 @@
 \usepackage{ifthen} % Conditional commands in LATEX documents
 \usepackage{pdfpages} % Simplifies the inclusion of external multi-page PDF documents in LATEX documents.
 \usepackage{verbatim} % (that skips everything between \begin{comment} and \end{comment})
-\usepackage{pstricks} % PSTricks offers an extensive collection of macros for generating PostScript
 \usepackage[english]{babel} % Manages culturally-determined typographical (and other) rules for a wide range of languages.
-\usepackage{makeidx} % Standard package for creating indexes, and Provides two new commands, \see and \printindex.
-\usepackage{rotating} % Rotation tools, including rotated full-page floats
-\usepackage{bbm} % Provide LaTex support for Blackboard varients of Computer Modern fonts.
-\usepackage{soul} % Find hypen automatically
-\usepackage{url} % Allow linebreaks at certain characters or combinations of characters. (simple URL typesetting)
 \usepackage{enumitem}

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/pyeasyphd/data/Templates/TEX/math.tex

@@ -1,6 +1,6 @@
 \section{Math Symbols}
 
-\begin{table}[h!]
+\begin{table}[!htbp]
 \caption{Math Symbols}
 \resizebox{\textwidth}{!}
 {
@@ -86,10 +86,10 @@ $\displaystyle \rmA$ & A matrix-valued random variable \\
 \egroup
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Sets and Graphs}}
 \bgroup
 \def\arraystretch{1.5}
-
 \begin{tabular}{p{1.5in}p{3.5in}}
 $\displaystyle \sA$ & A set \\
 $\displaystyle \sR$ & The set of real numbers \\
@@ -103,6 +103,7 @@ $\displaystyle \parents_\gG(\ervx_i)$ & The parents of $\ervx_i$ in $\gG$
 \end{tabular}
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Indexing}}
 \bgroup
 \def\arraystretch{1.5}
@@ -119,6 +120,7 @@ $\displaystyle \erva_i$ & Element $i$ of the random vector $\rva$ \\
 \egroup
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Calculus}}
 \bgroup
 \def\arraystretch{1.5}
@@ -139,6 +141,7 @@ $\displaystyle \int_\sS f(\vx) d\vx$ & Definite integral with respect to $\vx$ o
 \egroup
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Probability and Information Theory}}
 \bgroup
 \def\arraystretch{1.5}
@@ -156,14 +159,15 @@ $\displaystyle \mathcal{N} ( \vx ; \vmu , \mSigma)$ & Gaussian distribution % ov
 \egroup
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Functions}}
 \bgroup
 \def\arraystretch{1.5}
 \begin{tabular}{p{1.5in}p{3.5in}}
 $\displaystyle f: \sA \rightarrow \sB$ & The function $f$ with domain $\sA$ and range $\sB$ \\
 $\displaystyle f \circ g $ & Composition of the functions $f$ and $g$ \\
-  $\displaystyle f(\vx ; \vtheta) $ & A function of $\vx$ parametrized by $\vtheta$.
-  (Sometimes we write $f(\vx)$ and omit the argument $\vtheta$ to lighten notation) \\
+$\displaystyle f(\vx ; \vtheta) $ & A function of $\vx$ parametrized by $\vtheta$.
+(Sometimes we write $f(\vx)$ and omit the argument $\vtheta$ to lighten notation) \\
 $\displaystyle \log x$ & Natural logarithm of $x$ \\
 $\displaystyle \sigma(x)$ & Logistic sigmoid, $\displaystyle \frac{1} {1 + \exp(-x)}$ \\
 $\displaystyle \zeta(x)$ & Softplus, $\log(1 + \exp(x))$ \\
@@ -175,6 +179,7 @@ $\displaystyle \bm{1}_\mathrm{condition}$ & is 1 if the condition is true, 0 oth
 \egroup
 \vspace{0.5cm}
 
+\clearpage
 \centering{\textbf {Machine Learning}}
 \bgroup
 \def\arraystretch{1.5}

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/pyeasyphd/data/Templates/TEX/math_commands.tex

@@ -1,3 +1,11 @@
+%%%-------------------------------------------------------------------------%%%
+% Required packages
+\usepackage{amsmath}
+
+% Set up tensor font
+\DeclareMathAlphabet{\mathsfit}{\encodingdefault}{\sfdefault}{m}{sl}
+\SetMathAlphabet{\mathsfit}{bold}{\encodingdefault}{\sfdefault}{bx}{n}
+
 %%%-------------------------------------------------------------------------%%%
 %% Remark
 % \em is useful for long texts (\emph e.g. doesn't allow the argument to contain a \par). The commands differ (like the \textit/\itshape) in their handling of the italic correction
@@ -8,8 +16,6 @@
 %%%-------------------------------------------------------------------------%%%
 %% Optional math commands from https://github.com/goodfeli/dlbook_notation/blob/master/math_commands.tex
 
-\usepackage{amsmath}
-
 %% Math Symbols (def)
 % Vectors                  % Elements of vectors  % Matrix                   % Entries of a matrix
 \newcommand{\va}{{\bm{a}}} \newcommand{\eva}{{a}} \newcommand{\mA}{{\bm{A}}} \newcommand{\emA}{{A}}
@@ -57,7 +63,7 @@
 \newcommand{\rn}{{\textnormal{n}}}
 \newcommand{\ro}{{\textnormal{o}}}
 \newcommand{\rp}{{\textnormal{p}}}
-% rm is already a command, just don't name any random variables q
+% rq is already a command, just don't name any random variables q
 \newcommand{\rqq}{{\textnormal{q}}}
 \newcommand{\rr}{{\textnormal{r}}}
 \newcommand{\rs}{{\textnormal{s}}}
@@ -127,8 +133,6 @@
 \newcommand{\sZ}{{\mathbb{Z}}} \newcommand{\gZ}{{\mathcal{Z}}}
 
 % Tensor
-\DeclareMathAlphabet{\mathsfit}{\encodingdefault}{\sfdefault}{m}{sl}
-\SetMathAlphabet{\mathsfit}{bold}{\encodingdefault}{\sfdefault}{bx}{n}
 \newcommand{\tens}[1]{\bm{\mathsfit{#1}}} % Tensor
 \newcommand{\etens}[1]{\mathsfit{#1}} % Same font as tensor, without \bm wrapper
 % Tensor                     % Entries of a tensor

pyeasyphd-0.3.3/pyeasyphd/data/Templates/TEX/nextaimathmacros.sty

@@ -0,0 +1,681 @@
+% nextaimathmacros.sty
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{nextaimathmacros}[2025/10/20 Custom Math Symbols and Macros]
+
+%%%-------------------------------------------------------------------------%%%
+% Required packages
+\RequirePackage{amsmath}
+
+% Set up tensor font
+\DeclareMathAlphabet{\mathsfit}{\encodingdefault}{\sfdefault}{m}{sl}
+\SetMathAlphabet{\mathsfit}{bold}{\encodingdefault}{\sfdefault}{bx}{n}
+
+%%%-------------------------------------------------------------------------%%%
+%% Remark
+% \em is useful for long texts (\emph e.g. doesn't allow the argument to contain a \par). The commands differ (like the \textit/\itshape) in their handling of the italic correction
+% \def is a TeX primitive, \newcommand is a LaTeX overlay on top of \def. The most obvious benefits of \newcommand over \def are:
+    % \newcommand checks whether or not the command already exists
+    % \newcommand allows you to define an optional argument
+
+%%%-------------------------------------------------------------------------%%%
+%% Optional math commands from https://github.com/goodfeli/dlbook_notation/blob/master/math_commands.tex
+
+%% Math Symbols (def)
+% Vectors                  % Elements of vectors  % Matrix                   % Entries of a matrix
+\newcommand{\va}{{\bm{a}}} \newcommand{\eva}{{a}} \newcommand{\mA}{{\bm{A}}} \newcommand{\emA}{{A}}
+\newcommand{\vb}{{\bm{b}}} \newcommand{\evb}{{b}} \newcommand{\mB}{{\bm{B}}} \newcommand{\emB}{{B}}
+\newcommand{\vc}{{\bm{c}}} \newcommand{\evc}{{c}} \newcommand{\mC}{{\bm{C}}} \newcommand{\emC}{{C}}
+\newcommand{\vd}{{\bm{d}}} \newcommand{\evd}{{d}} \newcommand{\mD}{{\bm{D}}} \newcommand{\emD}{{D}}
+\newcommand{\ve}{{\bm{e}}} \newcommand{\eve}{{e}} \newcommand{\mE}{{\bm{E}}} \newcommand{\emE}{{E}}
+\newcommand{\vf}{{\bm{f}}} \newcommand{\evf}{{f}} \newcommand{\mF}{{\bm{F}}} \newcommand{\emF}{{F}}
+\newcommand{\vg}{{\bm{g}}} \newcommand{\evg}{{g}} \newcommand{\mG}{{\bm{G}}} \newcommand{\emG}{{G}}
+\newcommand{\vh}{{\bm{h}}} \newcommand{\evh}{{h}} \newcommand{\mH}{{\bm{H}}} \newcommand{\emH}{{H}}
+\newcommand{\vi}{{\bm{i}}} \newcommand{\evi}{{i}} \newcommand{\mI}{{\bm{I}}} \newcommand{\emI}{{I}}
+\newcommand{\vj}{{\bm{j}}} \newcommand{\evj}{{j}} \newcommand{\mJ}{{\bm{J}}} \newcommand{\emJ}{{J}}
+\newcommand{\vk}{{\bm{k}}} \newcommand{\evk}{{k}} \newcommand{\mK}{{\bm{K}}} \newcommand{\emK}{{K}}
+\newcommand{\vl}{{\bm{l}}} \newcommand{\evl}{{l}} \newcommand{\mL}{{\bm{L}}} \newcommand{\emL}{{L}}
+\newcommand{\vm}{{\bm{m}}} \newcommand{\evm}{{m}} \newcommand{\mM}{{\bm{M}}} \newcommand{\emM}{{M}}
+\newcommand{\vn}{{\bm{n}}} \newcommand{\evn}{{n}} \newcommand{\mN}{{\bm{N}}} \newcommand{\emN}{{N}}
+\newcommand{\vo}{{\bm{o}}} \newcommand{\evo}{{o}} \newcommand{\mO}{{\bm{O}}} \newcommand{\emO}{{O}}
+\newcommand{\vp}{{\bm{p}}} \newcommand{\evp}{{p}} \newcommand{\mP}{{\bm{P}}} \newcommand{\emP}{{P}}
+\newcommand{\vq}{{\bm{q}}} \newcommand{\evq}{{q}} \newcommand{\mQ}{{\bm{Q}}} \newcommand{\emQ}{{Q}}
+\newcommand{\vr}{{\bm{r}}} \newcommand{\evr}{{r}} \newcommand{\mR}{{\bm{R}}} \newcommand{\emR}{{R}}
+\newcommand{\vs}{{\bm{s}}} \newcommand{\evs}{{s}} \newcommand{\mS}{{\bm{S}}} \newcommand{\emS}{{S}}
+\newcommand{\vt}{{\bm{t}}} \newcommand{\evt}{{t}} \newcommand{\mT}{{\bm{T}}} \newcommand{\emT}{{T}}
+\newcommand{\vu}{{\bm{u}}} \newcommand{\evu}{{u}} \newcommand{\mU}{{\bm{U}}} \newcommand{\emU}{{U}}
+\newcommand{\vv}{{\bm{v}}} \newcommand{\evv}{{v}} \newcommand{\mV}{{\bm{V}}} \newcommand{\emV}{{V}}
+\newcommand{\vw}{{\bm{w}}} \newcommand{\evw}{{w}} \newcommand{\mW}{{\bm{W}}} \newcommand{\emW}{{W}}
+\newcommand{\vx}{{\bm{x}}} \newcommand{\evx}{{x}} \newcommand{\mX}{{\bm{X}}} \newcommand{\emX}{{X}}
+\newcommand{\vy}{{\bm{y}}} \newcommand{\evy}{{y}} \newcommand{\mY}{{\bm{Y}}} \newcommand{\emY}{{Y}}
+\newcommand{\vz}{{\bm{z}}} \newcommand{\evz}{{z}} \newcommand{\mZ}{{\bm{Z}}} \newcommand{\emZ}{{Z}}
+
+% Random variables
+\newcommand{\ra}{{\textnormal{a}}}
+\newcommand{\rb}{{\textnormal{b}}}
+\newcommand{\rc}{{\textnormal{c}}}
+\newcommand{\rd}{{\textnormal{d}}}
+\newcommand{\re}{{\textnormal{e}}}
+\newcommand{\rf}{{\textnormal{f}}}
+\newcommand{\rg}{{\textnormal{g}}}
+\newcommand{\rh}{{\textnormal{h}}}
+\newcommand{\ri}{{\textnormal{i}}}
+\newcommand{\rj}{{\textnormal{j}}}
+\newcommand{\rk}{{\textnormal{k}}}
+\newcommand{\rl}{{\textnormal{l}}}
+% rm is already a command, just don't name any random variables m
+\newcommand{\rmm}{{\textnormal{m}}}
+\newcommand{\rn}{{\textnormal{n}}}
+\newcommand{\ro}{{\textnormal{o}}}
+\newcommand{\rp}{{\textnormal{p}}}
+% rq is already a command, just don't name any random variables q
+\newcommand{\rqq}{{\textnormal{q}}}
+\newcommand{\rr}{{\textnormal{r}}}
+\newcommand{\rs}{{\textnormal{s}}}
+\newcommand{\rt}{{\textnormal{t}}}
+\newcommand{\ru}{{\textnormal{u}}}
+\newcommand{\rv}{{\textnormal{v}}}
+\newcommand{\rw}{{\textnormal{w}}}
+\newcommand{\rx}{{\textnormal{x}}}
+\newcommand{\ry}{{\textnormal{y}}}
+\newcommand{\rz}{{\textnormal{z}}}
+
+% Random vectors                % Elements of random vectors         % Random matrices               % Elements of random matrices
+\newcommand{\rva}{{\mathbf{a}}} \newcommand{\erva}{{\textnormal{a}}} \newcommand{\rmA}{{\mathbf{A}}} \newcommand{\ermA}{{\textnormal{A}}}
+\newcommand{\rvb}{{\mathbf{b}}} \newcommand{\ervb}{{\textnormal{b}}} \newcommand{\rmB}{{\mathbf{B}}} \newcommand{\ermB}{{\textnormal{B}}}
+\newcommand{\rvc}{{\mathbf{c}}} \newcommand{\ervc}{{\textnormal{c}}} \newcommand{\rmC}{{\mathbf{C}}} \newcommand{\ermC}{{\textnormal{C}}}
+\newcommand{\rvd}{{\mathbf{d}}} \newcommand{\ervd}{{\textnormal{d}}} \newcommand{\rmD}{{\mathbf{D}}} \newcommand{\ermD}{{\textnormal{D}}}
+\newcommand{\rve}{{\mathbf{e}}} \newcommand{\erve}{{\textnormal{e}}} \newcommand{\rmE}{{\mathbf{E}}} \newcommand{\ermE}{{\textnormal{E}}}
+\newcommand{\rvf}{{\mathbf{f}}} \newcommand{\ervf}{{\textnormal{f}}} \newcommand{\rmF}{{\mathbf{F}}} \newcommand{\ermF}{{\textnormal{F}}}
+\newcommand{\rvg}{{\mathbf{g}}} \newcommand{\ervg}{{\textnormal{g}}} \newcommand{\rmG}{{\mathbf{G}}} \newcommand{\ermG}{{\textnormal{G}}}
+\newcommand{\rvh}{{\mathbf{h}}} \newcommand{\ervh}{{\textnormal{h}}} \newcommand{\rmH}{{\mathbf{H}}} \newcommand{\ermH}{{\textnormal{H}}}
+\newcommand{\rvi}{{\mathbf{i}}} \newcommand{\ervi}{{\textnormal{i}}} \newcommand{\rmI}{{\mathbf{I}}} \newcommand{\ermI}{{\textnormal{I}}}
+\newcommand{\rvj}{{\mathbf{j}}} \newcommand{\ervj}{{\textnormal{j}}} \newcommand{\rmJ}{{\mathbf{J}}} \newcommand{\ermJ}{{\textnormal{J}}}
+\newcommand{\rvk}{{\mathbf{k}}} \newcommand{\ervk}{{\textnormal{k}}} \newcommand{\rmK}{{\mathbf{K}}} \newcommand{\ermK}{{\textnormal{K}}}
+\newcommand{\rvl}{{\mathbf{l}}} \newcommand{\ervl}{{\textnormal{l}}} \newcommand{\rmL}{{\mathbf{L}}} \newcommand{\ermL}{{\textnormal{L}}}
+\newcommand{\rvm}{{\mathbf{m}}} \newcommand{\ervm}{{\textnormal{m}}} \newcommand{\rmM}{{\mathbf{M}}} \newcommand{\ermM}{{\textnormal{M}}}
+\newcommand{\rvn}{{\mathbf{n}}} \newcommand{\ervn}{{\textnormal{n}}} \newcommand{\rmN}{{\mathbf{N}}} \newcommand{\ermN}{{\textnormal{N}}}
+\newcommand{\rvo}{{\mathbf{o}}} \newcommand{\ervo}{{\textnormal{o}}} \newcommand{\rmO}{{\mathbf{O}}} \newcommand{\ermO}{{\textnormal{O}}}
+\newcommand{\rvp}{{\mathbf{p}}} \newcommand{\ervp}{{\textnormal{p}}} \newcommand{\rmP}{{\mathbf{P}}} \newcommand{\ermP}{{\textnormal{P}}}
+\newcommand{\rvq}{{\mathbf{q}}} \newcommand{\ervq}{{\textnormal{q}}} \newcommand{\rmQ}{{\mathbf{Q}}} \newcommand{\ermQ}{{\textnormal{Q}}}
+\newcommand{\rvr}{{\mathbf{r}}} \newcommand{\ervr}{{\textnormal{r}}} \newcommand{\rmR}{{\mathbf{R}}} \newcommand{\ermR}{{\textnormal{R}}}
+\newcommand{\rvs}{{\mathbf{s}}} \newcommand{\ervs}{{\textnormal{s}}} \newcommand{\rmS}{{\mathbf{S}}} \newcommand{\ermS}{{\textnormal{S}}}
+\newcommand{\rvt}{{\mathbf{t}}} \newcommand{\ervt}{{\textnormal{t}}} \newcommand{\rmT}{{\mathbf{T}}} \newcommand{\ermT}{{\textnormal{T}}}
+\newcommand{\rvu}{{\mathbf{u}}} \newcommand{\ervu}{{\textnormal{u}}} \newcommand{\rmU}{{\mathbf{U}}} \newcommand{\ermU}{{\textnormal{U}}}
+\newcommand{\rvv}{{\mathbf{v}}} \newcommand{\ervv}{{\textnormal{v}}} \newcommand{\rmV}{{\mathbf{V}}} \newcommand{\ermV}{{\textnormal{V}}}
+\newcommand{\rvw}{{\mathbf{w}}} \newcommand{\ervw}{{\textnormal{w}}} \newcommand{\rmW}{{\mathbf{W}}} \newcommand{\ermW}{{\textnormal{W}}}
+\newcommand{\rvx}{{\mathbf{x}}} \newcommand{\ervx}{{\textnormal{x}}} \newcommand{\rmX}{{\mathbf{X}}} \newcommand{\ermX}{{\textnormal{X}}}
+\newcommand{\rvy}{{\mathbf{y}}} \newcommand{\ervy}{{\textnormal{y}}} \newcommand{\rmY}{{\mathbf{Y}}} \newcommand{\ermY}{{\textnormal{Y}}}
+\newcommand{\rvz}{{\mathbf{z}}} \newcommand{\ervz}{{\textnormal{z}}} \newcommand{\rmZ}{{\mathbf{Z}}} \newcommand{\ermZ}{{\textnormal{Z}}}
+
+% Don't use a set called E, because this would be the same as our symbol for expectation.
+% Set                          % Graph
+\newcommand{\sA}{{\mathbb{A}}} \newcommand{\gA}{{\mathcal{A}}}
+\newcommand{\sB}{{\mathbb{B}}} \newcommand{\gB}{{\mathcal{B}}}
+\newcommand{\sC}{{\mathbb{C}}} \newcommand{\gC}{{\mathcal{C}}}
+\newcommand{\sD}{{\mathbb{D}}} \newcommand{\gD}{{\mathcal{D}}}
+\newcommand{\sE}{{\mathbb{E}}} \newcommand{\gE}{{\mathcal{E}}}
+\newcommand{\sF}{{\mathbb{F}}} \newcommand{\gF}{{\mathcal{F}}}
+\newcommand{\sG}{{\mathbb{G}}} \newcommand{\gG}{{\mathcal{G}}}
+\newcommand{\sH}{{\mathbb{H}}} \newcommand{\gH}{{\mathcal{H}}}
+\newcommand{\sI}{{\mathbb{I}}} \newcommand{\gI}{{\mathcal{I}}}
+\newcommand{\sJ}{{\mathbb{J}}} \newcommand{\gJ}{{\mathcal{J}}}
+\newcommand{\sK}{{\mathbb{K}}} \newcommand{\gK}{{\mathcal{K}}}
+\newcommand{\sL}{{\mathbb{L}}} \newcommand{\gL}{{\mathcal{L}}}
+\newcommand{\sM}{{\mathbb{M}}} \newcommand{\gM}{{\mathcal{M}}}
+\newcommand{\sN}{{\mathbb{N}}} \newcommand{\gN}{{\mathcal{N}}}
+\newcommand{\sO}{{\mathbb{O}}} \newcommand{\gO}{{\mathcal{O}}}
+\newcommand{\sP}{{\mathbb{P}}} \newcommand{\gP}{{\mathcal{P}}}
+\newcommand{\sQ}{{\mathbb{Q}}} \newcommand{\gQ}{{\mathcal{Q}}}
+\newcommand{\sR}{{\mathbb{R}}} \newcommand{\gR}{{\mathcal{R}}}
+\newcommand{\sS}{{\mathbb{S}}} \newcommand{\gS}{{\mathcal{S}}}
+\newcommand{\sT}{{\mathbb{T}}} \newcommand{\gT}{{\mathcal{T}}}
+\newcommand{\sU}{{\mathbb{U}}} \newcommand{\gU}{{\mathcal{U}}}
+\newcommand{\sV}{{\mathbb{V}}} \newcommand{\gV}{{\mathcal{V}}}
+\newcommand{\sW}{{\mathbb{W}}} \newcommand{\gW}{{\mathcal{W}}}
+\newcommand{\sX}{{\mathbb{X}}} \newcommand{\gX}{{\mathcal{X}}}
+\newcommand{\sY}{{\mathbb{Y}}} \newcommand{\gY}{{\mathcal{Y}}}
+\newcommand{\sZ}{{\mathbb{Z}}} \newcommand{\gZ}{{\mathcal{Z}}}
+
+% Tensor
+\newcommand{\tens}[1]{\bm{\mathsfit{#1}}} % Tensor
+\newcommand{\etens}[1]{\mathsfit{#1}} % Same font as tensor, without \bm wrapper
+% Tensor                     % Entries of a tensor
+\newcommand{\tA}{{\tens{A}}} \newcommand{\etA}{{\etens{A}}}
+\newcommand{\tB}{{\tens{B}}} \newcommand{\etB}{{\etens{B}}}
+\newcommand{\tC}{{\tens{C}}} \newcommand{\etC}{{\etens{C}}}
+\newcommand{\tD}{{\tens{D}}} \newcommand{\etD}{{\etens{D}}}
+\newcommand{\tE}{{\tens{E}}} \newcommand{\etE}{{\etens{E}}}
+\newcommand{\tF}{{\tens{F}}} \newcommand{\etF}{{\etens{F}}}
+\newcommand{\tG}{{\tens{G}}} \newcommand{\etG}{{\etens{G}}}
+\newcommand{\tH}{{\tens{H}}} \newcommand{\etH}{{\etens{H}}}
+\newcommand{\tI}{{\tens{I}}} \newcommand{\etI}{{\etens{I}}}
+\newcommand{\tJ}{{\tens{J}}} \newcommand{\etJ}{{\etens{J}}}
+\newcommand{\tK}{{\tens{K}}} \newcommand{\etK}{{\etens{K}}}
+\newcommand{\tL}{{\tens{L}}} \newcommand{\etL}{{\etens{L}}}
+\newcommand{\tM}{{\tens{M}}} \newcommand{\etM}{{\etens{M}}}
+\newcommand{\tN}{{\tens{N}}} \newcommand{\etN}{{\etens{N}}}
+\newcommand{\tO}{{\tens{O}}} \newcommand{\etO}{{\etens{O}}}
+\newcommand{\tP}{{\tens{P}}} \newcommand{\etP}{{\etens{P}}}
+\newcommand{\tQ}{{\tens{Q}}} \newcommand{\etQ}{{\etens{Q}}}
+\newcommand{\tR}{{\tens{R}}} \newcommand{\etR}{{\etens{R}}}
+\newcommand{\tS}{{\tens{S}}} \newcommand{\etS}{{\etens{S}}}
+\newcommand{\tT}{{\tens{T}}} \newcommand{\etT}{{\etens{T}}}
+\newcommand{\tU}{{\tens{U}}} \newcommand{\etU}{{\etens{U}}}
+\newcommand{\tV}{{\tens{V}}} \newcommand{\etV}{{\etens{V}}}
+\newcommand{\tW}{{\tens{W}}} \newcommand{\etW}{{\etens{W}}}
+\newcommand{\tX}{{\tens{X}}} \newcommand{\etX}{{\etens{X}}}
+\newcommand{\tY}{{\tens{Y}}} \newcommand{\etY}{{\etens{Y}}}
+\newcommand{\tZ}{{\tens{Z}}} \newcommand{\etZ}{{\etens{Z}}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Optional command from author.
+
+% textnormal = $\text{}$
+\newcommand{\tnla}{{\textnormal{a}}} \newcommand{\tnlA}{{\textnormal{A}}}
+\newcommand{\tnlb}{{\textnormal{b}}} \newcommand{\tnlB}{{\textnormal{B}}}
+\newcommand{\tnlc}{{\textnormal{c}}} \newcommand{\tnlC}{{\textnormal{C}}}
+\newcommand{\tnld}{{\textnormal{d}}} \newcommand{\tnlD}{{\textnormal{D}}}
+\newcommand{\tnle}{{\textnormal{e}}} \newcommand{\tnlE}{{\textnormal{E}}}
+\newcommand{\tnlf}{{\textnormal{f}}} \newcommand{\tnlF}{{\textnormal{F}}}
+\newcommand{\tnlg}{{\textnormal{g}}} \newcommand{\tnlG}{{\textnormal{G}}}
+\newcommand{\tnlh}{{\textnormal{h}}} \newcommand{\tnlH}{{\textnormal{H}}}
+\newcommand{\tnli}{{\textnormal{i}}} \newcommand{\tnlI}{{\textnormal{I}}}
+\newcommand{\tnlj}{{\textnormal{j}}} \newcommand{\tnlJ}{{\textnormal{J}}}
+\newcommand{\tnlk}{{\textnormal{k}}} \newcommand{\tnlK}{{\textnormal{K}}}
+\newcommand{\tnll}{{\textnormal{l}}} \newcommand{\tnlL}{{\textnormal{L}}}
+\newcommand{\tnlm}{{\textnormal{m}}} \newcommand{\tnlM}{{\textnormal{M}}}
+\newcommand{\tnln}{{\textnormal{n}}} \newcommand{\tnlN}{{\textnormal{N}}}
+\newcommand{\tnlo}{{\textnormal{o}}} \newcommand{\tnlO}{{\textnormal{O}}}
+\newcommand{\tnlp}{{\textnormal{p}}} \newcommand{\tnlP}{{\textnormal{P}}}
+\newcommand{\tnlq}{{\textnormal{q}}} \newcommand{\tnlQ}{{\textnormal{Q}}}
+\newcommand{\tnlr}{{\textnormal{r}}} \newcommand{\tnlR}{{\textnormal{R}}}
+\newcommand{\tnls}{{\textnormal{s}}} \newcommand{\tnlS}{{\textnormal{S}}}
+\newcommand{\tnlt}{{\textnormal{t}}} \newcommand{\tnlT}{{\textnormal{T}}}
+\newcommand{\tnlu}{{\textnormal{u}}} \newcommand{\tnlU}{{\textnormal{U}}}
+\newcommand{\tnlv}{{\textnormal{v}}} \newcommand{\tnlV}{{\textnormal{V}}}
+\newcommand{\tnlw}{{\textnormal{w}}} \newcommand{\tnlW}{{\textnormal{W}}}
+\newcommand{\tnlx}{{\textnormal{x}}} \newcommand{\tnlX}{{\textnormal{X}}}
+\newcommand{\tnly}{{\textnormal{y}}} \newcommand{\tnlY}{{\textnormal{Y}}}
+\newcommand{\tnlz}{{\textnormal{z}}} \newcommand{\tnlZ}{{\textnormal{Z}}}
+
+% mathnormal = $$
+\newcommand{\mnla}{{\mathnormal{a}}} \newcommand{\mnlA}{{\mathnormal{A}}}
+\newcommand{\mnlb}{{\mathnormal{b}}} \newcommand{\mnlB}{{\mathnormal{B}}}
+\newcommand{\mnlc}{{\mathnormal{c}}} \newcommand{\mnlC}{{\mathnormal{C}}}
+\newcommand{\mnld}{{\mathnormal{d}}} \newcommand{\mnlD}{{\mathnormal{D}}}
+\newcommand{\mnle}{{\mathnormal{e}}} \newcommand{\mnlE}{{\mathnormal{E}}}
+\newcommand{\mnlf}{{\mathnormal{f}}} \newcommand{\mnlF}{{\mathnormal{F}}}
+\newcommand{\mnlg}{{\mathnormal{g}}} \newcommand{\mnlG}{{\mathnormal{G}}}
+\newcommand{\mnlh}{{\mathnormal{h}}} \newcommand{\mnlH}{{\mathnormal{H}}}
+\newcommand{\mnli}{{\mathnormal{i}}} \newcommand{\mnlI}{{\mathnormal{I}}}
+\newcommand{\mnlj}{{\mathnormal{j}}} \newcommand{\mnlJ}{{\mathnormal{J}}}
+\newcommand{\mnlk}{{\mathnormal{k}}} \newcommand{\mnlK}{{\mathnormal{K}}}
+\newcommand{\mnll}{{\mathnormal{l}}} \newcommand{\mnlL}{{\mathnormal{L}}}
+\newcommand{\mnlm}{{\mathnormal{m}}} \newcommand{\mnlM}{{\mathnormal{M}}}
+\newcommand{\mnln}{{\mathnormal{n}}} \newcommand{\mnlN}{{\mathnormal{N}}}
+\newcommand{\mnlo}{{\mathnormal{o}}} \newcommand{\mnlO}{{\mathnormal{O}}}
+\newcommand{\mnlp}{{\mathnormal{p}}} \newcommand{\mnlP}{{\mathnormal{P}}}
+\newcommand{\mnlq}{{\mathnormal{q}}} \newcommand{\mnlQ}{{\mathnormal{Q}}}
+\newcommand{\mnlr}{{\mathnormal{r}}} \newcommand{\mnlR}{{\mathnormal{R}}}
+\newcommand{\mnls}{{\mathnormal{s}}} \newcommand{\mnlS}{{\mathnormal{S}}}
+\newcommand{\mnlt}{{\mathnormal{t}}} \newcommand{\mnlT}{{\mathnormal{T}}}
+\newcommand{\mnlu}{{\mathnormal{u}}} \newcommand{\mnlU}{{\mathnormal{U}}}
+\newcommand{\mnlv}{{\mathnormal{v}}} \newcommand{\mnlV}{{\mathnormal{V}}}
+\newcommand{\mnlw}{{\mathnormal{w}}} \newcommand{\mnlW}{{\mathnormal{W}}}
+\newcommand{\mnlx}{{\mathnormal{x}}} \newcommand{\mnlX}{{\mathnormal{X}}}
+\newcommand{\mnly}{{\mathnormal{y}}} \newcommand{\mnlY}{{\mathnormal{Y}}}
+\newcommand{\mnlz}{{\mathnormal{z}}} \newcommand{\mnlZ}{{\mathnormal{Z}}}
+
+% roman font
+\newcommand{\mrma}{{\mathrm{a}}} \newcommand{\mrmA}{{\mathrm{A}}}
+\newcommand{\mrmb}{{\mathrm{b}}} \newcommand{\mrmB}{{\mathrm{B}}}
+\newcommand{\mrmc}{{\mathrm{c}}} \newcommand{\mrmC}{{\mathrm{C}}}
+\newcommand{\mrmd}{{\mathrm{d}}} \newcommand{\mrmD}{{\mathrm{D}}}
+\newcommand{\mrme}{{\mathrm{e}}} \newcommand{\mrmE}{{\mathrm{E}}}
+\newcommand{\mrmf}{{\mathrm{f}}} \newcommand{\mrmF}{{\mathrm{F}}}
+\newcommand{\mrmg}{{\mathrm{g}}} \newcommand{\mrmG}{{\mathrm{G}}}
+\newcommand{\mrmh}{{\mathrm{h}}} \newcommand{\mrmH}{{\mathrm{H}}}
+\newcommand{\mrmi}{{\mathrm{i}}} \newcommand{\mrmI}{{\mathrm{I}}}
+\newcommand{\mrmj}{{\mathrm{j}}} \newcommand{\mrmJ}{{\mathrm{J}}}
+\newcommand{\mrmk}{{\mathrm{k}}} \newcommand{\mrmK}{{\mathrm{K}}}
+\newcommand{\mrml}{{\mathrm{l}}} \newcommand{\mrmL}{{\mathrm{L}}}
+\newcommand{\mrmm}{{\mathrm{m}}} \newcommand{\mrmM}{{\mathrm{M}}}
+\newcommand{\mrmn}{{\mathrm{n}}} \newcommand{\mrmN}{{\mathrm{N}}}
+\newcommand{\mrmo}{{\mathrm{o}}} \newcommand{\mrmO}{{\mathrm{O}}}
+\newcommand{\mrmp}{{\mathrm{p}}} \newcommand{\mrmP}{{\mathrm{P}}}
+\newcommand{\mrmq}{{\mathrm{q}}} \newcommand{\mrmQ}{{\mathrm{Q}}}
+\newcommand{\mrmr}{{\mathrm{r}}} \newcommand{\mrmR}{{\mathrm{R}}}
+\newcommand{\mrms}{{\mathrm{s}}} \newcommand{\mrmS}{{\mathrm{S}}}
+\newcommand{\mrmt}{{\mathrm{t}}} \newcommand{\mrmT}{{\mathrm{T}}}
+\newcommand{\mrmu}{{\mathrm{u}}} \newcommand{\mrmU}{{\mathrm{U}}}
+\newcommand{\mrmv}{{\mathrm{v}}} \newcommand{\mrmV}{{\mathrm{V}}}
+\newcommand{\mrmw}{{\mathrm{w}}} \newcommand{\mrmW}{{\mathrm{W}}}
+\newcommand{\mrmx}{{\mathrm{x}}} \newcommand{\mrmX}{{\mathrm{X}}}
+\newcommand{\mrmy}{{\mathrm{y}}} \newcommand{\mrmY}{{\mathrm{Y}}}
+\newcommand{\mrmz}{{\mathrm{z}}} \newcommand{\mrmZ}{{\mathrm{Z}}}
+
+% Bold roman font
+\newcommand{\mbfa}{{\mathbf{a}}} \newcommand{\mbfA}{{\mathbf{A}}}
+\newcommand{\mbfb}{{\mathbf{b}}} \newcommand{\mbfB}{{\mathbf{B}}}
+\newcommand{\mbfc}{{\mathbf{c}}} \newcommand{\mbfC}{{\mathbf{C}}}
+\newcommand{\mbfd}{{\mathbf{d}}} \newcommand{\mbfD}{{\mathbf{D}}}
+\newcommand{\mbfe}{{\mathbf{e}}} \newcommand{\mbfE}{{\mathbf{E}}}
+\newcommand{\mbff}{{\mathbf{f}}} \newcommand{\mbfF}{{\mathbf{F}}}
+\newcommand{\mbfg}{{\mathbf{g}}} \newcommand{\mbfG}{{\mathbf{G}}}
+\newcommand{\mbfh}{{\mathbf{h}}} \newcommand{\mbfH}{{\mathbf{H}}}
+\newcommand{\mbfi}{{\mathbf{i}}} \newcommand{\mbfI}{{\mathbf{I}}}
+\newcommand{\mbfj}{{\mathbf{j}}} \newcommand{\mbfJ}{{\mathbf{J}}}
+\newcommand{\mbfk}{{\mathbf{k}}} \newcommand{\mbfK}{{\mathbf{K}}}
+\newcommand{\mbfl}{{\mathbf{l}}} \newcommand{\mbfL}{{\mathbf{L}}}
+\newcommand{\mbfm}{{\mathbf{m}}} \newcommand{\mbfM}{{\mathbf{M}}}
+\newcommand{\mbfn}{{\mathbf{n}}} \newcommand{\mbfN}{{\mathbf{N}}}
+\newcommand{\mbfo}{{\mathbf{o}}} \newcommand{\mbfO}{{\mathbf{O}}}
+\newcommand{\mbfp}{{\mathbf{p}}} \newcommand{\mbfP}{{\mathbf{P}}}
+\newcommand{\mbfq}{{\mathbf{q}}} \newcommand{\mbfQ}{{\mathbf{Q}}}
+\newcommand{\mbfr}{{\mathbf{r}}} \newcommand{\mbfR}{{\mathbf{R}}}
+\newcommand{\mbfs}{{\mathbf{s}}} \newcommand{\mbfS}{{\mathbf{S}}}
+\newcommand{\mbft}{{\mathbf{t}}} \newcommand{\mbfT}{{\mathbf{T}}}
+\newcommand{\mbfu}{{\mathbf{u}}} \newcommand{\mbfU}{{\mathbf{U}}}
+\newcommand{\mbfv}{{\mathbf{v}}} \newcommand{\mbfV}{{\mathbf{V}}}
+\newcommand{\mbfw}{{\mathbf{w}}} \newcommand{\mbfW}{{\mathbf{W}}}
+\newcommand{\mbfx}{{\mathbf{x}}} \newcommand{\mbfX}{{\mathbf{X}}}
+\newcommand{\mbfy}{{\mathbf{y}}} \newcommand{\mbfY}{{\mathbf{Y}}}
+\newcommand{\mbfz}{{\mathbf{z}}} \newcommand{\mbfZ}{{\mathbf{Z}}}
+
+% sans serif font
+\newcommand{\msfa}{{\mathsf{a}}} \newcommand{\msfA}{{\mathsf{A}}}
+\newcommand{\msfb}{{\mathsf{b}}} \newcommand{\msfB}{{\mathsf{B}}}
+\newcommand{\msfc}{{\mathsf{c}}} \newcommand{\msfC}{{\mathsf{C}}}
+\newcommand{\msfd}{{\mathsf{d}}} \newcommand{\msfD}{{\mathsf{D}}}
+\newcommand{\msfe}{{\mathsf{e}}} \newcommand{\msfE}{{\mathsf{E}}}
+\newcommand{\msff}{{\mathsf{f}}} \newcommand{\msfF}{{\mathsf{F}}}
+\newcommand{\msfg}{{\mathsf{g}}} \newcommand{\msfG}{{\mathsf{G}}}
+\newcommand{\msfh}{{\mathsf{h}}} \newcommand{\msfH}{{\mathsf{H}}}
+\newcommand{\msfi}{{\mathsf{i}}} \newcommand{\msfI}{{\mathsf{I}}}
+\newcommand{\msfj}{{\mathsf{j}}} \newcommand{\msfJ}{{\mathsf{J}}}
+\newcommand{\msfk}{{\mathsf{k}}} \newcommand{\msfK}{{\mathsf{K}}}
+\newcommand{\msfl}{{\mathsf{l}}} \newcommand{\msfL}{{\mathsf{L}}}
+\newcommand{\msfm}{{\mathsf{m}}} \newcommand{\msfM}{{\mathsf{M}}}
+\newcommand{\msfn}{{\mathsf{n}}} \newcommand{\msfN}{{\mathsf{N}}}
+\newcommand{\msfo}{{\mathsf{o}}} \newcommand{\msfO}{{\mathsf{O}}}
+\newcommand{\msfp}{{\mathsf{p}}} \newcommand{\msfP}{{\mathsf{P}}}
+\newcommand{\msfq}{{\mathsf{q}}} \newcommand{\msfQ}{{\mathsf{Q}}}
+\newcommand{\msfr}{{\mathsf{r}}} \newcommand{\msfR}{{\mathsf{R}}}
+\newcommand{\msfs}{{\mathsf{s}}} \newcommand{\msfS}{{\mathsf{S}}}
+\newcommand{\msft}{{\mathsf{t}}} \newcommand{\msfT}{{\mathsf{T}}}
+\newcommand{\msfu}{{\mathsf{u}}} \newcommand{\msfU}{{\mathsf{U}}}
+\newcommand{\msfv}{{\mathsf{v}}} \newcommand{\msfV}{{\mathsf{V}}}
+\newcommand{\msfw}{{\mathsf{w}}} \newcommand{\msfW}{{\mathsf{W}}}
+\newcommand{\msfx}{{\mathsf{x}}} \newcommand{\msfX}{{\mathsf{X}}}
+\newcommand{\msfy}{{\mathsf{y}}} \newcommand{\msfY}{{\mathsf{Y}}}
+\newcommand{\msfz}{{\mathsf{z}}} \newcommand{\msfZ}{{\mathsf{Z}}}
+
+% text italic font
+\newcommand{\mita}{{\mathit{a}}} \newcommand{\mitA}{{\mathit{A}}}
+\newcommand{\mitb}{{\mathit{b}}} \newcommand{\mitB}{{\mathit{B}}}
+\newcommand{\mitc}{{\mathit{c}}} \newcommand{\mitC}{{\mathit{C}}}
+\newcommand{\mitd}{{\mathit{d}}} \newcommand{\mitD}{{\mathit{D}}}
+\newcommand{\mite}{{\mathit{e}}} \newcommand{\mitE}{{\mathit{E}}}
+\newcommand{\mitf}{{\mathit{f}}} \newcommand{\mitF}{{\mathit{F}}}
+\newcommand{\mitg}{{\mathit{g}}} \newcommand{\mitG}{{\mathit{G}}}
+\newcommand{\mith}{{\mathit{h}}} \newcommand{\mitH}{{\mathit{H}}}
+\newcommand{\miti}{{\mathit{i}}} \newcommand{\mitI}{{\mathit{I}}}
+\newcommand{\mitj}{{\mathit{j}}} \newcommand{\mitJ}{{\mathit{J}}}
+\newcommand{\mitk}{{\mathit{k}}} \newcommand{\mitK}{{\mathit{K}}}
+\newcommand{\mitl}{{\mathit{l}}} \newcommand{\mitL}{{\mathit{L}}}
+\newcommand{\mitm}{{\mathit{m}}} \newcommand{\mitM}{{\mathit{M}}}
+\newcommand{\mitn}{{\mathit{n}}} \newcommand{\mitN}{{\mathit{N}}}
+\newcommand{\mito}{{\mathit{o}}} \newcommand{\mitO}{{\mathit{O}}}
+\newcommand{\mitp}{{\mathit{p}}} \newcommand{\mitP}{{\mathit{P}}}
+\newcommand{\mitq}{{\mathit{q}}} \newcommand{\mitQ}{{\mathit{Q}}}
+\newcommand{\mitr}{{\mathit{r}}} \newcommand{\mitR}{{\mathit{R}}}
+\newcommand{\mits}{{\mathit{s}}} \newcommand{\mitS}{{\mathit{S}}}
+\newcommand{\mitt}{{\mathit{t}}} \newcommand{\mitT}{{\mathit{T}}}
+\newcommand{\mitu}{{\mathit{u}}} \newcommand{\mitU}{{\mathit{U}}}
+\newcommand{\mitv}{{\mathit{v}}} \newcommand{\mitV}{{\mathit{V}}}
+\newcommand{\mitw}{{\mathit{w}}} \newcommand{\mitW}{{\mathit{W}}}
+\newcommand{\mitx}{{\mathit{x}}} \newcommand{\mitX}{{\mathit{X}}}
+\newcommand{\mity}{{\mathit{y}}} \newcommand{\mitY}{{\mathit{Y}}}
+\newcommand{\mitz}{{\mathit{z}}} \newcommand{\mitZ}{{\mathit{Z}}}
+
+% typewriter font
+\newcommand{\mtta}{{\mathtt{a}}} \newcommand{\mttA}{{\mathtt{A}}}
+\newcommand{\mttb}{{\mathtt{b}}} \newcommand{\mttB}{{\mathtt{B}}}
+\newcommand{\mttc}{{\mathtt{c}}} \newcommand{\mttC}{{\mathtt{C}}}
+\newcommand{\mttd}{{\mathtt{d}}} \newcommand{\mttD}{{\mathtt{D}}}
+\newcommand{\mtte}{{\mathtt{e}}} \newcommand{\mttE}{{\mathtt{E}}}
+\newcommand{\mttf}{{\mathtt{f}}} \newcommand{\mttF}{{\mathtt{F}}}
+\newcommand{\mttg}{{\mathtt{g}}} \newcommand{\mttG}{{\mathtt{G}}}
+\newcommand{\mtth}{{\mathtt{h}}} \newcommand{\mttH}{{\mathtt{H}}}
+\newcommand{\mtti}{{\mathtt{i}}} \newcommand{\mttI}{{\mathtt{I}}}
+\newcommand{\mttj}{{\mathtt{j}}} \newcommand{\mttJ}{{\mathtt{J}}}
+\newcommand{\mttk}{{\mathtt{k}}} \newcommand{\mttK}{{\mathtt{K}}}
+\newcommand{\mttl}{{\mathtt{l}}} \newcommand{\mttL}{{\mathtt{L}}}
+\newcommand{\mttm}{{\mathtt{m}}} \newcommand{\mttM}{{\mathtt{M}}}
+\newcommand{\mttn}{{\mathtt{n}}} \newcommand{\mttN}{{\mathtt{N}}}
+\newcommand{\mtto}{{\mathtt{o}}} \newcommand{\mttO}{{\mathtt{O}}}
+\newcommand{\mttp}{{\mathtt{p}}} \newcommand{\mttP}{{\mathtt{P}}}
+\newcommand{\mttq}{{\mathtt{q}}} \newcommand{\mttQ}{{\mathtt{Q}}}
+\newcommand{\mttr}{{\mathtt{r}}} \newcommand{\mttR}{{\mathtt{R}}}
+\newcommand{\mtts}{{\mathtt{s}}} \newcommand{\mttS}{{\mathtt{S}}}
+\newcommand{\mttt}{{\mathtt{t}}} \newcommand{\mttT}{{\mathtt{T}}}
+\newcommand{\mttu}{{\mathtt{u}}} \newcommand{\mttU}{{\mathtt{U}}}
+\newcommand{\mttv}{{\mathtt{v}}} \newcommand{\mttV}{{\mathtt{V}}}
+\newcommand{\mttw}{{\mathtt{w}}} \newcommand{\mttW}{{\mathtt{W}}}
+\newcommand{\mttx}{{\mathtt{x}}} \newcommand{\mttX}{{\mathtt{X}}}
+\newcommand{\mtty}{{\mathtt{y}}} \newcommand{\mttY}{{\mathtt{Y}}}
+\newcommand{\mttz}{{\mathtt{z}}} \newcommand{\mttZ}{{\mathtt{Z}}}
+
+% fraktur font
+\newcommand{\mfraka}{{\mathfrak{a}}} \newcommand{\mfrakA}{{\mathfrak{A}}}
+\newcommand{\mfrakb}{{\mathfrak{b}}} \newcommand{\mfrakB}{{\mathfrak{B}}}
+\newcommand{\mfrakc}{{\mathfrak{c}}} \newcommand{\mfrakC}{{\mathfrak{C}}}
+\newcommand{\mfrakd}{{\mathfrak{d}}} \newcommand{\mfrakD}{{\mathfrak{D}}}
+\newcommand{\mfrake}{{\mathfrak{e}}} \newcommand{\mfrakE}{{\mathfrak{E}}}
+\newcommand{\mfrakf}{{\mathfrak{f}}} \newcommand{\mfrakF}{{\mathfrak{F}}}
+\newcommand{\mfrakg}{{\mathfrak{g}}} \newcommand{\mfrakG}{{\mathfrak{G}}}
+\newcommand{\mfrakh}{{\mathfrak{h}}} \newcommand{\mfrakH}{{\mathfrak{H}}}
+\newcommand{\mfraki}{{\mathfrak{i}}} \newcommand{\mfrakI}{{\mathfrak{I}}}
+\newcommand{\mfrakj}{{\mathfrak{j}}} \newcommand{\mfrakJ}{{\mathfrak{J}}}
+\newcommand{\mfrakk}{{\mathfrak{k}}} \newcommand{\mfrakK}{{\mathfrak{K}}}
+\newcommand{\mfrakl}{{\mathfrak{l}}} \newcommand{\mfrakL}{{\mathfrak{L}}}
+\newcommand{\mfrakm}{{\mathfrak{m}}} \newcommand{\mfrakM}{{\mathfrak{M}}}
+\newcommand{\mfrakn}{{\mathfrak{n}}} \newcommand{\mfrakN}{{\mathfrak{N}}}
+\newcommand{\mfrako}{{\mathfrak{o}}} \newcommand{\mfrakO}{{\mathfrak{O}}}
+\newcommand{\mfrakp}{{\mathfrak{p}}} \newcommand{\mfrakP}{{\mathfrak{P}}}
+\newcommand{\mfrakq}{{\mathfrak{q}}} \newcommand{\mfrakQ}{{\mathfrak{Q}}}
+\newcommand{\mfrakr}{{\mathfrak{r}}} \newcommand{\mfrakR}{{\mathfrak{R}}}
+\newcommand{\mfraks}{{\mathfrak{s}}} \newcommand{\mfrakS}{{\mathfrak{S}}}
+\newcommand{\mfrakt}{{\mathfrak{t}}} \newcommand{\mfrakT}{{\mathfrak{T}}}
+\newcommand{\mfraku}{{\mathfrak{u}}} \newcommand{\mfrakU}{{\mathfrak{U}}}
+\newcommand{\mfrakv}{{\mathfrak{v}}} \newcommand{\mfrakV}{{\mathfrak{V}}}
+\newcommand{\mfrakw}{{\mathfrak{w}}} \newcommand{\mfrakW}{{\mathfrak{W}}}
+\newcommand{\mfrakx}{{\mathfrak{x}}} \newcommand{\mfrakX}{{\mathfrak{X}}}
+\newcommand{\mfraky}{{\mathfrak{y}}} \newcommand{\mfrakY}{{\mathfrak{Y}}}
+\newcommand{\mfrakz}{{\mathfrak{z}}} \newcommand{\mfrakZ}{{\mathfrak{Z}}}
+
+% Set                            % Graph                            % Group (Algebra)
+\newcommand{\mbbA}{{\mathbb{A}}} \newcommand{\mcalA}{{\mathcal{A}}} \newcommand{\mscrA}{{\mathscr{A}}}
+\newcommand{\mbbB}{{\mathbb{B}}} \newcommand{\mcalB}{{\mathcal{B}}} \newcommand{\mscrB}{{\mathscr{B}}}
+\newcommand{\mbbC}{{\mathbb{C}}} \newcommand{\mcalC}{{\mathcal{C}}} \newcommand{\mscrC}{{\mathscr{C}}}
+\newcommand{\mbbD}{{\mathbb{D}}} \newcommand{\mcalD}{{\mathcal{D}}} \newcommand{\mscrD}{{\mathscr{D}}}
+\newcommand{\mbbE}{{\mathbb{E}}} \newcommand{\mcalE}{{\mathcal{E}}} \newcommand{\mscrE}{{\mathscr{E}}}
+\newcommand{\mbbF}{{\mathbb{F}}} \newcommand{\mcalF}{{\mathcal{F}}} \newcommand{\mscrF}{{\mathscr{F}}}
+\newcommand{\mbbG}{{\mathbb{G}}} \newcommand{\mcalG}{{\mathcal{G}}} \newcommand{\mscrG}{{\mathscr{G}}}
+\newcommand{\mbbH}{{\mathbb{H}}} \newcommand{\mcalH}{{\mathcal{H}}} \newcommand{\mscrH}{{\mathscr{H}}}
+\newcommand{\mbbI}{{\mathbb{I}}} \newcommand{\mcalI}{{\mathcal{I}}} \newcommand{\mscrI}{{\mathscr{I}}}
+\newcommand{\mbbJ}{{\mathbb{J}}} \newcommand{\mcalJ}{{\mathcal{J}}} \newcommand{\mscrJ}{{\mathscr{J}}}
+\newcommand{\mbbK}{{\mathbb{K}}} \newcommand{\mcalK}{{\mathcal{K}}} \newcommand{\mscrK}{{\mathscr{K}}}
+\newcommand{\mbbL}{{\mathbb{L}}} \newcommand{\mcalL}{{\mathcal{L}}} \newcommand{\mscrL}{{\mathscr{L}}}
+\newcommand{\mbbM}{{\mathbb{M}}} \newcommand{\mcalM}{{\mathcal{M}}} \newcommand{\mscrM}{{\mathscr{M}}}
+\newcommand{\mbbN}{{\mathbb{N}}} \newcommand{\mcalN}{{\mathcal{N}}} \newcommand{\mscrN}{{\mathscr{N}}}
+\newcommand{\mbbO}{{\mathbb{O}}} \newcommand{\mcalO}{{\mathcal{O}}} \newcommand{\mscrO}{{\mathscr{O}}}
+\newcommand{\mbbP}{{\mathbb{P}}} \newcommand{\mcalP}{{\mathcal{P}}} \newcommand{\mscrP}{{\mathscr{P}}}
+\newcommand{\mbbQ}{{\mathbb{Q}}} \newcommand{\mcalQ}{{\mathcal{Q}}} \newcommand{\mscrQ}{{\mathscr{Q}}}
+\newcommand{\mbbR}{{\mathbb{R}}} \newcommand{\mcalR}{{\mathcal{R}}} \newcommand{\mscrR}{{\mathscr{R}}}
+\newcommand{\mbbS}{{\mathbb{S}}} \newcommand{\mcalS}{{\mathcal{S}}} \newcommand{\mscrS}{{\mathscr{S}}}
+\newcommand{\mbbT}{{\mathbb{T}}} \newcommand{\mcalT}{{\mathcal{T}}} \newcommand{\mscrT}{{\mathscr{T}}}
+\newcommand{\mbbU}{{\mathbb{U}}} \newcommand{\mcalU}{{\mathcal{U}}} \newcommand{\mscrU}{{\mathscr{U}}}
+\newcommand{\mbbV}{{\mathbb{V}}} \newcommand{\mcalV}{{\mathcal{V}}} \newcommand{\mscrV}{{\mathscr{V}}}
+\newcommand{\mbbW}{{\mathbb{W}}} \newcommand{\mcalW}{{\mathcal{W}}} \newcommand{\mscrW}{{\mathscr{W}}}
+\newcommand{\mbbX}{{\mathbb{X}}} \newcommand{\mcalX}{{\mathcal{X}}} \newcommand{\mscrX}{{\mathscr{X}}}
+\newcommand{\mbbY}{{\mathbb{Y}}} \newcommand{\mcalY}{{\mathcal{Y}}} \newcommand{\mscrY}{{\mathscr{Y}}}
+\newcommand{\mbbZ}{{\mathbb{Z}}} \newcommand{\mcalZ}{{\mathcal{Z}}} \newcommand{\mscrZ}{{\mathscr{Z}}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Some commonly used cases
+% Vectors
+\newcommand{\vzero}{{\bm{0}}}
+\newcommand{\vone}{{\bm{1}}}
+\newcommand{\vmu}{{\bm{\mu}}}
+\newcommand{\vtheta}{{\bm{\theta}}}
+% Elements of vectors
+\newcommand{\evalpha}{{\alpha}}
+\newcommand{\evbeta}{{\beta}}
+\newcommand{\evepsilon}{{\epsilon}}
+\newcommand{\evlambda}{{\lambda}}
+\newcommand{\evomega}{{\omega}}
+\newcommand{\evmu}{{\mu}}
+\newcommand{\evpsi}{{\psi}}
+\newcommand{\evsigma}{{\sigma}}
+\newcommand{\evtheta}{{\theta}}
+% Matrix
+\newcommand{\mBeta}{{\bm{\Beta}}}
+\newcommand{\mPhi}{{\bm{\Phi}}}
+\newcommand{\mLambda}{{\bm{\Lambda}}}
+\newcommand{\mSigma}{{\bm{\Sigma}}}
+% Entries of a matrix
+\newcommand{\emLambda}{{\Lambda}}
+\newcommand{\emSigma}{{\Sigma}}
+% Random variables
+\newcommand{\reta}{{\textnormal{\(\eta \)}}}
+% Random vectors
+\newcommand{\rvepsilon}{{\mathbf{\epsilon}}}
+\newcommand{\rvtheta}{{\mathbf{\theta}}}
+% Entries of a tensor
+\newcommand{\etLambda}{{\etens{\Lambda}}}
+
+%%%-------------------------------------------------------------------------%%%
+%% function
+\newcommand{\R}{{\mathbb{R}}} % domain
+
+%% probability
+\newcommand{\E}{{\mathbb{E}}} % expectation
+\newcommand{\Var}{{\mathrm{Var}}} % variance
+\newcommand{\Std}{{\mathrm{Std}}} % standard variance
+\newcommand{\Cov}{{\mathrm{Cov}}} % covariance
+\newcommand{\KL}{{D_{\mathrm{KL}}}} % KL divergence
+\newcommand{\standarderror}{{\mathrm{SE}}} % standard error
+
+%% norm
+% Wolfram Mathworld says $L^2$ is for function spaces and $\ell^2$ is for vectors
+% But then they seem to use $L^2$ for vectors throughout the site, and so does
+% wikipedia.
+\newcommand{\normLzero}{L^0}
+\newcommand{\normLone}{L^1}
+\newcommand{\normLtwo}{L^2}
+\newcommand{\normLp}{L^p}
+\newcommand{\normLinfty}{L^\infty}
+\newcommand{\normlzero}{\ell^0}
+\newcommand{\normlone}{\ell^1}
+\newcommand{\normltwo}{\ell^2}
+\newcommand{\normlp}{\ell^p}
+\newcommand{\normlinfty}{\ell^\infty}
+
+%% Number
+\newcommand{\1}{{\bm{1}}}
+
+%% other
+\newcommand{\Ls}{{\mathcal{L}}}
+\newcommand{\emp}{{\tilde{p}}}
+\newcommand{\lr}{{\alpha}}
+\newcommand{\reg}{{\lambda}}
+\newcommand{\rect}{{\mathrm{rectifier}}}
+\newcommand{\eps}{{\epsilon}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Machine Learning
+% The true underlying data generating distribution
+\newcommand{\pdata}{{p_{\textrm{data}}}}
+% The empirical distribution defined by the training set
+\newcommand{\ptrain}{{\hat{p}_{\textrm{data}}}}
+\newcommand{\Ptrain}{{\hat{P}_{\textrm{data}}}}
+% The model distribution
+\newcommand{\pmodel}{{p_{\textrm{model}}}}
+\newcommand{\Pmodel}{{P_{\textrm{model}}}}
+\newcommand{\ptildemodel}{{\tilde{p}_{\textrm{model}}}}
+% Stochastic autoencoder distributions
+\newcommand{\pencode}{{p_{\textrm{encoder}}}}
+\newcommand{\pdecode}{{p_{\textrm{decoder}}}}
+\newcommand{\precons}{{p_{\textrm{reconstruct}}}}
+% Laplace distribution
+\newcommand{\laplace}{{\mathrm{Laplace}}}
+%
+\newcommand{\train}{\mathcal{D}}
+\newcommand{\valid}{\mathcal{D_{\mathrm{valid}}}}
+\newcommand{\test}{\mathcal{D_{\mathrm{test}}}}
+%
+\newcommand{\parents}{Pa} % See usage in notation.tex. Chosen to match Daphne's book.
+%
+\newcommand{\softmax}{{\mathrm{softmax}}}
+\newcommand{\sigmoid}{{\sigma}}
+\newcommand{\softplus}{{\zeta}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Mark sections of captions for referring to divisions of figures
+\newcommand{\figleft}{{\em (Left)\/}}
+\newcommand{\figcenter}{{\em (Center)\/}}
+\newcommand{\figright}{{\em (Right)\/}}
+\newcommand{\figtop}{{\em (Top)\/}}
+\newcommand{\figbottom}{{\em (Bottom)\/}}
+\newcommand{\captiona}{{\em (a)\/}}
+\newcommand{\captionb}{{\em (b)\/}}
+\newcommand{\captionc}{{\em (c)\/}}
+\newcommand{\captiond}{{\em (d)\/}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Figure, Table, Equation, Algorithm, Section, Chapter, Part
+
+% ==================== FIGURE REFERENCES ====================
+% Single figure reference (lowercase)
+\providecommand{\onefigref}[1]{\hyperref[#1]{figure~\ref*{#1}}}
+% Multiple figure references (lowercase)
+\providecommand{\twofigrefs}[2]{\hyperref[#1]{figures~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threefigrefs}[3]{\hyperref[#1]{figures~\ref*{#1},~\ref*{#2},~and~\ref*{#3}}}
+\providecommand{\fourfigrefs}[4]{\hyperref[#1]{figures~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% Single figure reference (sentence start, capitalized)
+\providecommand{\oneFigref}[1]{\hyperref[#1]{Figure~\ref*{#1}}}
+% Purpose: Creates clickable "Figure X" reference for beginning of sentences
+% - Uses \hyperref for clickable link
+% - \ref* prevents nested hyperlinks
+% - ~ ensures unbreakable space
+% Multiple figure references (capitalized)
+\providecommand{\twoFigrefs}[2]{\hyperref[#1]{Figures~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeFigrefs}[3]{\hyperref[#1]{Figures~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fourFigrefs}[4]{\hyperref[#1]{Figures~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% ==================== TABLE REFERENCES ====================
+% Table references (lowercase)
+\providecommand{\onetableref}[1]{\hyperref[#1]{table~\ref*{#1}}}
+\providecommand{\twotablerefs}[2]{\hyperref[#1]{tables~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threetablerefs}[3]{\hyperref[#1]{tables~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fourtablerefs}[4]{\hyperref[#1]{tables~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% Table references (capitalized)
+\providecommand{\oneTableref}[1]{\hyperref[#1]{Table~\ref*{#1}}}
+\providecommand{\twoTablerefs}[2]{\hyperref[#1]{Tables~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeTablerefs}[3]{\hyperref[#1]{Tables~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fourTablerefs}[4]{\hyperref[#1]{Tables~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% ==================== EQUATION REFERENCES ====================
+% Equation references (lowercase)
+\providecommand{\oneeqref}[1]{\hyperref[#1]{equation~\ref*{#1}}}
+\providecommand{\twoeqrefs}[2]{\hyperref[#1]{equations~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeeqrefs}[3]{\hyperref[#1]{equations~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\foureqrefs}[4]{\hyperref[#1]{equations~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% Equation references (capitalized)
+\providecommand{\oneEqref}[1]{\hyperref[#1]{Equation~\ref*{#1}}}
+\providecommand{\twoEqrefs}[2]{\hyperref[#1]{Equations~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeEqrefs}[3]{\hyperref[#1]{Equations~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fourEqrefs}[4]{\hyperref[#1]{Equations~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% Plain equation reference
+\providecommand{\plaineqref}[1]{\hyperref[#1]{\ref*{#1}}}
+
+% ==================== ALGORITHM REFERENCES ====================
+% Algorithm references (lowercase)
+\providecommand{\onealgref}[1]{\hyperref[#1]{algorithm~\ref*{#1}}}
+\providecommand{\twoalgrefs}[2]{\hyperref[#1]{algorithms~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threealgrefs}[3]{\hyperref[#1]{algorithms~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fouralgrefs}[4]{\hyperref[#1]{algorithms~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% Algorithm references (capitalized)
+\providecommand{\oneAlgref}[1]{\hyperref[#1]{Algorithm~\ref*{#1}}}
+\providecommand{\twoAlgrefs}[2]{\hyperref[#1]{Algorithms~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeAlgrefs}[3]{\hyperref[#1]{Algorithms~\ref*{#1},~\ref*{#2}, and~\ref*{#3}}}
+\providecommand{\fourAlgrefs}[4]{\hyperref[#1]{Algorithms~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+
+% ==================== SECTION REFERENCES ====================
+% Section references (lowercase)
+\providecommand{\onesecref}[1]{\hyperref[#1]{section~\ref*{#1}}}
+\providecommand{\twosecrefs}[2]{\hyperref[#1]{sections~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threesecrefs}[3]{\hyperref[#1]{sections~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\foursecrefs}[4]{\hyperref[#1]{sections~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangesecrefs}[2]{\hyperref[#1]{sections~\ref*{#1}--\ref*{#2}}}
+
+% Section references (capitalized)
+\providecommand{\oneSecref}[1]{\hyperref[#1]{Section~\ref*{#1}}}
+\providecommand{\twoSecrefs}[2]{\hyperref[#1]{Sections~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeSecrefs}[3]{\hyperref[#1]{Sections~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\fourSecrefs}[4]{\hyperref[#1]{Sections~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangeSecrefs}[2]{\hyperref[#1]{Sections~\ref*{#1}--\ref*{#2}}}
+
+% ==================== CHAPTER REFERENCES ====================
+% Chapter references (lowercase)
+\providecommand{\onechapref}[1]{\hyperref[#1]{chapter~\ref*{#1}}}
+\providecommand{\twochaprefs}[2]{\hyperref[#1]{chapters~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threechaprefs}[3]{\hyperref[#1]{chapters~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\fourchaprefs}[4]{\hyperref[#1]{chapters~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangechaprefs}[2]{\hyperref[#1]{chapters~\ref*{#1}--\ref*{#2}}}
+
+% Chapter references (capitalized)
+\providecommand{\oneChapref}[1]{\hyperref[#1]{Chapter~\ref*{#1}}}
+\providecommand{\twoChaprefs}[2]{\hyperref[#1]{Chapters~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threeChaprefs}[3]{\hyperref[#1]{Chapters~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\fourChaprefs}[4]{\hyperref[#1]{Chapters~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangeChaprefs}[2]{\hyperref[#1]{Chapters~\ref*{#1}--\ref*{#2}}}
+
+% ==================== PART REFERENCES ====================
+% Part references (lowercase)
+\providecommand{\onepartref}[1]{\hyperref[#1]{part~\ref*{#1}}}
+\providecommand{\twopartrefs}[2]{\hyperref[#1]{parts~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threepartrefs}[3]{\hyperref[#1]{parts~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\fourpartrefs}[4]{\hyperref[#1]{parts~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangepartrefs}[2]{\hyperref[#1]{parts~\ref*{#1}--\ref*{#2}}}
+
+% Part references (capitalized)
+\providecommand{\onePartref}[1]{\hyperref[#1]{Part~\ref*{#1}}}
+\providecommand{\twoPartrefs}[2]{\hyperref[#1]{Parts~\ref*{#1} and~\ref*{#2}}}
+\providecommand{\threePartrefs}[3]{\hyperref[#1]{Parts~\ref*{#1},~\ref*{#2} and~\ref*{#3}}}
+\providecommand{\fourPartrefs}[4]{\hyperref[#1]{Parts~\ref*{#1},~\ref*{#2},~\ref*{#3} and~\ref*{#4}}}
+\providecommand{\rangePartrefs}[2]{\hyperref[#1]{Parts~\ref*{#1}--\ref*{#2}}}
+
+% ==================== IMPLEMENTATION NOTES ====================
+% 1. All commands use \providecommand to prevent redefine errors
+% 2. Hyperlinks are attached to the full reference text
+% 3. \ref* prevents nested hyperlinks within \hyperref
+% 4. Punctuation follows English typesetting conventions
+% 5. Requires packages:
+% \usepackage{hyperref} % For hyperlink support
+% \usepackage{cleveref} % Optional for advanced referencing
+
+% ==================== RECOMMENDED PRACTICES ====================
+% 1. Use consistent label prefixes (fig:, tab:, eq:, etc.)
+% 2. For advanced features, consider using cleveref instead:
+% \crefname{figure}{figure}{figures} % Singular/plural forms
+% \Crefname{figure}{Figure}{Figures} % Capitalized versions
+% Then use \cref{fig:1} or \Cref{fig:1} for auto-formatting
+
+%%%-------------------------------------------------------------------------%%%
+%% newcommand for math
+\newcommand{\abs}[1]{\left\vert#1\right\vert}
+\newcommand{\norm}[1]{\left\Vert#1\right\Vert}
+\newcommand{\ceil}[1]{\lceil#1\rceil}
+\newcommand{\floor}[1]{\lfloor#1\rfloor}
+
+%% DeclareMathOperator
+\DeclareMathOperator*{\argmax}{arg\,max}
+\DeclareMathOperator*{\argmin}{arg\,min}
+\DeclareMathOperator{\sign}{sign}
+\DeclareMathOperator{\Tr}{Tr}
+
+%%%-------------------------------------------------------------------------%%%
+%% newcommand for table
+\newcommand{\mr}[2]{\multirow{#1}{#2}}
+\newcommand{\mc}[2]{\multicolumn{#1}{#2}}
+
+%%%-------------------------------------------------------------------------%%%
+%% Highlight a newly defined term
+\newcommand{\newterm}[1]{{\textbf #1}}

pyeasyphd-0.3.3/pyeasyphd/scripts/run_beamer_tex.py

@@ -0,0 +1,105 @@
+import os
+
+from pyeasyphd.tools import PyRunBibMdTex
+
+
+def run_beamer_tex_weekly_reports(
+    path_input_file: str,
+    input_file_names: list[str],
+    path_output_file: str,
+    bib_path_or_file: str,
+    path_conferences_journals_json: str,
+    options: dict
+) -> None:
+    """
+    Process academic article files (TeX, and bibliography) with automated Git version control.
+
+    This function handles the conversion and processing of academic article files including TeX documents, and
+    bibliography management with automatic Git commit and push capabilities.
+
+    Note: The raw figures and TeX source files must be located in the data/raw subdirectory of the input path.
+
+    Args:
+        path_input_file (str): Path to input files directory
+        input_file_names (list[str]): List of input file names
+        path_output_file (str): Path to output directory
+        bib_path_or_file (str): Path to bibliography file or directory
+        path_conferences_journals_json (str): Path to conferences and journals JSON files directory
+        options (dict): Additional options to override default settings
+
+    Returns:
+        None
+    """
+    path_input_file = os.path.expandvars(os.path.expanduser(path_input_file))
+    path_output_file = os.path.expandvars(os.path.expanduser(path_output_file))
+
+    # Initialize default options with detailed descriptions
+    _options = {
+        "full_json_c": os.path.expanduser(os.path.join(path_conferences_journals_json, "conferences.json")),
+        "full_json_j": os.path.expanduser(os.path.join(path_conferences_journals_json, "journals.json")),
+
+        # figure options
+        "includegraphics_figs_directory": "",
+        "shutil_includegraphics_figs": True,
+        "includegraphics_figs_in_relative_path": True,
+        "figure_folder_name": "figs",  # "" or "figs" or "main"
+
+        # bib options
+        "abbr_index_article_for_abbr": 1,  # 0, 1, 2
+        "abbr_index_inproceedings_for_abbr": 0,  # 0, 1, 2
+        "add_link_to_fields_for_abbr": None,  # None, or ["title", "journal", "booktitle"]
+        "maximum_authors_for_abbr": 0,  # 0, 1, 2, ...
+        "add_index_to_entries": False,
+        "bib_for_abbr_name": "abbr.bib",
+        "bib_for_zotero_name": "zotero.bib",
+        "bib_for_save_name": "save.bib",
+        "display_google_connected_scite": ["google", "connected", "scite"],
+
+        "bib_folder_name": "bibs",  # "" or "bib" or "bibs" or "main"
+        "delete_original_bib_in_output_folder": False,
+        "bib_path_or_file": os.path.expanduser(bib_path_or_file),
+
+        # tex options
+        "handly_preamble": True,
+        "final_output_main_tex_name": "main.tex",
+        "run_latex": False,
+        "delete_run_latex_cache": False,
+
+        "input_texs_directory": "",
+        "shutil_input_texs": False,  # default is True
+        "input_texs_in_relative_path": True,
+        "tex_folder_name": "texs",  # "" or "tex" or "texs" or "main"
+        "delete_original_tex_in_output_folder": True,  # default is False
+        "generate_tex": True,
+
+        # md options
+        "add_url_for_basic_dict": True,  # default is True
+        "add_anchor_for_basic_dict": False,  # default is False
+        "add_anchor_for_beauty_dict": False,  # default is False
+        "add_anchor_for_complex_dict": False,  # default is False
+
+        "final_output_main_md_name": "main.md",
+        "delete_temp_generate_md": True,
+        "add_reference_in_md": True,
+        "add_bib_in_md": False,
+        "replace_cite_to_fullcite_in_md": True,
+        "replace_by_basic_beauty_complex_in_md": "basic",
+        "display_basic_beauty_complex_references_in_md": "beauty",
+        "add_anchor_in_md": False,  # default is False
+
+        "md_folder_name": "mds",  # "" or "md" or "main"
+        "delete_original_md_in_output_folder": False,  # default is False
+
+        # html options
+        "generate_html": False,
+    }
+
+    # Update with user-provided options
+    _options.update(options)
+
+    # Create full file paths from input file names
+    file_list = [os.path.join(path_input_file, f) for f in input_file_names]
+
+    PyRunBibMdTex(path_output_file, ".tex", "beamer", _options).run_files(file_list, "", "current")
+
+    return None

{pyeasyphd-0.3.1 → pyeasyphd-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyeasyphd"
-version = "0.3.1"
+version = "0.3.3"
 description = "pyeasyphd"
 license = "GPL-3.0-or-later"
 authors = ["NextAI <nextartifintell@gmail.com>"]