summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/engtlc/engtlc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/engtlc/engtlc.tex')
-rw-r--r--Master/texmf-dist/doc/latex/engtlc/engtlc.tex1304
1 files changed, 620 insertions, 684 deletions
diff --git a/Master/texmf-dist/doc/latex/engtlc/engtlc.tex b/Master/texmf-dist/doc/latex/engtlc/engtlc.tex
index 72eda9395b1..f1b38fecc6c 100644
--- a/Master/texmf-dist/doc/latex/engtlc/engtlc.tex
+++ b/Master/texmf-dist/doc/latex/engtlc/engtlc.tex
@@ -1,33 +1,37 @@
-\documentclass[12pt,a4paper,openany]{book}
-\usepackage{amsmath, amssymb, amscd}
+\documentclass[11pt,a4paper,openany]{book}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{lmodern}
+\usepackage[english]{babel}
+\usepackage{amsmath, amssymb}
\usepackage{tabularx}
-\usepackage{fancyhdr}
-\usepackage{amsfonts}
-\usepackage{amssymb}
+\usepackage{fancyhdr}
\usepackage{graphicx}
-\usepackage{pstricks,pstricks-add}
-\usepackage[utf8x]{inputenc}
\usepackage{listings}
\usepackage{booktabs}
\usepackage{colortbl}
\usepackage{xcolor}
-\usepackage{listings}
+\usepackage{textcomp}
\lstset{language=[LaTeX]TeX,%
basicstyle=\footnotesize\ttfamily}
\usepackage{engtlc}
-\usepackage{fiandracolors}
-\usepackage[italian]{babel}
\usepackage[pdfpagelabels,plainpages=false,colorlinks=true,hyperindex=true]{hyperref}
+
+% Commands for the documentation
+\newcommand*{\meta}[1]{{\normalfont\textlangle\textit{#1}\textrangle}}
+\newcommand*{\marg}[1]{\texttt{\{\meta{#1}\}}}
+\newcommand*{\cs}[1]{\texttt{\char92#1}}
+
\begin{document}
-\pagenumbering{Roman}
+\frontmatter
\begin{titlepage}
-\title{\begin{huge}\textbf{Il pacchetto engtlc}\end{huge}\\ \vspace{.5cm}
- \begin{large}Versione 2.0\end{large}}
-\author{\begin{LARGE} Fiandrino Claudio\end{LARGE}}
+\title{\begin{huge}\textbf{The \textsf{Engtlc} package}\end{huge}\\[.5cm]
+ \begin{large}Version 3.0\end{large}}
+\author{\begin{LARGE}Claudio Fiandrino \end{LARGE}}
\maketitle
\end{titlepage}
-\hypersetup{urlcolor=royalblue}
-\hypersetup{linkcolor=royalviolet}
+\hypersetup{urlcolor=blue}
+\hypersetup{linkcolor=blue}
\pagestyle{fancy}
\renewcommand{\chaptermark}[1]{%
\markboth{\MakeUppercase{%
@@ -39,1114 +43,1046 @@
\fancyhead[LO]{\rightmark}
\fancyfoot{}
\tableofcontents
-\newpage
+
\mainmatter
-\chapter{Introduzione}
-Questo pacchetto è stato creato in quattro fasi diverse: la prima in cui sono stati raggruppati i comandi fondamentali come unità di misura e simboli generali in data 7/12/2009, la seconda in cui sono stati aggiunte le ultime unità di misura e simboli nuovi come impedenze e ammettenze.
-La terza edizione, a cui ha collaborato con suggerimenti molto preziosi Alessio Sanna, ha inserito le unità in Byte e le diciture di campo elettrico e magnetico. Ultimata in data 18/12/2009 è stata pubblicata in data 13/01/2010.
+\chapter{Introduction}
+This package has been realized in four different periods: in the first one I wrote the macros for measurement units and general symbols; in the second one I extended the units part and I added some other symbols such as the impedance and admittance ones.
+In the third version, in which Alessio Sanna gave me precious suggestions, I inserted byte and chip units and the symbols for electrical and magnetic fields. I finished it on 18/12/2009 and on 13/01/2010 it had been published on CTAN.
+
+In that third version there were some mistakes due of my inexperience in \LaTeX\ programming. Thanks to Enrico Gregorio, who send me a list of them, I decided to correct them in a new version and added some new symbol commands.
-Questa edizione era costellata di piccoli e grandi errori dovuti alla mia inesperienza. Ringrazio Enrico Gregorio che mi ha cortesemente inviato un elenco delle modifiche da apportare per rendere migliore il pacchetto. Corretti gli errori ho aggiunto comandi non presenti nella versione precedente come il simbolo di segnale analitico, di integrale, delta, i simboli $\lambda$ e di potenza.
+This fourth version, thanks to Claudio Beccari for the precious help, complies to ISO regulations and introduces \emph{alias} commands in english, as explained in section~\ref{sec:simboli}. Moreover some new commands have been added: probability symbols, commands to define signals in temporal, frequency, discrete and z-transform domain are the major novelties.
-Le finalità per cui è creato sono molto semplici: serve a tutti coloro che lavorano, studiano in ambienti riguardanti materie elettroniche e di telecomunicazioni; infatti engtlc è l'abbreviazione delle parole \emph{Engineering Telecommunications}. In che cosa aiuta?
+The purpose to create \textsf{engtlc} is very simple: it can be used by all those who work in electrical engineering or telecommunication area; indeed, \textsf{engtlc} is the acronym of \emph{Engineering Telecommunications}.
-Aiuta a velocizzare la scrittura in ambiente \LaTeX; per esperienza personale ho avuto modo di notare quanto poco comodo possa essere il codice in casi in cui si debba ripetere molte volte alcune espressioni e magari occorra cambiare di poco rispetto a prima il codice.
+Where does it help?
+It helps in writing a document with \LaTeX, of course; in my personal experience I observed that \LaTeX\ code isn't very user friendly when you have to repeat over and over again some words where the code is a little bit different every time.
-Se si deve indicare l'espressione della probabilità della variabile $x$ il codice da scrivere risulta essere:
+If you have to write the probability of $x$ you can write the \LaTeX\ code like:
\begin{tabbing}
-\hspace{5cm}\=\kill
+\hspace{7cm}\=\kill
\begin{lstlisting}
$\mathcal{P}(x)$
-\end{lstlisting} \hspace{2cm} \> \hspace{2cm} $\mathcal{P}(x)$
+\end{lstlisting} \> $\mathcal{P}(x)$
\end{tabbing}
-Nel caso in cui qualche riga successiva si deve indicare invece la probabilità dell'evento A occorrerebbe nuovamente digitare:
+If, after some time, you have to write the probability of the event A:
\begin{tabbing}
-\hspace{5cm}\=\kill
+\hspace{7cm}\=\kill
\begin{lstlisting}
-$\mathcal{P}(\text{A})$
-\end{lstlisting} \hspace{2cm} \> \hspace{2cm} $\mathcal{P}(\text{A})$
+$\mathcal{P}(\text{A})$
+\end{lstlisting} \> $\mathcal{P}(\text{A})$
\end{tabbing}
-oppure copiare il codice precedente e cambiare solo l'argomento.
+or you can copy the previous code and change the argument.
-Grazie al pacchetto engtlc invece è sufficiente digitare:
-\begin{lstlisting}
-$\prob{1}$
-\end{lstlisting}
-dove \texttt{1} è l'argomento da inserire, come $x$ oppure A.
+With \textsf{engtlc} it is easier; you simply write:
+\begin{flushleft}
+\texttt{\$\cs{prob}\marg{argument}\$}
+\end{flushleft}
+where \meta{argument} is the argument you have to put like $x$ or A.
-Le novità introdotte non si fermano certo qui e verranno illustrate più dettagliatamente in seguito, nel capitolo \ref{chap: comandi}.
-\chapter{Come installare engtlc}
-Potete reperire il pacchetto dal sito \href{http://claudiofiandrino.altervista.org}{http://claudiofiandrino.altervista.org} nella sezione works oppure sul sito ufficiale \\ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/engtlc}{http://tug.ctan.org/tex-archive/macros/latex/contrib/engtlc}.
-\section*{Da Linux}
-Una volta scaricato il pacchetto \emph{.zip} per chi usa una qualsiasi distribuzione Linux occorre copiare, con i privilegi necessari di superuser, tale pacchetto nella seguente directory:
-\begin{center}
-\texttt{/usr/share/texmf/tex/latex}
-\end{center}
-Se avete scaricato sul desktop il pacchetto, con il comando:
-\begin{center}
-\texttt{cd /home/\emph{nome utente}/Scrivania}
-\end{center}
-vi portate sulla directory del desktop. Successivamente copiate l'archivio con il comando:
-\begin{center}
-\texttt{cp engtlc.zip /usr/share/texmf/tex/latex/}
-\end{center}
-Fatto questo dovete scompattare l'archivio e aprire il terminale di comando; spostatevi nella directory sempre con i privilegi di root in questo modo:
-\begin{center}
-\texttt{cd /usr/share/texmf/tex/latex}
-\end{center}
-A questo punto vi basta digitare:
-\begin{center}
-\texttt{texhash}
-\end{center}
-per far sì che il compilatore \emph{veda} il nuovo pacchetto che volete installare.
-
-Questo processo è una procedura valida in linea generale: qualsiasi sia la classe o i pacchetti che volete installare in aggiunta al compilatore con questo metodo ci riuscirete.
-\section*{Da Windows}
-Se usate Windows come sistema operativo e avete installato MiK\TeX:
+The following chapters are structured in this way:
\begin{itemize}
-\item[.] aprite la directory \emph{C}: $>$ \emph{Program Files} $>$ \emph{MiK\TeX 2.8} $>$ \emph{tex} $>$ \emph{latex};
-\item[.] copiate il file engtlc.zip e scompattelo nella directory;
-\item[.] aprite \emph{Start}, cercate \emph{MiK\TeX 2.8}$>$ \emph{Maintenance (Admin)}$>$ \emph{Settings};
-\item[.] una volta aperta vi comparirà una finestra: cliccate su \emph{Refresh FNDB} e così avrete aggiornato il database contenente i pacchetti.
+\item[$\star$] the procedures to install the package and its dependencies are explained in chapter~\ref{chap:installazione};
+\item[$\star$] the specific new commands introduced by \textsf{engtlc} are shown in chapter~\ref{chap:comandi}.
\end{itemize}
-\bigskip
-A questo punto siete pronti per usare engtlc!
-\chapter{I comandi introdotti da engtlc}\label{chap: comandi}
-Esaminiamo ora quali sono le potenzialità di engtlc.
-Si tratteranno inizialmente le unità di misura per passare poi a simboli generali.
-\section{Unità di misura}
-Per quanto mi riguarda ho sempre trovato un'enorme perdita di tempo scrivere tutte le volte il codice per l'inserimento delle unità di misura; infatti non è breve e, nel caso in cui nel vostro documento siete costretti a riportare continuamente unità diverse diventa molto fastidioso.
-Ecco un esempio di codice se dovete esprimere l'unità \kbits:
+\chapter{How to install \textsf{engtlc}}\label{chap:installazione}
+If it is not already intalled in your \TeX\ distribution, you can find the package in my website \url{http://claudiofiandrino.altervista.org} within the works section; alternatively you can download it from the official \LaTeX\ packages website \url{http://tug.ctan.org/tex-archive/macros/latex/contrib/engtlc}.
+
+After downloading the \emph{.zip} file, decompress it and move all the files into the \texttt{~/texmf/tex/latex/engtlc/} in your home directory (if you don't have a personal \texttt{texmf} tree in your home directory, create one). After moving the unzipped files in the aforementioned folder, rembeber to refresh the filename database if your \TeX\ distribution and operating system require it.
+
+The home folder, shown with \texttt{\textasciitilde}, is a normal way of indicating it on Linux platforms. On Macs the \texttt{texmf} personal tree should be rooted in \texttt{\textasciitilde/Library}; on Windows platforms, from Vista and newer releases, the concept of ``home'' is now well known; for previous version you should root your personal \texttt{texmf} tree somewhere such as \texttt{C:\char92Documents and Settings\char92\meta{your username}}.
+
+Remember: This package is dependent on some external packages such as \textsf{textcomp}, \textsf{amsmath}, \textsf{amssymb}. The package does not expressly load them in order to avoid conflicts among different sets of options the user might want to specify. Therefore the user is responsable for loading them with the options s/he likes best. Since these packages are generally loaded by the user for other purposes, this should not be an inconvenience. Anyway, if you do not load
+\textsf{amsmath} and \textsf{amssymb}, you will receive an error: this because some commands need this packages. On the contrary, if you do not load \textsf{textcomp}, you will see a warning.
+
+
+\chapter{Commands introduced by \textsf{engtlc}}\label{chap:comandi}
+Let's start to examine \textsf{engtlc} commands.
+
+In the first section several commands for writing units of measurement are shown, while in the second section several new symbol commands are listed.
+
+\section{Units of measurement}
+I believe that the possibility of introducing units of measurement in a short and consistent way might be very useful. Of course there are other packages that allow to do the same, but possibly with longer constructs. For example with siunuitx if you have to use ``kbit/s'' you have to type in:
\begin{tabbing}
-\hspace{4cm}\= \kill
+\hspace{7cm}\= \kill
+Code \> Visualization \\
\begin{lstlisting}
-\unit{kbit/s}
+\si{\kibi\bit\per\second}
\end{lstlisting} \> \kbits
\end{tabbing}
-Ho pensato quindi di creare con un codice più corto per le unità più utilizzate: di seguito troverete le tabelle raggruppate per tipi di unità di misura.
+So I decided to create shorter codes that can replace the longer ones shown above.
+
+\textsf{Engtlc} units of measurement must used only within math environments \texttt{\$ \$}, \texttt{[ ]} or within any kind \emph{equation like} ones.
-Occorre precisare che è preferibile usare le unità di misura in scrittura matematica, ovvero fra \lstinline!$ $! oppure fra \lstinline!\[ \]! o negli ambienti equation.
-Funzionano anche in modalità testuale se non sono contenuti all'interno del codice termini come \lstinline!\ohm! oppure \lstinline!\mu!. Inoltre se fosse necessario inserire una parola dopo l'unità riportata si osserverebbe questo spiacevole effetto:
+Be careful: if in your text you use a unit command and forget that the space after a control sequence is absorbed by the control sequence itself, you observe this mistake:
\begin{tabbing}
\hspace{4cm}\= \kill
+Code \> Visualization\\
\begin{lstlisting}
-8 \cm e
-\end{lstlisting} \> 8 \cm e
+8 \cm and
+\end{lstlisting} \> 8 \cm and
\end{tabbing}
-Quindi l'uso principale, quando si compone un testo, rimane sempre quello in scrittura matematica.
-\subsubsection{Misure di tempo}
-\begin{center}
-\begin{tabular}{ccc}
-\toprule
-Unità & Codice equivalente & Visualizzazione\\
-\midrule
-ore & \begin{lstlisting}
- $\ho$
-\end{lstlisting} & \ho \\
-secondi & \begin{lstlisting}
- $\s$
-\end{lstlisting} & \s \\
-millisecondi & \begin{lstlisting}
- $\ms$
-\end{lstlisting} & $\ms$ \\
-microsecondi & \begin{lstlisting}
- $\us$
-\end{lstlisting} & $\us$ \\
-nanosecondi & \begin{lstlisting}
- $\ns$
-\end{lstlisting} & $\ns$\\
-picosecondi & \begin{lstlisting}
- $\ps$
-\end{lstlisting} & $\ps$\\
+
+\subsubsection{Time units}
+\begin{center}
+\begin{tabular}{lll}
+\toprule
+Unit & Equivalent code & Visualization\\
+\midrule
+hours & \cs{ho} & \ho \\
+seconds & \cs{s} & \s \\
+milliseconds & \cs{ms} & $\ms$ \\
+microseconds & \cs{us} & $\us$ \\
+nanoseconds & \cs{ns} & $\ns$\\
+picoseconds & \cs{ps} & $\ps$\\
\bottomrule
\end{tabular}
\end{center}
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di lunghezza}
+\subsubsection{Length units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-micrometri & \begin{lstlisting}
- $\um$
-\end{lstlisting} & $\um$ \\
-millimetri & \begin{lstlisting}
- $\mm$
-\end{lstlisting} & $\mm$ \\
-centimetri & \begin{lstlisting}
- $\cm$
-\end{lstlisting} & $\cm$ \\
-decimetri & \begin{lstlisting}
- $\dm$
-\end{lstlisting} & $\dm$\\
-metri & \begin{lstlisting}
- $\m$
-\end{lstlisting} & $\m$\\
-kilometri & \begin{lstlisting}
- $\km$
-\end{lstlisting} & $\km$\\
+micrometres & \cs{um} & $\um$ \\
+millimetres & \cs{mm} & $\mm$ \\
+centimetres & \cs{cm} & $\cm$ \\
+decimetres & \cs{dm} & $\dm$\\
+metres & \cs{m} & $\m$\\
+kilometres & \cs{km} & $\km$\\
\bottomrule
\end{tabular}
\end{center}
+
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di corrente}
+\subsubsection{Current units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-microampere & \begin{lstlisting}
- $\uA$
-\end{lstlisting} & $\uA$ \\
-milliampere & \begin{lstlisting}
- $\mA$
-\end{lstlisting} & $\mA$ \\
-ampere & \begin{lstlisting}
- $\A$
-\end{lstlisting} & $\A$ \\
+microampere & \cs{uA} & $\uA$ \\
+milliampere & \cs{mA} & $\mA$ \\
+ampere & \cs{A} & $\A$ \\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di tensione}
+\subsubsection{Voltage units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-microvolt & \begin{lstlisting}
- $\uV$
-\end{lstlisting} & $\uV$ \\
-millivolt & \begin{lstlisting}
- $\mV$
-\end{lstlisting} & $\mV$ \\
-volt & \begin{lstlisting}
- $\V$
-\end{lstlisting} & $\V$\\
-megavolt & \begin{lstlisting}
- $\MV$
-\end{lstlisting} & $\MV$\\
+microvolt & \cs{uV} & $\uV$ \\
+millivolt & \cs{mV} & $\mV$ \\
+volt & \cs{V} & $\V$\\
+megavolt & \cs{MV} & $\MV$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di resistenza}
+\subsubsection{Resistance units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-milliohm & \begin{lstlisting}
- $\mohm$
-\end{lstlisting} & $\mohm$ \\
-ohm & \begin{lstlisting}
- $\ohm$
-\end{lstlisting} & $\ohm$\\
-kilohm & \begin{lstlisting}
- $\kohm$
-\end{lstlisting} & $\kohm$\\
-megaohm & \begin{lstlisting}
- $\Mohm$
-\end{lstlisting} & $\Mohm$\\
+milliohm & \cs{mohm} & $\mohm$ \\
+ohm & \cs{ohm} & $\ohm$\\
+kilohm & \cs{kohm} & $\kohm$\\
+megaohm & \cs{Mohm} & $\Mohm$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di conduttanza}
+\subsubsection{Conductance units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-millisiemens & \begin{lstlisting}
- $\mSi$
-\end{lstlisting} & $\mSi$ \\
-siemens & \begin{lstlisting}
- $\Si$
-\end{lstlisting} & $\Si$\\
-kilosiemens & \begin{lstlisting}
- $\kSi$
-\end{lstlisting} & $\kSi$\\
-megasiemens & \begin{lstlisting}
- $\MSi$
-\end{lstlisting} & $\MSi$\\
+picosiemens & \cs{pSi} & $\pSi$\\
+nanosiemens & \cs{nSi} & $\nSi$ \\
+microsiemens &\cs{uSi} & $\uSi$ \\
+millisiemens & \cs{mSi} & $\mSi$ \\
+siemens & \cs{Si} & $\Si$\\
+kilosiemens & \cs{kSi} & $\kSi$\\
+megasiemens & \cs{MSi} & $\MSi$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di capacità}
+\subsubsection{Capacity units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-femtofarad & \begin{lstlisting}
- $\fFa$
-\end{lstlisting} & $\fFa$ \\
-picofarad & \begin{lstlisting}
- $\pFa$
-\end{lstlisting} & $\pFa$\\
-nanofarad & \begin{lstlisting}
- $\nFa$
-\end{lstlisting} & $\nFa$ \\
-microfarad & \begin{lstlisting}
- $\uFa$
-\end{lstlisting} & $\uFa$\\
-millifarad & \begin{lstlisting}
- $\mFa$
-\end{lstlisting} & $\mFa$ \\
-farad & \begin{lstlisting}
- $\Fa$
-\end{lstlisting} & $\Fa$\\
+femtofarad & \cs{fFa} & $\fFa$ \\
+picofarad & \cs{pFa} & $\pFa$\\
+nanofarad & \cs{nFa} & $\nFa$ \\
+microfarad & \cs{uFa} & $\uFa$\\
+millifarad & \cs{mFa} & $\mFa$ \\
+farad & \cs{Fa} & $\Fa$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di induttanza}
+\subsubsection{Inductance units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-femtohenry & \begin{lstlisting}
- $\fHe$
-\end{lstlisting} & $\fHe$ \\
-picohenry & \begin{lstlisting}
- $\pHe$
-\end{lstlisting} & $\pHe$\\
-nanohenry & \begin{lstlisting}
- $\nHe$
-\end{lstlisting} & $\nHe$ \\
-microhenry & \begin{lstlisting}
- $\uHe$
-\end{lstlisting} & $\uHe$\\
-millihenry & \begin{lstlisting}
- $\mHe$
-\end{lstlisting} & $\mHe$ \\
-henry & \begin{lstlisting}
- $\He$
-\end{lstlisting} & $\He$\\
+femtohenry & \cs{fHe} & $\fHe$ \\
+picohenry & \cs{pHe} & $\pHe$\\
+nanohenry & \cs{nHe} & $\nHe$ \\
+microhenry & \cs{uHe} & $\uHe$\\
+millihenry & \cs{mHe} & $\mHe$ \\
+henry & \cs{He} & $\He$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di in dB}
+\subsubsection{Level units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-dB & \begin{lstlisting}
- $\dB$
-\end{lstlisting} & $\dB$ \\
-dBm & \begin{lstlisting}
- $\dBm$
-\end{lstlisting} & $\dBm$\\
+dB & \cs{dB} & $\dB$ \\
+dBm & \cs{dBm} & $\dBm$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di potenza}
+\subsubsection{Power units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-microwatt & \begin{lstlisting}
- $\uW$
-\end{lstlisting} & $\uW$\\
-milliwatt & \begin{lstlisting}
- $\mW$
-\end{lstlisting} & $\mW$ \\
-watt & \begin{lstlisting}
- $\W$
-\end{lstlisting} & $\W$\\
-kilowatt & \begin{lstlisting}
- $\kW$
-\end{lstlisting} & $\kW$\\
-megawatt & \begin{lstlisting}
- $\MW$
-\end{lstlisting} & $\MW$\\
+microwatt & \cs{uW} & $\uW$\\
+milliwatt & \cs{mW} & $\mW$ \\
+watt & \cs{W} & $\W$\\
+kilowatt & \cs{kW} & $\kW$\\
+megawatt & \cs{MW} & $\MW$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Misure di frequenza}
+\subsubsection{Frequency units}
\begin{center}
-\begin{tabular}{ccc}
+\begin{tabular}{lll}
\toprule
-Unità & Codice equivalente & Visualizzazione\\
+Unit & Equivalent code & Visualization\\
\midrule
-hertz & \begin{lstlisting}
- $\Hz$
-\end{lstlisting} & $\Hz$\\
-kilohertz & \begin{lstlisting}
- $\kHz$
-\end{lstlisting} & $\kHz$ \\
-megahertz & \begin{lstlisting}
- $\MHz$
-\end{lstlisting} & $\MHz$\\
-terahertz & \begin{lstlisting}
- $\THz$
-\end{lstlisting} & $\THz$\\
+hertz & \cs{Hz} & $\Hz$\\
+kilohertz & \cs{kHz} & $\kHz$ \\
+megahertz & \cs{MHz} & $\MHz$\\
+gigaahertz& \cs{GHz} & $\GHz$\\
+terahertz & \cs{THz} & $\THz$\\
\bottomrule
\end{tabular}
\end{center}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsubsection{Unità per bit e chip}
-\begin{center}
-\begin{tabular}{ccc}
-\toprule
-Unità & Codice equivalente & Visualizzazione\\
-\midrule
-bit & \begin{lstlisting}
- $\bit$
-\end{lstlisting} & $\bit$\\
-kilobit & \begin{lstlisting}
- $\kbit$
-\end{lstlisting} & $\kbit$ \\
-megabit & \begin{lstlisting}
- $\Mbit$
-\end{lstlisting} & $\Mbit$\\
-Byte & \begin{lstlisting}
- $\Byte$
-\end{lstlisting} & $\Byte$\\
-kiloByte & \begin{lstlisting}
- $\kByte$
-\end{lstlisting} & $\kByte$ \\
-megaByte & \begin{lstlisting}
- $\MByte$
-\end{lstlisting} & $\MByte$\\
-bit al secondo & \begin{lstlisting}
- $\bits$
-\end{lstlisting} & $\bits$\\
-kilobit al secondo & \begin{lstlisting}
- $\kbits$
-\end{lstlisting} & $\kbits$ \\
-megabit al secondo & \begin{lstlisting}
- $\Mbits$
-\end{lstlisting} & $\Mbits$\\
-Byte al secondo & \begin{lstlisting}
- $\Bytes$
-\end{lstlisting} & $\Bytes$\\
-kiloByte al secondo & \begin{lstlisting}
- $\kBytes$
-\end{lstlisting} & $\kBytes$ \\
-megaByte al secondo & \begin{lstlisting}
- $\MBytes$
-\end{lstlisting} & $\MBytes$\\
-chip al secondo & \begin{lstlisting}
- $\chips$
-\end{lstlisting} & $\chips$\\
-kilochip al secondo & \begin{lstlisting}
- $\kchips$
-\end{lstlisting} & $\kchips$ \\
-megachip al secondo & \begin{lstlisting}
- $\Mchips$
-\end{lstlisting} & $\Mchips$\\
-chip su bit al secondo & \begin{lstlisting}
- $\chipsubit$
-\end{lstlisting} & $\chipsubit$\\
-\bottomrule
-\end{tabular}
-\end{center}
-\section{Simboli}
-In questa sezione sono riportati una serie di simboli utili nei più svariati campi.\\
-A differenza della versione precedente che recava distinzione tra comandi in modalità matematica e in scrittura testuale problema risolto.
-
-Passiamo ad elencare prima i simboli generali.
-\subsection{Simboli generali}
-\subsubsection*{Comando di fine esercizio}
-Comando di fine esercizio: questo comando colloca un quadrato nero allineato sulla destra della pagina.
+\subsubsection{Bit, byte, and chip units according to the ISO regulations}
+\begin{center}
+\begin{tabular}{lll}
+\toprule
+Unit & Equivalent code & Visualization\\
+\midrule
+bit & \cs{bit} & $\bit$\\
+kibibit & \cs{kbit} & $\kbit$ \\
+mebibit & \cs{Mbit} & $\Mbit$\\
+byte & \cs{Byte} & $\Byte$\\
+kibibyte & \cs{kByte} & $\kByte$ \\
+mebibyte & \cs{MByte} & $\MByte$\\
+gibibyte & \cs{GByte} & $\GByte$ \\
+tebibyte & \cs{TByte} & $\TByte$ \\
+bit per second & \cs{bits} & $\bits$\\
+kibibit per second & \cs{kbits} & $\kbits$ \\
+mebibit per second & \cs{Mbits} & $\Mbits$\\
+byte per second & \cs{Bytes} & $\Bytes$\\
+kibibyte per second & \cs{kBytes} & $\kBytes$ \\
+mebibyte per second & \cs{MBytes} & $\MBytes$\\
+gibibyte per second & \cs{GBytes} & $\GBytes$\\
+tebibyte per second & \cs{TBytes} & $\TBytes$\\
+chip per second & \cs{chips} & $\chips$\\
+kibichip per second & \cs{kchips} & $\kchips$ \\
+mebichip per second & \cs{Mchips} & $\Mchips$\\
+chip su bit per second & \cs{chipsubit} & $\chipsubit$\\
+\bottomrule
+\end{tabular}
+\end{center}
+\section{Symbols}\label{sec:simboli}
+Several symbol macros are listed in this section.
+All these macros are supposed to be used only in math mode. Each macro has an English and an Italian contracted name and the examples will show both of them: in the first line there will be the English version and in the second line the Italian one; if only one line is shown, there is non difference between the English and the Italian names.
+
+\subsection{General symbols}
+
+\subsubsection{End of exercise}
+The command of end exercise puts a black square flush to the right side of the text block.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- $\finees$
-\end{lstlisting} & $\blacksquare$\\
+\cs{exerend} & $\blacksquare$\\
+\cs{finees} & $\blacksquare$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando di implicazione verso destra}
-Comando di implicazione verso destra: questo comando è molto simile a \lstinline!\implies!, ma crea una spaziatura regolabile dall'argomento. I valori devono essere numeri maggiori di 0.
+
+\subsubsection{Spaced ``implies'' command}
+This command is very similar to \cs{implies}, but it puts before and after the symbol a space that can be chosen by the user by means of an optional argument; by default this space is 0.5\,cm; you can change the unit of measure for the spacing by assigning a value to the length register \cs{Implspace}, for example:
+\begin{verbatim}
+\setlength{\Implspace}{3mm}
+\end{verbatim}
+The syntax is therefore:
+\begin{flushleft}
+\cs{Spimplies}\texttt{[\meta{optional space in units of \normalfont\cs{Implspace}}]}\\
+\cs{frecciadex}\texttt{[\meta{optional space in units of \normalfont\cs{Implspace}}]}
+\end{flushleft}
+In the following table, keeping in mind that \cs{Spimpiles} and \cs{frecciadex} are synonymous, in the first line the optional argument has been used, while in the second line the default spacing has been used, so as to evaluate the difference; in both cases the length register \cs{Implspace} was not reset and contains the value of 0.5\,cm.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- $\frecciadex{1}$
-\end{lstlisting} & $\implies$\\
+\texttt{A\cs{Spimplies[0.3]} B} & $A\Spimplies[0.3]B$ \\
+\texttt{A\cs{frecciadex} B} & $A\Spimplies B$ \\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando di implicazione verso il basso}
-Comando di implicazione verso il basso: crea una freccia che punta verso il basso, a differenza di \lstinline!\frecciadex!, ed ha una grandezza adeguata.
+Notice that, by inserting in the optional argument the default length, you will obtain the same result:
\begin{center}
\begin{tabular}{cc}
\toprule
Codice & Visualizzazione\\
\midrule
-\begin{lstlisting}
- $\frecciadown$
-\end{lstlisting} & $\Downarrow$\\
+\texttt{A\cs{Spimplies} B} & $A\Spimplies B$ \\
+\texttt{A\cs{frecciadex[0.5]} B} & $A\frecciadex[0.5] B$ \\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Varianza del rumore bianco}
+
+\subsubsection{Vertical ``implies'' command}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \varianzarumore
-\end{lstlisting} & \varianzarumore\\
+\cs{Downimplies} & $\Downarrow$\\
+\cs{frecciadown} & $\Downarrow$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Trasformata di Fourier}
-Comando per la trasformata di Fourier del simbolo $x$.
+
+\subsubsection{White noise command}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \fourier{x}
-\end{lstlisting} & \fourier{x}\\
+\cs{noisevar} & \noisevar\\[1ex]
+\cs{varianzarumore} & \varianzarumore\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Trasformata inversa di Fourier}
-Il comando per la trasformata inversa di Fourier opera in maniera analoga al comando precedente.
+
+\subsubsection{Fourier Transform}
+Command for the Fourier transform of $x$.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \invfourier{x}
-\end{lstlisting} & \invfourier{x}\\
+\cs{fourier\{x\}} & \fourier{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando parte reale}
-Per scrivere la parte reale di un simbolo $x$ si usa:
+
+\subsubsection{Inverse Fourier Transform}
+This command is very similar to the previous one.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \partereale{x}
-\end{lstlisting} & \partereale{x}\\
+\cs{invfourier\{x\}} & \invfourier{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando parte immaginaria}
-Il comando per la parte immaginaria di $x$ è:
+
+\subsubsection{Real part}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \parteimm{x}
-\end{lstlisting} & \parteimm{x}\\
+\cs{bfRe\{x\}} & \partereale{x}\\
+\cs{partereale\{x\}} & \partereale{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando probabilità}
-Il comando per esprimere la probabilità di un evento A:
+
+\subsubsection{Imaginary part}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \prob{\text{A}}
-\end{lstlisting} & \prob{\text{A}}\\
+\cs{bfIm\{x\}} & \parteimm{x}\\
+\cs{parteimm\{x\}} & \parteimm{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando quantità di informazione}
-Per esprimere la quantità di informazione di un simbolo $x$ il comando da usare è:
+
+\subsubsection{Information element}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \Info{x}
-\end{lstlisting} & \Info{x}\\
+\cs{Info\{x\}} & \Info{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando versore}
-Per visualizzare un simbolo $x$ come versore:
+
+\subsubsection{Signals in different domains}
+
+The following four macros define signal functions, by using as a convention lower case letters for signals in the time domain and for discrete sequences while signals in frequency and $z$-transform domains have automatically the upper case letter.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\versore{x}
-\end{lstlisting} & \versore{x}\\
+\cs{signt\{f\}} & \signt{f}\\
+\cs{signf\{g\}} & \signf{g}\\
+\cs{signn\{h\}} & \signn{h}\\
+\cs{signz\{k\}} & \signz{k}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando vettore}
-Per esprimere il simbolo $x$ come vettore:
+
+\subsubsection{Analytic signal}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\vettore{x}
-\end{lstlisting} & \vettore{x}\\
+\cs{analytic\{x\}} & \analytic{x}\\
+\cs{analitic\{x\}} & \analitic{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando coseno}
-Per esprimere un coseno ad una precisa frequenza, ad esempio $f_0$:
+
+
+\subsubsection{Unit vector}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\coseno{f_0}
-\end{lstlisting} & \coseno{f_0}\\
+\cs{unitvec\{x\}} & \versore{x}\\
+\cs{versore\{x\}} & \versore{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando seno}
-Per esprimere invece il seno ad una precisa frequenza $f_0$:
+
+\subsubsection{Vector}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\seno{f_0}
-\end{lstlisting} & \seno{f_0}\\
+\cs{vector\{x\}} & \vettore{x}\\
+\cs{vettore\{x\}} & \vettore{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando energia}
-Il comando per esprimere l'energia con pedice a scelta, ad esempio energia media, è:
+
+\subsubsection{Cosine wave of a given frequency}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\energia{m}
-\end{lstlisting} & \energia{m}\\
+\cs{cosine\{f\_0\}} & \coseno{f_0}\\
+\cs{coseno\{f\_0\}} & \coseno{f_0}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando modulo}
-Il comando per visualizzare un simbolo $x$ in modulo, con delimtatori verticali adattabili, è:
+
+\subsubsection{Sine wave of a given frequency}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\modulo{x}
-\end{lstlisting} & \modulo{x}\\
+\cs{sine\{f\_0\}} & \seno{f_0}\\
+\cs{seno\{f\_0\}} & \seno{f_0}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando modulo con esponente}
-Per esprimere invece il modulo di un simbolo $x$ con qualsiasi esponente, ad esempio 2, si usa:
+
+\subsubsection{Energy}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\moduloexp{x}{2}
-\end{lstlisting} & \moduloexp{x}{2}\\
+\cs{energy\{m\}} & \energia{m}\\
+\cs{energia\{m\}} & \energia{m}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando grandezza in dB}
-Per esprimere qualche grandezza in decibel creando la barra verticale, ad esempio il rapporto $\dfrac{C}{I}$, esiste il comando:
+
+\subsubsection{Module}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-$\indB{\dfrac{C}{I}}$
-\end{lstlisting} & $\indB{\dfrac{C}{I}}$\\
+\cs{Abs\{x\}} & \modulo{x}\\
+\cs{modulo\{x\}} & \modulo{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando massimo}
-L'espressione del massimo di un simbolo $x$ si introduce con:
+
+\subsubsection{Exponential with ISO compliant natural base}
+The ISO regulations require that the base of natural logarithms and of the exponential function be set in roman type.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\massimo{x}
-\end{lstlisting} & \massimo{x}\\
+\cs{rmexp\{x\}} & \rmexp{x}\\
+\cs{ex\{x\}} & \ex{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando minimo}
-Per quanto riguarda il minimo, per analogia:
+
+\subsubsection{ISO compliant imaginary unit, engineering style}
+Similarly the ISO regulations require the imaginary unit to be typeset in roman type; electrical and telecommunications engineers use the letter ``j'' in order to avoid any possible confusion with the standard current symbol $i$; the roman type avoids also any possible confusion with the standard symbols for the current density~$j$.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\minimo{x}
-\end{lstlisting} & \minimo{x}\\
+\cs{iu\cs{omega}} & $\iu\omega$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando grandezza velocità della luce}
-Se occorre riportare il valore della velocità della luce è comodo utilizzare:
+
+\subsubsection{Module with exponent}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-$\valc$
-\end{lstlisting} & $\valc$\\
+\cs{AbsPow\{x\}\{2\}} & \moduloexp{x}{2}\\
+\cs{moduloexp\{x\}\{2\}} & \moduloexp{x}{2}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando logaritmo}
-Un logaritmo di base 2, ad esempio, e argomento $x$ si introduce con:
+
+\subsubsection{Function value for a certain value of the independent variable}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\loga{2}{x}
-\end{lstlisting} & \loga{2}{x}\\
+\cs{for\{f(x)\}\{x\_0\}} & \for{f(x)}{x_0}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando segnale analitico/sorgente di campo}
-Per esprimere un segnale analitico $x$ o una sorgente di campo $v$ si usa:
+
+
+\subsubsection{A ratio in dB}
+A special application of the previous command \cs{for}.
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\analitic{x}
-\end{lstlisting} & \analitic{x}\\
-\begin{lstlisting}
-\analitic{v}
-\end{lstlisting} & \analitic{v}\\
+\cs{indB\{\cs{dfrac}\{C\}\{I\}\}} & $\indB{\dfrac{C}{I}}$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando integrale}
-Un integrale definito su tutto un'asse è definito come:
+
+\subsubsection{Maximum}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\intinf{x\,dx}
-\end{lstlisting} & \intinf{x\,dx}\\
+\cs{Max\{x\}} & \massimo{x}\\
+\cs{massimo\{x\}} & \massimo{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Comando delta}
-La funzione $\delta$ calcolata in un punto preciso $x$ si esprime:
+
+\subsubsection{Minimum}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\deltain{x}
-\end{lstlisting} & \deltain{x}\\
+\cs{Min\{x\}} & \minimo{x}\\
+\cs{minimo\{x\}} & \minimo{x}\\
\bottomrule
\end{tabular}
\end{center}
-\subsection{Simboli Gamma}
-Il simbolo, usato prevalentemente nei corsi di campi elettromagnetici è ben caratterizzato; se occorre un'utilizzo generico, senza cioè identificare il punto in cui si calcola, ma specificando se si tratta di un gamma in tensione o in corrente, si deve usare:
+
+\subsubsection{Speed of light}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\gammatens
-\end{lstlisting} & \gammatens\\
-\begin{lstlisting}
-\gammacorr
-\end{lstlisting} & \gammacorr\\
+\cs{clight} & $\valc$\\
+\cs{valc} & $\valc$\\
\bottomrule
\end{tabular}
\end{center}
-Qualora fosse necessario anche inserire il punto della linea in cui deve essere calcolato, si può utilizzare il comando:
+\subsubsection{Logarithm with specified base}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\gammatensin{A}
-\end{lstlisting} & \gammatensin{A}\\
-\begin{lstlisting}
-\gammacorrin{A}
-\end{lstlisting} & \gammacorrin{A}\\
+\cs{Log\{2\}\{x\}} & \loga{2}{x}\\
+\cs{loga\{2\}\{x\}} & \loga{2}{x}\\
\bottomrule
\end{tabular}
\end{center}
-A volte per indicare il gamma in tensione non si specifica l'apice:
+
+\subsubsection{Integral}
+An integral on the whole real domain, from $-\infty$ to $+\infty$:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\gammain{A}
-\end{lstlisting} & \gammain{A}\\
+\cs{infint\{x\cs{diff} x\}} & \intinf{x\diff x}\\[1ex]
+\cs{intinf\{x\cs{diff} x\}} & \intinf{x\diff x}\\
\bottomrule
\end{tabular}
\end{center}
-Quando si usa questo due comando occorre sempre tenere a mente che il gamma è in tensione!!!
+Notice the use of the differential sign \cs{diff} that complies with the ISO regulations that require the differential sign be set in roman type with the proper spacings on the left and on the right.
-Per inserire un gamma di Kurokawa si introduce:
+\subsubsection{Dirac's Delta with independent variable}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\gammak
-\end{lstlisting} & \gammak\\
+\cs{deltain\{x\}} & \deltain{x}\\
\bottomrule
\end{tabular}
\end{center}
-Vediamo un esempio che adopera più simboli di engtlc: caratterizziamo il modulo quadro di un gamma di Kurokawa.
-\begin{tabbing}
-\hspace{7cm}\=\kill
-Codice \> Visualizzazione \\
-\lstinline!\moduloexp{\gammak}{2}! \> \moduloexp{\gammak}{2}
-\end{tabbing}
+\subsection{Reflectances}
+The reflectance symbols used in electrical and magnetic field theory courses are described; you have two kind of commands, the generic ones, and the specific ones where you can specify the point of measure.
-Un altro esempio può essere: parte reale della trasformata di Fourier del modulo quadro di $x$:
-\begin{tabbing}
-\hspace{10cm}\=\kill
-Codice \> Visualizzazione \\
-\lstinline!\partereale{\fourier{\moduloexp{x}{2}}}! \> \partereale{\fourier{\moduloexp{x}{2}}}
+\subsubsection{Generic reflectances}
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{Vgamma} & \gammatens\\
+\cs{gammatens} & \gammatens\\
+\cs{Cgamma} & \gammacorr\\
+\cs{gammacorr} & \gammacorr\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+\subsubsection{Specific reflectances}
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{Vgammain\{A\}} & \gammatensin{A}\\
+\cs{gammatensin\{A\}} & \gammatensin{A}\\
+\cs{Cgammain\{A\}} & \gammacorrin{A}\\
+\cs{gammacorrin\{A\}} & \gammacorrin{A}\\
+\bottomrule
+\end{tabular}
+\end{center}
+Since the voltage reflectance (gamma) is used more often than the current one, it may be input with a shorter command:
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{gammain\{A\}} & \gammain{A}\\
+\bottomrule
+\end{tabular}
+\end{center}
+\subsubsection{The Kurokawa reflectance}
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{gammak} & \gammak\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+\subsection{Usage examples}
+Here are some examples that clearly show the usefulness of \textsf{engtlc}:
+\begin{enumerate}
+\item \begin{tabbing}
+\hspace{7cm}\=\kill
+Code \> Visualization\\
+\cs{AbsPow\{\cs{gammak}\}\{2\}} \> \AbsPow{\gammak}{2}
\end{tabbing}
-Il codice per realizzare questo comando sarebbe:
-\begin{lstlisting}
-$\textbf{Re}\left\lbrace \mathcal{F}\left\lbrace
-\end{lstlisting}
+\item \begin{tabbing}
+\hspace{9cm}\=\kill
+Code \> Visualization \\
+\cs{bfRe\{\cs{fourier}\{\cs{AbsPow}\{x\}\{2\}\}\}} \> $\bfRe{\fourier{\AbsPow{x}{2}}}$
+\end{tabbing}
+The standard code to write the above expression is:
\begin{lstlisting}
+$\textbf{Re}\left\lbrace \mathcal{F}\left\lbrace
\left\vert x \right\vert^{2} \right\rbrace \right\rbrace$
\end{lstlisting}
-\subsection{Simboli $\lambda$}
-Sono implementati 3 simboli per esprimere la lunghezza d'onda.
-\subsubsection*{Nel vuoto}
+
+\end{enumerate}
+
+\subsection{Wave length symbols}
+There are three different types of symbols:
+
+\subsubsection{In the open space}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- $\lbvt$
-\end{lstlisting} & $\lbvt$\\
+\cs{lbvt} & $\lbvt$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Guidata 1}
+
+\subsubsection{In a guide filled with generic dielectric}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- $\lbg$
-\end{lstlisting} & $\lbg$\\
+\cs{lbg} & $\lbg$\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Guidata 2}
+
+\subsubsection{In an empty guide }
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- $\lbgvt$
-\end{lstlisting} & $\lbgvt$\\
+\cs{lbgvt} & $\lbgvt$\\
\bottomrule
\end{tabular}
\end{center}
-\subsection{Simboli per impedenze e ammettenze}
-Il pacchetto engtlc permette anche la rappresentazione di qualsiasi tipo di impedenza e ammettenza.
-\subsubsection{Impedenze e ammettenze generiche}
-Per esprimere un'impedenza o un'ammettenza calcolata nel punto A di una linea si utilizzano i comandi:
+
+\subsection{Impedance and admittance symbols}
+With \textsf{engtlc} you can also write any kind of impedance and admittance.
+
+\subsubsection{Generic impedance and admittance}
+To input an impedance or admittance at a specific port or line section~A use:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\z{A}
-\end{lstlisting} & \z{A}\\
-\begin{lstlisting}
-\y{A}
-\end{lstlisting} & \y{A}\\
+\cs{z\{A\}} & \z{A}\\
+\cs{y\{A\}} & \y{A}\\
\bottomrule
\end{tabular}
\end{center}
-Si noti che, a differenza del comando per esprimere la probabilità, qui non si usa il comando \lstinline!\text{}! per non rendere corsivo il punto di cui si identifica l'impedenza o ammettenza.\\
-Questa scelta è stata operata al fine di fornire una scrittura di migliore impatto visivo per il lettore.
-La caratterizzazione di impedenze e ammettenze normalizzate in un punto A, avviene con i comandi:
+To input a normalized impedance or admittance at a specific port or line section~A use:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\znorm{A}
-\end{lstlisting} & \znorm{A}\\
-\begin{lstlisting}
-\ynorm{A}
-\end{lstlisting} & \ynorm{A}\\
+\cs{znorm\{A\}} & \znorm{A}\\
+\cs{ynorm\{A\}} & \ynorm{A}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection{Impedenze e ammettenze caratteristiche}
-L'impedenza e ammettenza caratteristica generica di una linea o guida di trasmissione avviene con:
+
+\subsubsection{Characteristic impedance and admittance}
+To input the symbol for characteristic impedance or admittance use:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\zinf
-\end{lstlisting} & \zinf\\
-\begin{lstlisting}
-\yinf
-\end{lstlisting} & \yinf\\
+\cs{zinf} & \zinf\\
+\cs{yinf} & \yinf\\
\bottomrule
\end{tabular}
\end{center}
-Qualora fosse necessario caratterizzare più impedenze o ammettenze caratteristiche sulla linea, si può ricorrere a comandi molto simili a quelli precedenti, ma con una -\texttt{n} come desinenza finale, la quale indica il numero che si vuole attribuire; nel caso si voglia attribuire il 2:
+In a guide there are several mode dependent characteristic impendances: you may use another command in order to distinguish them; for example if you want to label with~2 a second impedance you may use:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\zinfn{2}
-\end{lstlisting} & \zinfn{2}\\
-\begin{lstlisting}
-\yinfn{2}
-\end{lstlisting} & \yinfn{2}\\
+\cs{zinf[2]} & \zinf[2]\\
+\cs{zinfn\{2\}} & \zinfn{2}\\
+\cs{yinf[2]} & \yinf[2]\\
+\cs{yinfn\{2\}} & \yinfn{2}\\
\bottomrule
\end{tabular}
\end{center}
-Si presti attenzione perchè non si deve fare confusione tra impedenze e ammettenze generiche con quelle specifiche; osserviamo cosa succede a non inserire la -\texttt{n} finale:
-\begin{tabbing}
-\hspace{7cm}\=\kill
-Codice impedenza generica \> Visualizzazione \\
-\lstinline!\zinf{2}! \> \hspace{0.8cm} \zinf{2}
-\end{tabbing}
+To avoid confusion pay attention when you input a numbered impedance and you use the \cs{zinf} or \cs{yinf} commands: you must use either the optional argument command or the n-extended command:
\begin{tabbing}
\hspace{7cm}\=\kill
- Codice impedenza specifica \> Visualizzazione \\
- \lstinline!\zinfn{2}! \> \hspace{0.8cm} \zinfn{2}
+Impedance with optional argument \> Visualization \\
+\cs{zinf[2]} \> \zinf[2] \\
+n-extended impedance Code \> Visualization \\
+\cs{zinfn\{2\}} \> \zinfn{2} \\
+Generic impedance Code \> Visualization \\
+\cs{zinf\{2\}} \> \zinf{2}
\end{tabbing}
-Il codice per l'impedenza generica non è sbagliato, ma il risultato non è sicuramente quello desiderato.
+The last code is not wrong under the \LaTeX\ point of view, but probably the output is not the expected one\dots
-E' possibile anche operare con le impedenze e ammettenze caratteristiche del vuoto:
+The open space impedance and admittance is input by means of:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\zvt
-\end{lstlisting} & \zvt\\
-\begin{lstlisting}
-\yvt
-\end{lstlisting} & \yvt\\
+\cs{zvt} & \zvt\\
+\cs{yvt} & \yvt\\
\bottomrule
\end{tabular}
\end{center}
-Vediamo un esempio che coinvolga più comandi engtlc.
-
-La caratterizzazione della potenza disponibile di una linea è: tensione del generatore al quadrato diviso 4 volte la parte reale dell'impedenza del generatore. Con i comandi:\\
-\noindent codice:
+\subsection{Some more usage examples}
-\lstinline!\[\potdisp=\frac{\moduloexp{V}{2}}{\partereale{4\cdot\z{G}}}\]! \\
-
-\noindent visualizzazione:
+\noindent With \textsf{engtlc} commands the available power can be written with the code:
+\begin{verbatim}
+\[\availpow=\frac{\AbsPow{V}{2}}{\bfRe{4\cdot\z{G}}}\]
+\end{verbatim}
+that yields:
+\[ \availpow=\frac{\AbsPow{V}{2}}{4\cdot \bfRe{\z{G}}} \]
+Without the \textsf{engtlc} commands the code would be:
+\begin{verbatim}
+\[P_{\mathrm{disp}}=\frac{\left| V \right|^2}%
+{ 4\cdot\textbf{Re}\left\{ Z_\mathrm{G}\right\}}\]
+\end{verbatim}
-\[ \potdisp=\frac{\moduloexp{V}{2}}{\partereale{4\cdot\z{G}}} \]
+\subsection{Power symbols}
+Here we have the commands to input power symbols; the following commands may be used in both text and math modes.
-Senza i comandi introdotti occorrerebbe scrivere:
-\begin{lstlisting}
-\[P_{disp}=\frac{\left| V \right|^2}
-{\textbf{Re}\left\lbrace {4\cdot\text{Z}_{G}}\right\rbrace}\]
-\end{lstlisting}
-\subsection{Potenza}
-I simboli per indicare la potenza sono ben definiti.
-\subsubsection*{Potenza in un punto}
-Per caratterizzare la potenza in un punto, ad esempio $A$:
+\subsubsection{Power into a port}
+To write the power entering into a specific port or line\slash guide section~A use:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potin{A}
-\end{lstlisting} & \potin{A}\\
+\cs{powerin\{A\}} & \powerin{A}\\
+\cs{potin\{A\}} & \potin{A}\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Potenza disponibile}
+
+\subsubsection{Available Power}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potdisp
-\end{lstlisting} & \potdisp\\
+\cs{availpow} & \potdisp\\
+\cs{potdisp} & \potdisp\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Potenza di alimentazione}
+
+\subsubsection{Power supply}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potalim
-\end{lstlisting} & \potalim\\
+\cs{genpow} & \genpow\\
+\cs{potalim} & \potalim\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Potenza irradiata}
+
+\subsubsection{Radiation Power}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potirr
-\end{lstlisting} & \potirr\\
+\cs{irrpow} & \potirr\\
+\cs{potirr} & \potirr\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Potenza dissipata}
+
+\subsubsection{Dissipated Power}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potdiss
-\end{lstlisting} & \potdiss\\
+\cs{disspow} & \potdiss\\
+\cs{potdiss} & \potdiss\\
\bottomrule
\end{tabular}
\end{center}
-\subsubsection*{Potenza incidente}
+
+\subsubsection{Incident power}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
- \potinc
-\end{lstlisting} & \potinc\\
+\cs{incpow} & \potinc\\
+\cs{potinc} & \potinc\\
\bottomrule
\end{tabular}
\end{center}
-\subsection{Campi elettrici e magnetici}
-Per quanto riguarda i campi i comandi engtlc sono molto generici.\\
-Si introducono soltanto:
+
+Pay attention that, in this version, all shortcuts describing power symbols, a part from the first one \cs{powerin\{A\}}, have an optional argument: it is used to indicate explicitly the point in which you can measure the power. To describe, for example, the dissipated power for a general transmitting device, you should use \cs{disspow[tx]} which give as a result $\disspow[tx]$. Be careful: if you put \{ \} instead of [ ] you obtain a different, undesired result. Indeed, \cs{irrpow\{rx\}} becomes $\irrpow{rx}$.
+
+\subsection{Electrical and magnetic field symbols}
+With regards to electrical and magnetic fields, \textsf{engtlc} commands are not so well established, as they depend on every particular school, whether they are typeset or handwritten, etcetera. For informal handouts the underlined vector convention is often used. We distinguish:
\begin{itemize}
-\item[.] campo elettrico e magnetico in funzione del vettore spostamento \vettore{r} e del tempo;
-\item[.] fasori di campo elettrico e mangnetico.
+\item[$\star$] electric and magnetic field as a function of a vector position \vector{r} and time;
+\item[$\star$] electric and magnetic field phasors as a function of a vector position~\vector{r}.
\end{itemize}
-Nella trattazione dei campi si preferisce, come dicitura di vettore utilizzare $\underline{r}$ rispetto a \vettore{r}.
-Campi in funzione di $\underline{r}$ e $t$:
+In several electric and magnetic fields courses in order to denote $A$ as a vector, instead of using arrows ``accents'' or bold symbols, the convention $\underline{A}$ is used:
+\begin{center}
+\begin{tabular}{lc@{\qquad}lr}
+\toprule
+\multicolumn2{c@{\qquad}}{Time dependent fields}&
+ \multicolumn2c{Field phasors} \\
+%\midrule
+Code & Visualization & Code & \makebox[3em][r]{Visualization} \\
+\midrule
+\cs{Efield} & \campoe & \cs{phasorEfield} & \campoefas \\
+\cs{campoe} & \campoe & \cs{campoefas} & \campoefas \\
+\cs{Hfield} & \campoh & \cs{phasorHfield} & \campohfas \\
+\cs{campoh} & \campoh & \cs{campohfas} & \campohfas \\
+\bottomrule
+\end{tabular}
+\end{center}
+
+Pay attention: we distinguish the symbols of energy \cs{energy\marg{argument}} and electric field \cs{campoe} because the second one is a vector and it does not have subscript symbols.
+\subsection{Probability symbols}
+
+\subsubsection{Probability}
+The probability of event A, or of variable $x$, is input as:
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\campoe
-\end{lstlisting} & \campoe\\
-\begin{lstlisting}
-\campoh
-\end{lstlisting} & \campoh\\
+\cs{prob\{\cs{text}\{A\}\}} & \prob{\text{A}}\\
+\cs{prob\{x\}} & \prob{x}\\
\bottomrule
\end{tabular}
\end{center}
-I fasori di campo si introducono, invece, con:
+
+\subsubsection{Expected value}
\begin{center}
\begin{tabular}{cc}
\toprule
-Codice & Visualizzazione\\
+Code & Visualization\\
\midrule
-\begin{lstlisting}
-\campoefas
-\end{lstlisting} & \campoefas\\
-\begin{lstlisting}
-\campohfas
-\end{lstlisting} & \campohfas\\
+\cs{expval\{x\}} & \expval{x}\\
+\cs{valatt\{x\}} & \valatt{x}\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+\subsubsection{Variance}
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{var\{x\}} & \var{x}\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+\subsubsection{Joint probability}
+This macro inserts a well separated comma between two stochastic variables:
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{comma} & \prob{x\comma y}\\
+\cs{virgola} & \prob{x \virgola y }\\
\bottomrule
\end{tabular}
\end{center}
-\chapter{Licenza LPPL}
-Engtlc è sottoposto a licenza LPPL: \LaTeX\, Project Public Licence.
+
+\subsubsection{Conditional probability}
+These macros insert a vertical bar separator between two stochastic variables:
+\begin{center}
+\begin{tabular}{cc}
+\toprule
+Code & Visualization\\
+\midrule
+\cs{given} & \prob{x\given y}\\
+\cs{dato} & \prob{x\dato y}\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+\section*{Aknowledgements}
+I wish to thank prof.~Enrico Gregorio, who very kindly sent me a complete list of errors in my third package edition and documentation.
+
+I wish to thank also prof.~Claudio Beccari for many useful suggestions and the adaptation of several commands to the ISO regulations.
+
+
+\chapter{LPPL Licence}
+\textsf{engtlc} is distributed under LPPL Licence: \LaTeX\, Project Public Licence.
\begin{footnotesize}
\begin{verbatim}
-%% engtlc.dtx
-%% Copyright 2010 Fiandrino Claudio
+%% engtlc.sty
+%% Copyright 2010-2012 Claudio Fiandrino
%
-% This work may be distributed and/or modified under the
-% conditions of the LaTeX Project Public License, either version 1.3
-% of this license or (at your option) any later version.
-% The latest version of this license is in
-% http://www.latex-project.org/lppl.txt
-% and version 1.3 or later is part of all distributions of LaTeX
-% version 2005/12/01 or later.
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
%
-% This work has the LPPL maintenance status `maintained'.
+% This work has the LPPL maintenance status `maintained'.
%
-% The Current Maintainer of this work is Fiandrino Claudio.
+% The Current Maintainer of this work is Fiandrino Claudio.
%
-% This work consists of the files engtlc.dtx and pig.ins
-% and the derived file engtlc.sty.
+% This work consists of the file engtlc.sty.
\end{verbatim}
\end{footnotesize}
-\end{document} \ No newline at end of file
+\end{document}