1 files changed, 128 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-magneticfield/pst-magneticfield-docEN.tex b/Master/texmf-dist/doc/generic/pst-magneticfield/pst-magneticfield-docEN.tex
index 100a0253d56..7332ee4e06d 100644
--- a/Master/texmf-dist/doc/generic/pst-magneticfield/pst-magneticfield-docEN.tex
+++ b/Master/texmf-dist/doc/generic/pst-magneticfield/pst-magneticfield-docEN.tex
@@ -1,17 +1,19 @@
-%% $Id: pst-magneticfield-docEN.tex 343 2010-06-10 15:08:37Z herbert $
-\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
+%% $Id: pst-magneticfield-docEN.tex 912 2019-01-17 10:46:15Z herbert $
+\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings,
     headexclude,footexclude,oneside]{pst-doc}
-\usepackage[latin1]{inputenc}
 \usepackage{pst-magneticfield}
 \let\pstMFfv\fileversion
+\usepackage{graphicx}
 \lstset{pos=t,language=PSTricks,
     morekeywords={psmagneticfield,psmagneticfieldThreeD},basicstyle=\footnotesize\ttfamily}
 
-%\newenvironment{postscript}{}{} % uncomment, when running with latex
+\newenvironment{postscript}{}{} % uncomment, when running with latex
 
 \newcommand\Cadre[1]{\psframebox[fillstyle=solid,fillcolor=black,linestyle=none,framesep=0]{#1}}
 \def\bgImage{}
-%
+
+\addbibresource{pst-magneticfield-doc.bib}
+
 \begin{document}
 
 \title{\texttt{pst-magneticfield}}
@@ -506,6 +508,126 @@ with setting the keyword \Lkeyword{setgray}.
 
 
 \clearpage
+\section{Stream density}
+
+
+\begin{center}
+\begin{postscript}
+\begin{pspicture}(-6,-4)(6,4)
+\psmagneticfield[N=3,R=2,L=2,StreamDensityPlot](-6,-4)(6,4)
+\end{pspicture}
+\end{postscript}
+\end{center}
+
+\begin{lstlisting}
+\begin{pspicture}(-6,-4)(6,4)
+\psmagneticfield[N=3,R=2,L=2,StreamDensityPlot](-6,-4)(6,4)
+\end{pspicture}
+\end{lstlisting}
+
+\begin{center}
+\begin{postscript}
+\psset{unit=0.75}
+\begin{pspicture}(-6,-5)(6,5)
+\psmagneticfield[N=2,R=2,L=1,StreamDensityPlot,setgray](-6,-5)(6,5)
+\end{pspicture}
+\end{postscript}
+\end{center}
+
+\begin{lstlisting}
+\psset{unit=0.75}
+\begin{pspicture}(-6,-5)(6,5)
+\psmagneticfield[N=2,R=2,L=1,StreamDensityPlot,setgray](-6,-5)(6,5)
+\end{pspicture}
+\end{lstlisting}
+
+
+\begin{center}
+\begin{postscript}
+\psset{unit=0.75,AntiHelmholtz,
+  R=2,pointsB=500,pointsS=2000,PasB=0.02,PasS=0.00275,nS=10,
+  nL=2,drawSelf=true,styleSpire=styleSpire,styleCourant=sensCourant}
+\begin{pspicture*}(-7,-6)(7,6)
+\psmagneticfield[linecolor={[HTML]{660066}},StreamDensityPlot](-7,-6)(7,6)
+\end{pspicture*}
+\end{postscript}
+\end{center}
+
+
+\begin{lstlisting}
+\psset{unit=0.75,AntiHelmholtz,
+  R=2,pointsB=500,pointsS=2000,PasB=0.02,PasS=0.00275,nS=10,
+  nL=2,drawSelf=true,styleSpire=styleSpire,styleCourant=sensCourant}
+\begin{pspicture*}(-7,-6)(7,6)
+\psmagneticfield[linecolor={[HTML]{660066}},StreamDensityPlot](-7,-6)(7,6)
+\end{pspicture*}
+\end{lstlisting}
+
+
+
+\section{Bar magnet}
+The magnetic field of a bat magnet can be simulated. There is one macro for the bar magnet, which will be
+put over one of the above created mnagnetic fields.
+
+\begin{BDef}
+\Lcs{psBarMagnet}\OptArgs\OptArg{\Largr{$x,y$}}
+\end{BDef}
+
+\begin{LTXexample}
+\begin{pspicture}(-1,-2)(12,2)
+\psBarMagnet% (0,0) is assumed
+\psBarMagnet(2,0.5)
+\psBarMagnet*(4,0)
+\psBarMagnet[rot=90](7,0)
+\psBarMagnet[rot=45](10,0)
+\end{pspicture}
+\end{LTXexample}
+
+
+Bar magnet and field can be put of the other by single commands:
+
+
+\begin{LTXexample}
+\begin{pspicture*}[showgrid=false](-5,-8)(5,8)
+\psset{linecolor=blue}
+\psscalebox{0.8 1.2}{\psmagneticfield[R=1,L=5,N=5,pointsS=200,nL=9,nS=0,PasB=0.1,numSpires=0](-8,-10)(8,10)}
+\rput(0,0){\psscalebox{2.2 3.0}{\psBarMagnet}}
+\end{pspicture*}
+\end{LTXexample}
+
+
+or by using the optional argument \Lkeyword{showField}:
+
+\begin{LTXexample}
+\begin{pspicture*}(-5,-8)(5,8)
+\psBarMagnet[showField](0,0)
+\end{pspicture*}
+\end{LTXexample}
+
+A rotation has to be done with the command \Lcs{rotatebox} from package \LPack{graphicx}:
+
+
+\begin{LTXexample}
+\begin{pspicture*}(-5,-8)(5,8)
+\rotatebox{180}{\psBarMagnet[showField](0,0)}
+\end{pspicture*}
+\end{LTXexample}
+
+
+Scaling is possible with the optional argument \Lkeyword{magnetscale} and all options which
+are valid for
+
+
+\begin{LTXexample}
+\begin{pspicture*}(-5,-8)(5,8)
+\psBarMagnet[showField,nL=18,magnetScale=1 1.5](0,0)
+\end{pspicture*}
+\end{LTXexample}
+
+
+
+
+\clearpage
 \section{List of all optional arguments for \texttt{pst-magneticfield}}
 
 \xkvview{family=pst-magneticfield,columns={key,type,default}}
@@ -513,8 +635,7 @@ with setting the keyword \Lkeyword{setgray}.
 \nocite{*}
 \bgroup
 \raggedright
-\bibliographystyle{plain}
-\bibliography{pst-magneticfield-doc}
+\printbibliography
 \egroup