summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/diffcoeff/diffcoeff.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-12-28 03:00:29 +0000
committerNorbert Preining <norbert@preining.info>2019-12-28 03:00:29 +0000
commit1d29cc334a5a588ee0a0678be215be65df74d6aa (patch)
treee9a2aa82a482862f09a47184a1db0a57a16415cd /macros/latex/contrib/diffcoeff/diffcoeff.tex
parent9e5fd640685233da79d1b74327f9fe3edf173471 (diff)
CTAN sync 201912280300
Diffstat (limited to 'macros/latex/contrib/diffcoeff/diffcoeff.tex')
-rw-r--r--macros/latex/contrib/diffcoeff/diffcoeff.tex139
1 files changed, 93 insertions, 46 deletions
diff --git a/macros/latex/contrib/diffcoeff/diffcoeff.tex b/macros/latex/contrib/diffcoeff/diffcoeff.tex
index 258f3a71d9..9ade962edd 100644
--- a/macros/latex/contrib/diffcoeff/diffcoeff.tex
+++ b/macros/latex/contrib/diffcoeff/diffcoeff.tex
@@ -1,4 +1,4 @@
-%% LyX 2.3.2-2 created this file. For more info, see http://www.lyx.org/.
+%% LyX 2.3.3 created this file. For more info, see http://www.lyx.org/.
%% Do not edit unless you really know what you are doing.
\documentclass[english]{article}
\usepackage{lmodern}
@@ -6,6 +6,7 @@
\renewcommand{\ttdefault}{lmtt}
\usepackage[T1]{fontenc}
\usepackage[latin9]{inputenc}
+\synctex=-1
\usepackage{color}
\usepackage{babel}
\usepackage{wrapfig}
@@ -52,7 +53,7 @@
a \LaTeX{} package to ease\texttt{ }the~\\
writing of differential coefficients \\
in all their variety\\
- Version 3.1}
+ Version 3.2}
\author{Andrew Parsloe\\
{\small{}(ajparsloe@gmail.com)}}
\maketitle
@@ -144,6 +145,11 @@ should occur in these other contexts.\footnote{This rather obvious lack in versi
error in version 3).
\item Version 3 also provides some simple spacing commands that can be useful
for tweaking standard spacing.
+\item Version 3.2 fixes a bug in which an ordinary derivative as the differentiand
+of a partial derivative displayed as a partial derivative. It now displays,
+as it should, as an ordinary derivative.
+\item In version 3.2, the differential command \texttt{\textbackslash dl} now
+also allows negative spacing before it.
\end{enumerate}
\subsubsection*{Note on terminology}
@@ -161,11 +167,11 @@ of derivatives `disporting every which way'.
Multi-character variables of differentiation un-parenthesized:
\begin{equation}
-\diffp{\frac{\psi}{\Theta}}{\frac{1}{\Theta}},\quad\diffp{E/T}{1/T},\quad\diffp{\ln f}{\ln x_{0}},\quad\diffp\psi{a_{i},\frac{1}{\Theta}},\quad\diffp{\mathcal{L}}{\eta_{,i}^{(r)}}\label{eq:eg1}
+\diffp{\frac{\psi}{\Theta}}{\frac{1}{\Theta}},\quad\diffp{E/T}{1/T},\quad\diffp{\ln f}{\ln x_{0}},\quad\diffp\psi{a_{i},\frac{1}{\Theta}},\quad\diffp{\mathcal{L}}{\eta_{,i}^{(r)}}.\label{eq:eg1}
\end{equation}
Multi-character variables of differentiation parenthesized:
\begin{equation}
-\diffp H{\displaystyle \diffp S{q_{k}}[]},\quad\diffp\varepsilon{(1/\Theta)},\label{eq:eg2}
+\diffp H{\displaystyle \diffp S{q_{k}}[]},\quad\diffp\varepsilon{(1/\Theta)}.\label{eq:eg2}
\end{equation}
Higher-order derivatives where the parentheses do not or do include the
operator:
@@ -553,6 +559,24 @@ this. Thus, to express a relation in thermodynamics,
\noindent where the starring automatically takes care of the parentheses
and subscripts.
+\subsection{Iterated derivatives}
+
+Derivatives can be the differentiands of derivatives, as seen above when
+writing Lagrange's equations,
+\begin{example}
+\textbackslash diffp L\{q\_k\}-\textbackslash diff{*}\{\textbackslash diffp
+L\{\textbackslash dot\{q\}\_k\}{[}{]}\}t = 0 $\Longrightarrow\quad{\displaystyle \diffp L{q_{k}}-\diff*{\diffp L{\dot{q}_{k}}[]}t}=0.$
+\end{example}
+
+\noindent However, in versions of \texttt{diffcoeff} before version 3.2,
+an ordinary derivative within a partial derivative rendered as a partial
+derivative. That is now corrected, the ordinary derivative rendering correctly:
+\begin{example}
+\textbackslash diffp{*}\{\textbackslash diff\{x\textasciicircum\textbackslash mu\}\{\textbackslash lambda\}\}\{x\textasciicircum\textbackslash sigma\}
+$\Longrightarrow\quad{\displaystyle \diffp*{\diff{x^{\mu}}{\lambda}}{x^{\sigma}}}$
+\end{example}
+
+
\subsection{Mixed partial derivatives}
The new thing with partial derivatives, not present with ordinary derivatives,
@@ -714,8 +738,8 @@ to the $\partial$ symbol in the numerator.
In tensor calculus the differentiations are almost always in terms of super-
or subscripted coordinates. In many other contexts this is the case too
-- the reciprocal of the temperature in thermodynamics or generalized
-cooredinates in analytical mechanics. This is why a comma list is used
-in \texttt{diffcoeff} for specifying variables of differentiation for mixed
+coordinates in analytical mechanics. This is why a comma list is used in
+\texttt{diffcoeff} for specifying variables of differentiation for mixed
partial derivatives. Although it would be nice to write the minimal \texttt{\{xy\}}
rather than \texttt{\{x,y}\} when two variables $x$ and $y$ are involved,
the extra writing is trivial and the comma list allows a simpler handling
@@ -879,36 +903,6 @@ which as far as I know has no meaning.
\section{Changing defaults; variant forms\label{sec:Changing-defaults}}
-\begin{wraptable}[22]{o}{0.5\columnwidth}%
-\vspace{-4.5ex}
- \caption{{\small{}Defaults (ordinary derivatives})\label{tab:Ordinary-derivatives}}
-
-\abovetopsep=.5ex{}%
-\begin{tabular}{lr}
-\toprule
-{\small{}key} & {\small{}default}\tabularnewline
-\midrule
-{\small{}op-symbol } & \texttt{\small{}d}\tabularnewline
-{\small{}op-symbol-alt} & \texttt{\small{}= op-symbol}\tabularnewline
-{\small{}op-order-sep } & \texttt{\small{}1 mu}\tabularnewline
-{\small{}{*}-op-left } & \texttt{\small{}false}\tabularnewline
-{\small{}{*}-italic-nudge} & \texttt{\small{}3 mu}\tabularnewline
-{\small{}{*}/-op-wrap} & \texttt{\small{}true}\tabularnewline
-{\small{}long-var-wrap } & \texttt{\small{}d(v)}\tabularnewline
-{\small{}denom-term-sep} & \texttt{\small{}2 mu}\tabularnewline
-{\small{}/-denom-term-sep } & \texttt{\small{}1 mu}\tabularnewline
-term-sep-adjust & \texttt{-1 mu}\tabularnewline
-{\small{}left-delim} & \texttt{\small{}\textbackslash left .}\tabularnewline
-{\small{}right-delim} & \texttt{\small{}\textbackslash right |}\tabularnewline
-{\small{}elbowroom} & \texttt{\small{}0 mu}\tabularnewline
-{\small{}subscr-nudge } & \texttt{\small{}0 mu}\tabularnewline
-{\small{}/-left-delim} & \texttt{\small{}(}\tabularnewline
-{\small{}/-right-delim } & \texttt{\small{})}\tabularnewline
-{\small{}/-elbowroom} & \texttt{\small{}0 mu}\tabularnewline
-{\small{}/-subscr-nudge } & \texttt{\small{}0 mu}\tabularnewline
-\bottomrule
-\end{tabular}\end{wraptable}%
-
To write the range of different examples displayed in the Rogues' Gallery
(Section~\ref{sec:Rogues'-gallery}) I have had to make extensive use
of forms of derivative other than the default. \texttt{Diffcoeff} is built
@@ -937,6 +931,36 @@ Keys with an opening slash, /, apply only to the slash form of the derivative;
keys with an opening asterisk, {*}, apply only when the differentiand is
appended.
+\begin{wraptable}[22]{o}{0.5\columnwidth}%
+\noindent \begin{centering}
+\vspace{-4.5ex}
+ \caption{{\small{}Defaults (ordinary derivatives})\label{tab:Ordinary-derivatives}}
+\par\end{centering}
+\noindent \centering{}\abovetopsep=.5ex{}%
+\begin{tabular}{lr}
+\toprule
+{\small{}key} & {\small{}default}\tabularnewline
+\midrule
+{\small{}op-symbol} & \texttt{\small{}d}\tabularnewline
+{\small{}op-symbol-alt} & \texttt{\small{}= op-symbol}\tabularnewline
+{\small{}op-order-sep} & \texttt{\small{}1 mu}\tabularnewline
+{\small{}{*}-op-left} & \texttt{\small{}false}\tabularnewline
+{\small{}{*}-italic-nudge} & \texttt{\small{}3 mu}\tabularnewline
+{\small{}{*}/-op-wrap} & \texttt{\small{}true}\tabularnewline
+{\small{}long-var-wrap} & \texttt{\small{}d(v)}\tabularnewline
+{\small{}denom-term-sep} & \texttt{\small{}2 mu}\tabularnewline
+{\small{}/-denom-term-sep} & \texttt{\small{}1 mu}\tabularnewline
+term-sep-adjust & \texttt{-1 mu}\tabularnewline
+{\small{}left-delim} & \texttt{\small{}\textbackslash left .}\tabularnewline
+{\small{}right-delim} & \texttt{\small{}\textbackslash right |}\tabularnewline
+{\small{}elbowroom} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}subscr-nudge} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}/-left-delim} & \texttt{\small{}(}\tabularnewline
+{\small{}/-right-delim} & \texttt{\small{})}\tabularnewline
+{\small{}/-elbowroom} & \texttt{\small{}0 mu}\tabularnewline
+{\small{}/-subscr-nudge} & \texttt{\small{}0 mu}\tabularnewline
+\bottomrule
+\end{tabular}\end{wraptable}%
Note that these settings are, in general, font dependent. The values given
are (in the author's opinion) appropriate for the default \LaTeX{} math
fonts. There are also likely to be variations required for whether a derivative
@@ -954,6 +978,10 @@ default = \texttt{d}
denominator while \textbf{op-symbol} is used in the numerator; e.g. for
$\diff.nabla.{v^{i}}t$, \texttt{op-symbol = \textbackslash nabla} and
\texttt{op-symbol-alt = d}; otherwise (and usually) defaults to \textbf{op-symbol}
+\end{description}
+~\vspace{-5ex}
+
+\begin{description}
\item [{op-order-sep}] extra horizontal space added between the op-symbol and
the superscripted order of differentiation in higher order derivatives;
compare $d^{2}$ with $d^{\mkern1mu 2}$, $\partial^{2}$ with $\partial^{\mkern1mu 2}$
@@ -1251,7 +1279,7 @@ I have attached a name, \texttt{padrift},\texttt{ }to this setting,
it qualifies -- is it perhaps a typo? -- and `adrift in a sea of whitespace'.
This is to be compared with the default
\begin{example}
-\noindent \textbackslash diffpFx{[}y{]} $\Longrightarrow{\displaystyle \diffp Fx[y]}$
+\noindent \textbackslash diffp Fx{[}y{]} $\Longrightarrow{\displaystyle \diffp Fx[y]}$
\end{example}
\noindent where the subscript is tucked in close to the right parenthesis
@@ -1545,10 +1573,11 @@ present document, the default form is math-italic and so
\end{example}
\noindent It is also possible\footnote{\noindent From version 3.1 of \texttt{diffcoeff}; version 3.0 of the package
-produced a \LaTeX{} error.} to use the command before \texttt{\textbackslash vec\{x\}} or \texttt{\textbackslash mathbf\{x\}}:
+produced a \LaTeX{} error.} to use the command before, for instance, \texttt{\textbackslash vec\{x\}}
+or \texttt{\textbackslash mathbf\{x\}}:
\begin{example}
-\textbackslash dl \textbackslash vec\{x\} $\Longrightarrow\dl\vec{{x}},$
-~~~~\textbackslash dl \textbackslash mathbf\{x\} $\Longrightarrow\dl\mathbf{x}.$
+\textbackslash dl \textbackslash vec\{x\} $\Longrightarrow\dl\vec{x}$~~~~\textbackslash dl
+\textbackslash mathbf\{x\} $\Longrightarrow\dl0\mathbf{x}.$
\end{example}
@@ -1576,6 +1605,8 @@ offers a slightly shorter way of writing \texttt{\textbackslash partial}
is because of the convenience offered by the second option to the \texttt{\textbackslash dl}
command.
+\subsubsection{Spacing}
+
This second option inserts spacing before the `d'. If \texttt{\textbackslash dl}
is followed by a digit (0, 1, 2, ..., 9) it will insert a horizontal space
of that number of mu before the `d'; (\texttt{\textbackslash dl0x} has
@@ -1598,18 +1629,32 @@ the total differential expression, since the differentials are already
distinct from the preceding fraction forms $\diff.ptxt.Px$ etc., and \texttt{\textbackslash dl2x}
when writing $\int\sin x\dl2x$.
-As remarked above, the \texttt{\textbackslash dl.p.} alternative to \texttt{\textbackslash partial
-}is unlikely to be of use except for a document, like the present one,
-illustrating various points of usage. Thus, to illustrate spacing in the
-denominator of a mixed partial derivative, I have earlier used \texttt{\textbackslash dl.p.x\textbackslash dl.p.2y\textbackslash dl.p.2z},
+Note that only \emph{one} digit can be used. If two are used, as here,
+\begin{example}
+\textbackslash dl20x $\Longrightarrow\dl20x$
+\end{example}
+
+\noindent the effect is unlikely to be what is wanted.
+
+From version 3.2 of \texttt{diffcoeff} it is possible to also add \emph{negative}
+space before the differential, which might be useful in special contexts,
+perhaps to construct a symbol:
+\begin{example}
+/\textbackslash dl-9x $\Longrightarrow/\dl-9x.$
+\end{example}
+
+\noindent For negative space before the differential, add a minus sign
+before the (single) digit.
+
+The spacing digit option \emph{follows} the dot-delimited name option.
+For example, to illustrate spacing in the denominator of a mixed partial
+derivative, I have earlier used \texttt{\textbackslash dl.p.x\textbackslash dl.p.2y\textbackslash dl.p.2z},
and the variation to that spacing when a higher-order differentiation occurs:
\begin{example}
\textbackslash dl.p.x\textasciicircum 2\textbackslash dl.p.1y\textbackslash dl.p.2z
$\Longrightarrow\dl.p.x^{2}\dl.p.1y\dl.p.2z.$
\end{example}
-\noindent Note here that the spacing digit option \emph{follows} the dot-delimited
-name option.
\section{Rationale}
@@ -1765,6 +1810,8 @@ name option.
\item [{\texttt{\textbackslash dl}}] options:
\begin{enumerate}
\item .\emph{name}. (as for \texttt{\textbackslash diff})
+\item \emph{minus sign} (optional, use only if negative spacing before the `d'
+is wanted)
\item \emph{digit} (insert spacing of this number of mu before the `d')
\end{enumerate}
\item [{\texttt{\textbackslash negmu}}] insert a $-1$ mu space