diff options
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/MTsample.pdf | bin | 197451 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/MTsample_src.zip | bin | 44817 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/README | 36 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/mattens.pdf | bin | 408664 -> 540804 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/mattens_sample.pdf | bin | 0 -> 194705 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/mattens/mattens_sample_src.zip | bin | 0 -> 35130 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/mattens/mattens.dtx | 1324 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/mattens/mattens.ins | 86 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/mattens/mattens.sty | 30 |
9 files changed, 659 insertions, 817 deletions
diff --git a/Master/texmf-dist/doc/latex/mattens/MTsample.pdf b/Master/texmf-dist/doc/latex/mattens/MTsample.pdf Binary files differdeleted file mode 100644 index ef26e3e5938..00000000000 --- a/Master/texmf-dist/doc/latex/mattens/MTsample.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/mattens/MTsample_src.zip b/Master/texmf-dist/doc/latex/mattens/MTsample_src.zip Binary files differdeleted file mode 100644 index 7d5c22c7ba0..00000000000 --- a/Master/texmf-dist/doc/latex/mattens/MTsample_src.zip +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/mattens/README b/Master/texmf-dist/doc/latex/mattens/README index ccaa43b43d4..1e9817a5463 100644 --- a/Master/texmf-dist/doc/latex/mattens/README +++ b/Master/texmf-dist/doc/latex/mattens/README @@ -2,7 +2,7 @@ for vector/tensor typesetting Author: Danie Els - Copyright (c) 2001-2004 Danie Els + Copyright (c) 2001-2009 Danie Els Licence: LaTeX Project Public License DESCRIPTION @@ -14,7 +14,7 @@ DESCRIPTION velocities, moments of inertia, etc. This package adheres to the well-defined and documented notation - as proposed by Hassenpflug[1,2]. + as proposed by Hassenpflug:. 1. Hassenpflug, W.C., "Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates." @@ -22,7 +22,7 @@ DESCRIPTION 2. Hassenpflug, W.C., "Matrix Tensor Notation Part II. Skew and Curved Coordinates." - Comput. Math. Appl., vol. 29, no. 11, 1993, pp. 1-–103. + Comput. Math. Appl., vol. 29, no. 11, 1995, pp. 1-–103. FILES IN DISTRIBUTION @@ -52,23 +52,22 @@ FILES IN DISTRIBUTION SAMPLE DOCUMENT - MTsample.pdf - MTsample.tex A sample document that describes the tensor - notation itself in mode detail. It shows some - of the applications of the vector/tensor - notation. + mattens_sample.pdf + mattens_sample.tex A sample document that describes the tensor + notation itself in mode detail. It shows some + of the applications of the vector/tensor + notation. - readme_sampl Read-me file for the compilation of the - MTsample document and graphics. + Header.asy Asympote header file for graphics - rotate.(mps/ps) Graphics file (MetaPost output). - transrot.(mps/ps) Graphics file (MetaPost output). + Genrots.asy Asympote source file + Genrots.pdf Graphics input file - mphead.tex MetaPost (for latexMP packages) input header. - rotate.mp MetaPost source file. - transrot.mp MetaPost source file. - MPfig.bat Dos batch file for compilation of MetaPost - graphics files. See "readme.sampl". + Genrots2.asy Asympote source file + Genrots2.pdf Graphics input file + + TransRot.asy Asympote source file + TransRot.pdf Graphics input file BASIC INSTALLATION @@ -90,4 +89,5 @@ BASIC INSTALLATION <texmf>/doc/latex/mattens/ readme mattens.pdf - MTsample.pdf + mattens_sample.pdf + mattens_sample_src.zip diff --git a/Master/texmf-dist/doc/latex/mattens/mattens.pdf b/Master/texmf-dist/doc/latex/mattens/mattens.pdf Binary files differindex 864f4c9af6f..33bfd88609c 100644 --- a/Master/texmf-dist/doc/latex/mattens/mattens.pdf +++ b/Master/texmf-dist/doc/latex/mattens/mattens.pdf diff --git a/Master/texmf-dist/doc/latex/mattens/mattens_sample.pdf b/Master/texmf-dist/doc/latex/mattens/mattens_sample.pdf Binary files differnew file mode 100644 index 00000000000..321d16aa7cb --- /dev/null +++ b/Master/texmf-dist/doc/latex/mattens/mattens_sample.pdf diff --git a/Master/texmf-dist/doc/latex/mattens/mattens_sample_src.zip b/Master/texmf-dist/doc/latex/mattens/mattens_sample_src.zip Binary files differnew file mode 100644 index 00000000000..f551c78b3ca --- /dev/null +++ b/Master/texmf-dist/doc/latex/mattens/mattens_sample_src.zip diff --git a/Master/texmf-dist/source/latex/mattens/mattens.dtx b/Master/texmf-dist/source/latex/mattens/mattens.dtx index 46115b9f906..50a753b7243 100644 --- a/Master/texmf-dist/source/latex/mattens/mattens.dtx +++ b/Master/texmf-dist/source/latex/mattens/mattens.dtx @@ -1,39 +1,99 @@ -% \iffalse +% \iffalse meta-comment +% +% mattens.dtx +% Copyright (C) 2001--2009 Danie Els +% +% ------------------------------------------------------------------- +% The mattens package +% for vector/tensor typesetting +% ------------------------------------------------------------------- +% This work may be distributed and/or modified under the conditions +% of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX +% version 2005/12/01 or later. +% +% This work has the LPPL maintenance status 'maintained'. +% +% This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za) % -% mattens.dtx Copyright (C) 2001,2004 DNJ Els +% This package consists of the files: mattens.dtx +% mattens.ins +% and the derived files: mattens.sty +% ------------------------------------------------------------------- % -% It may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either version 1.1 -% 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.1 or later is part of all distributions of LaTeX -% version 1999/06/01 or later. +% \fi % +% \iffalse %<*driver> \documentclass[a4paper]{ltxdoc} + \makeatletter + \newcommand{\DeclareSBox}[2]{% + \@ifdefinable{#1}{% + \edef\tempa{\expandafter\@gobble\string#1}% + \edef\tempa{\csname MTbox@\tempa\endcsname}% + \expandafter\newbox\tempa + \global\sbox{\tempa}{#2}% + \protected@xdef#1{\noexpand\usebox{\tempa}}}} \usepackage{amsmath} \usepackage{amsfonts} - \DeclareMathSymbol{\square}{\mathord}{AMSa}{"03} + \DeclareMathSymbol{\square}{\mathord}{AMSa}{"03} + \newcommand*{\m}{\raisebox{.1ex}{$\scriptscriptstyle\square$}} + \DeclareMathAlphabet{\mathsfsl}{OT1}{cmss}{m}{sl} \usepackage{color} - % Declare the following two saved boxes before + % Declare the following saved box before % the accents and bm packages are loaded - \newsavebox{\AccentBox} - \sbox{\AccentBox}{$\dot{\overline{f}}^a_b$} + \DeclareSBox{\AccentBox}{$\dot{\overline{f}}^a_b$} \usepackage{array} \usepackage{accents} + \newcommand{\dotr}[1]{\accentset{\phantom{r}{\displaystyle.}r}{#1}} \usepackage{mattens} \usepackage{bm} - \bmdefine{\bO}{\mathit{\Omega}} + \bmdefine{\bO}{\mathit{\Omega}} + + \newcommand*{\pkg}[1]{\textsf{#1}} + \newcommand*{\opt}[1]{\textsf{#1}} + \newcommand*{\MT}{\pkg{mattens}} + \newcommand*{\Hass}{Hassenpflug} + \newcommand*{\myemph}[1]{\emph{#1}} + \newenvironment{Decl}% + {\par\small\addvspace{2.3ex plus 1ex}% + \vskip -\parskip + \noindent\hspace{\leftmargini}% + \begin{tabular}{|l|}\hline\ignorespaces}% + {\\\hline\end{tabular}\nobreak\par\nobreak + \vspace{2.3ex}\vskip -\parskip} + \newenvironment{Indent}[1]{% + \begin{list}{}{% + \setlength{\topsep}{0pt}% + \setlength{\leftmargin}{#1}% + \setlength{\listparindent}{\parindent}% + \setlength{\itemindent}{\parindent}% + \setlength{\parsep}{\parskip}}% + \item[] + }{\end{list}} + \newenvironment{sample}{% + \begin{quote}\small\begin{tabbing}% + \hskip12pc\=\kill}% + {\end{tabbing}\end{quote}} + \newcommand*{\sphline}{% horizontal table line with spaces + \noalign{\vskip3pt}\hline\noalign{\vskip3pt}} + \newcommand*{\tdot}{\ensuremath{\cdot}} + \newcommand*{\trnsp}{\ensuremath{\mathsf{T}}} + \newcommand*{\norm}[1]{\ensuremath{\lVert{#1}\rVert}} + \newcommand*{\SB}[1]{\ensuremath{\left[\, #1\right]}} - \EnableCrossrefs - %\DisableCrossrefs % Say \DisableCrossrefs if index is ready - \CodelineIndex - \RecordChanges % Gather update information - %\OnlyDescription % comment out for implementation details - \setlength\hfuzz{15pt} % dont make so many - \hbadness=7000 % over and under full box warnings - \DeclareMathAlphabet{\mathsfsl}{OT1}{cmss}{m}{sl} + \MakeShortVerb{\|} + \EnableCrossrefs + %\DisableCrossrefs % Say \DisableCrossrefs if index is ready + \CodelineIndex + \RecordChanges % Gather update information + %\OnlyDescription % comment out for implementation details + \setlength\hfuzz{15pt} % dont make so many + \hbadness=7000 % over and under full box warnings + \makeatother \begin{document} \DocInput{mattens.dtx} \end{document} @@ -41,7 +101,7 @@ % % \fi % -% \CheckSum{585} +% \CheckSum{584} %% \CharacterTable %% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z %% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z @@ -87,65 +147,11 @@ % % \changes{1.0}{2001 Dec 9}{Initial version} % \changes{1.1}{2004 Jan 15}{Doc: Updated} +% \changes{1.3}{2009 Sep 1}{Doc: Updated} % % % \GetFileInfo{mattens.sty} % -% ^^A Some commands to format document %%%%%%%%%%%%% -% -% \newcommand*{\pkg}[1]{\textsf{#1}} -% \newcommand*{\opt}[1]{\textsf{#1}} -% \newcommand*{\MT}{\pkg{mattens}} -% \newcommand*{\Hass}{Hassenpflug} -% -% \newcommand*{\myemph}[1]{\emph{#1}} -% -% \newenvironment{Decl}^^A -% {\par\small\addvspace{2.3ex plus 1ex}^^A -% \vskip -\parskip -% \noindent\hspace{\leftmargini}^^A -% \begin{tabular}{|l|}\hline\ignorespaces}^^A -% {\\\hline\end{tabular}\nobreak\par\nobreak -% \vspace{2.3ex}\vskip -\parskip} -% -% \newenvironment{Indent}[1]{^^A -% \begin{list}{}{^^A -% \setlength{\topsep}{0pt}^^A -% \setlength{\leftmargin}{#1}^^A -% \setlength{\listparindent}{\parindent}^^A -% \setlength{\itemindent}{\parindent}^^A -% \setlength{\parsep}{\parskip}}^^A -% \item[] -% }{\end{list}} -% -% \newenvironment{sample}{^^A -% \begin{quote}\small\begin{tabbing}^^A -% \hskip12pc\=\kill}^^A -% {\end{tabbing}\end{quote}} -% -% \newcommand*{\sphline}{^^A horizontal table line with spaces -% \noalign{\vskip3pt}^^A -% \hline^^A -% \noalign{\vskip3pt}} -% -% \newcommand{\dotr}[1]{\accentset{\phantom{r}{\displaystyle.}r}{#1}} -% -% \makeatletter -% \newcommand{\DeclareSBox}[2]{% -% \@ifdefinable{#1}{^^A -% \edef\tempa{\expandafter\@gobble\string#1}^^A -% \edef\tempa{\csname MTbox@\tempa\endcsname}^^A -% \expandafter\newbox\tempa^^A -% \global\sbox{\tempa}{#2}^^A -% \protected@xdef#1{\noexpand\usebox{\tempa}}^^A -% }} -% \newcommand*{\tdot}{\ensuremath{\cdot}} -% \newcommand*{\trnsp}{\ensuremath{\mathsf{T}}} -% \newcommand*{\norm}[1]{\ensuremath{\lVert{#1}\rVert}} -% \newcommand*{\SB}[1]{\ensuremath{\left[\, #1\right]}} -% \makeatother -% -% \MakeShortVerb{\|} % % \title{The \MT\ package\thanks{This file has version number % \fileversion, last revised @@ -156,25 +162,24 @@ % % \begin{abstract} % \noindent The \MT\ package contains the definitions to typeset vectors and -% tensors such as \aS{e}_i, \bS[\dot]{x}^r, \bSb{E}^s_r, etc., for the representation of common -% vectors and tensors such as forces, velocities, moments of inertia, -% etc. -% These symbols (and variants thereof) are found on the black -% boards of engineering schools and in many journals and books, +% tensors such as $\aS{e}_i$, $\bS[\dot]{x}^r$, $\bSb{E}^s_r$, etc., for the +% representation of common vectors and tensors such as forces, velocities, +% moments of inertia, etc. These symbols (and variants thereof) are found on +% the black boards of engineering schools and in many journals and books, % particularly those concerned with dynamics and kinematics. % -% This package adheres to the well defined and documented notation -% of Hassenpflug.\footnote{ -% Hassenpflug, W.C., -% Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates. -% \emph{Comput. Math.\ Applic.,} vol.\ 26, no.\ 3, 1993, pp.\ 55--93.} -% \footnote{ -% Hassenpflug, W.C., -% Matrix Tensor Notation Part II. Skew and Curved Coordinates. -% \emph{Comput. Math. Appl.}, vol.\ 29, no.\ 11, 1993, pp. 1--103.} +% This package adheres to the well defined and documented notation of +% Hassenpflug.\footnote{^^A +% Hassenpflug, W.C., +% Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates. +% \emph{Comput. Math.\ Applic.,} vol.\ 26, no.\ 3, 1993, pp.\ 55--93.}^^A +% \textsuperscript{,}^^A +% \footnote{ +% Hassenpflug, W.C., +% Matrix Tensor Notation Part II. Skew and Curved Coordinates. +% \emph{Comput. Math. Appl.}, vol.\ 29, no.\ 11, 1993, pp. 1--103.} % % \medskip -% % \noindent\slshape{\bfseries Keywords:} vector, matrix, tensor, notation. % \end{abstract} % @@ -184,617 +189,465 @@ % \clearpage % \section{Background} % -% A browse through journals and handbooks, in particular those -% concerned with dynamics, reveals an amazing array of private -% notations for vectors and tensors. Every author has his or her own -% notation, making it very difficult to comprehend what is going on -% in complex multi reference axes environments. -% -% This package is based on the notation of \Hass\cite{Hass93a,Hass93b}. -% It was developed and refined by Dr.~\Hass{} over many years of -% teaching engineering, and as stated by him\cite{Hass93a}: -% -% \begin{quote} -% \slshape``It is designed particulary to distinguish between -% vectors and tensors and their representation as vectors and matrices -% in different coordinate systems. The main purpose of this notation -% is that it can be used in the teaching situation, therefore, it -% conveys all the information explicitly in the symbols, and it can be -% used in handwriting.'' +% A browse through journals and handbooks, in particular those concerned with +% dynamics, reveals an amazing array of private notations for vectors and +% tensors. Every author has his or her own notation, making it very difficult +% to comprehend what is going on in complex multi reference axes environments. +% +% This package is based on the notation of \Hass\cite{Hass93a,Hass93b}. It was +% developed and refined by Dr.~\Hass{} over many years of teaching engineering, +% and as stated by him\cite{Hass93a}: +% +% \begin{quote}\slshape +% ``It is designed particulary to distinguish between vectors and tensors +% and their representation as vectors and matrices in different coordinate +% systems. The main purpose of this notation is that it can be used in the +% teaching situation, therefore, it conveys all the information explicitly +% in the symbols, and it can be used in handwriting.'' % \end{quote} -% \noindent \Hass\cite{Hass93a} identifies the following list of -% requirements for a good notation for tensor quantities and -% operations, to which his notation conforms. A notation must: +% +% \noindent \Hass\cite{Hass93a} identifies the following list of requirements +% for a good notation for tensor quantities and operations, to which his +% notation conforms. A notation must: % \begin{itemize} -% \item be easily written by hand; -% \item distinguish between vector and scalar quantities; -% \item distinguish between (second order) tensors and vectors; -% \item distinguish between physical vectors and their -% representation by vector arrays, and between physical -% (second order) tensors and their representation by matrices; -% \item distinguish between row and column vectors; -% \item use the same symbol as name for the same vector or tensor in -% either its physical sense or its representation by a vector -% array or matrix in different coordinate axes; -% \item distinguish between matrix/vector representation of the same -% vector/tensor in different coordinate axes; -% \item be equally valid in orthonormal and skew coordinate -% axes; -% \item indicate all intended operations uniquely; -% \item be equally valid in all dimensions; -% \item be equally valid for algebraic vector/matrix algebra -% which has no connection to any metric space; -% \item be applicable to differentials; -% \item allow for defaults to avoid repetitive elaborate symbols, i.e., -% not all the symbols need to be written down explicitly if it is -% clear from the context. -% \item It must be well documented (own addition). +% \item be easily written by hand; +% \item distinguish between vector and scalar quantities; +% \item distinguish between (second order) tensors and vectors; +% \item distinguish between physical vectors and their representation +% by vector arrays, and between physical (second order) tensors and +% their representation by matrices; +% \item distinguish between row and column vectors; +% \item use the same symbol as name for the same vector or tensor in +% either its physical sense or its representation by a vector array +% or matrix in different coordinate axes; +% \item distinguish between matrix/vector representation of the same +% vector/tensor in different coordinate axes; +% \item be equally valid in orthonormal and skew coordinate axes; +% \item indicate all intended operations uniquely; +% \item be equally valid in all dimensions; +% \item be equally valid for algebraic vector/matrix algebra which has +% no connection to any metric space; +% \item be applicable to differentials; +% \item allow for defaults to avoid repetitive elaborate symbols, i.e., +% not all the symbols need to be written down explicitly if it is +% clear from the context. +% \item It must be well documented (own addition). % \end{itemize} % % \noindent The \MT\ package was developed to typeset the \Hass{} matrix % tensor symbols in a consistent manner. % -% An appeal is made to -% the engineering and scientific community to adopt -% this notation, because of its consistency -% and ease of use. -% +% An appeal is made to the engineering and scientific community to adopt this +% notation, because of its consistency and ease of use. % % \section{Usage of \MT\ package} % % The \MT\ package is loaded in the document preamble with: % \begin{quote} -% \begin{tabbing}^^A -% \hskip14pc\=\kill^^A -% $~~~\vdots$\\ -% \cmd{\usepackage}\oarg{options}|{mattens}| \>|% amsmath loaded internally|\\ -% $~~~\vdots$\\ -% \cmd{\usepackage}\marg{font packages} \>|%|\\ -% \cmd{\DeclareSymbolFont}... \>|% All the font changes|\\ -% \cmd{\SetSymbolFont}... \>|%|\\ -% \cmd{\DeclareSymbolFontAlphabet}... \>|%|\\ -% $~~~\vdots$\\ -% \cmd{\usepackage}|{bm} %\boldsymbol redirected to call \bm|\\ -% $~~~\vdots$ +% \begin{tabbing} +% \hskip14pc\=\kill +% \qquad$\vdots$\\ +% \cmd{\usepackage}\oarg{options}|{mattens}| \>|% amsmath loaded internally|\\ +% \qquad$\vdots$\\ +% \cmd{\usepackage}\marg{font packages} \>|%|\\ +% \cmd{\DeclareSymbolFont}... \>|% All the font changes|\\ +% \cmd{\SetSymbolFont}... \>|%|\\ +% \cmd{\DeclareSymbolFontAlphabet}... \>|%|\\ +% \qquad$\vdots$\\ +% \cmd{\usepackage}|{bm} %\boldsymbol redirected to call \bm|\\ +% \qquad$\vdots$ % \end{tabbing} % \end{quote} % % \noindent When \MT\ is loaded, the \pkg{amsmath} package is loaded -% automatically, because it is needed for the redefined -% \cmd{\overrightarrow} and \cmd{\underrightarrow} commands, -% as well as the \cmd{\boldsymbol} command. It -% must be loaded before any font packages -% that redefine some of the \pkg{amsmath} symbols or commands. -% -% On the other hand, the preferred method for obtaining bold -% italic math symbols is the \cmd{\bm} command of the -% \pkg{bm} package.\footnote{In the \pkg{amsmath} documentation, -% \AmS{} recommends the \cmd{\bm} command of the \pkg{bm} package -% instead of the \cmd{\boldsymbol} command for bold italic math -% symbols. The \cmd{\boldsymbol} puts its contents in a box, -% \cmd{\mbox\{}\cmd{\boldmath\$}\meta{contents}\texttt{\$\}}, -% while \cmd{\bm} is a font changing command that uses the appropriate -% bold math font.} -% The \pkg{bm} package must be loaded after all the font packages -% in order for it to recognize the bold math versions. -% The \pkg{bm} package reroutes the \cmd{\boldsymbol} command to point -% to \cmd{\bm}. If \cmd{\boldsymbol} is called after -% the \pkg{bm} package is loaded, it is equivalent to -% \cmd{\bm}. -% If the \pkg{bm} package is not loaded, \MT\ defaults to -% the \cmd{\boldsymbol} command. -% -% The \MT\ package by default sets bold italics symbols. This -% choice stems from the ISO standards for typesetting of vectors -% and tensors. The formatting of symbols then indicates the fact -% that it is a vector/tensor and the lines, arrows and sub- and -% superscripts indicate the specific type and reference axes. +% automatically, because it is needed for the redefined \cmd{\overrightarrow} +% and \cmd{\underrightarrow} commands, as well as the \cmd{\boldsymbol} +% command. It must be loaded before any font packages that redefine some of the +% \pkg{amsmath} symbols or commands. +% +% On the other hand, the preferred method for obtaining bold italic math +% symbols is the \cmd{\bm} command of the \pkg{bm} package.\footnote{In the +% \pkg{amsmath} documentation, \AmS{} recommends the \cmd{\bm} command of the +% \pkg{bm} package instead of the \cmd{\boldsymbol} command for bold italic +% math symbols. The \cmd{\boldsymbol} puts its contents in a box, +% \cmd{\mbox\{}\cmd{\boldmath\$}\meta{contents}\texttt{\$\}}, while \cmd{\bm} +% is a font changing command that uses the appropriate bold math font.} The +% \pkg{bm} package must be loaded after all the font packages in order for it +% to recognize the bold math versions. The \pkg{bm} package reroutes the +% \cmd{\boldsymbol} command to point to \cmd{\bm}. If \cmd{\boldsymbol} is +% called after the \pkg{bm} package is loaded, it is equivalent to \cmd{\bm}. +% If the \pkg{bm} package is not loaded, \MT\ defaults to the \cmd{\boldsymbol} +% command. +% +% The \MT\ package by default sets bold italics symbols. This choice stems from +% the ISO standards for typesetting of vectors and tensors. The formatting of +% symbols then indicates the fact that it is a vector/tensor and the lines, +% arrows and sub- and superscripts indicate the specific type and reference +% axes. % % The following options are recognized by \MT: % % \begin{description} -% \item[\normalfont\opt{noformat}:~~ ] No symbol formatting is performed, -% otherwise symbols are set by default in bold italics with the -% \cmd{\boldsymbol} or \cmd{\bm} command. +% \item[\normalfont\opt{noformat}:] No symbol formatting is performed, +% otherwise symbols are set by default in bold italics with the +% \cmd{\boldsymbol} or \cmd{\bm} command. % -% It is important to note that the \Hass{} requirement of easily -% written by hand is not fulfilled if the symbols are formatted -% by anything else than normal math fonts. +% It is important to note that the \Hass{} requirement of easily +% written by hand is not fulfilled if the symbols are formatted +% by anything else than normal math fonts. % -% \item[\normalfont\opt{mathstrut}: ~~] A mathstrut is inserted -% with the symbol to force all the lines and arrows to the same -% height and depth. The default is no mathstrut. +% \item[\normalfont\opt{mathstrut}:] A mathstrut is inserted with the +% symbol to force all the lines and arrows to the same height and +% depth. The default is no mathstrut. % \end{description} % -% \clearpage -% \section{List of \MT\ commands} +% \clearpage +% \section{List of \MT\ commands} % % \begin{table}[htbp] -% \caption{List of Matrix Tensor typing commands} \label{tab:1} -% \small -% \renewcommand{\footnoterule}{} -% \begin{tabular}{@{}ll>{\itshape}r@{}>{\itshape}c@{}>{\itshape}lc@{}} -% \sphline -% \bfseries Type & -% \bfseries Command & -% \multicolumn{3}{c}{ -% \bfseries Description} & -% \bfseries Output\\ -% \sphline -% Physical column vector& -% \cmd{\aS}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aS} & -% arrow--&Symbol& & -% \aS{x} \\[1.0ex] -% -% Physical row vector & -% \cmd{\Sa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{Sa} & -% &Symbol&--arrow& -% \Sa{x} \\[1.0ex] -% -% Column vector & -% \cmd{\bS}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bS} & -% bar--&Symbol& & -% \bS{x} \\[1.0ex] -% -% Row vector & -% \cmd{\Sb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{Sb} & +% \caption{List of Matrix Tensor typing commands} \label{tab:1} +% \small +% \renewcommand{\footnoterule}{} +% \begin{tabular}{@{}ll>{\itshape}r@{}>{\itshape}c@{}>{\itshape}lc@{}} +% \sphline +% \bfseries Type & +% \bfseries Command & +% \multicolumn{3}{c}{\bfseries Description} & +% \bfseries Output +% \\ +% \sphline +% +% Physical column vector& +% \cmd{\aS}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aS} & +% arrow--&Symbol& & +% $\aS{x}$ +% \\[1.0ex] +% +% Physical row vector & +% \cmd{\Sa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{Sa} & +% &Symbol&--arrow& +% $\Sa{x}$ +% \\[1.0ex] +% +% Column vector & +% \cmd{\bS}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bS} & +% bar--&Symbol& & +% $\bS{x}$ +% \\[1.0ex] +% +% Row vector & +% \cmd{\Sb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{Sb} & % &Symbol&--bar & -% \Sb{x} \\[1.0ex] -% -% Physical tensor & -% \cmd{\aSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aSa}& -% arrow--&Symbol&--arrow& -% \aSa{E}\\[1.0ex] -% -% Tensor (mixed base) & -% \cmd{\aSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aSb}& -% arrow--&Symbol&--bar & -% \aSb{E}\\[1.0ex] -% -% Tensor (mixed base) & -% \cmd{\bSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bSa}& -% bar--&Symbol&--arrow& -% \bSa{E}\\[1.0ex] -% -% Tensor & -% \cmd{\bSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bSb}& -% bar--&Symbol&--bar & -% \bSb{E}\\[1.0ex] -% -% Cross-product tensor$^\dag$ -% & -% \cmd{\aCSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aCSa}& -% arrow--C&Symbol&--arrow& -% \aCSa{w} \\[1.0ex] -% -% Cross-product tensor & -% \cmd{\bCSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bCSb}& -% bar--C&Symbol&--bar & -% \bCSb{w} \\[1.0ex] -% -% \sphline -% -% \multicolumn{5}{@{}l}{\footnotesize$^\dag$~ -% It is defined as the tensor -% \bCSb{a}\ associated with the vector \bS{a}, where -% $\bS{a}\times\bS{c}=\bCSb{a}\cdot\bS{c}$} -% \end{tabular} -% \end{table} +% $\Sb{x}$ +% \\[1.0ex] +% +% Physical tensor & +% \cmd{\aSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aSa}& +% arrow--&Symbol&--arrow& +% $\aSa{E}$ +% \\[1.0ex] +% +% Tensor (mixed base) & +% \cmd{\aSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aSb}& +% arrow--&Symbol&--bar & +% $\aSb{E}$ +% \\[1.0ex] +% +% Tensor (mixed base) & +% \cmd{\bSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bSa}& +% bar--&Symbol&--arrow& +% $\bSa{E}$ +% \\[1.0ex] +% +% Tensor & +% \cmd{\bSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bSb}& +% bar--&Symbol&--bar & +% $\bSb{E}$ +% \\[1.0ex] +% +% Cross-product tensor$^\dag$ & +% \cmd{\aCSa}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{aCSa}& +% arrow--C&Symbol&--arrow& +% $\aCSa{w}$ +% \\[1.0ex] +% +% Cross-product tensor & +% \cmd{\bCSb}\oarg{accent}\marg{Symbol}\SpecialUsageIndex{bCSb}& +% bar--C&Symbol&--bar & +% $\bCSb{w}$ +% \\[1.0ex] +% +% \sphline +% \multicolumn{5}{@{}l}{\footnotesize$^\dag$~ +% It is defined as the tensor $\bCSb{a}$ associated with the +% vector $\bS{a}$, where $\bS{a}\times\bS{c}=\bCSb{a}\cdot\bS{c}$} +% \end{tabular} +% \end{table} % % \subsection{General syntax} % % The general syntax of the \MT\ commands is -%{\newcommand*\m{\raisebox{.1ex}{$\scriptscriptstyle\square$}}^^A % \begin{Decl} -% |\|\m|S|\m\,| |\oarg{accent}\marg{Symbol} ~~ -% |\|\m|CS|\m\,| |\oarg{accent}\marg{Symbol}\\[1ex] -% |\|\m|S|\m\,|*|\oarg{accent}\marg{Symbol}~~~ -% |\|\m|CS|\m\,|*|\oarg{accent}\marg{Symbol} -% \end{Decl}} -% -% \noindent with command names \cmd{\bS}, \cmd{\aS}, \cmd{\aSa}, \cmd{\aSb}, etc. -% See table\:\ref{tab:1} for a full list of all the commands. The -% ``starred'' form is used to set the -% symbol in normal math. This can be used for compound tensors or for -% pre-declared symbols (see \pkg{bm} documentation). -% An example of the usage is +% |\|\m|S|\m\,| |\oarg{accent}\marg{Symbol} ~~ +% |\|\m|CS|\m\,| |\oarg{accent}\marg{Symbol}\\[1ex] +% |\|\m|S|\m\,|*|\oarg{accent}\marg{Symbol}~~~ +% |\|\m|CS|\m\,|*|\oarg{accent}\marg{Symbol} +% \end{Decl} +% \noindent with command names $\cmd{\bS}$, $\cmd{\aS}$, $\cmd{\aSa}$, +% $\cmd{\aSb}$, etc. See table\:\ref{tab:1} for a full list of all the +% commands. The ``starred'' form is used to set the symbol in normal math. +% This can be used for compound tensors or for pre-declared symbols (see +% \pkg{bm} documentation). An example of the usage is % \begin{sample} -% \hskip4pc\=\hskip8pc\=\hskip2pc\=\kill^^A -% \cmd{\aS}|{e}| \> \cmd{\aS*}|{e}| \> \aS{e} \> \aS*{e}\\[0.75ex] -% \cmd{\Sb}|{x}| \> \cmd{\Sb*}|{x}| \> \Sb{x} \> \Sb*{x}\\[0.75ex] -% \cmd{\aCSa}|{z}|\> \cmd{\aCSa*}|{z}| \> \aCSa{z}\> \aCSa*{z} +% \hskip4pc\=\hskip8pc\=\hskip2pc\=\kill^^A +% \cmd{\aS}|{e}| \> \cmd{\aS*}|{e}| \> $\aS{e}$ \> $\aS*{e}$\\[0.75ex] +% \cmd{\Sb}|{x}| \> \cmd{\Sb*}|{x}| \> $\Sb{x}$ \> $\Sb*{x}$\\[0.75ex] +% \cmd{\aCSa}|{z}|\> \cmd{\aCSa*}|{z}| \> $\aCSa{z}$\> $\aCSa*{z}$ % \end{sample} -% The optional argument \meta{accent} is intended for -% \LaTeX{} accent commands such as \cmd{\dot}, \cmd{\ddot}, etc., or -% their $\AmS$ equivalents, \cmd{\Dot}, \cmd{\Ddot}. -% +% The optional argument \meta{accent} is intended for \LaTeX{} accent commands +% such as $\cmd{\dot}$, $\cmd{\ddot}$, etc., or their $\AmS$ equivalents, +% $\cmd{\Dot}$, $\cmd{\Ddot}$. % \begin{sample} -% |\bS[\Ddot]{x}| \> \bS[\Ddot]{x} +% |\bS[\Ddot]{x}| \> $\bS[\Ddot]{x}$ % \end{sample} % -% \noindent The \MT\ commands look ahead for sub- and superscripts (including primes) -% in order to place them at the correct horizontal and vertical -% positions. +% The \MT\ commands look ahead for sub- and superscripts (including primes) in +% order to place them at the correct horizontal and vertical positions. % \begin{sample} -% \cmd{\bS}|[|\cmd{\Dot}|]{x}^s_i| \> \bS[\Dot]{x}^s_i\\[1ex] -% \cmd{\bS}|[|\cmd{\Ddot}|]{x}_i^s| \> \bS[\Ddot]{x}_i^s\\[1ex] -% \cmd{\bS}|{x}''^s_i| \> \bS{x}''^s_i\\[1ex] -% \cmd{\bSa}|{E}^k| \> \bSa{E}^k\\[1ex] -% \cmd{\aSb}|[|\cmd{\Dot}|]{E}_s| \> \aSb[\Dot]{E}_s +% \cmd{\bS}|[|\cmd{\Dot}|]{x}^s_i| \> $\bS[\Dot]{x}^s_i$ \\[1ex] +% \cmd{\bS}|[|\cmd{\Ddot}|]{x}_i^s| \> $\bS[\Ddot]{x}_i^s$ \\[1ex] +% \cmd{\bS}|{x}''^s_i| \> $\bS{x}''^s_i$ \\[1ex] +% \cmd{\bSa}|{E}^k| \> $\bSa{E}^k$ \\[1ex] +% \cmd{\aSb}|[|\cmd{\Dot}|]{E}_s| \> $\aSb[\Dot]{E}_s$ % \end{sample} % -% \noindent These commands, including the sub- and -% superscripts, can be used in text mode. -% +% The commands are also robust and can be used in moving commands such as +% footnotes\footnote{A vector $\aS{e}_i$ in a footnote}, headers, etc. % \begin{sample} -% |Vector \bS{x}^s_i{} in text.| \> -% Vector \bS{x}^s_i{} in text. +% |\footnote{A vector $\aS{e}_i$ in a footnote}| % \end{sample} % -% \noindent The commands are also robust and can be used in moving commands -% such as footnotes\footnote{A vector \aS{e}_i\ in a footnote}, -% headers, etc. -% -% \begin{sample} -% |\footnote{A vector \aS{e}_i{} in a footnote}| -% \end{sample} -% -% \noindent The symbols scale to the appropriate sizes if used in sub- and -% superscripts. For example, for an integration path parameterized -% by the vector $\bS{r}^s(\xi)$, the equation for a line integral -% +% The symbols scale to the appropriate sizes if used in sub- and superscripts. +% For example, for an integration path parameterized by the vector +% $\bS{r}^s(\xi)$, the equation for a line integral % \begin{verbatim} -% \begin{equation*} -% \oint\limits_{\bS{r}^s(\xi)} \dotsi +% \begin{equation*} +% \oint\limits_{\bS{r}^s(\xi)} \dotsi % \end{equation*} % \end{verbatim} % gives -% \[\oint\limits_{\bS{r}^s(\xi)} \dotsi\] -% +% \begin{equation*} +% \oint\limits_{\bS{r}^s(\xi)} \dotsi +% \end{equation*} % \bigskip % % ^^A\clearpage % \section{Symbol formatting commands} % \subsection{Bold italic symbols} % -% \noindent The symbol format can be set with the package options -% +% The symbol format can be set with the package options % \begin{sample} -% \hskip14pc\=\kill -% |\usepackage{mattens}| \>Uses |\boldsymbol| as default\\ -% |\usepackage[noformat]{mattens}| \>No symbol formatting +% \hskip14pc\=\kill +% |\usepackage{mattens}| \>|% Uses \boldsymbol as default| % \end{sample} -% -% \noindent or anywhere in the document with the command -% +% or +% \begin{sample} +% \hskip14pc\=\kill +% |\usepackage[noformat]{mattens}| \>|% No symbol formatting| +% \end{sample} +% or anywhere in the document with the command % \begin{Decl} -% \cmd{\SetSymbFont}\marg{font-command}^^A -% \SpecialUsageIndex{\SetSymbFont} +% \cmd{\SetSymbFont}\marg{font-command}^^A +% \SpecialUsageIndex{\SetSymbFont} % \end{Decl} -% -% \noindent The \pkg{bm} package reroutes the \cmd{\boldsymbol} command to point -% to \cmd{\bm}. If \cmd{\SetSymbFont}|{\boldsymbol}| is called after -% the \pkg{bm} package is loaded, it is equivalent to -% \cmd{\SetSymbFont}|{\bm}|. Bold formatting of individual tensors -% can also be switched off with the use of the starred forms of the -% tensor commands. -% -% If the symbols are interpreted as tensors, then according to the ISO, -% it can be typeset in a slanted sans serif font (if you are fond -% of fonts). For the Computer Modern fonts with an \texttt{OT1} -% encoding, you can put in the preamble -% +% \noindent The \pkg{bm} package reroutes the \cmd{\boldsymbol} command to +% point to \cmd{\bm}. If \cmd{\SetSymbFont}|{\boldsymbol}| is called after the +% \pkg{bm} package is loaded, it is equivalent to \cmd{\SetSymbFont}|{\bm}|. +% Bold formatting of individual tensors can also be switched off with the use +% of the starred forms of the tensor commands. +% +% If the symbols are interpreted as tensors, then according to the ISO, it can +% be typeset in a slanted sans serif font (if you are fond of fonts). For the +% Computer Modern fonts with an \texttt{OT1} encoding, you can put in the +% preamble % \begin{quote} -% |\DeclareMathAlphabet{\mathsfsl}{OT1}{cmss}{m}{sl}| +% |\DeclareMathAlphabet{\mathsfsl}{OT1}{cmss}{m}{sl}| % \end{quote} -% -% \noindent Examples of formats are -% +% Examples of formats are % \begin{sample} -% |\SetSymbFont{\bm}| \>\SetSymbFont{\bm}\aSb{E}_s\\[1ex] -% |\SetSymbFont{\relax}| \>\SetSymbFont{\relax}\aSb{E}_s\\[1ex] -% |\SetSymbFont{\mathsfsl}| \>\SetSymbFont{\mathsfsl}\aSb{E}_s +% |\SetSymbFont{\bm}| \>\SetSymbFont{\bm}$\aSb{E}_s$\\[1ex] +% |\SetSymbFont{\relax}| \>\SetSymbFont{\relax}$\aSb{E}_s$\\[1ex] +% |\SetSymbFont{\mathsfsl}| \>\SetSymbFont{\mathsfsl}$\aSb{E}_s$ % \end{sample} % \SetSymbFont{\bm} % -% Only the first symbol (or group) in multi-symbol constructions is -% formatted. This can be used to obtain -% +% Only the first symbol (or group) in multi-symbol constructions is formatted. +% This can be used to obtain % \begin{sample} -% |\bS{{}xy}| ~|\bS*{xy}| \> \bS{{}xy} ~ \bS*{xy}\\ -% |\bS{xy}| \> \bS{xy} \\ -% |\bS{{xy}}| \> \bS{{xy}} +% |\bS{{}xy}| ~|\bS*{xy}| \> $\bS{{}xy}$ ~ $\bS*{xy}$\\ +% |\bS{xy}| \> $\bS{xy}$ \\ +% |\bS{{xy}}| \> $\bS{{xy}}$ % \end{sample} % or % \begin{sample} -% |\bCSb*{\bS{x}+\bS{y}}| \> \bCSb*{\bS{x}+\bS{y}}\\[1ex] -% |\bSb{E_{313}}^s_r| \> \bSb{E_{313}}^s_r +% |\bCSb*{\bS{x}+\bS{y}}| \> $\bCSb*{\bS{x}+\bS{y}}$\\[1ex] +% |\bSb{E_{313}}^s_r| \> $\bSb{E_{313}}^s_r$ % \end{sample} % -% When a font does not have bold italic symbols and is properly -% configured, the |\bm| command -% constructs the symbols with the ``poor man's bold'' -% method. This results in the loss of the subscript kerning. -% This is the case for the \pkg{mathptm}\ package for Times fonts. -% If bold italic symbols are needed for Times fonts, it is advisable -% to use the \pkg{txfonts} package or one of the commercial fonts. +% When a font does not have bold italic symbols and is properly configured, the +% |\bm| command constructs the symbols with the ``poor man's bold'' method. +% This results in the loss of the subscript kerning. This is the case for the +% \pkg{mathptm}\ package for Times fonts. If bold italic symbols are needed for +% Times fonts, it is advisable to use the \pkg{txfonts} package or one of the +% commercial fonts. % % % \subsection{Struts} % -% A strut can be inserted inside the tensor construction to force -% all the lines to the same height. This can be given in the package -% options -% +% A strut can be inserted inside the tensor construction to force all the lines +% to the same height. This can be given in the package options % \begin{sample} -% \hskip14pc\=\kill -% |\usepackage{mattens}| \>No strut as default \\ -% |\usepackage[mathstrut]{mattens}| \>Uses |\mathstrut| +% \hskip14pc\=\kill +% |\usepackage{mattens}| \>|% No strut as default | % \end{sample} -% -% \noindent or anywhere in the document with the command -% +% or +% \begin{sample} +% \hskip14pc\=\kill +% |\usepackage[mathstrut]{mattens}| \>|% Uses \mathstrut | +% \end{sample} +% or anywhere in the document with the command % \begin{Decl} -% \SpecialUsageIndex{\SetSymbStrut}^^A -% \cmd{\SetSymbStrut}\marg{strut} +% \SpecialUsageIndex{\SetSymbStrut}^^A +% \cmd{\SetSymbStrut}\marg{strut} % \end{Decl} -% % \noindent For example -% % \SetSymbStrut{\relax} % \begin{sample} -% |\SetSymbStrut{\relax}| \\ -% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>\bSb{E}, \bS{x}, \Sb{y} +% |\SetSymbStrut{\relax}| \\ +% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$ % \end{sample} -% \SetSymbStrut{\mathstrut}% +% \SetSymbStrut{\mathstrut} % \begin{sample} -% |\SetSymbStrut{\mathstrut}| \\ -% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>\bSb{E}, \bS{x}, \Sb{y} +% |\SetSymbStrut{\mathstrut}| \\ +% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$ % \end{sample} -% \SetSymbStrut{\vphantom{E}}% +% \SetSymbStrut{\vphantom{E}} % \begin{sample} -% |\SetSymbStrut{\vphantom{E}}| \\ -% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>\bSb{E}, \bS{x}, \Sb{y} +% |\SetSymbStrut{\vphantom{E}}| \\ +% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$ % \end{sample} % \SetSymbStrut{\relax} % % \subsection{Additional sub- and superscript spaces} % -% The placing of the sub- and superscripts was fine-tuned for -% Computer Modern fonts. Other fonts may require the sub- and -% superscript to shift closer or further away from the lines and the -% symbols. Additional spaces can be inserted before the sub- and -% superscripts with the following commands: -% +% The placing of the sub- and superscripts was fine-tuned for Computer Modern +% fonts. Other fonts may require the sub- and superscript to shift closer or +% further away from the lines and the symbols. Additional spaces can be +% inserted before the sub- and superscripts with the following commands: % \begin{Decl} -% \cmd{\SetArrowSkip}\marg{muskip length}\\[.5ex] -% \cmd{\SetBarSkip}\marg{muskip length}\\[.5ex] -% \cmd{\SetSymSubSkip}\marg{muskip length}\\[.5ex] -% \cmd{\SetSymSupSkip}\marg{muskip length} -% \SpecialUsageIndex{\SetArrowSkip} -% \SpecialUsageIndex{\SetBarSkip} -% \SpecialUsageIndex{\SetSymSubSkip} -% \SpecialUsageIndex{\SetSymSupSkip} +% \cmd{\SetArrowSkip}\marg{muskip length}\\[.5ex] +% \cmd{\SetBarSkip}\marg{muskip length}\\[.5ex] +% \cmd{\SetSymSubSkip}\marg{muskip length}\\[.5ex] +% \cmd{\SetSymSupSkip}\marg{muskip length} +% \SpecialUsageIndex{\SetArrowSkip} +% \SpecialUsageIndex{\SetBarSkip} +% \SpecialUsageIndex{\SetSymSubSkip} +% \SpecialUsageIndex{\SetSymSupSkip} % \end{Decl} -% % \noindent The length units must be in math units (\myemph{mu}), where -% $18\,\mathit{mu}=1\,\mathit{em}$ (a little less than the -% width of the letter ``M''). -% -% +% $18\,\mathit{mu}=1\,\mathit{em}$ (a little less than the width of the letter +% ``M''). % % \section{Other packages and classes} % % \begin{description} -% -% \item[\normalfont\pkg{bm}:~~] The \pkg{bm} package is preferred for -% bold\-/\-heavy symbols in math mode. It can also be used to -% predeclare bold symbols for use with the starred form of the tensor -% commands, for example: -% \SetSymbFont{\bm} -% \begin{sample} -% |\bmdefine{\bO}{\mathit{\Omega}}|\\ -% |\bSb*{\bO_i}| \>\qquad\qquad\qquad \bSb*{\bO_i} -% \end{sample} -% -% \item[\normalfont\pkg{hyperref}:~~] -% When tensor symbols are set in chapter and section headers, -% \pkg{hyperref} crashes if the \cmd{\texorpdfstring} command is not used. -% \begin{sample} -% |\section{A header with \texorpdfstring{\bS{x}^i_j}{xij}\ in it}| \\ -% \end{sample} -% -% \item[\normalfont\pkg{color}:~~] -% To change the colour of a symbol the \cmd{\color} command must -% be grouped two levels deep to survive all the expansions if the -% \pkg{bm} package is loaded. -% \begin{sample} -% |\aSb{{{\color{red}E}}}_i| \> \aSb{{{\color{red}E}}}_i \\ -% \end{sample} -% -% \item[\normalfont\pkg{slide}, \pkg{foils}:~~] -% The Euler math fonts are definitely compulsory. The ratio of -% the sub- and superscript sizes to normal math font sizes is too -% big inside the \pkg{slide} class. For tensors such as \bS{x}^j_k, -% you may find that the sub- and superscripts overlap. Choose -% your script characters carefully. \\ -% -% \item[\normalfont\pkg{eulervm}:~~] -% The \Hass{} ideal of symbols that are easily written by hand -% is satisfied with the beautiful letters of the Euler fonts. -% This package is a must for presentation material, but \myemph{please -% do not use bold Euler symbols}, they just do not look right! \\ -% -% \item[\normalfont\pkg{accents}:~~] -% For the creation of alternative accents the \MT\ package is fully -% compatible with the \pkg{accents}\ package. -% As an example of its usage, the equation in \Hass\cite{Hass93a}, -% \S10.1, p.82 +% \item[\normalfont\pkg{bm}:\quad] The \pkg{bm} package is preferred +% for bold\-/\-heavy symbols in math mode. It can also be used to +% predeclare bold symbols for use with the starred form of the +% tensor commands, for example: \SetSymbFont{\bm} +% \begin{sample} +% | \bmdefine{\bO}{\mathit{\Omega}}|\\ +% |$\bSb*{\bO_i}$| \>\qquad\qquad\qquad $\bSb*{\bO_i}$ +% \end{sample} +% +% \item[\normalfont\pkg{hyperref}:\quad] When tensor symbols are set in +% chapter and section headers, \pkg{hyperref} crashes if the +% \cmd{\texorpdfstring} command is not used. +% \begin{sample} +% |\section{A header with \texorpdfstring{$\bS{x}^i_j$}{xij} in it}| +% \end{sample} +% +% \item[\normalfont\pkg{color}:\quad] To change the colour of a symbol +% the \cmd{\color} command must be grouped two levels deep to +% survive all the expansions if the \pkg{bm} package is loaded. +% \begin{sample} +% |$\aSb{{{\color{red}E}}}_i$| \> $\aSb{{{\color{red}E}}}_i$ +% \end{sample} +% +% \item[\normalfont\pkg{slide}, \pkg{foils}:~~] The Euler math fonts +% are definitely compulsory. The ratio of the sub- and superscript +% sizes to normal math font sizes is too big inside the \pkg{slide} +% class. For tensors such as $\bS{x}^j_k$, you may find that the +% sub- and superscripts overlap. Choose your script characters +% carefully. +% +% \item[\normalfont\pkg{eulervm}:\quad] The \Hass{} ideal of symbols +% that are easily written by hand is satisfied with the beautiful +% letters of the Euler fonts. This package is a must for +% presentation material, but \myemph{please do not use bold Euler +% symbols}, they just do not look right! +% +% \item[\normalfont\pkg{accents}:\quad] For the creation of alternative +% accents the \MT\ package is fully compatible with the +% \pkg{accents}\ package. As an example of its usage, the equation +% in \Hass\cite{Hass93a}, \S10.1, p.82 % % \begin{minipage}{\textwidth} % \begin{verbatim} -% \SetSymbFont{\relax} -% \SetSymbStrut{\mathstrut}% -% \newcommand{\dotr}[1]{\accentset{\phantom{r}{\displaystyle.}r}{#1}} -% \begin{equation*} -% \text{apparent velocity} = \frac{\partial_r}{\mathrm{d}t} \aS{r} -% = \aS[\dotr]{r} -% = \aSb{E}_s \tdot \bS[\dotr]{r}^s -% \equiv \aS{v}_{\mathrm{app}} -% = \aS{v}_{\mathrm{rel}} -% \end{equation*} +% \SetSymbFont{\relax} +% \SetSymbStrut{\mathstrut} +% \newcommand{\dotr}[1]{% +% \accentset{\phantom{r}{\displaystyle.}r}{#1}} +% \begin{equation*} +% \text{apparent velocity} +% = \frac{\partial_r}{\mathrm{d}t} \aS{r} +% = \aS[\dotr]{r} +% = \aSb{E}_s \tdot \bS[\dotr]{r}^s +% \equiv \aS{v}_{\mathrm{app}} +% = \aS{v}_{\mathrm{rel}} +% \end{equation*} % \end{verbatim} % \end{minipage} -% which gives\SetSymbFont{\relax}\SetSymbStrut{\mathstrut}% -% \begin{equation*} -% \text{apparent velocity} = -% \frac{\partial_r}{\mathrm{d}t} \aS{r} = -% \aS[\dotr]{r} = -% \aSb{E}_s \tdot \bS[\dotr]{r}^s \equiv -% \aS{v}_{\mathrm{app}} = -% \aS{v}_{\mathrm{rel}} -% \end{equation*} -% \SetSymbStrut{\relax}\SetSymbFont{\bm} \\ +% \medskip % +% which gives\SetSymbFont{\relax}\SetSymbStrut{\mathstrut}% +% \begin{equation*} +% \text{apparent velocity} = +% \frac{\partial_r}{\mathrm{d}t} \aS{r} = +% \aS[\dotr]{r} = +% \aSb{E}_s \tdot \bS[\dotr]{r}^s \equiv +% \aS{v}_{\mathrm{app}} = +% \aS{v}_{\mathrm{rel}} +% \end{equation*} +% \SetSymbStrut{\relax}\SetSymbFont{\bm} % \end{description} % ^^A\clearpage % -% -% -% \section{Additional commands} -% -% The commands in this section are no longer part of the \MT\ -% package, but the definitions are supplied here if the user -% needs them. -% -% \subsection{Saving equations} -% \changes{1.1}{2004 Jan 15}{Doc: Code for \cs{DeclareSBox}, \cs{SB}, -% \cs{norm}, \cs{trnsp}, \cs{tdot} -% added to documentation.} -% \begin{Decl} -% \SpecialUsageIndex{\DeclareSBox} -% \cmd{\DeclareSBox}\marg{$\backslash$cmd}\marg{contents} -% \end{Decl} -% \begin{sample} -% |\newcommand{\DeclareSBox}[2]{% |\\ -% | \@ifdefinable{#1}{% |\\ -% | \edef\tempa{\expandafter\@gobble\string#1}% |\\ -% | \edef\tempa{\csname MTbox@\tempa\endcsname}% |\\ -% | \expandafter\newbox\tempa% |\\ -% | \global\sbox{\tempa}{#2}% |\\ -% | \protected@xdef#1{\noexpand\usebox{\tempa}}% |\\ -% | }} | -% \end{sample} -% -% \noindent The \cmd{\DeclareSBox} command can be used -% to save the \meta{contents} in a savebox -% |\MTbox@|\textit{cmd}. It then defines a command |\|\textit{cmd} that -% expands to |\usebox{\MTbox@|\textit{cmd}|}|. -% -% It is \myemph{very important} to remember that it is the fully -% expanded version of the \meta{contents} that is saved and not the macros. -% If |\|\textit{cmd} is used in a different environment the -% contents will retain the settings they were declared with. The -% saved boxes (and commands) are defined globally so that the contents -% of the box are not destroyed when a group is exited. -% -% \begin{sample} -% \hspace{17pc}\=\kill -% |{\large\DeclareSBox{\Le}{\bS{e}^s}}| \> {\large\DeclareSBox{\Le}{\bS{e}^s}}\\ -% |{\small\DeclareSBox{\se}{\bS{e}^s}}| \> {\small\DeclareSBox{\se}{\bS{e}^s}}\\ -% |Test \Le\ and \se\ here.| \> {\normalsize Test \Le\ and \se\ here.} -% \end{sample} -% -% This command is also useful for saving other objects such as -% the graphics of logos that are used repetitively. -% -% -% \subsection{Helper commands} -% -% When matrices and tensors are typed, there are some constructs that -% occur frequently. -% -% \begin{Decl} -% \SpecialUsageIndex{\SB} -% \cmd{\SB}\marg{argument} -% \end{Decl} -% \begin{sample} -% |\newcommand*{\SB}[1]{\ensuremath{\left[\, #1\right]}}| -% \end{sample} -% -% \noindent This command puts square brackets, \texttt{[...]}, -% around its argument, and can be used in text mode. The square -% brackets are preferred for the first level delimiter to indicate -% that we are dealing with matrices. -% -% \begin{sample} -% |$\SB{\bSb{E}^s_r}^{-1}$| \> $\SB{\bSb{E}^s_r}^{-1}$ \\[.5ex] -% |$\SB{\bS{x}+\bS{y}\,}$| \> $\SB{\bS{x}+\bS{y}\,}$ -% \end{sample} -% -% \begin{Decl} -% \SpecialUsageIndex{\norm} -% \cmd{\norm}\marg{argument} -% \end{Decl} -% \begin{sample} -% |\newcommand*{\norm}[1]{\ensuremath{\lVert{#1}\rVert}}| -% \end{sample} -% -% \noindent This is the standard form for a matrix or vector norm. -% \begin{sample} -% |$\norm{\aS{x}}=x$| \> $\norm{\aS{x}}=x$ -% \end{sample} -% -% \begin{Decl} -% \SpecialUsageIndex{\tdot} -% \cmd{\tdot} -% \end{Decl} -% \begin{sample} -% |\newcommand*{\tdot}{\ensuremath{\cdot}}| -% \end{sample} -% -% \noindent This command sets a half-high dot to indicate matrix -% multiplication. It can be used in text mode. -% -% \begin{sample} -% |$\bS{x}^s = | \\ -% | \bSb{E}_r^s\tdot\bS{x}^r$| \> -% $\bS{x}^s =\bSb{E}_r^s\tdot\bS{x}^r$ -% \end{sample} -% -% \begin{Decl} -% \SpecialUsageIndex{\trnsp} -% \cmd{\trnsp} -% \end{Decl} -% \begin{sample} -% |\newcommand*{\trnsp}{\ensuremath{\mathsf{T}}}| -% \end{sample} -% -% \noindent This command types the matrix transpose symbol ,\trnsp. -% -% \begin{sample} -% |$\SB{\bSb{E}^s_r}^\trnsp$| \> $\SB{\bSb{E}^s_r}^\trnsp$ -% \end{sample} -% \clearpage -% -% -% -% % \section{Typesetting the \Hass{} notation in \LaTeX} % \subsection{Why?} % -% The \Hass{} notation contains symbols such as, \aS{e}_i, -% \bS[\dot]{x}^{r}_{\alpha}, \bSa[\dot]{E}^s, etc. These symbols +% The \Hass{} notation contains symbols such as, $\aS{e}_i$, +% $\bS[\dot]{x}^{r}_{\alpha}$, $\bSa[\dot]{E}^s$, etc. These symbols % are quite common and variants thereof are found on many % blackboards of engineering schools. Based on the reputation of % \TeX{} it would seem trivial to typeset them, but to the contrary % ... % \SetSymbFont{\relax} % \begin{sample} -% |\bS[\dot]{f}^a_b| \> \bS[\dot]{f}^a_b ~~~(correct typesetting)\\[.75ex] -% |$\dot{\overline{f}}^a_b$| \> \usebox{\AccentBox}\\[.75ex] -% |$\dot{\overline{f}}{}^a_b$| \> $\dot{\overline{f}}{}^a_b$\\[.75ex] -% |$\dot{\overline{f}^a_b}$| \> $\dot{\overline{f}^a_b}$ +% |\bS[\dot]{f}^a_b| \> $\bS[\dot]{f}^a_b$ ~~~(correct typesetting)\\[.75ex] +% |$\dot{\overline{f}}^a_b$| \> \AccentBox\\[.75ex] +% |$\dot{\overline{f}}{}^a_b$| \> $\dot{\overline{f}}{}^a_b$\\[.75ex] +% |$\dot{\overline{f}^a_b}$| \> $\dot{\overline{f}^a_b}$ % \end{sample} % \SetSymbFont{\bm} % @@ -814,178 +667,123 @@ % % \begin{itemize} % -% \item -% For an \cmd{\overline}, $\overline{f}^a_b$, the superscript moves up -% to the height of the overline, which is fine for vector notation, -% but the subscript kerning is lost, because the symbol is set -% inside a box with italic correction added (App. G of the -% \TeX{}book). If the subscript is added inside the \cmd{\overline} -% construct, $\overline{f_b}^a$, the overline is stretched, which is -% acceptable only when the subscript is part of the symbol itself. -% The subscript kerning can be corrected by attaching the subscript -% to the symbol and the superscript to the overline and then overtyping -% (\cmd{\rlap} or \cmd{\llap}) them while using a phantom symbol (without -% subscript) for the overline, -% \begin{sample} -% |\leavevmode\rlap{$\overline{\phantom{f}}^a$}%|\\ -% | {$f^{}_b$}| -% \end{sample} -% which gives \leavevmode\rlap{$\overline{\phantom{f}}^a$}{$f^{}_b$}. -% -% The \cmd{\leavevmode} command is nessesary to prevent the symbol -% being spread over two lines when it is the first token in a new -% paragraph (\TeX{} in vertical mode). -% -% Care must be taken with the sequence in which the two parts -% overlap when the one is wider than the other, -% \leavevmode\rlap{$\overline{\phantom{f}}^{abcde}$}{$f^{}_a$}, -% because the superscript will then run into the following text. -% -% \item -% If a math accent is added to the overline, \usebox{\AccentBox}, -% the superscript goes to the level of the accent (except if the -% \pkg{accents}\ package is loaded). This can be remedied by -% controlling the height of the accented overline construction with -% a \cmd{\vphantom} commands as a strut, -% ^^A -% \begin{sample} -%|\leavevmode\rlap%|\\ -%| {$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}%|\\ -%| {$f^{}_b$}| -% \end{sample} -% which gives -% \rlap^^A -% {$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}^^A -% {$f^{}_b$}. -% -% \item -% For an |\overrightarrow| in vector notation, -% ($\overrightarrow{i}_a$, ~$\overrightarrow{iiii}_a\,$), the -% construction of the stretchable arrow results in an arrow wider -% than most symbols, with the symbol centred below it. -% The subscript ended up far removed from the symbol. -% For multiple symbols, the arrow width is equal to the box containing -% the letters, resulting in better-looking subscripts -% (but still without the subscript kerning). -% The previous procedure can be used to correct the -% subscript kerning, except that additional white space must be -% inserted before the symbol to centre it beneath the arrow. -% -% \begin{sample} -% |\newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$}|\\ -% |\newlength{\SymWdth}\settowidth{\SymWdth}{$i$}|\\ -% |\addtolength{\Wspace}{-\SymWdth} |\\ -% |\leavevmode\rlap% |\\ -% | {$\dot{\overrightarrow{\phantom{i}}}$}% |\\ -% | {\hspace*{.5\Wspace}$i^{}_b$} |\\ -% \end{sample} -% \newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$} -% \newlength{\SymWdth}\settowidth{\SymWdth}{$i$} -% \addtolength{\Wspace}{-\SymWdth} -% which gives \rlap{$\dot{\overrightarrow{\phantom{i}}}$}{\hspace*{.5\Wspace}$i^{}_b$}. -% -% The commands can be optimized by using saveboxes, \myemph{but} -% the symbols will not scale correctly when used as sub- or -% superscripts or in the \cmd{\tfrac} macro. A solution is to nest -% the commands inside a \cmd{\mathpalette} environment, but be warned, -% this is very expensive! -% The commands \cmd{\phantom}, \cmd{\smash}, \cmd{\overrightarrow} -% (in \pkg{amsmath}) are already inside \cmd{\mathpalette} macros, and -% \TeX{} calls the arguments of a \cmd{\mathpalette} macro four times -% before deciding on the dimensions. -% -% \item -% The shape of the arrow tip of the |\overrightarrow| command was -% probably not designed for this type of application and is much too -% broad in the final CM font version. This broad arrow shape is -% incidentally one of last changes by Prof.~Knuth to the CM font symbols. -% The PostScript version of the CM fonts typesets the arrow much -% better, but it is highly likely that it is still the old outdated -% version of the symbol. -% -% \item -% The subscript heights differ for the cases with and without -% superscripts, $x_b,\; x_b^a$. This is not very satisfactory for a -% consistent matrix-tensor notation, but it can be remedied by -% inserting a dummy superscript, |$x^{}_b$|, which then gives -% $x^{}_b$, $x_b^a$. +% \item For an \cmd{\overline}, $\overline{f}^a_b$, the superscript moves up to +% the height of the overline, which is fine for vector notation, but the +% subscript kerning is lost, because the symbol is set inside a box with +% italic correction added (App. G of the \TeX{}book). If the subscript is +% added inside the \cmd{\overline} construct, $\overline{f_b}^a$, the +% overline is stretched, which is acceptable only when the subscript is +% part of the symbol itself. The subscript kerning can be corrected by +% attaching the subscript to the symbol and the superscript to the overline +% and then overtyping (\cmd{\rlap} or \cmd{\llap}) them while using a +% phantom symbol (without subscript) for the overline, +% \begin{sample} +% |\leavevmode\rlap{$\overline{\phantom{f}}^a$}%|\\ +% | {$f^{}_b$}| +% \end{sample} +% which gives \leavevmode\rlap{$\overline{\phantom{f}}^a$}{$f^{}_b$}. +% +% The \cmd{\leavevmode} command is nessesary to prevent the symbol being +% spread over two lines when it is the first token in a new paragraph +% (\TeX{} in vertical mode). +% +% Care must be taken with the sequence in which the two parts overlap when +% the one is wider than the other, +% \leavevmode\rlap{$\overline{\phantom{f}}^{abcde}$}{$f^{}_a$}, +% because the superscript will then run into the following text. +% +% \item If a math accent is added to the overline, \AccentBox, the superscript +% goes to the level of the accent (except if the \pkg{accents}\ package is +% loaded). This can be remedied by controlling the height of the accented +% overline construction with a \cmd{\vphantom} commands as a strut, +% \begin{sample} +% |\leavevmode\rlap%|\\ +% | {$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}%|\\ +% | {$f^{}_b$}| +% \end{sample} +% which gives +% \rlap{$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}^^A +% {$f^{}_b$}. +% +% \item For an |\overrightarrow| in vector notation, ($\overrightarrow{i}_a$, +% ~$\overrightarrow{iiii}_a\,$), the construction of the stretchable arrow +% results in an arrow wider than most symbols, with the symbol centred +% below it. The subscript ended up far removed from the symbol. For +% multiple symbols, the arrow width is equal to the box containing the +% letters, resulting in better-looking subscripts (but still without the +% subscript kerning). The previous procedure can be used to correct the +% subscript kerning, except that additional white space must be inserted +% before the symbol to centre it beneath the arrow. +% \begin{sample} +% |\newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$}|\\ +% |\newlength{\SymWdth}\settowidth{\SymWdth}{$i$}|\\ +% |\addtolength{\Wspace}{-\SymWdth} |\\ +% |\leavevmode\rlap{$\dot{\overrightarrow{\phantom{i}}}$}% |\\ +% | {\hspace*{.5\Wspace}$i^{}_b$} | +% \end{sample} +% \newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$} +% \newlength{\SymWdth}\settowidth{\SymWdth}{$i$} +% \addtolength{\Wspace}{-\SymWdth} +% which gives \rlap{$\dot{\overrightarrow{\phantom{i}}}$}{\hspace*{.5\Wspace}$i^{}_b$}. +% +% The commands can be optimized by using saveboxes, \myemph{but} the +% symbols will not scale correctly when used as sub- or superscripts or in +% the \cmd{\tfrac} macro. A solution is to nest the commands inside a +% \cmd{\mathpalette} environment, but be warned, this is very expensive! +% The commands \cmd{\phantom}, \cmd{\smash}, \cmd{\overrightarrow} (in +% \pkg{amsmath}) are already inside \cmd{\mathpalette} macros, and \TeX{} +% calls the arguments of a \cmd{\mathpalette} macro four times before +% deciding on the dimensions. +% +% \item The shape of the arrow tip of the |\overrightarrow| command was +% probably not designed for this type of application and is much too broad +% in the final CM font version. This broad arrow shape is incidentally one +% of last changes by Prof.~Knuth to the CM font symbols. The PostScript +% version of the CM fonts typesets the arrow much better, but it is highly +% likely that it is still the old outdated version of the symbol. +% +% \item The subscript heights differ for the cases with and without +% superscripts, $x_b,\; x_b^a$. This is not very satisfactory for a +% consistent matrix-tensor notation, but it can be remedied by inserting a +% dummy superscript, |$x^{}_b$|, which then gives $x^{}_b$, $x_b^a$. % % \end{itemize} -% % The \MT\ package was developed to overcome (some of) the above-mentioned -% problems and to typeset the \Hass{} matrix tensor symbols in a -% consistent manner. +% problems and to typeset the \Hass{} matrix tensor symbols in a consistent +% manner. % % % \subsection{To do's} % % \begin{itemize} -% \item -% The vertical spacing between the symbols and the lines and arrows -% differs, \aSb{E}, \bSa{E}. This problem cannot be fixed easily -% and would need some additional struts or even a rewriting of the -% arrows and lines commands. -% -% \item -% For the purists: The ends of the |\overrightarrow| are rounded -% (ligature of symbols), while the ends of the |\overline| are squared -% (\TeX{} line drawing). -% -% \item -% \MT\ does not yet work with the \pkg{xspace} package. +% \item The vertical spacing between the symbols and the lines and +% arrows differs, $\aSb{E}$, $\bSa{E}$. This problem cannot be +% fixed easily and would need some additional struts or even a +% rewriting of the arrows and lines commands. +% +% \item For the purists: The ends of the |\overrightarrow| are rounded +% (ligature of symbols), while the ends of the |\overline| are +% squared (\TeX{} line drawing). % \end{itemize} -% -% \section{Bugs, etc.} -% -% I am sure there is much room for improvement, because -% I am a \TeX{}natic and not a \TeX{}pert and to quote -% Knuth from the \TeX{}book: -% \begin{quote} -% {\slshape\small Always remember, however, that there's usually -% a simpler and better way to do something than the first way that -% pops into your head. You may not have to resort to any subterfuge -% at all, since \TeX{} is able to do lots of things in a -% straightforward way. Try for simple solutions first.} -% \end{quote} -% -% \noindent Please send all bug reports, suggestions, advice or -% code improvements to: -% -% \begin{center} -% \colorbox[rgb]{1.00,1.00,0.50}{\begin{minipage}{.6\textwidth} -% \centering -% Danie Els\\ -% -% \smallskip -% Department of Mechanical Engineering\\ -% University of Stellenbosch\\ -% Private Bag X1, Matieland 7602, South Africa.\\ -% e-mail: \texttt{dnjels@sun.ac.za} -% \end{minipage}} -% \end{center} -% % \bigskip % -% % \begin{thebibliography}{7} +% \bibitem{Hass93a} +% \Hass, W.~C., +% ``Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates,'' +% \textsl{Comput. Math. Appl.}, +% \textbf{26}(3), 1993, pp. 55--93. % -% \bibitem{Hass93a} -% \Hass, W.~C., -% ``Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates,'' -% \textsl{Comput. Math. Appl.}, -% \textbf{26}(3), 1993, pp. 55--93. +% \bibitem{Hass93b} +% \Hass, W.~C., +% ``Matrix Tensor Notation Part II. Skew and Curved Coordinates,'' +% \textsl{Comput. Math. Appl.}, +% \textbf{29}(11), 1993, pp. 1--103. +% \end{thebibliography} % -% \bibitem{Hass93b} -% \Hass, W.~C., -% ``Matrix Tensor Notation Part II. Skew and Curved Coordinates,'' -% \textsl{Comput. Math. Appl.}, -% \textbf{29}(11), 1993, pp. 1--103. +% \StopEventually{} ^^A end StopEventually % -% \end{thebibliography} -% -% \StopEventually{} ^^A end StopEventually -% -% \clearpage +% \clearpage % % \section{The Code: \pkg{mattens.sty}} % \setlength{\parskip}{\smallskipamount} @@ -1001,7 +799,9 @@ % % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{mattens}[2004/01/28 v1.2 Matrix/Tensors (DNJ Els)] +\ProvidesPackage{mattens}[2009/09/01 + v1.3 + Matrix/Tensors (DNJ Els)] % \end{macrocode} % % @@ -1212,7 +1012,7 @@ % \end{macro} % % \begin{macro}{\aS} -% Type the tensor: \aS{x} +% Type the tensor: $\aS{x}$ % \begin{macrocode} \DeclareRobustCommand*{\aS}{% \let\MT@cmd=\MT@OverAandB% @@ -1224,7 +1024,7 @@ % \end{macro} % % \begin{macro}{\bS} -% Type the tensor: \bS{x} +% Type the tensor: $\bS{x}$ % \begin{macrocode} \DeclareRobustCommand*{\bS}{% \let\MT@cmd=\MT@OverAandB% @@ -1237,7 +1037,7 @@ % % % \begin{macro}{\Sa} -% Type the tensor: \Sa{x} +% Type the tensor: $\Sa{x}$ % \begin{macrocode} \DeclareRobustCommand*{\Sa}{% \let\MT@cmd=\MT@UnderAandB% @@ -1249,7 +1049,7 @@ % \end{macro} % % \begin{macro}{\Sb} -% Type the tensor: \Sb{x} +% Type the tensor: $\Sb{x}$ % \begin{macrocode} \DeclareRobustCommand*{\Sb}{% \let\MT@cmd=\MT@UnderAandB% @@ -1261,7 +1061,7 @@ % \end{macro} % % \begin{macro}{\bSb} -% Type the tensor: \bSb{E} +% Type the tensor: $\bSb{E}$ % \begin{macrocode} \DeclareRobustCommand*{\bSb}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1273,7 +1073,7 @@ % \end{macro} % % \begin{macro}{\aSb} -% Type the tensor: \aSb{E} +% Type the tensor: $\aSb{E}$ % \begin{macrocode} \DeclareRobustCommand*{\aSb}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1285,7 +1085,7 @@ % \end{macro} % % \begin{macro}{\bSa} -% Type the tensor: \bSa{E} +% Type the tensor: $\bSa{E}$ % \begin{macrocode} \DeclareRobustCommand*{\bSa}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1297,7 +1097,7 @@ % \end{macro} % % \begin{macro}{\aSa} -% Type the tensor: \aSa{E} +% Type the tensor: $\aSa{E}$ % \begin{macrocode} \DeclareRobustCommand*{\aSa}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1309,7 +1109,7 @@ % \end{macro} % % \begin{macro}{\bCSb} -% Type the tensor: \bCSb{\omega} +% Type the tensor: $\bCSb{\omega}$ % \begin{macrocode} \DeclareRobustCommand*{\bCSb}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1321,7 +1121,7 @@ % \end{macro} % % \begin{macro}{\aCSa} -% Type the tensor: \aCSa{\omega} +% Type the tensor: $\aCSa{\omega}$ % \begin{macrocode} \DeclareRobustCommand*{\aCSa}{% \let\MT@cmd=\MT@DoubleAandB% @@ -1478,7 +1278,7 @@ % \end{macro} % \end{macro} % -% +% \changes{1.3}{2009 Sep 1}{Remove \cmd{\ensuremath} to force math mode.} % \begin{macrocode} \newcommand*\MT@SetScripts[3]{% \let\MT@SetSup\relax% @@ -1491,7 +1291,7 @@ \def\MT@SetSub{_{\mskip\MT@SubSkip\relax#3}}% \def\MT@SetSubS{^{}_{\mskip\MT@SubSkip\relax#3}}% \fi - \ensuremath{\MT@cmd{#1}}} + \MT@cmd{#1}} % \end{macrocode} % % @@ -1540,7 +1340,7 @@ % \end{macrocode} % % \begin{macro}{\MT@OverAandB} -% This command generates the tensor symbols \aS{e}{} and \bS{e}. +% This command generates the tensor symbols $\aS{e}$ and $\bS{e}$. % It utilizes the \cmd{\mathpalette} macro for the sizing of the % final tensor. \LaTeX{} commands \cmd{\smash} and \cmd{\phantom} % with embedded \cmd{\mathpalette} calls are avoided to prevent @@ -1629,7 +1429,7 @@ % \begin{macro}{\MT@UnderAandB} % \begin{macro}{\MT@@UnderAandB} % \changes{1.2}{2004 Jan 27}{Make provisions for wide accents (\cmd{\dddot}).} -% This command generates the tensor symbols \Sa{e}{} and \Sb{e}. +% This command generates the tensor symbols $\Sa{e}$ and $\Sb{e}$. % It is identical to the previous command except the sub- and % superscripts are swapped and the phantom box is set to the width % of the accent. diff --git a/Master/texmf-dist/source/latex/mattens/mattens.ins b/Master/texmf-dist/source/latex/mattens/mattens.ins index 7f7811be80d..cc0a6520c6a 100644 --- a/Master/texmf-dist/source/latex/mattens/mattens.ins +++ b/Master/texmf-dist/source/latex/mattens/mattens.ins @@ -1,37 +1,71 @@ +% mattens.ins
+% Copyright (C) 2001--2009 Danie Els
+%
+% -------------------------------------------------------------------
+% The mattens package
+% for vector/tensor typesetting
+% -------------------------------------------------------------------
+% This work may be distributed and/or modified under the conditions
+% of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status 'maintained'.
+%
+% This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za)
+%
+% This package consists of the files: mattens.dtx
+% mattens.ins
+% and the derived files: mattens.sty
+% -------------------------------------------------------------------
+
+\def\batchfile{mattens.ins}
+\def\filedate{2009/09/01}
\input docstrip.tex
-\preamble
+\keepsilent
- The mattens package
- Copyright (C) 2001--2004 by Danie Els <dnjels@sun.ac.za>
+\declarepreamble\DNJEpreamble
-This file may be distributed and/or modified under the conditions of
-the LaTeX Project Public License, either version 1.2 of this license
-or (at your option) any later version. The latest version of this
-license is in:
+Copyright (C) 2001--2009 Danie Els
- http://www.latex-project.org/lppl.txt
+-------------------------------------------------------------------
+ The mattens package
+ for vector/tensor typesetting
+-------------------------------------------------------------------
+This work may be distributed and/or modified under the conditions
+of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX
+version 2005/12/01 or later.
-and version 1.2 or later is part of all distributions of LaTeX
-version 1999/12/01 or later.
+This work has the LPPL maintenance status 'maintained'.
-\endpreamble
+This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za)
+-------------------------------------------------------------------
-\keepsilent
-\askforoverwritefalse
+\endpreamble
-\generate{\file{mattens.sty}{\from{mattens.dtx}{package}}}
+\generate{%
+ \askforoverwritefalse
+ \usepreamble\DNJEpreamble
+ \file{mattens.sty}{\from{mattens.dtx}{package}}}
\obeyspaces
-\Msg{*********************************************************}
-\Msg{* *}
-\Msg{* To finish the installation you have to move the *}
-\Msg{* following file into a directory searched by TeX: *}
-\Msg{* *}
-\Msg{* mattens.sty *}
-\Msg{* *}
-\Msg{* To produce the documentation run the file mattens.dtx *}
-\Msg{* through LaTeX. *}
-\Msg{* *}
-\Msg{* Happy TeXing! *}
-\Msg{*********************************************************}
+\Msg{**********************************************************}
+\Msg{* *}
+\Msg{* To finish the installation you have to move the *}
+\Msg{* following files into a directory searched by TeX: *}
+\Msg{* *}
+\Msg{* mattens.sty *}
+\Msg{* *}
+\Msg{* To produce the documentation run the file mattens.dtx *}
+\Msg{* through LaTeX. *}
+\Msg{* *}
+\Msg{* Happy TeXing! *}
+\Msg{**********************************************************}
\endbatchfile
diff --git a/Master/texmf-dist/tex/latex/mattens/mattens.sty b/Master/texmf-dist/tex/latex/mattens/mattens.sty index 1086b580627..f4cfced8661 100644 --- a/Master/texmf-dist/tex/latex/mattens/mattens.sty +++ b/Master/texmf-dist/tex/latex/mattens/mattens.sty @@ -6,18 +6,24 @@ %% %% mattens.dtx (with options: `package') %% -%% The mattens package -%% Copyright (C) 2001--2004 by Danie Els <dnjels@sun.ac.za> +%% Copyright (C) 2001--2009 Danie Els %% -%% This file may be distributed and/or modified under the conditions of -%% the LaTeX Project Public License, either version 1.2 of this license -%% or (at your option) any later version. The latest version of this -%% license is in: +%% ------------------------------------------------------------------- +%% The mattens package +%% for vector/tensor typesetting +%% ------------------------------------------------------------------- +%% This work may be distributed and/or modified under the conditions +%% of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. %% -%% http://www.latex-project.org/lppl.txt +%% This work has the LPPL maintenance status 'maintained'. %% -%% and version 1.2 or later is part of all distributions of LaTeX -%% version 1999/12/01 or later. +%% This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za) +%% ------------------------------------------------------------------- %% %% \CharacterTable %% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z @@ -36,7 +42,9 @@ %% Right brace \} Tilde \~} %% \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{mattens}[2004/01/28 v1.2 Matrix/Tensors (DNJ Els)] +\ProvidesPackage{mattens}[2009/09/01 + v1.3 + Matrix/Tensors (DNJ Els)] \newcommand*{\MT@SymbStrt}{} \newcommand*{\SetSymbStrut}[1]{\renewcommand*{\MT@SymbStrt}{#1}} \SetSymbStrut{\relax} @@ -194,7 +202,7 @@ \def\MT@SetSub{_{\mskip\MT@SubSkip\relax#3}}% \def\MT@SetSubS{^{}_{\mskip\MT@SubSkip\relax#3}}% \fi - \ensuremath{\MT@cmd{#1}}} + \MT@cmd{#1}} \newcommand*{\MT@Symb}[1]{\MT@SymbStrt\MT@bold#1} \newcommand*{\MT@SymbC}[1]{% \MT@SymbStrt\widetilde{% |