diff options
author | Norbert Preining <norbert@preining.info> | 2020-03-25 03:01:53 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2020-03-25 03:01:53 +0000 |
commit | e32477e40d853a81951c9811f8554455dbff4014 (patch) | |
tree | 12744b350742c71cbb3c768354084a5c50369ce7 /graphics/pstricks/contrib/pst-tools/doc | |
parent | e9af7499b89170ca5c737240b0cdb9563dcf6c5a (diff) |
CTAN sync 202003250301
Diffstat (limited to 'graphics/pstricks/contrib/pst-tools/doc')
-rw-r--r-- | graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.pdf | bin | 116833 -> 128099 bytes | |||
-rw-r--r-- | graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.tex | 62 |
2 files changed, 57 insertions, 5 deletions
diff --git a/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.pdf b/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.pdf Binary files differindex 299cc4ad38..15cd40da5c 100644 --- a/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.pdf +++ b/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.pdf diff --git a/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.tex b/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.tex index 2473feb2fe..9296568bc3 100644 --- a/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.tex +++ b/graphics/pstricks/contrib/pst-tools/doc/pst-tools-doc.tex @@ -1,6 +1,6 @@ -%% $Id: pst-tools-doc.tex 675 2017-12-03 08:39:12Z herbert $ +%% $Id: pst-tools-doc.tex 1163 2020-03-24 09:47:58Z herbert $ \documentclass[11pt,english,BCOR=10mm,DIV=13,toc=bibliography,parskip=false, - headings=small, headinclude=false,footinclude=false,oneside]{pst-doc} + headings=small,headinclude=false,footinclude=false,oneside]{pst-doc} \usepackage[utf8]{inputenc} \usepackage{pst-tools} \let\pstToolsFV\fileversion @@ -24,7 +24,7 @@ \begin{abstract} This package defines some tools which are useful for all packages not only the PSTricks like packages. - +Since the version 0.10 it includes the macros from \texttt{random.tex}. \vfill \noindent Thanks to: @@ -188,7 +188,7 @@ It must be a comma separated list. \begin{lstlisting} -\psRegisterList{Color}{violet,blue,green,red}% defines macro \Color +\psRegisterList{Color}{yellow,blue,green,red}% defines macro \Color \begin{pspicture}(-7,-4.5)(7,5.5) \psaxes{->}(0,0)(-6.5,-4.5)(6.75,5) \psset{plotpoints=400,algebraic,linewidth=1pt,fillstyle=solid,opacity=0.4} @@ -201,7 +201,7 @@ It must be a comma separated list. \end{pspicture} \end{lstlisting} -\psRegisterList{Color}{violet,blue,green,red}% defines macro \Color +\psRegisterList{Color}{yellow,blue,green,red}% defines macro \Color \begin{pspicture}(-7,-4.5)(7,5.5) \psaxes{->}(0,0)(-6.5,-4.5)(6.75,5) \psset{plotpoints=400,algebraic,linewidth=1pt,fillstyle=solid,opacity=0.4} @@ -213,6 +213,58 @@ It must be a comma separated list. \end{pspicture} + +\section{Random numbers} +The file \LFile{random.tex} from Donald Arseneau is no more part of CTAN due to a missing licence statement. +\LFile{pst-tools} at version 0.10 includes the code. The documentation was inside the package otself: + +Random integers are generated in the range 1 to 2147483646 by the +macro \Lcs{nextrandom}. The result is returned in the counter \Lcs{randomi}. +Do not change \Lcs{randomi} except, perhaps, to initialize it at some +random value. If you do not initialize it, it will be initialized +using the time and date. (This is a sparse initialization, giving +fewer than a million different starting values, but you should use +other sources of numbers if they are available--just remember that +most of the numbers available to TeX are not at all random.) + +The \Lcs{nextrandom} command is not very useful by itself, unless you +have exactly 2147483646 things to choose from. Much more useful +is the \Lcs{setrannum} command which sets a given counter to a random +value within a specified range. There are three parameters: + +\Lcs{setrannum\{<counter>\}\{<minimum>\}\{<maximum>\}} + +For example, to +simulate a die-roll: + +\verb|\setrannum{\die}{1}{6}| \verb|\ifcase\die...| . + +If you need random numbers that are not integers, you will have to +use dimen registers and \Lcs{setrandimen}. For example, to set a random +page width: + +\Lcs{setrandimen} \Lcs{hsize\{3in\}\{6.5in\}} + + The »\Lcs{pointless}« macro +will remove the »pt« that TeX gives so you can use the dimensions +as pure `real' numbers. In that case, specify the range in pt units. +For example, + + \verb|\setrandimen\answer{2.71828pt}{3.14159pt}| + + The answer is \verb|\pointless\answer|. + +The random number generator is the one by Lewis, Goodman, and Miller +(1969) and used as \texttt{ran0} in »Numerical Recipies« using Schrage's +method for avoiding overflows. The multiplier is $16807 (7^5)$, the +added constant is 0, and the modulus is $2147483647 (2^{31}-1)$. The +range of integers generated is $1 - 2147483646$. A smaller range would +reduce the complexity of the macros a bit, but not much--most of the +code deals with initialization and type-conversion. On the other hand, +the large range may be wasted due to the sparse seed initialization. + + + \section{List of the defined PostScript functions} \footnotesize |