diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-fractal')
-rwxr-xr-x | Master/texmf-dist/doc/generic/pst-fractal/Changes | 6 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-fractal/README | 46 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.bib | 129 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.pdf | bin | 0 -> 15304639 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.tex | 256 |
5 files changed, 437 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-fractal/Changes b/Master/texmf-dist/doc/generic/pst-fractal/Changes new file mode 100755 index 00000000000..33204879dd4 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-fractal/Changes @@ -0,0 +1,6 @@ +pst-fractal.sty -------- +0.01 2007-04-05 first CTAN version + + +pst-fractal.tex -------- +0.03 2007-04-05 first CTAN version diff --git a/Master/texmf-dist/doc/generic/pst-fractal/README b/Master/texmf-dist/doc/generic/pst-fractal/README new file mode 100644 index 00000000000..bafa6bd17fb --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-fractal/README @@ -0,0 +1,46 @@ +%% Package `pst-fractal.tex' +%% +%% Herbert Voss <voss _at_ pstricks.de> (Germany) +%% +%% 2007-04-05 +%% + +PSTricks offers excellent macros to insert more or less complex +graphics into a document. pstricks.tex itself is the base for several +other additional packages, which are mostly named pst-xxxx, +like pst-fractal, which provides macros for the Julia and +Mandelbrot set and the Sierpinski triangle. + + +Save the files + +pst-fractal.sty +pst-fractal.tex + +in any place, where latex or any other TeX program will find it. +The pro file should go into $TEXMF$/dvips/pstricks/. + +pst-fractal uses the extended version of the keyval package. So +be sure that you +- have installed xkeyval with the special pst-xkey + (CTAN: tex-archive/macros/latex/contrib/xkeyval/) +- do not load another package after pst-fractal, which loads + the old keyval.sty or pst-key.tex + + +If you like to get the documentation file in another format run + +latex pst-fractal-doc.tex +bibtex pst-fractal.doc +latex pst-fractal-doc.tex +dvips pst-fractal-doc.dvi + +to get a PostScript file. But pay attention, that the pst-fractal +files are saved in the above mentioned way, before you run +latex on the documentation file. + +The intermediate DVI file works only with viewers which can +interprete the embedded PostScript code. + +For another PDF output read the Introduction from +the documentation. diff --git a/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.bib b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.bib new file mode 100644 index 00000000000..3b785845e22 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.bib @@ -0,0 +1,129 @@ +@STRING{dtk = {{D}ie {\TeX}nische {K}om{\"o}die} } + +@Book{PostScript, + Author = {Kollock, Nikolai G.}, + Title = {PostScript richtig eingesetzt: vom Konzept zum + praktischen Einsatz}, + Publisher = {IWT}, + Address = {Vaterstetten}, + year = 1989, +} + +@Manual{pstricks, + Title = {PSTricks - {\PS} macros for Generic TeX}, + Author = {Timothy Van Zandt}, + Organization = {}, + Address = {\url{http://www.tug.org/application/PSTricks}}, + Note = {}, + year = 1993, +} + + +@Manual{pdftricks, + Title = {PSTricks Support for pdf}, + Author = {Herbert Voss}, + Organization = {}, + Address = {\url{http://PSTricks.de/pdf/pdfoutput.phtml}}, + Note = {}, + year = 2002, +} + +@Manual{miwi, + Title = {References for \TeX{} and Friends}, + Author = {Michael Wiedmann and Peter Karp}, + Organization = {}, + Address = {\url{http://www.miwie.org/tex-refs/}}, + Note = {}, + year = 2003, +} + + +@Manual{pstlens:2001, + Title = {PST-lens - {\PS} macros for Generic TeX}, + Author = {Denis Girou and Manuel Luque}, + Organization = {}, + Address = {\url{ftp://ftp.dante.de/tex-archive/graphics/pstricks/contrib/pst-lens/}}, + Note = {}, + year = 2001, +} + +@Manual{vue3d:2002, + Title = {Vue en 3D}, + Author = {Manuel Luque}, + Organization = {}, + Address = {\url{http://members.aol.com/Mluque5130/vue3d16112002.zip}}, + Note = {}, + year = 2002, +} + +@Article{dtk02.2:jackson.voss:plot-funktionen, + author = {Laura E. Jackson and Herbert Vo{\ss}}, + title = {Die {P}lot-{F}unktionen von {\texttt{pst-plot}}}, + journal = dtk, + year = 2002, + volume = {2/02}, + altvolume = 2, + altnumber = 14, + month = jun, + pages = {27--34}, + annote = bretter, + keywords = {}, + abstract = { Im letzten Heft wurden die mathematischen Funktionen von + \PS~im Zusammenhang mit dem {\LaTeX}-Paket + \texttt{pst-plot} zum Zeichnen von Funktionen beschrieben + und durch Beispiele erl{\"a}utert. In diesem Teil werden + die bislang nur erw{\"a}hnten Plot-Funktionen f{\"u}r + externe Daten behandelt. } +} + +@Article{dtk02.1:voss:mathematischen, + author = {Herbert Vo{\ss}}, + title = {Die mathematischen {F}unktionen von {P}ostscript}, + journal = dtk, + year = 2002, + volume = {1/02}, + altvolume = 1, + altnumber = 14, + month = mar, + pages = {40-47}, + annote = bretter, + keywords = {}, + abstract = { \PS, faktisch genauso alt wie {\TeX}, ist im + Verh{\"a}ltnis dazu allgemein noch weniger bekannt, wenn es + darum geht zu beurteilen, was es denn nun im eigentlichen + Sinne ist. Au{\ss}erdem wird h{\"a}ufig vergessen, dass + sich mit den \PS-Funktionen viele Dinge erledigen lassen, + bei denen sonst auf externe Programme zur{\"u}ckgegriffen + wird. Dies wird im Folgenden f{\"u}r die mathematischen + Funktionen im Zusammenhang mit dem Paket \texttt{pst-plot} + gezeigt. } +} + + +@Book{companion, + author = {Michel Goosens and Frank Mittelbach and Alexander + Samarin}, + title = {The {\LaTeX} {G}raphics {C}ompanion}, + publisher = {{Addison-Wesley Publishing Company}}, + year = {2004}, + edition = {2.}, + address = {Reading, Mass.} +} + +@Book{PSTricks2, + author = {Herbert Vo\ss}, + title = {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX}, + edition = {4.}, + publisher = {DANTE -- Lehmanns}, + year = {2007}, + address = {Heidelberg/Hamburg} +} + +@Book{voss:math, + author = {Herbert Vo\ss}, + title = {\LaTeX\ in {M}athematik und {N}aturwissenschaften}, + publisher = {{Franzis-Verlag}}, + year = {2006}, + address = {Poing} +} + diff --git a/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.pdf b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.pdf Binary files differnew file mode 100644 index 00000000000..63725ffbc40 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.pdf diff --git a/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.tex b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.tex new file mode 100644 index 00000000000..430f66d6eb5 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-fractal/pst-fractal-doc.tex @@ -0,0 +1,256 @@ +\listfiles +\documentclass[11pt,a4paper]{article} +\usepackage[T1]{fontenc} +\usepackage[latin1]{inputenc} +\usepackage{amsmath} +\usepackage{graphicx} +\usepackage{geometry,lmodern} +\usepackage{pstricks} +\usepackage{showexpl} +%\lstset{wide=true} +\usepackage{pst-fractal} +\let\myFV\fileversion +\usepackage{url} +\usepackage[bottom]{footmisc} +\usepackage{fancyhdr} +\usepackage{abstract} +\pagestyle{fancy} +\usepackage{url} +\def\UrlFont{\small\ttfamily} +\makeatletter +\def\verbatim@font{\small\normalfont\ttfamily} +\makeatother +\lfoot{\small\ttfamily\jobname.tex} +\cfoot{} +\rfoot{\thepage} +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt} +\let\myPart\part +\renewcommand{\part}[1]{\clearpage\myPart{#1}} +\newcommand{\PS}{PostScript} +\newcommand\CMD[1]{\texttt{\textbackslash#1}} +\psset{subgriddiv=0,gridlabels=7pt,gridcolor=black!15} +\usepackage[pdfauthor={Herbert Voss},pdftitle={Fractals},linktocpage,colorlinks]{hyperref} +% + +% +\begin{document} +\author{Herbert Voß\thanks{voss@perce.de}} +\date{\today} +\title{Fractals: pst-fractal v\myFV\\Documentation} + +\maketitle% +\begin{abstract} +The well known \verb+pstricks+ package offers excellent macros to insert more or less complex +graphics into a document. \verb+pstricks+ itself is the base for several other additional packages, +which are mostly named \verb+pst-xxxx+, like \verb+pst-fractal+. + +This version uses the extended keyval package \verb+xkeyval+, so be sure that you have installed +this package together with the spcecial one \verb+pst-xkey+ for PSTricks. The \verb+xkeyval+ +package is available at \href{ftp://ftp.dante.de/pub/tex/macros/latex/contrib/xkeyval/}{CTAN:/macros/latex/contrib/xkeyval/}. +It is also important that after \verb+pst-fractal+ no package is loaded, which uses the old keyval interface. + +The fractals are really big, which is the reason why this document is about 15 MByte. +\vspace*{2cm} +\end{abstract}% + +\tableofcontents + + +\section{Julia and Mandelbrot sets} + +The syntax of the \verb+psfractal+ macro is simple +\begin{verbatim} +\psfractal[settings](x0,y0)(x1,y1) +\end{verbatim} +All Arguments are optional, \verb+psfractal+ is the same as \verb+\psfractal(-1,-1)(1,1)+. + +The Julia and Mandelbrot sets are a graphical representation of the following sequence + +$x$ is the real and $y$ the imaginary part of the complex number $z$. $C(x,y)$ is a complex constant +and preset by $(0,0)$. +\begin{align} +z_{n+1}(x,y) &= (z_n(x,y))^2 +C(x,y)\\ +\end{align} + +\subsection{Julia sets} + +A Julia set is given with + +\begin{align} +z_{n+1}(x,y) &= (z_n(x,y))^2 +C(x,y)\\ +z_0 &= (x_0;y_0) +\end{align} +$(x_0;y_0)$ is the starting value. + + +\begin{LTXexample}[width=3cm] +\psfractal +\end{LTXexample} + +\begin{LTXexample}[width=5cm] +\psfractal[xWidth=5cm,yWidth=5cm, + baseColor=white, + dIter=20](-2,-2)(2,2) +\end{LTXexample} + + +\subsection{Mandelbrot sets} + +A Mandelbrot set is given with + +\begin{align} +z_{n+1}(x,y) &= (z_n(x,y))^2 +C(x,y)\\ +z_0 &= (0;0)\\ +C(x,y) &= (x_0;y_0) +\end{align} + +$(x_0;y_0)$ is the starting value. + + +\begin{LTXexample}[width=3cm] +\psfractal[type=Mandel] +\end{LTXexample} + +\begin{LTXexample}[width=6.5cm] +\psfractal[type=Mandel, + xWidth=6cm,yWidth=4.8cm, + baseColor=white, + dIter=10](-2,-1.2)(1,1.2) +\end{LTXexample} + +\subsection{Sierpinski triangle} + +The triangle must be given by three mandatory arguments: + +\begin{verbatim} +\psSier[settings](x0,y0)(x1,y1)(x2,y2) +\end{verbatim} + +In difference to \verb|psfractal| it doesn't reserve any space, this is the +reason why it should be part of a \verb|pspicture| environment. + +\begin{LTXexample}[width=6.5cm] +\begin{pspicture}(5,5) + \psSier(0,0)(2,5)(5,0) +\end{pspicture} +\end{LTXexample} + +\section{The options} + + +\subsection{\texttt{type}} +Can be of "`Julia"' (default) or "`Mandel"'. + +\begin{LTXexample}[width=4.5cm] +\psfractal\quad \psfractal[type=Mandel] +\end{LTXexample} + + +\subsection{\texttt{baseColor}} +The color for the convergent part. + +\begin{LTXexample}[pos=t] +\psfractal[xWidth=5cm,yWidth=5cm,dIter=10](-2,-2)(2,2)\quad +\psfractal[xWidth=5cm,yWidth=5cm,baseColor=white,dIter=10](-2,-2)(2,2) +\end{LTXexample} + + + +\subsection{\texttt{xWidth} and \texttt{yWidth}} +These values define the physical width of the fractal. + +\begin{LTXexample}[pos=t] +\psfractal[type=Mandel,xWidth=12.8cm,yWidth=10.8cm,dIter=5](-2.5,-1.3)(0.7,1.3) +\end{LTXexample} + +\subsection{\texttt{cx} and \texttt{cy}} +Define the starting value for the complex constant number $C$. + +\begin{LTXexample}[pos=t] +\psset{xWidth=5cm,yWidth=5cm} +\psfractal[dIter=2](-2,-2)(2,2)\quad \psfractal[dIter=2,cx=-1.3,cy=0](-2,-2)(2,2) +\end{LTXexample} + +\subsection{\texttt{dIter}} +The color is set by wavelength to RGB conversion of the iteration number, where +\verb+dIter+ is the step, predefined by 1. The wavelength is given by +the value of iter added by 400. + +\begin{LTXexample}[pos=t] +\psset{xWidth=5cm,yWidth=5cm} +\psfractal[dIter=30](-2,-2)(2,2)\quad \psfractal[dIter=10,cx=-1.3,cy=0](-2,-2)(2,2) +\end{LTXexample} + + +\subsection{\texttt{maxIter}} +\verb+maxIter+ is the number of the maximum iteration until it leaves the loop. +It is predefined by 255, but internally multiplied by \texttt{dIter}. + +\begin{LTXexample}[pos=t] +\psset{xWidth=5cm,yWidth=5cm} +\psfractal[maxIter=50,dIter=3](-2,-2)(2,2)\quad +\psfractal[maxIter=30,cx=-1.3,cy=0](-2,-2)(2,2) +\end{LTXexample} + +\subsection{\texttt{maxRadius}} +if the square of distance of $z_n$ to the origin of the complex coordinate system +is greater as \texttt{maxRadius} then the algorithm leaves the loop +and sets the point. \texttt{maxRadius} should always be the square of the "`real"' +value, it is preset by 100. + +\begin{LTXexample}[pos=t] +\psset{xWidth=5cm,yWidth=5cm} +\psfractal[maxRadius=30,dIter=10](-2,-2)(2,2)\quad +\psfractal[maxRadius=30,dIter=30,cx=-1.3,cy=0](-2,-2)(2,2) +\end{LTXexample} + +\subsection{\texttt{plotpoints}} +This option is only valid for the Sierpinski triangle and preset by 2000. + +\begin{LTXexample}[pos=t] +\begin{pspicture}(5,5) + \psSier(0,0)(2.5,5)(5,0) +\end{pspicture}\quad +\begin{pspicture}(5,5) + \psSier[plotpoints=10000](0,0)(2.5,5)(5,0) +\end{pspicture} +\end{LTXexample} + +\section{PDF output} + +\verb|pst-fractal| is based on the popular \verb|pstricks| package and writes pure \PS code\cite{PostScript}, so it is not possible to run \TeX{} files with pdf\LaTeX{} when there are pstricks macros in the document. If you still need a PDF output use one of the following possibilities: +\begin{itemize} +\item package \verb|pdftricks.sty|\cite{pdftricks} +\item the for Linux free available program VTeX/Lnx\footnote{\url{http://www.micropress-inc.com/linux/}} +\item build the PDF with \verb|ps2pdf| (\verb|dvi|$\rightarrow$\verb|ps|$\rightarrow$\verb|pdf|) +\item use the \verb|pst-pdf| package.\footnote{\url{http://www.ctan.org/CTAN/macros/latex/contrib/pst-pdf/}} +\end{itemize} + +You do not need to load \verb|pstricks.sty|, it will be done by \verb|pst-fractal| by default. + +\section{FAQ} +\begin{itemize} +\item The fractal is not correct placed. + +Be sure that you view your output with a dvi viewer which can show PostScript code, like +kdvi but not xdvi. It is better to run \verb|dvips| and then view the ps-file with \verb|gv|. +\item Unknown PostScript command: + +Be sure that you have the ''newest`` \verb|pstricks-add.tex| file +\begin{verbatim} +\def\fileversion{2.85} +\def\filedate{2007/04/01} +\end{verbatim} +\end{itemize} + + + +\section{Credits} + +\nocite{*} + +\bibliographystyle{plain} +\bibliography{pst-fractal-doc} + +\end{document} |