diff options
| author | Karl Berry <karl@freefriends.org> | 2009-01-19 23:41:00 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2009-01-19 23:41:00 +0000 |
| commit | 7182f14254c8a7ac0ee463a6a9944e914cca9875 (patch) | |
| tree | 58bfeb2da572cdf35f31e68b31935c51984ee3ed /Master/texmf-dist/doc/generic/pstricks-add | |
| parent | 3b0d311f8129942a21307bf752701045027438a2 (diff) | |
pstricks-add 3.16 (18jan09)
git-svn-id: svn://tug.org/texlive/trunk@11919 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pstricks-add')
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/Changes | 15 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/README | 3 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.bib | 14 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf | bin | 1712671 -> 1973570 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex | 2695 |
5 files changed, 917 insertions, 1810 deletions
diff --git a/Master/texmf-dist/doc/generic/pstricks-add/Changes b/Master/texmf-dist/doc/generic/pstricks-add/Changes index c64ec370cd9..b99c503a31e 100644 --- a/Master/texmf-dist/doc/generic/pstricks-add/Changes +++ b/Master/texmf-dist/doc/generic/pstricks-add/Changes @@ -1,4 +1,4 @@ -%% $Id: Changes 49 2008-10-13 10:59:27Z herbert $ +%% $Id: Changes 75 2009-01-17 22:01:38Z herbert $ %% pstricks-add.pro ----------- v 0.21 2008-10-13 - add bubblesort macro @@ -34,6 +34,19 @@ pstricks-add.sty ----------- (hv) pstricks-add.tex ----------- (Dominik Rodriguez/hv) + v 3.16 2009-01-17 - add optional argument for \psplot ans \parametricplot + for additional PostScript settings + v 3.16 2008-12-22 - make showorigin also valid for the ticks + v 3.15 2008-12-12 - fixed bug with \psgraph and the optional labels + v 3.14 2008-12-02 - fixed bug with \psaxes and the optional arguments + v 3.13 2008-11-24 - added the PostScript variable ps@Exit to exit loops in + \psaxes and \parametricplot + - added yMaxValue option for plotstyles lines, polygons and beziers + to draw discontinued functions + v 3.12 2008-11-14 - modified \psxTick and \psyTick (Martin Chicoine) + - new macro \use@keep@par, which doesn't delete the setting + after using it + v 3.11 2008-10-15 - added \psBoxplot v 3.10 2008-08-27 - fix bug with \pslabelsep and \psh(v)label v 3.09 2008-08-06 - fix bug with lineAngle - make chartNodes variable diff --git a/Master/texmf-dist/doc/generic/pstricks-add/README b/Master/texmf-dist/doc/generic/pstricks-add/README index 68950ed0b46..d776273808e 100644 --- a/Master/texmf-dist/doc/generic/pstricks-add/README +++ b/Master/texmf-dist/doc/generic/pstricks-add/README @@ -12,6 +12,8 @@ pstricks-add collects a lot of the code which was posted to the pstricks mailing list and has some more new features: - pstricks + o random dots + O braces o define and calculate colors on PS side o Gouraud shading o braces as node connection/linestyle @@ -19,6 +21,7 @@ to the pstricks mailing list and has some more new features: o arrows, arrows, arrows, ... - pst-plot + o new syntax for \psplot and \psparametricplot o new environment psgraph o new macro pstScalePoints o new option for logarithmic axes diff --git a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.bib b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.bib index d7ec06279cf..cb8f1f164c5 100644 --- a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.bib +++ b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.bib @@ -17,9 +17,9 @@ @Book{PSTricks2, author = {Herbert Vo\ss}, title = {{\PST} {G}rafik f\"ur \TeX{} und \LaTeX}, - edition = {forth}, - publisher = {DANTE -- Lehmanns}, - year = {2007}, + edition = {fifth}, + publisher = {DANTE -- Lob.media}, + year = {2008}, address = {Heidelberg/Hamburg} } @@ -172,10 +172,10 @@ } @book{voss06, - Title = {\LaTeX{} in {N}aturwissenschaften \&{} {M}athematik}, + Title = {Mathematiksatz in \LaTeX{}}, Author = {Herbert Vo\ss}, - Publisher = {Franzis Verlag}, + Publisher = {Lehmanns Media/DANTE}, Edition= {first}, - Address= {M\"unchen}, - Year= {2006}, + Address= {Berlin/Heidelberg}, + Year= {2009}, } diff --git a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf Binary files differindex 19e9b822ba7..51b5d07c68d 100644 --- a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf +++ b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf diff --git a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex index bfebf8b1668..5d2279355a3 100644 --- a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex +++ b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex @@ -1,1009 +1,17 @@ -%% $Id: pstricks-add-doc.tex 49 2008-10-13 10:59:27Z herbert $ -\documentclass[10pt]{article} +%% $Id: pstricks-add-doc.tex 75 2009-01-17 22:01:38Z herbert $ +\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings + headexclude,footexclude,oneside]{pst-doc} \listfiles -\usepackage{filecontents} -\begin{filecontents*}{demo0.dat} - 0.1414 0.0052 - 0.2828 0.0217 - 0.4243 0.0480 - 0.5657 0.0890 - 0.7071 0.1375 - 0.8485 0.1906 - 0.9899 0.2663 - 1.1314 0.3580 - 1.2728 0.4644 - 1.4142 0.5801 - 1.5556 0.7033 - 1.6971 0.8899 - 1.8385 1.1143 - 1.9799 1.2593 - 2.1213 1.5692 - 2.2627 3.2331 - 2.4042 4.4097 - 2.5456 5.8186 - 2.6870 7.4441 - 2.8284 8.2287 -\end{filecontents*} - -\begin{filecontents*}{demo1.dat} -1 99447169 -2 110351058 -3 123557238 -4 138346129 -5 145050826 -6 160363212 -7 174000394 -8 183856559 -9 189128691 -10 197634845 -11 213257357 -12 216899512 -13 230152738 -14 224144907 -15 247410024 -16 261168438 -17 252920343 -18 326153799 -19 319442110 -20 310351522 -21 381919943 -22 438043888 -23 357527766 -24 603304997 -\end{filecontents*} -\begin{filecontents*}{demo2.dat} - 1989 3.08 - 1990 3.84 - 1991 4.08 - 1992 3.21 - 1993 5.23 - 1994 2.97 - 1995 2.53 - 1996 2.8 - 1997 2.78 - 1998 3.15 - 1999 2.32 - 2000 2.4 - 2001 2.46 -\end{filecontents*} -\begin{filecontents*}{demo3.dat} - 1989 3.08 - 1990 3.1 - 1991 3.08 - 1992 3.21 - 1993 5.0 - 1994 2.27 - 1995 3.53 - 1996 3.8 - 1997 2.8 - 1998 4.15 - 1999 3.32 - 2000 1.4 - 2001 2.46 -\end{filecontents*} +\input{pstricks-add-doc.dat} -\begin{filecontents*}{data3.dat} - 0.000 -2.50 0.005 -1.99 0.010 -0.30 - 0.015 4.13 0.020 13.38 0.025 28.98 0.030 50.90 0.035 77.54 0.040 107.38 - 0.045 140.64 0.050 178.40 0.055 219.83 0.060 261.04 0.065 296.91 0.070 324.44 - 0.075 343.62 0.080 355.50 0.085 361.69 0.090 365.03 0.095 368.62 0.100 373.63 - 0.105 378.46 0.110 380.61 0.115 379.02 0.120 373.82 0.125 365.64 0.130 356.65 - 0.135 350.11 0.140 346.68 0.145 342.68 0.150 333.46 0.155 318.08 0.160 300.16 - 0.165 284.50 0.170 274.03 0.175 269.79 0.180 271.15 0.185 275.29 0.190 278.41 - 0.195 278.36 0.200 276.25 0.205 274.57 0.210 273.76 0.215 271.64 0.220 266.67 - 0.225 259.84 0.230 253.63 0.235 249.81 0.240 248.42 0.245 248.77 0.250 250.60 - 0.255 254.21 0.260 259.40 0.265 264.37 0.270 266.65 0.275 265.49 0.280 262.59 - 0.285 260.82 0.290 261.87 0.295 264.55 0.300 265.84 0.305 263.56 0.310 257.47 - 0.315 248.74 0.320 238.67 0.325 227.49 0.330 214.46 0.335 198.64 0.340 179.05 - 0.345 154.73 0.350 125.23 0.355 91.14 0.360 53.95 0.365 15.45 0.370 -21.37 - 0.375 -49.99 0.380 -62.54 0.385 -56.58 0.390 -37.83 0.395 -15.76 0.400 1.86 - 0.405 11.54 0.410 13.66 0.415 10.78 0.420 5.87 0.425 1.24 0.430 -1.95 - 0.435 -3.54 0.440 -3.98 0.445 -3.80 0.450 -3.43 0.455 -3.16 0.460 -3.09 - 0.465 -3.21 0.470 -3.44 0.475 -3.76 0.480 -4.13 0.485 -4.46 0.490 -4.74 - 0.495 -4.99 0.500 -5.30 0.505 -5.66 0.510 -6.05 0.515 -6.44 0.520 -6.73 - 0.525 -6.81 0.530 -6.67 0.535 -6.38 0.540 -6.08 0.545 -5.83 0.550 -5.66 - 0.555 -5.56 0.560 -5.49 0.565 -5.45 0.570 -5.46 0.575 -5.51 0.580 -5.61 - 0.585 -5.73 0.590 -5.81 0.595 -5.84 0.600 -5.83 0.605 -5.82 0.610 -5.84 - 0.615 -5.87 0.620 -5.91 0.625 -5.98 0.630 -6.07 0.635 -6.17 0.640 -6.30 - 0.645 -6.41 0.650 -6.43 0.655 -6.30 0.660 -6.01 0.665 -5.55 0.670 -4.96 - 0.675 -4.37 0.680 -3.94 0.685 -3.79 0.690 -3.94 0.695 -4.33 0.700 -4.83 - 0.705 -5.31 0.710 -5.65 0.715 -5.85 0.720 -5.95 0.725 -6.02 0.730 -6.10 - 0.735 -6.19 0.740 -6.29 0.745 -6.37 0.750 -6.40 0.755 -6.32 0.760 -6.07 - 0.765 -5.64 0.770 -5.08 0.775 -4.47 0.780 -3.84 0.785 -3.19 0.790 -2.58 - 0.795 -2.11 0.800 -1.84 0.805 -1.78 0.810 -1.90 0.815 -2.15 0.820 -2.45 - 0.825 -2.71 0.830 -2.86 0.835 -2.91 0.840 -2.96 0.845 -3.02 0.850 -3.10 - 0.855 -3.20 0.860 -3.36 0.865 -3.52 0.870 -3.63 0.875 -3.64 0.880 -3.52 - 0.885 -3.30 0.890 -3.04 0.895 -2.80 0.900 -2.59 0.905 -2.42 0.910 -2.27 - 0.915 -0.53 0.920 -0.16 0.925 0.08 0.930 0.13 0.935 -0.05 0.940 -0.41 - 0.945 -0.90 0.950 -1.44 0.955 -1.99 0.960 -2.46 0.965 -2.79 0.970 -2.98 - 0.975 -3.08 0.980 -3.13 0.985 -3.13 0.990 -3.05 0.995 -2.86 1.000 -2.57 -\end{filecontents*} - -\begin{filecontents*}{data.dat} -0 0 -1 1 -2 3 -3 6 -4 6 -5 11 -6 15 -7 18 -8 25 -9 26 -10 32 -11 37 -12 37 -13 44 -14 52 -15 65 -16 67 -17 82 -18 89 -19 104 -20 104 -21 111 -22 133 -23 142 -24 144 -25 166 -26 171 -27 182 -28 205 -29 230 -30 235 -31 256 -32 268 -33 289 -34 322 -35 356 -36 363 -37 394 -38 413 -39 430 -40 461 -41 496 -42 527 -43 563 -44 590 -45 616 -46 616 -47 652 -48 685 -49 694 -50 728 -51 779 -52 785 -53 791 -54 823 -55 846 -56 891 -57 892 -58 894 -59 922 -60 976 -61 1002 -62 1025 -63 1083 -64 1130 -65 1173 -66 1176 -67 1208 -68 1211 -69 1221 -70 1272 -71 1281 -72 1290 -73 1329 -74 1379 -75 1428 -76 1460 -77 1489 -78 1550 -79 1600 -80 1666 -81 1678 -82 1680 -83 1760 -84 1785 -85 1796 -86 1874 -87 1881 -88 1932 -89 1936 -90 1968 -91 2016 -92 2091 -93 2111 -94 2181 -95 2227 -96 2260 -97 2354 -98 2371 -99 2423 -100 2498 -101 2552 -102 2585 -103 2622 -104 2676 -105 2678 -106 2752 -107 2842 -108 2904 -109 2984 -110 3029 -111 3037 -112 3062 -113 3162 -114 3181 -115 3266 -116 3364 -117 3461 -118 3479 -119 3494 -120 3523 -121 3630 -122 3668 -123 3699 -124 3815 -125 3939 -126 4003 -127 4107 -128 4168 -129 4199 -130 4231 -131 4304 -132 4331 -133 4354 -134 4416 -135 4435 -136 4448 -137 4514 -138 4601 -139 4672 -140 4736 -141 4843 -142 4845 -143 4923 -144 5059 -145 5095 -146 5240 -147 5255 -148 5289 -149 5393 -150 5475 -151 5586 -152 5647 -153 5669 -154 5733 -155 5837 -156 5871 -157 5881 -158 5970 -159 5973 -160 6055 -161 6107 -162 6266 -163 6399 -164 6402 -165 6474 -166 6605 -167 6669 -168 6837 -169 6908 -170 6958 -171 7103 -172 7183 -173 7319 -174 7464 -175 7513 -176 7672 -177 7693 -178 7841 -179 7891 -180 8035 -181 8200 -182 8337 -183 8515 -184 8545 -185 8546 -186 8632 -187 8793 -188 8822 -189 8996 -190 9073 -191 9227 -192 9317 -193 9381 -194 9394 -195 9494 -196 9614 -197 9744 -198 9805 -199 9923 -200 9942 -201 10079 -202 10169 -203 10322 -204 10393 -205 10570 -206 10723 -207 10802 -208 10862 -209 10958 -210 11054 -211 11216 -212 11409 -213 11528 -214 11659 -215 11793 -216 11888 -217 11900 -218 12081 -219 12082 -220 12161 -221 12311 -222 12345 -223 12403 -224 12469 -225 12678 -226 12695 -227 12732 -228 12863 -229 12896 -230 13120 -231 13142 -232 13361 -233 13549 -234 13702 -235 13821 -236 13978 -237 14182 -238 14356 -239 14472 -240 14668 -241 14794 -242 15008 -243 15092 -244 15148 -245 15172 -246 15218 -247 15430 -248 15639 -249 15744 -250 15973 -251 16076 -252 16233 -253 16466 -254 16572 -255 16752 -256 16987 -257 17013 -258 17034 -259 17101 -260 17301 -261 17495 -262 17576 -263 17604 -264 17610 -265 17720 -266 17924 -267 17933 -268 17997 -269 18152 -270 18353 -271 18417 -272 18553 -273 18663 -274 18897 -275 18934 -276 19092 -277 19366 -278 19615 -279 19783 -280 19980 -281 20044 -282 20249 -283 20484 -284 20623 -285 20641 -286 20718 -287 20937 -288 21202 -289 21401 -290 21403 -291 21657 -292 21667 -293 21693 -294 21893 -295 22053 -296 22115 -297 22207 -298 22342 -299 22617 -300 22724 -301 22851 -302 23048 -303 23263 -304 23379 -305 23586 -306 23597 -307 23761 -308 23853 -309 24112 -310 24421 -311 24718 -312 24904 -313 25001 -314 25298 -315 25387 -316 25430 -317 25611 -318 25895 -319 26138 -320 26186 -321 26482 -322 26753 -323 27073 -324 27266 -325 27497 -326 27663 -327 27871 -328 27982 -329 28032 -330 28037 -331 28082 -332 28363 -333 28416 -334 28626 -335 28672 -336 28995 -337 29143 -338 29192 -339 29491 -340 29515 -341 29618 -342 29731 -343 30003 -344 30259 -345 30288 -346 30312 -347 30613 -348 30730 -349 30941 -350 30951 -351 31118 -352 31438 -353 31582 -354 31722 -355 31984 -356 32116 -357 32425 -358 32780 -359 32841 -360 33017 -361 33378 -362 33523 -363 33742 -364 33859 -365 34163 -366 34349 -367 34687 -368 34755 -369 34939 -370 35136 -371 35226 -372 35456 -373 35802 -374 35957 -375 36266 -376 36623 -377 36876 -378 37192 -379 37566 -380 37901 -381 37914 -382 37974 -383 38260 -384 38311 -385 38329 -386 38347 -387 38354 -388 38724 -389 38794 -390 39163 -391 39372 -392 39656 -393 39959 -394 40224 -395 40446 -396 40550 -397 40604 -398 40932 -399 41331 -400 41533 -401 41920 -402 42274 -403 42338 -404 42644 -405 42815 -406 42962 -407 43222 -408 43457 -409 43615 -410 44001 -411 44263 -412 44274 -413 44427 -414 44545 -415 44916 -416 45298 -417 45523 -418 45537 -419 45659 -420 45793 -421 46125 -422 46455 -423 46725 -424 46751 -425 46820 -426 46954 -427 47162 -428 47361 -429 47709 -430 47981 -431 48040 -432 48241 -433 48585 -434 48745 -435 49167 -436 49215 -437 49652 -438 49977 -439 50108 -440 50161 -441 50399 -442 50421 -443 50523 -444 50637 -445 50846 -446 51223 -447 51592 -448 51740 -449 52142 -450 52447 -451 52813 -452 53012 -453 53333 -454 53380 -455 53556 -456 53876 -457 54028 -458 54231 -459 54642 -460 54935 -461 55191 -462 55618 -463 55978 -464 56029 -465 56051 -466 56356 -467 56503 -468 56582 -469 56709 -470 57169 -471 57598 -472 57751 -473 58214 -474 58566 -475 58695 -476 58963 -477 59314 -478 59719 -479 60158 -480 60380 -481 60582 -482 60674 -483 61030 -484 61163 -485 61328 -486 61752 -487 61764 -488 61978 -489 62369 -490 62556 -491 62997 -492 63268 -493 63736 -494 63796 -495 63874 -496 63896 -497 64259 -498 64582 -499 65061 -500 65410 -501 65879 -502 66153 -503 66445 -504 66799 -505 67153 -506 67345 -507 67747 -508 67976 -509 68216 -510 68324 -511 68635 -512 68883 -513 69203 -514 69359 -515 69871 -516 69924 -517 70071 -518 70523 -519 70604 -520 70849 -521 71038 -522 71307 -523 71553 -524 72026 -525 72365 -526 72788 -527 72928 -528 73199 -529 73601 -530 73648 -531 73825 -532 74113 -533 74258 -534 74283 -535 74611 -536 75104 -537 75609 -538 75804 -539 76075 -540 76480 -541 76837 -542 77166 -543 77602 -544 77886 -545 78348 -546 78793 -547 79243 -548 79711 -549 80033 -550 80149 -551 80449 -552 80563 -553 80750 -554 80930 -555 81198 -556 81252 -557 81324 -558 81835 -559 82227 -560 82730 -561 82861 -562 83211 -563 83399 -564 83482 -565 83678 -566 84126 -567 84131 -568 84501 -569 84542 -570 84772 -571 85126 -572 85250 -573 85594 -574 85694 -575 85710 -576 85776 -577 86099 -578 86327 -579 86451 -580 86512 -581 86955 -582 87037 -583 87541 -584 87928 -585 88137 -586 88585 -587 88877 -588 89170 -589 89241 -590 89780 -591 89880 -592 89990 -593 90462 -594 90538 -595 90720 -596 91265 -597 91809 -598 92109 -599 92707 -600 93188 -601 93341 -602 93621 -603 94003 -604 94474 -605 94659 -606 95163 -607 95281 -608 95511 -609 95837 -610 96311 -611 96859 -612 97314 -613 97744 -614 97854 -615 98301 -616 98710 -617 99216 -618 99678 -619 99820 -620 100357 -621 100957 -622 101109 -623 101361 -624 101383 -625 101726 -626 101765 -627 101848 -628 102168 -629 102246 -630 102392 -631 102516 -632 102949 -633 102973 -634 103258 -635 103663 -636 104075 -637 104558 -638 104941 -639 105149 -640 105342 -641 105760 -642 105926 -643 106075 -644 106412 -645 106561 -646 106900 -647 107513 -648 108090 -649 108266 -650 108268 -651 108901 -652 108959 -653 109365 -654 109642 -655 110203 -656 110707 -657 111246 -658 111438 -659 111922 -660 112262 -661 112916 -662 113319 -663 113661 -664 114136 -665 114291 -666 114722 -667 115066 -668 115095 -669 115461 -670 115697 -671 116359 -672 116550 -673 116919 -674 116974 -675 117531 -676 117767 -677 118054 -678 118510 -679 118664 -680 119002 -681 119298 -682 119431 -683 119704 -684 120280 -685 120542 -686 120998 -687 121446 -688 121450 -689 121882 -690 122081 -691 122738 -692 122853 -693 123331 -694 123626 -695 124268 -696 124389 -697 124497 -698 125149 -699 125734 -700 126280 -701 126797 -702 127219 -703 127346 -704 127842 -705 128531 -706 128899 -707 129465 -708 129540 -709 130021 -710 130072 -711 130693 -712 131143 -713 131843 -714 131949 -715 132401 -716 132554 -717 132861 -718 133249 -719 133770 -720 134488 -721 135178 -722 135190 -723 135404 -724 135851 -725 136059 -726 136174 -727 136739 -728 136997 -729 137702 -730 138214 -731 138587 -732 139096 -733 139241 -734 139840 -735 140159 -736 140309 -737 140922 -738 141616 -739 142352 -740 142763 -741 143147 -742 143484 -743 144165 -744 144608 -745 144686 -746 145034 -747 145417 -748 145939 -749 145981 -750 146171 -751 146608 -752 147226 -753 147718 -754 148254 -755 148487 -756 148668 -757 149226 -758 149314 -759 149434 -760 150073 -761 150366 -762 150797 -763 150951 -764 151291 -765 151813 -766 152307 -767 152588 -768 153185 -769 153313 -770 153483 -771 154016 -772 154602 -773 154805 -774 154890 -775 155126 -776 155806 -777 156377 -778 156692 779 156734 780 156883 781 157412 782 157929 783 158547 -784 158764 785 158973 786 159385 787 159416 788 159637 789 159670 -790 160103 791 160549 792 160679 793 161283 794 161951 795 162320 -796 162776 797 163374 798 164039 799 164090 800 164460 801 164947 -802 165162 803 165373 804 165703 805 165906 806 166207 807 166815 -808 167412 809 168041 810 168758 811 168994 812 169548 813 170116 -814 170134 815 170275 816 170725 817 171110 818 171652 819 172034 -820 172524 821 172996 822 173240 823 174005 824 174380 825 175092 -826 175597 827 176176 828 176920 829 177290 830 177982 831 178062 -832 178824 833 179596 834 179693 835 180165 836 180650 837 181475 -838 182033 839 182121 840 182814 841 183388 842 183971 843 184270 -844 184786 845 185560 846 186048 847 186777 848 187228 849 187467 -850 187788 851 187831 852 187835 853 187979 854 188220 855 188853 -856 189642 857 190249 858 190994 859 191590 860 192304 861 192904 -862 193122 863 193575 864 194069 865 194874 866 195488 867 196335 -868 197090 869 197859 870 198241 871 198948 872 199153 873 199264 -874 199531 875 200155 876 200335 877 201046 878 201848 879 201885 -880 201979 881 202107 882 202892 883 203113 884 203406 885 203888 -886 204508 887 204880 888 205419 889 206285 890 206301 891 206455 -892 206902 893 207157 894 207246 895 207758 896 208566 897 208977 -898 209635 899 209773 900 210085 901 210951 902 211525 903 211557 -904 212143 905 212342 906 212833 907 213309 908 213515 909 214052 -910 214773 911 215134 912 215895 913 216268 914 216808 915 217435 -916 217828 917 217888 918 218804 919 219013 920 219563 921 219629 -922 220022 923 220829 924 221335 925 221385 926 221772 927 222538 -928 223369 929 223421 930 224214 931 224950 932 225376 933 225441 -934 225647 935 225874 936 226647 937 227340 938 227981 939 228754 -940 229465 941 230385 942 230550 943 231021 944 231829 945 232030 -946 232657 947 232855 948 233463 949 234013 950 234622 951 235472 -952 235775 953 235914 954 236551 955 236951 956 237532 957 237668 -958 238018 959 238404 960 239162 961 239195 962 240002 963 240893 -964 241209 965 242172 966 242201 967 242263 968 242465 969 243094 -970 243710 971 243799 972 244333 973 244861 974 245416 975 246031 -976 246139 977 246486 978 247242 979 247666 980 247869 981 248654 -982 249249 983 249324 984 249402 985 250116 986 250382 987 250517 -988 251198 989 251929 990 252212 991 252213 992 252493 993 253441 -994 253948 995 254830 996 254984 997 255322 998 256249 999 256500 -\end{filecontents*} - -\begin{filecontents*}{dataMul.dat} -[% file dataMul.dat -0 0 3.375 0.0625 10 5.375 7.1875 4.5 -20 7.1875 8.375 6.25 30 5.75 7.75 6.6875 -40 2.1875 5.75 5.9375 50 -1.9375 2.1875 4.3125 -60 -5.125 -1.8125 0.875 70 -6.4375 -5.3125 -2.6875 -80 -4.875 -7.1875 -4.875 90 0 -7.625 -5.625 -100 5.5 -6.3125 -5.8125 110 6.8125 -2.75 -4.75 -120 5.25 2.875 -0.75 -]% -\end{filecontents*} - -\usepackage[T1]{fontenc} -\usepackage[latin1]{inputenc} -%\usepackage{mathpazo} -%\usepackage{pamathx} -%\usepackage[scaled]{luximono} -\usepackage{arev} -%\usepackage{mathptmx} -\usepackage[lmargin=2.5cm,bmargin=3cm]{geometry} -\usepackage{tabularx} -\usepackage{graphicx,ragged2e} -\usepackage{xkvview} -\usepackage[svgnames,dvipsnames,table]{pstricks} -\usepackage{framed,xspace,multirow,caption} -\usepackage{pst-eucl,pst-fun} -\makeatletter -\define@key[psset]{}{PSfont}{\def\psk@PSfont{/#1 }} -\define@key[psset]{}{valuewidth}{\pst@getint{#1}\psk@valuewidth } -\define@key[psset]{}{fontscale}{\pst@checknum{#1}\psk@fontscale } -\define@key[psset]{}{decimals}{\pst@getint{#1}\psk@decimals } -\psset{PSfont=Times-Roman,fontscale=10,valuewidth=10,decimals=-1} -\def\psPrintValue{\pst@object{psPrintValue}} -\def\psPrintValue@i#1{% - \begin@SpecialObj - \addto@pscode{ - gsave \psk@PSfont findfont \psk@fontscale scalefont setfont - #1 \psk@decimals -1 gt { 10 \psk@decimals exp dup 3 1 roll mul cvi exch div } if - \psk@valuewidth string cvs 0 0 moveto show grestore - }% - \end@SpecialObj% -} -\makeatother +\usepackage[latin9]{inputenc} +\usepackage{pst-eucl,pst-fun,multirow} \usepackage{pstricks-add} +\usepackage{pifont} \let\pstricksaddFV\fileversion -\def\PST{\texttt{PSTricks}} -\newcommand*\PostScript{\textsf{PostScript}\xspace} -% % -\usepackage{longtable} -\usepackage{pifont} -\def\textat{\protect\makeatletter\texttt{@}\protect\makeatother} -\makeatletter -\renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.5em}} -\renewcommand*\l@subsection{\@dottedtocline{2}{3.8em}{3.2em}} -\renewcommand*\l@subsubsection{\@dottedtocline{3}{7.0em}{4.1em}} -\renewcommand*\l@paragraph{\@dottedtocline{4}{10em}{5em}} -\renewcommand*\l@subparagraph{\@dottedtocline{5}{12em}{6em}} -\makeatother -\let\psEllipticArc\psellipticarc -\let\psEllipticArcN\psellipticarcn -\let\psWedgeEllipse\psellipticwedge -%\parindent=0pt -\newcommand\verbI[1]{{\small\texttt{#1}}} -\newcommand\CMD[1]{{\texttt{\textbackslash#1}}} -\let\param\texttt +\let\CMD\Lcs % \newcommand{\pstEllipse}[5][]{% \psset{#1} @@ -1020,26 +28,7 @@ }% } % -\psset{subgriddiv=0,griddots=5,gridlabels=7pt} -% -\DeclareRobustCommand\cs[1]{\texttt{\char`\\#1}} -\def\PS{PostScript} -% -%\renewcommand{\ttdefault}{ul9}% Luxi Mono - -\parindent=0pt -\parskip=1ex plus 5pt - -\usepackage[colorlinks,linktocpage]{hyperref} -\makeatletter -\def\verbatim@font{\small\normalfont\ttfamily} -\makeatother -\usepackage{showexpl} -\lstset{preset=\RaggedRight} -\lstdefinestyle{syntax}{backgroundcolor=\color{blue!20},numbers=none,xleftmargin=0pt,xrightmargin=0pt, - frame=single} -\usepackage{amsmath} - +\def\textat{\char064}% \newdimen\fullWidth \makeatletter \renewcommand\ON{% @@ -1051,16 +40,59 @@ \renewcommand\OFF{% \xdef\lst@alloverstyle##1{##1}% } - +\define@key[psset]{}{PSfont}[Times-Roman]{\def\psk@PSfont{/#1 }} +\define@key[psset]{}{valuewidth}[10]{\pst@getint{#1}\psk@valuewidth } +\define@key[psset]{}{fontscale}[10]{\pst@checknum{#1}\psk@fontscale } +\define@key[psset]{}{decimals}[-1]{\pst@getint{#1}\psk@decimals } +\psset{PSfont=Times-Roman,fontscale=10,valuewidth=10,decimals=-1} +% +\def\psPrintValue{\pst@object{psPrintValue}} +\def\psPrintValue@i#1{% + \begin@SpecialObj + \addto@pscode{ + gsave \psk@PSfont findfont \psk@fontscale scalefont setfont + #1 \psk@decimals -1 gt { 10 \psk@decimals exp dup 3 1 roll mul cvi exch div } if + \psk@valuewidth string cvs 0 0 moveto show grestore + }% + \end@SpecialObj% +} +\renewcommand*\l@section[2]{% + \ifnum \c@tocdepth >\z@ + \ifnum \lastpenalty<20009 + \addpenalty{\@secpenalty}% + \fi + \addvspace{1.0em \@plus\p@}% + \setlength\@tempdima{2.5em}% + \if@tocleft + \ifx\toc@l@number\@empty\else + \setlength\@tempdima{0\toc@l@number}% + \fi + \fi + \begingroup + \raggedsectionentry + \parindent \z@ \advance\rightskip \@pnumwidth + \parfillskip -\@pnumwidth + \interlinepenalty\@M + \leavevmode + \advance\leftskip \@tempdima \null\nobreak\hskip -\leftskip + \usekomafont{sectionentry}{#1\nobreak + \usekomafont{sectionentrypagenumber}{% + \hfill\nobreak + \hb@xt@\@pnumwidth{\hss#2}}}\par + \endgroup + \ifnum \scr@compatibility>\@nameuse{scr@v@2.96}\relax + \penalty20008 + \fi + \fi +} +\renewcommand*\l@subsection{\bprot@dottedtocline{2}{1.5em}{3.6em}} +\renewcommand*\l@subsubsection{\bprot@dottedtocline{3}{3.8em}{4.5em}} +\renewcommand*\l@paragraph{\bprot@dottedtocline{4}{7.0em}{5em}} \makeatother \lstset{escapechar=§} \begin{document} -\fullWidth=\linewidth -\advance\fullWidth by \marginparsep -\advance\fullWidth by \marginparwidth - \title{\texttt{pstricks-add}\\additionals Macros for \texttt{pstricks}% %\thanks{% % This document was written with \texttt{Kile: 1.7 (Qt: 3.1.1; KDE: 3.3;} @@ -1068,11 +100,16 @@ % was build with VTeX/Free (\url{http://www.micropress-inc.com/linux})} \\ \small v.\pstricksaddFV} -\author{Dominique Rodriguez and Herbert Vo\ss} +\docauthor{Herbert Vo\ss} +\author{Dominique Rodriguez\\Herbert Vo\ss} \date{\today} \maketitle +\fullWidth=\linewidth +\advance\fullWidth by \marginparsep +\advance\fullWidth by \marginparwidth + \begin{abstract} This version of \verb+pstricks-add+ needs \verb+pstricks.tex+ version >1.04 from June 2004, otherwise the additional macros may @@ -1080,23 +117,45 @@ not work as expected. The ellipsis material and the option \verb+asolid+ (renamed to \verb+eofill+) are \index{fillstyle!eofill@\texttt{eofill}} now part of the new \verb+pstricks.tex+ package, available at CTAN or at -\url{http://perce.de/LaTeX/}. \verb+pstricks-add+ will for ever be +\url{http://perce.de/LaTeX/}. \LPack{pstricks-add} will for ever be an experimental and dynamical package, try it at your own risk. \begin{itemize} -\item It is important to load \verb+pstricks-add+ as the \textbf{last} PSTricks related package, otherwise +\item It is important to load \LPack{pstricks-add} as the \textbf{last} PSTricks related package, otherwise a lot of the macros won't work in the expected way. -\item \verb+pstricks-add+ uses the extended version of the keyval package. So be sure that -you have installed \verb+pst-xkey+ which is part of the -\verb+xkeyval+-package, and that all packages that use the old +\item \LPack{pstricks-add} uses the extended version of the keyval package. So be sure that +you have installed \LPack{pst-xkey} which is part of the +\LPack{xkeyval}-package, and that all packages that use the old keyval interface are loaded \textbf{before} the -\verb+xkeyval+.\cite{xkeyval} -\item the option \verb+tickstyle+ from \verb+pst-plot+ is no longer supported; use \verb+ticksize+ instead. -\item the option \verb+xyLabel+ is no longer supported; use the option \verb+labelFontSize+ instead. -\item if \verb+pstricks-add+ is loaded together with the package \texttt{pst-func} then \texttt{InsideArrow} - of the \CMD{psbezier} macro doesn't work! +\LPack{xkeyval}.\cite{xkeyval} +\item the option \Lkeyword{tickstyle} from \LPack{pst-plot} is no longer supported; use \Lkeyword{ticksize} instead. +\item the option \Lkeyword{xyLabel} is no longer supported; use the option \Lkeyword{labelFontSize} instead. +\item if \LPack{pstricks-add} is loaded together with the package \LPack{pst-func} then \Lkeyword{InsideArrow} + of the \Lcs{psbezier} macro doesn't work! \end{itemize} +\vfill +\noindent +Thanks to: +Hendri Adriaens; +Stefano Baroni; +Martin Chicoine; +Gerry Coombes; +Ulrich Dirr; +Christophe Fourey; +Hubert G\"a\ss lein; +J\"urgen Gilg; +Denis Girou; +Peter Hutnick; +Christophe Jorssen; +Uwe Kern; +Manuel Luque; +Jens-Uwe Morawski; +Tobias N\"ahring; +Rolf Niepraschk; +Alan Ristow; +Arnaud Schmittbuhl; +Timothy Van Zandt \end{abstract} \clearpage @@ -1111,7 +170,7 @@ keyval interface are loaded \textbf{before} the \section{Numeric functions} %-------------------------------------------------------------------------------------- -All macros contain a \textat{} in their name, because they are +All macros have a \textat{} in their name, because they are only for internal use, but it is no problem to use them like other macros. One can define another name without a \textat{}: \begin{lstlisting}[style=syntax] @@ -1120,20 +179,20 @@ macros. One can define another name without a \textat{}: \makeatother \end{lstlisting} -or put the macro inside the \verb+\makeatletter+ -- -\verb+\makeatother+ sequence. +or put the macro inside the \Lcs{makeatletter} -- +\Lcs{makeatother} sequence. %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}divide}} +\subsection{\nxLcs{pst@divide}} %-------------------------------------------------------------------------------------- -\verb+pstricks+ itself has its own divide macro, called -\verb+\pst@divide+, which can divide two lengths and save the -quotient as a floating point number: \index{Division} +\LPack{pstricks} itself has its own divide macro, called +\Lcs{pst@divide}, which can divide two lengths and save the +quotient as a \Index{floating point} number: \index{Division} % -\begin{lstlisting}[style=syntax] -\pst@divide{<dividend>}{<divisor>}{<result as a macro>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@divide}\Largb{dividend}\Largb{divisor}\Largb{result as a macro} +\end{BDef} \begin{LTXexample}[width=2cm] \makeatletter @@ -1145,14 +204,14 @@ quotient as a floating point number: \index{Division} \noindent this gives the output $5.66666$. The result is not a length! %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}mod}} +\subsection{\nxLcs{pst@mod}} %-------------------------------------------------------------------------------------- -\verb+pstricks-add+ defines an additional numeric function for the modulus: +\LPack{pstricks-add} defines an additional numeric function for the modulus: \index{Modulus} -\begin{lstlisting}[style=syntax] -\pst@mod{<integer>}{<integer>}{<result as a macro>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@mod}\Largb{integer}\Largb{integer}\Largb{result as a macro} +\end{BDef} \begin{LTXexample}[width=2cm] \makeatletter @@ -1168,12 +227,12 @@ some sense to define a new macroname in the preamble and use it throughout, e.g. \verb+\let\modulo\pst@mod+. %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}max}} +\subsection{\nxLcs{pst@max}} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\pst@max{<integer>}{<integer>}{<result as count register>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@max}\Largb{integer}\Largb{integer}\Largb{result as count register} +\end{BDef} \begin{LTXexample}[width=2cm] \newcount\maxNo @@ -1185,12 +244,12 @@ throughout, e.g. \verb+\let\modulo\pst@mod+. %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}maxdim}} +\subsection{\nxLcs{pst@maxdim}} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\pst@maxdim{<dimension>}{<dimension>}{<result as dimension register>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@maxdim}\Largb{dimension}\Largb{dimension}\Largb{result as a dimension register} +\end{BDef} \begin{LTXexample}[width=2cm] \newdimen\maxDim @@ -1201,12 +260,12 @@ throughout, e.g. \verb+\let\modulo\pst@mod+. \end{LTXexample} %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}mindim}} +\subsection{\nxLcs{pst@mindim}} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\pst@mindim{<dimension>}{<dimension>}{<result as dimension register>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@mindim}\Largb{dimension}\Largb{dimension}\Largb{result as dimension register} +\end{BDef} \begin{LTXexample}[width=2cm] \newdimen\minDim @@ -1217,12 +276,12 @@ throughout, e.g. \verb+\let\modulo\pst@mod+. \end{LTXexample} %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}abs}} +\subsection{\nxLcs{pst@abs}} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\pst@abs{<integer>}{<result as a count register>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@abs}\Largb{integer}\Largb{result as a count register} +\end{BDef} \begin{LTXexample}[width=2cm] \newcount\absNo @@ -1233,12 +292,12 @@ throughout, e.g. \verb+\let\modulo\pst@mod+. \end{LTXexample} %-------------------------------------------------------------------------------------- -\subsection{\CMD{pst\textat{}absdim}} +\subsection{\nxLcs{pst@absdim}} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\pst@absdim{<dimension>}{<result as a dimension register>} -\end{lstlisting} +\begin{BDef} +\Lcs{pst@absdim}\Largb{dimension}\Largb{result as a dimension register} +\end{BDef} \begin{LTXexample}[width=2cm] \newdimen\absDim @@ -1255,9 +314,9 @@ throughout, e.g. \verb+\let\modulo\pst@mod+. Tobias Nähring has implemented an enhanced feature for dashed lines. The number of arguments is no longer limited. -\begin{lstlisting}[style=syntax] -dash=value1[unit] value2[unit] ... -\end{lstlisting} +\begin{BDef} +\Lkeyword{dash}=value1\OptArg*{unit} value2\OptArg*{unit} \ldots +\end{BDef} \begin{LTXexample}[width=0.4\linewidth] \psset{linewidth=2.5pt,unit=0.6} @@ -1273,16 +332,16 @@ dash=value1[unit] value2[unit] ... \end{LTXexample} %-------------------------------------------------------------------------------------- -\section{\CMD{rmultiput}: a multiple \CMD{rput}} +\section{\nxLcs{rmultiput}: a multiple \nxLcs{rput}} %-------------------------------------------------------------------------------------- -\verb+PSTricks+ already has a \verb+multirput+, which puts a box n +\verb+PSTricks+ already has a \Lcs{multirput}, which puts a box n times with a difference of $dx$ and $dy$ relative to each other. It is not possible to put it with a different distance from one -point to the next. This is possible with \verb+rmultiput+: -\begin{lstlisting}[style=syntax] -\rmultiput[<options>]{<any material>}(x1,y1)(x2,y2) ... (xn,yn) -\rmultiput*[<options>]{<any material>}(x1,y1)(x2,y2) ... (xn,yn) -\end{lstlisting} +point to the next. This is possible with \Lcs{rmultiput}: + +\begin{BDef} +\LcsStar{rmultiput}\OptArgs\Largb{any material}\Largr{\Coord1}\Largr{\Coord2}\ldots\Largr{\Coord{n}} +\end{BDef} \begin{LTXexample}[width=6.2cm] \psset{unit=0.75} @@ -1305,9 +364,10 @@ it always depends on the \CMD{rput} coordinates. With \CMD{psrotate} the rotating center can be placed anywhere. The rotation is done with \verb+\pscustom+, all optional arguments are only valid if they are part of the \verb+\pscustom+ macro. -\begin{lstlisting}[style=syntax] -\psrotate[options](x,y){rot angle}{<object>} -\end{lstlisting} + +\begin{BDef} +\Lcs{psrotate}\OptArgs\Largr{$x,y$}\Largb{rot angle}\Largb{object} +\end{BDef} \begin{LTXexample}[width=0.4\linewidth] \psset{unit=0.75} @@ -1361,20 +421,21 @@ only valid if they are part of the \verb+\pscustom+ macro. \clearpage %-------------------------------------------------------------------------------------- -\section{\CMD{psChart}: a pie chart} +\section{\nxLcs{psChart}: a pie chart} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\psChart[<options>]{comma separated value list}{comma separated value list}{radius} -\end{lstlisting} +\begin{BDef} +\Lcs{psChart}\OptArgs\Largb{comma separated value list}\Largb{comma separated value list}\Largb{radius} +\end{BDef} -The special optional arguments for the \CMD{psChart} macro are as follows: +The special optional arguments for the \Lcs{psChart} macro are as follows: +\noindent \begin{tabularx}{\linewidth}{@{}>{\ttfamily}lX>{\ttfamily}l@{}} \textrm{\emph{name}} & \textrm{\emph{description}} & \textrm{\emph{default}}\\\hline -chartSep & distance from the pie chart center to an outraged pie piece & 10pt\\ -chartColor & gray or colored pie (values are: \texttt{gray} or \texttt{color})& gray\\ -userColor & a comma separated list of user defined colors for the pie & \{\} +\Lkeyword{chartSep} & distance from the pie chart center to an outraged pie piece & 10pt\\ +\Lkeyword{chartColor} & gray or colored pie (values are: \texttt{gray} or \texttt{color})& gray\\ +\Lkeyword{userColor} & a comma separated list of user defined colors for the pie & \{\} \end{tabularx} \bigskip @@ -1382,16 +443,16 @@ The first mandatory argument is the list of the values and may not be empty. The one is a list of outraged pieces, numbered consecutively from 1 to up the total number of values. The list of user defined colors must be enclosed in braces! -The macro \CMD{psChart} defines for every value three nodes at the half angle and +The macro \Lcs{psChart} defines for every value three nodes at the half angle and in distances from 0.75, 1, and 1.25 times of the radius from the origin. The nodes are named as \verb+psChartI?+, \verb+psChart?+, and \verb+psChartO?+, where ? is the number of the pie. The letter I leads to the inner node and the letter O to the outer node. -The distance can be changed with the optional arguments \verb+chartNodeI+ and -\verb+chartNodeO+ in the usual way with \verb+\psset{chartNodeI=...,chartNodeO=...}+. +The distance can be changed with the optional arguments \Lkeyword{chartNodeI} and +\Lkeyword{chartNodeO} in the usual way with \verb+\psset{chartNodeI=...,chartNodeO=...}+. The other one is the node on the circle line. The origin is by default \texttt{(0,0)}. Moving the pie to another position can be done as -usual with the \CMD{rput}-macro. The used colors are named internally as \verb+chartFillColor?+ +usual with the \Lcs{rput}-macro. The used colors are named internally as \verb+chartFillColor?+ and can be used by the user for coloring lines or text. @@ -1472,36 +533,37 @@ and can be used by the user for coloring lines or text. \clearpage %-------------------------------------------------------------------------------------- -\section{\CMD{psHomothetie}: central dilatation} +\section{\nxLcs{psHomothetie}: central dilatation} %-------------------------------------------------------------------------------------- -\begin{lstlisting}[style=syntax] -\psHomothetie[<options>](<center>){<factor>}{<object>} -\end{lstlisting} +\begin{BDef} +\Lcs{psHomothetie}\OptArgs\Largr{center}\Largb{factor}\Largb{object} +\end{BDef} \begin{LTXexample}[width=9cm] \begin{pspicture}[showgrid=true](-5,-4)(4,8) \psBill% needs package pst-fun \psHomothetie[linecolor=blue](4,-3){2}{\psBill} \psdots[dotsize=3pt,linecolor=red](4,-3) -\pstVerb{ /m -3 -0.85 sub 4 0.6 sub div def } -\psplot[linestyle=dashed,linecolor=red]{-5}{4}{ m x mul m 4 mul sub 3 sub } +\psplot[linestyle=dashed,linecolor=red]{-5}{4}% + [ /m -3 -0.85 sub 4 0.6 sub div def ] + { m x mul m 4 mul sub 3 sub }% \psHomothetie[linecolor=green](4,-3){-0.2}{\psBill} \end{pspicture} \end{LTXexample} +%\pstVerb{ /m -3 -0.85 sub 4 0.6 sub div def } \clearpage %-------------------------------------------------------------------------------------- -\section{\CMD{psbrace}} +\section{\nxLcs{psbrace}} %-------------------------------------------------------------------------------------- \subsection{Syntax} -\begin{lstlisting}[style=syntax] -\psbrace[<options>](<A>)(<B>){<text>} -\psbrace*[<options>](<A>)(<B>){<text>} -\end{lstlisting} +\begin{BDef} +\LcsStar{psbrace}\OptArgs\Largr{A}\Largr{B}\Largb{text} +\end{BDef} \begin{LTXexample}[width=4.5cm] @@ -1516,18 +578,18 @@ and can be used by the user for coloring lines or text. \end{LTXexample} \bigskip -The option \verb|\specialCoor| is enabled, so that all types of coordinates +The option \Lcs{specialCoor} is enabled, so that all types of coordinates are possible, (nodename), ($x,y$), ($nodeA|nodeB$), \ldots -The star version fills the inner of the brace with the current linecolor. +The star version fills the inner of the \Index{brace} with the current linecolor. With the fillcolor \verb+white+ or any other background color the brace can be "`unfilled"'. %-------------------------------------------------------------------------------------- \subsection{Options} %-------------------------------------------------------------------------------------- -Additional to all other available options from \verb|pstricks| or the other -related packages, there are two new option, named \verb|braceWidth| and -\verb|bracePos|. All important ones are shown in the following graphics +Additional to all other available options from \LPack{pstricks} or the other +related packages, there are two new option, named \Lkeyword{braceWidth} and +\Lkeyword{bracePos}. All important ones are shown in the following graphics and table. \begin{center} @@ -1546,32 +608,32 @@ and table. \end{pspicture} \end{center} -A positive value for \verb+nodesepA+ and \verb+nodesepB+ shifts the label to the upper right +A positive value for \Lkeyword{nodesepA} and \Lkeyword{nodesepB} shifts the label to the upper right and a negative value to the lower left. This does not depends on the value for the rotating of the label! \begin{center} -\begin{tabular}{l|l} +\begin{tabular}{@{}l|l@{}} name & meaning\\\hline -\verb|braceWidth| & default is \verb+2\pslinewidth+\\ -\verb|braceWidthInner| & default is \verb+10\pslinewidth+\\ -\verb|braceWidthOuter| & default is \verb+10\pslinewidth+\\ -\verb|bracePos| & relative position (default is $0.5$)\\ -\verb|nodesepA| & x-separation (default is $0pt$)\\ -\verb|nodesepB| & y-separation (default is $0pt$)\\ -\verb|rot| & additional rotating for the text (default is $0$)\\ -\verb|ref| & reference point for the text (default is c)\\ -\verb|fillcolor| & default is black +\Lkeyword{braceWidth} & default is \Lcs{pslinewidth}\\ +\Lkeyword{braceWidthInner} & default is \verb+10\pslinewidth+\\ +\Lkeyword{braceWidthOuter} & default is \verb+10\pslinewidth+\\ +\Lkeyword{bracePos} & relative position (default is $0.5$)\\ +\Lkeyword{nodesepA} & x-separation (default is $0pt$)\\ +\Lkeyword{nodesepB} & y-separation (default is $0pt$)\\ +\Lkeyword{rot} & additional rotating for the text (default is $0$)\\ +\Lkeyword{ref} & reference point for the text (default is c)\\ +\Lkeyword{fillcolor} & default is black \end{tabular} \end{center} By default the text is written perpendicular to the brace line and -can be changed with the \verb|pstricks| option \verb|rot=...|. The +can be changed with the \LPack{pstricks} option \Lkeyword{rot}=\ldots\ The text parameter can take any object and may also be empty. The -reference point can be any value of the combination of \verb|l| -(left) or \verb|r| (right) and \verb|b| (bottom) or \verb|B| -(Baseline) or \verb|C| (center) or \verb|t| (top), where the -default is \verb|c|, the center of the object. +reference point can be any value of the combination of \Lkeyval{l} +(left) or \Lkeyval{r} (right) and \Lkeyval{b} (bottom) or \Lkeyval{B} +(Baseline) or \Lkeyval{C} (center) or \Lkeyval{t} (top), where the +default is \Lkeyval{c}, the center of the object. %-------------------------------------------------------------------------------------- %\subsection{Examples} @@ -1653,7 +715,7 @@ default is \verb|c|, the center of the object. \end{LTXexample} -\clearpage It is also possible to put a vertical brace around a +It is also possible to put a vertical brace around a default paragraph. This works by setting two invisible nodes at the beginning and the end of the paragraph. Indentation is possible with a minipage. @@ -1738,26 +800,28 @@ Some nonsense text, which is nothing more than nonsense. %-------------------------------------------------------------------------------------- \section{Random dots} %-------------------------------------------------------------------------------------- -The syntax of the new macro \verb+\psRandom+ is: +The syntax of the new macro \Lcs{psRandom} is: -\begin{lstlisting}[style=syntax] -\psRandom[<option>]{} -\psRandom[<option>]{<clip path>} -\psRandom[<option>](<xMax,yMax>){<clip path>} -\psRandom[<option>](<xMin,yMin>)(<xMax,yMax>){<clip path>} -\end{lstlisting} +\begin{BDef} +\Lcs{psRandom}\OptArgs\Largb{}\\ +\Lcs{psRandom}\OptArgs\OptArg*{\Largr{$x_{Min},y_{Min}$}}\OptArg*{\Largr{$x_{Max},y_{Max}$}}\Largb{clip path} %$ +%\psRandom[<option>](<xMax,yMax>){<clip path>} +%\psRandom[<option>](<xMin,yMin>)(<xMax,yMax>){<clip path>} +\end{BDef} -If there is no area for the dots defined, then \verb+(0,0)(1,1)+ in the actual -scale is used for placing the dots. This area should be greater than the clipping +If there is no area for the dots defined, then \verb+(0,0)(1,1)+ in the current +scale setting is used for placing the dots. If there is only one \Largr{$x_{Max},y_{Max}$} %$ +defined, then \verb+(0,0)+ is used for the other point. +This area should be greater than the clipping path to be sure that the dots are placed over the full area. The clipping path can be everything. If no clipping path is given, then the frame \verb+(0,0)(1,1)+ in user coordinates is used. The new options are: \begin{center} -\begin{tabular}{l|l|l} +\begin{tabular}{@{}l|l|l@{}} name & default\\\hline -\verb|randomPoints| & \verb|1000| & number of random dots\tabularnewline -\verb|color| & \verb+false+ & random color\tabularnewline +\Lkeyword{randomPoints} & \verb|1000| & number of random dots\tabularnewline +\Lkeyword{color} & \false & random color\tabularnewline \end{tabular} \end{center} @@ -1799,11 +863,11 @@ name & default\\\hline %-------------------------------------------------------------------------------------- \section{Dice} %-------------------------------------------------------------------------------------- -\CMD{psdice} creates the view of a dice. The number on the dice is the only parameter. +\Lcs{psdice} creates the view of a dice. The number on the dice is the only parameter. The optional parameters, like the color can be used as usual. The macro is a box of dimension zero and is placed -at the current point. Use the \CMD{rput} macro to place it anywhere. The optional -argument \texttt{unit} can be used to scale the dice. the default size of +at the current point. Use the \Lcs{rput} macro to place it anywhere. The optional +argument \Lkeyword{unit} can be used to scale the dice. the default size of the dice $1\mathrm{cm}\times1\mathrm{cm}$. \begin{center} @@ -1814,17 +878,13 @@ the dice $1\mathrm{cm}\times1\mathrm{cm}$. \multido{\iB=1+1}{6}{% \rput(! \iA\space 7 \iB\space sub){% \rnode[c]{p\iA\iB}{\makebox[1em][l]{\strut\psPrintValue[fontscale=12]{\iA\space \iB\space add}}}% - }% - }% -} -% +}}} \ncbox[linearc=0.35,nodesep=0.2,linestyle=dotted]{p11}{p66} \ncbox[linearc=0.35,nodesep=0.2,linestyle=dashed]{p15}{p51} \rput{90}(-1.5,3.5){1. dice} \rput{0}(3.5,8.5){2. dice} \psline[linewidth=1.5pt](0.25,0.5)(0.25,8) \psline[linewidth=1.5pt](-1,6.75)(6.5,6.75) -% \end{pspicture} \end{center} @@ -1836,17 +896,13 @@ the dice $1\mathrm{cm}\times1\mathrm{cm}$. \multido{\iB=1+1}{6}{% \rput(! \iA\space 7 \iB\space sub){% \rnode[c]{p\iA\iB}{\makebox[1em][l]{\strut\psPrintValue[fontscale=12]{\iA\space \iB\space add}}}% - }% - }% -} -% +}}} \ncbox[linearc=0.35,nodesep=0.2,linestyle=dotted]{p11}{p66} \ncbox[linearc=0.35,nodesep=0.2,linestyle=dashed]{p15}{p51} \rput{90}(-1.5,3.5){1. dice} \rput{0}(3.5,8.5){2. dice} \psline[linewidth=1.5pt](0.25,0.5)(0.25,8) \psline[linewidth=1.5pt](-1,6.75)(6.5,6.75) -% \end{pspicture} \end{lstlisting} @@ -1856,50 +912,51 @@ the dice $1\mathrm{cm}\times1\mathrm{cm}$. %-------------------------------------------------------------------------------------- \subsection{Definition} %-------------------------------------------------------------------------------------- -\verb|pstricks-add| defines the following ''arrows``: +\LPack{pstricks-add} defines the following "`arrows"': \begin{center} \bgroup \def\myline#1{\psline[linecolor=red,linewidth=0.5pt,arrowscale=1.5]{#1}(0,1ex)(1.3,1ex)}% \psset{arrowscale=1.5} - \begin{tabular}{c@{\qquad}p{3cm}l}% + \begin{tabular}{@{} c @{\qquad} p{3cm} l @{}}% Value & Example & Name \\[2pt]\hline - \verb/-/ & \myline{-} & None\\ - \verb/<->/ & \myline{<->} & Arrowheads.\\ - \verb/>-</ & \myline{>-<} & Reverse arrowheads.\\ - \verb/<<->>/ & \myline{<<->>} & Double arrowheads.\\ - \verb/>>-<</ & \myline{>>-<<} & Double reverse arrowheads.\\ - \verb/|-|/ & \myline{|-|} & T-bars, flush to endpoints.\\ - \verb/|*-|*/ & \myline{|*-|*} & T-bars, centered on endpoints.\\ - \verb/[-]/ & \myline{[-]} & Square brackets.\\ - \verb/]-[/ & \myline{]-[} & Reversed square brackets.\\ - \verb/(-)/ & \myline{(-)} & Rounded brackets.\\ - \verb/)-(/ & \myline{)-(} & Reversed rounded brackets.\\ - \verb/o-o/ & \myline{o-o} & Circles, centered on endpoints.\\ - \verb/*-*/ & \myline{*-*} & Disks, centered on endpoints.\\ - \verb/oo-oo/ & \myline{oo-oo} & Circles, flush to endpoints.\\ - \verb/**-**/ & \myline{**-**} & Disks, flush to endpoints.\\ - \verb/|<->|/ & \myline{|<->|} & T-bars and arrows.\\ - \verb/|>-<|/ & \myline{|>-<|} & T-bars and reverse arrows.\\ - \verb/h-h|/ & \myline{h-h} & left/right hook arrows.\\ - \verb/H-H|/ & \myline{H-H} & left/right hook arrows.\\ - \verb/v-v|/ & \myline{v-v} & left/right inside vee arrows.\\ - \verb/V-V|/ & \myline{V-V} & left/right outside vee arrows.\\ - \verb/f-f|/ & \myline{f-f} & left/right inside filled arrows.\\ - \verb/F-F|/ & \myline{F-F} & left/right outside filled arrows.\\ - \verb/t-t|/ & \myline{t-t} & left/right inside slash arrows.\\[5pt] - \verb/T-T|/ & \myline{T-T} & left/right outside slash arrows.\\ + \Lnotation{-} & \myline{-} & None\\ + \Lnotation{<->} & \myline{<->} & Arrowheads.\\ + \Lnotation{>-<} & \myline{>-<} & Reverse arrowheads.\\ + \Lnotation{<{<}-{>}>} & \myline{<<->>} & Double arrowheads.\\ + \Lnotation{{>}>-{<}<} & \myline{>>-<<} & Double reverse arrowheads.\\ + \Lnotation{{|}-{|}} & \myline{|-|} & T-bars, flush to endpoints.\\ + \Lnotation{{|}*-{|}*} & \myline{|*-|*} & T-bars, centered on endpoints.\\ + \Lnotation{[-]} & \myline{[-]} & Square brackets.\\ + \Lnotation{]-[} & \myline{]-[} & Reversed square brackets.\\ + \Lnotation{(-)} & \myline{(-)} & Rounded brackets.\\ + \Lnotation{)-(} & \myline{)-(} & Reversed rounded brackets.\\ + \Lnotation{o-o} & \myline{o-o} & Circles, centered on endpoints.\\ + \Lnotation{*-*} & \myline{*-*} & Disks, centered on endpoints.\\ + \Lnotation{oo-oo} & \myline{oo-oo} & Circles, flush to endpoints.\\ + \Lnotation{**-**} & \myline{**-**} & Disks, flush to endpoints.\\ + \Lnotation{{|}<->{|}} & \myline{|<->|} & T-bars and arrows.\\ + \Lnotation{{|}>-<{|}} & \myline{|>-<|} & T-bars and reverse arrows.\\ + \Lnotation{h-h{|}} & \myline{h-h} & left/right hook arrows.\\ + \Lnotation{H-H{|}} & \myline{H-H} & left/right hook arrows.\\ + \Lnotation{v-v|} & \myline{v-v} & left/right inside vee arrows.\\ + \Lnotation{V-V|} & \myline{V-V} & left/right outside vee arrows.\\ + \Lnotation{f-f|} & \myline{f-f} & left/right inside filled arrows.\\ + \Lnotation{F-F|} & \myline{F-F} & left/right outside filled arrows.\\ + \Lnotation{t-t|} & \myline{t-t} & left/right inside slash arrows.\\[5pt] + \Lnotation{T-T|} & \myline{T-T} & left/right outside slash arrows.\\ \end{tabular} \egroup \end{center} -You can also mix and match, e.g., \verb/->/, \verb/*-)/ and \verb/[->/ are all valid values -of the \verb|arrows| parameter. The parameter can be set with -\begin{lstlisting}[style=syntax] -\psset{arrows=<type>} -\end{lstlisting} +You can also mix and match, e.g., \Lnotation{->}, \Lnotation{*-)} and \Lnotation{[->} are all valid values +of the \Lkeyword{arrows} parameter. The parameter can be set with + +\begin{BDef} +\Lcs{psset}\Largb{arrows=<type>} +\end{BDef} \noindent or for some macros with a special option, like\\[5pt] \noindent\verb|\psline[<general options>]{<arrow type>}(A)(B)|\\ @@ -1912,16 +969,16 @@ is declared in the following tables. Without setting one of these parameters the is like the one described in the old PSTricks manual. \begin{center} - \begin{tabular}{lc}% +\begin{tabular}{@{}lc@{}}% Value & Meaning \\[2pt]\hline - \verb+->>+ & \ -A \\ - \verb+<<->>+ & A-A\\ - \verb+<<-+ & A-\ \\ - \verb+>>-+ & B-\ \\ - \verb+-<<+ & \ -B\\ - \verb+>>-<<+ & B-B\\ - \verb+>>->>+ & B-A\\ - \verb+<<-<<+ & A-B + \Lnotation{-{>}>} & \ -A \\ + \Lnotation{{<}<-{>}>} & A-A\\ + \Lnotation{{<}<-} & A-\ \\ + \Lnotation{{>}>-} & B-\ \\ + \Lnotation{-{<}<} & \ -B\\ + \Lnotation{{>}>-{<}<} & B-B\\ + \Lnotation{{>}>-{>}>} & B-A\\ + \Lnotation{{<}<-{<}<} & A-B \end{tabular} \end{center} @@ -1955,7 +1012,8 @@ is like the one described in the old PSTricks manual. \subsection{\texttt{hookarrow}} -\begin{LTXexample} +%\begin{LTXexample} +\bgroup \psset{arrowsize=8pt,arrowlength=1,linewidth=1pt,nodesep=2pt,shortput=tablr} \large \begin{psmatrix}[colsep=12mm,rowsep=10mm] @@ -1974,19 +1032,38 @@ $e_b:S$ & 1 & & 1 & 0 \\ \ncline{-h}{3,4}{3,5}^{$e_5$} \ncline{-h}{3,5}{2,5}<{$e_{r3}$}>{$f_{r3}$} \ncline{-h}{4,3}{5,3}<{$e_{r1}$}>{$f_{r1}$} -\end{LTXexample} +%\end{LTXexample} +\egroup + +\begin{lstlisting} +\psset{arrowsize=8pt,arrowlength=1,linewidth=1pt,nodesep=2pt,shortput=tablr} +\large +\begin{psmatrix}[colsep=12mm,rowsep=10mm] + & & $R_2$ \\ + & & 0 & & $R_3$\\ +$e_b:S$ & 1 & & 1 & 0 \\ + & & 0 \\ + & & $R_1$ \\ +\end{psmatrix} +\ncline{h-}{1,3}{2,3}<{$e_{r2}$}>{$f_{r2}$}\ncline{-h}{2,3}{3,2}<{$e_1$} +\ncline{-h}{3,1}{3,2}^{$e_s$}_{$f_{s}$} \ncline{-h}{3,2}{4,3}>{$e_3$}<{$f_3$} +\ncline{-h}{4,3}{3,4}>{$e_4$}<{$f_4$} \ncline{-h}{3,4}{2,3}>{$e_2$}<{$f_2$} +\ncline{-h}{3,4}{3,5}^{$e_5$} +\ncline{-h}{3,5}{2,5}<{$e_{r3}$}>{$f_{r3}$} +\ncline{-h}{4,3}{5,3}<{$e_{r1}$}>{$f_{r1}$} +\end{lstlisting} \subsection{\texttt{hookrightarrow} and \texttt{hookleftarrow}} -This is another type of arrow and is abbreviated with \verb+H+. +This is another type of arrow and is abbreviated with \Lnotation{H}. The length and width of the hook is set by the new options -\verb+hooklength+ and \verb+hookwidth+, which are by default set +\Lkeyword{hooklength} and \Lkeyword{hookwidth}, which are by default set to % -\begin{lstlisting}[style=syntax] -\psset{hooklength=3mm,hookwidth=1mm} -\end{lstlisting} +\begin{BDef} +\Lcs{psset}\Largb{hooklength=3mm,hookwidth=1mm} +\end{BDef} % If the line begins with a right hook then the line ends with a left hook and vice versa: @@ -2000,7 +1077,6 @@ If the line begins with a right hook then the line ends with a left hook and vic \end{LTXexample} - \begin{LTXexample}[width=7.25cm] $\begin{psmatrix} E&W_i(X)&&Y\\ @@ -2017,7 +1093,7 @@ E&W_i(X)&&Y\\ %-------------------------------------------------------------------------------------- -\subsection{\texttt{ArrowInside} Option} +\subsection{\nxLkeyword{ArrowInside} Option} %-------------------------------------------------------------------------------------- It is now possible to have arrows inside lines and not only at the @@ -2029,49 +1105,49 @@ Name & Example & Output\\\hline \endfirsthead Name & Example & Output\\\hline \endhead -\texttt{ArrowInside} & +\Lkeyword{ArrowInside} & \texttt{\textbackslash psline[ArrowInside=->](0,0)(2,0)} & \psline[ArrowInside=->](0,0.1)(2,0.1) \\ -\texttt{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsidePos=0.25](0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsidePos=0.25](0,0.1)(2,0.1) \\ -\texttt{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsidePos=10](0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsidePos=10](0,0.1)(2,0.1) \\ -\texttt{ArrowInsideNo} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsideNo} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsideNo=2](0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsideNo=2](0,0.1)(2,0.1) \\ -\texttt{ArrowInsideOffset} & \texttt{\textbackslash psline[ArrowInside=->,\%} - \hspace*{20pt}\texttt{ArrowInsideNo=2,\%} +\Lkeyword{ArrowInsideOffset} & \texttt{\textbackslash psline[ArrowInside=->,\%} + \hspace*{20pt}\texttt{ArrowInsideNo=2,\%}\newline \hspace*{20pt}\texttt{ArrowInsideOffset=0.1](0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsideNo=2,ArrowInsideOffset=0.1](0,0.1)(2,0.1) \\ % -\texttt{ArrowInside} & \texttt{\textbackslash psline[ArrowInside=->]\{->\}(0,0)(2,0)} & +\Lkeyword{ArrowInside} & \texttt{\textbackslash psline[ArrowInside=->]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->]{->}(0,0)(2,0)\\ -\texttt{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsidePos=0.25]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsidePos=0.25]{->}(0,0)(2,0) \\ -\texttt{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsidePos} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsidePos=10]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsidePos=10]{->}(0,0)(2,0) \\ -\texttt{ArrowInsideNo} & \texttt{\textbackslash psline[ArrowInside=->,\%} +\Lkeyword{ArrowInsideNo} & \texttt{\textbackslash psline[ArrowInside=->,\%} \hspace*{20pt}\texttt{ArrowInsideNo=2]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsideNo=2]{->}(0,0)(2,0) \\ -\texttt{ArrowInsideOffset} & \texttt{\textbackslash psline[ArrowInside=->,\%} - \hspace*{20pt}\texttt{ArrowInsideNo=2,\%} +\Lkeyword{ArrowInsideOffset} & \texttt{\textbackslash psline[ArrowInside=->,\%} + \hspace*{20pt}\texttt{ArrowInsideNo=2,\%}\newline \hspace*{20pt}\texttt{ArrowInsideOffset=0.1]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->, ArrowInsideNo=2,ArrowInsideOffset=0.1]{->}(0,0)(2,0) \\ % -\texttt{ArrowFill} & \texttt{\textbackslash psline[ArrowFill=false,\%} +\Lkeyword{ArrowFill} & \texttt{\textbackslash psline[ArrowFill=false,\%} \hspace*{20pt}\texttt{arrowinset=0]\{->\}(0,0)(2,0)} & \psline[ArrowFill=false,arrowinset=0]{->}(0,0)(2,0)\\ -\texttt{ArrowFill} & \texttt{\textbackslash psline[ArrowFill=false,\%} +\Lkeyword{ArrowFill} & \texttt{\textbackslash psline[ArrowFill=false,\%} \hspace*{20pt}\texttt{arrowinset=0]\{<<->>\}(0,0)(2,0)} & \psline[ArrowFill=false,arrowinset=0]{<<->>}(0,0)(2,0)\\ -\texttt{ArrowFill} & \texttt{\textbackslash psline[ArrowInside=->,\%} - \hspace*{20pt}\texttt{arrowinset=0,\%}\hspace{30pt} - \hspace*{20pt}\texttt{ArrowFill=false,\%}\hspace{30pt} - \hspace*{20pt}\texttt{ArrowInsideNo=2,\%} +\Lkeyword{ArrowFill} & \texttt{\textbackslash psline[ArrowInside=->,\%} + \hspace*{20pt}\texttt{arrowinset=0,\%}\newline + \hspace*{20pt}\texttt{ArrowFill=false,\%}\newline + \hspace*{20pt}\texttt{ArrowInsideNo=2,\%}\newline \hspace*{20pt}\texttt{ArrowInsideOffset=0.1]\{->\}(0,0)(2,0)} & \psline[ArrowInside=->, ArrowFill=false,ArrowInsideNo=2,ArrowInsideOffset=0.1]{->}(0,0)(2,0) \\ \end{longtable} @@ -2086,57 +1162,60 @@ absolute position difference, then choose a value greater than \verb|1|, e.g. \verb|10| which places an arrow every 10 pt. The default unit \verb|pt| cannot be changed. +\medskip \noindent \begin{tabularx}{\linewidth}{@{\color{red}\vrule width 2pt}lX@{}} -& The \verb+ArrowInside+ takes only arrow definitions like \verb+->+ into account. -Arrows from right to left (\verb+<-+) are not possible and ignored. If you need +& The \Lkeyword{ArrowInside} takes only arrow definitions like \Lnotation{->} into account. +Arrows from right to left (\Lnotation{<-}) are not possible and ignored. If you need such arrows, change the order of the pairs of coordinates for the line or curve macro. \end{tabularx} %-------------------------------------------------------------------------------------- -\subsection{\texttt{ArrowFill} Option} +\subsection{\nxLkeyword{ArrowFill} Option} %-------------------------------------------------------------------------------------- By default all arrows are filled polygons. With the option -\verb|ArrowFill=false| there are ''white`` arrows. Only for the +\Lkeyset{ArrowFill=false} there are ''white`` arrows. Only for the beginning/end arrows are they empty, the inside arrows are overpainted by the line. +\psset{arrowscale=1} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=red,arrowinset=0]{<->}(0,0)(3,0) +\psset{arrowscale=2.5} +\psline[linecolor=red,arrowinset=0]{<->}(-1,0)(2,0) \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=red,arrowinset=0,ArrowFill=false]{<->}(0,0)(3,0) +\psset{arrowscale=2.5} +\psline[linecolor=red,arrowinset=0,ArrowFill=false]{<->}(-1,0)(2,0) \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=red,arrowinset=0,arrowsize=0.2,ArrowFill=false]{<->}(0,0)(3,0) +\psset{arrowscale=2.5} +\psline[linecolor=red,arrowinset=0,arrowsize=0.2, + ArrowFill=false]{<->}(-1,0)(2,0) \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=blue,arrowscale=6,ArrowFill=true]{>>->>}(0,0)(3,0) +\psline[linecolor=blue,arrowscale=4, + ArrowFill]{>>->>}(-1,0)(2,0) \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=blue,arrowscale=6,ArrowFill=false]{>>->>}(0,0)(3,0) +\psline[linecolor=blue,arrowscale=4, + ArrowFill=false]{>>->>}(-1,0)(2,0) \rule{3cm}{0pt}\\[30pt] \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=blue,arrowscale=6,ArrowFill=true]{>|->|}(0,0)(3,0) +\psline[linecolor=blue,arrowscale=4, + ArrowFill]{>|->|}(-1,0)(2,0) \end{LTXexample} \begin{LTXexample}[width=3.5cm] -\psset{arrowscale=3} -\psline[linecolor=blue,arrowscale=6,ArrowFill=false]{>|->|}(0,0)(3,0)% +\psline[linecolor=blue,arrowscale=4, + ArrowFill=false]{>|->|}(-1,0)(2,0)% \end{LTXexample} @@ -2145,7 +1224,7 @@ overpainted by the line. %-------------------------------------------------------------------------------------- All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. -\subsubsection{\CMD{psline}} +\subsubsection{\nxLcs{psline}} \bigskip \begin{LTXexample}[width=2.5cm] @@ -2247,9 +1326,9 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \end{pspicture} \end{LTXexample} - +\clearpage %-------------------------------------------------------------------------------------- -\subsubsection{\CMD{pspolygon}} +\subsubsection{\nxLcs{pspolygon}} %-------------------------------------------------------------------------------------- % Polygons (\pspolygon macro) @@ -2307,7 +1386,7 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. %-------------------------------------------------------------------------------------- -\subsubsection{\CMD{psbezier}} +\subsubsection{\nxLcs{psbezier}} %-------------------------------------------------------------------------------------- % Bezier curves (\psbezier macro) @@ -2315,13 +1394,13 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \begin{LTXexample}[width=3.5cm] \begin{pspicture}(3,3) \psset{arrowscale=2} - \psbezier[ArrowInside=-|](1,1)(2,2)(3,3) + \psbezier[ArrowInside=-|](0,1)(1,0)(2,1)(3,3) \psset{linestyle=none,ArrowInside=-o} - \psbezier[ArrowInsidePos=0.25](1,1)(2,2)(3,3) - \psbezier[ArrowInsidePos=0.75](1,1)(2,2)(3,3) + \psbezier[ArrowInsidePos=0.25](0,1)(1,0)(2,1)(3,3) + \psbezier[ArrowInsidePos=0.75](0,1)(1,0)(2,1)(3,3) \psset{linestyle=none,ArrowInside=-*} - \psbezier[ArrowInsidePos=0](1,1)(2,2)(3,3) - \psbezier[ArrowInsidePos=1](1,1)(2,2)(3,3) + \psbezier[ArrowInsidePos=0](0,1)(1,0)(2,1)(3,3) + \psbezier[ArrowInsidePos=1](0,1)(1,0)(2,1)(3,3) \end{pspicture} \end{LTXexample} @@ -2330,16 +1409,15 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \begin{pspicture}(4,3) \psset{arrowscale=2} \psbezier[ArrowInside=->,showpoints=true]% - {*-*}(2,3)(3,0)(4,2) + {*-*}(0,0)(2,3)(3,0)(4,2) \end{pspicture} \end{LTXexample} - \begin{LTXexample}[width=4.5cm] \begin{pspicture}(4,3) \psset{arrowscale=2} - \psbezier[ArrowInside=->,showpoints=true,% - ArrowInsideNo=2](2,3)(3,0)(4,2) + \psbezier[ArrowInside=->,showpoints=true, + ArrowInsideNo=2](0,0)(2,3)(3,0)(4,2) \end{pspicture} \end{LTXexample} @@ -2347,8 +1425,9 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \begin{LTXexample}[width=4.5cm] \begin{pspicture}(4,3) \psset{arrowscale=2} - \psbezier[ArrowInside=->,showpoints=true,% - ArrowInsideNo=2,ArrowInsideOffset=-0.2]{->}(2,3)(3,0)(4,2) + \psbezier[ArrowInside=->,showpoints=true, + ArrowInsideNo=2,ArrowInsideOffset=-0.2]% + {->}(0,0)(2,3)(3,0)(4,2) \end{pspicture} \end{LTXexample} @@ -2357,7 +1436,7 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \begin{pspicture}(5,3) \psset{arrowscale=2} \psbezier[ArrowInsideNo=9,ArrowInside=-|,% - showpoints=true]{*-*}(1,3)(3,0)(5,3) + showpoints=true]{*-*}(0,0)(1,3)(3,0)(5,3) \end{pspicture} \end{LTXexample} @@ -2367,7 +1446,7 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \psset{ArrowInside=-|} \psbezier[ArrowInsidePos=0.25,showpoints=true]{*-*}(2,3)(3,0)(4,2) \psset{linestyle=none} - \psbezier[ArrowInsidePos=0.75](2,3)(3,0)(4,2) + \psbezier[ArrowInsidePos=0.75](0,0)(2,3)(3,0)(4,2) \end{pspicture} \end{LTXexample} @@ -2378,13 +1457,13 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. \psbezier[ArrowInside=->,% showpoints=true](A)(B)(C) \psset{linestyle=none,ArrowInside=-<} - \psbezier[ArrowInsideNo=4](A)(B)(C) + \psbezier[ArrowInsideNo=4](0,0)(A)(B)(C) \psset{ArrowInside=-o} - \psbezier[ArrowInsidePos=0.1](A)(B)(C) - \psbezier[ArrowInsidePos=0.9](A)(B)(C) + \psbezier[ArrowInsidePos=0.1](0,0)(A)(B)(C) + \psbezier[ArrowInsidePos=0.9](0,0)(A)(B)(C) \psset{ArrowInside=-*} - \psbezier[ArrowInsidePos=0.3](A)(B)(C) - \psbezier[ArrowInsidePos=0.7](A)(B)(C) + \psbezier[ArrowInsidePos=0.3](0,0)(A)(B)(C) + \psbezier[ArrowInsidePos=0.7](0,0)(A)(B)(C) \end{pspicture} \end{LTXexample} @@ -2400,7 +1479,7 @@ All examples are printed with \verb|\psset{arrowscale=2,linecolor=red}|. %-------------------------------------------------------------------------------------- -\subsubsection{\CMD{pcline}} +\subsubsection{\nxLcs{pcline}} %-------------------------------------------------------------------------------------- These examples need the package \verb|pst-node|. @@ -2445,7 +1524,7 @@ These examples need the package \verb|pst-node|. %-------------------------------------------------------------------------------------- -\subsubsection{\CMD{pccurve}} +\subsubsection{\nxLcs{pccurve}} %-------------------------------------------------------------------------------------- These examples also need the package \verb|pst-node|. @@ -2485,14 +1564,14 @@ Possible optional arguments are \begin{center} \begin{tabular}{l|l} name & meaning\\\hline -\verb|veearrowlength| & default is 3mm\\ -\verb|veearrowangle| & default is 30\\ -\verb|veearrowlinewidth| & default is 0.35mm\\ -\verb|filledveearrowlength| & default is 3mm\\ -\verb|filledveearrowangle| & default is 15\\ -\verb|filledveearrowlinewidth| & default is 0.35mm\\ -\verb|tickarrowlength| & default is 1.5mm\\ -\verb|tickarrowlinewidth| & default is 0.35mm\\ +\Lkeyword{veearrowlength} & default is 3mm\\ +\Lkeyword{veearrowangle} & default is 30\\ +\Lkeyword{veearrowlinewidth} & default is 0.35mm\\ +\Lkeyword{filledveearrowlength} & default is 3mm\\ +\Lkeyword{filledveearrowangle} & default is 15\\ +\Lkeyword{filledveearrowlinewidth} & default is 0.35mm\\ +\Lkeyword{tickarrowlength} & default is 1.5mm\\ +\Lkeyword{tickarrowlinewidth} & default is 0.35mm\\ \end{tabular} \end{center} @@ -2543,10 +1622,10 @@ name & meaning\\\hline \subsection{Special arrow option \texttt{arrowLW}} Only for the arrowtype \texttt{o} and \texttt{*} it is possible to -set the arrowlinewidth with the optional keyword \texttt{arrowLW}. -When scaling an arrow by the keyword \verb+\arrowscale+ the width +set the arrowlinewidth with the optional keyword \Lkeyword{arrowLW}. +When scaling an arrow by the keyword \Lkeyword{arrowscale} the width of the borderline is also scaled. With the optional argument -\texttt{arrowLW} the line width can be set separately and is not +\Lkeyword{arrowLW} the line width can be set separately and is not taken into account by the scaling value. \begin{LTXexample}[width=4cm] @@ -2562,12 +1641,12 @@ taken into account by the scaling value. \clearpage %-------------------------------------------------------------------------------------- -\section{\CMD{psFormatInt}} +\section{\nxLcs{psFormatInt}} %-------------------------------------------------------------------------------------- There exist some packages and a lot of code to format an integer like $1\,000\,000$ or $1,234,567$ (in Europe $1.234.567$). But all packages expect a real number as -argument and cannot handle macros as an argument. For this case \verb|pstricks-add| -has a macro \verb|psFormatInt| which can handle both: +argument and cannot handle macros as an argument. For this case \LPack{pstricks-add} +has a macro \Lcs{psFormatInt} which can handle both: \begin{LTXexample}[width=3cm] \psFormatInt{1234567}\\ @@ -2578,7 +1657,7 @@ has a macro \verb|psFormatInt| which can handle both: \psFormatInt{\temp} \end{LTXexample} -With the option \verb|intSeparator| the symbol can be changed to any any non-number character. +With the option \Lkeyword{intSeparator} the symbol can be changed to any any non-number character. %-------------------------------------------------------------------------------------- @@ -2598,7 +1677,7 @@ to run \verb+ps2pdf+ with the option \subsection{,,Manipulating transparent colors''} %-------------------------------------------------------------------------------------- -\verb+pstricks-add+ supports real transparency and a simulated one with hatch lines: +\LPack{pstricks-add} supports real transparency and a simulated one with hatch lines: \begin{lstlisting} \def\defineTColor{\@ifnextchar[{\defineTColor@i}{\defineTColor@i[]}} \def\defineTColor@i[#1]#2#3{% transparency "Colors" @@ -2641,9 +1720,9 @@ The \verb+xcolor+ package (version 2.6) has a new feature for defining colors: \definecolor[ps]{<name>}{<model>}{< PS code >} \end{lstlisting} -\verb+model+ can be one of the color models, which PostScript will +\verb+model+ can be one of the color models, which \PS will understand, e.g. \verb+rgb+. With this definition the color is -calculated on the PostScript side. +calculated on the \PS side. \begin{LTXexample}[pos=t,preset=\centering] \definecolor[ps]{bl}{rgb}{tx@addDict begin Red Green Blue end}% \psset{unit=1bp} @@ -2801,6 +1880,7 @@ be seen with Acroread 7 or later. The syntax is easy: \psset{unit=0.75cm} +\resetOptions \begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(0,-.25)(10,10) \psGTriangle(0,0)(5,10)(10,0){red}{green}{blue} @@ -2830,20 +1910,21 @@ be seen with Acroread 7 or later. The syntax is easy: \end{pspicture} \end{LTXexample} + \newpage %-------------------------------------------------------------------------------------- -\part{\texttt{pst-node}} +\part{\nxLPack{pst-node}} %-------------------------------------------------------------------------------------- %-------------------------------------------------------------------------------------- \section{Relative nodes with \CMD{psGetNodeCenter}} %-------------------------------------------------------------------------------------- -The command \CMD{psGetNodeCenter}\verb+{node}+ makes sense only at -the PostScript level. It defines the two variables \verb+node.x+ -and \verb+node.y+ which can be used to define relative nodes. The +The command \Lcs{psGetNodeCenter}\Largb{node} makes sense only at +the PostScript level. It defines the two variables \Larg{node.x} +and \Larg{node.y} which can be used to define relative nodes. The following example defines the node \verb+MyNode+ and a second one relative to the first one, with 4 units left and 4 units up. -\verb+node+ must be an existing node name. +\Larg{node} must be an existing node name. \begin{LTXexample}[width=5cm] \begin{pspicture}[showgrid=true,arrowscale=2](5,5) @@ -2858,14 +1939,14 @@ relative to the first one, with 4 units left and 4 units up. %-------------------------------------------------------------------------------------- -\section{\CMD{ncdiag} and \CMD{pcdiag}} +\section{\nxLcs{ncdiag} and \nxLcs{pcdiag}} %-------------------------------------------------------------------------------------- -With the new option \verb|lineAngle| the lines drawn by the \verb|ncdiag| macro +With the new option \Lkeyword{lineAngle} the lines drawn by the \Lcs{ncdiag} macro can now have a specified gradient. Without this option one has to define the two arms (which maybe zero) and PSTricks draws the connection between them. Now there -is only a static \verb|armA|, the second one \verb|armB| is calculated when an angle -\verb|lineAngle| is defined. This angle is the gradient of the intermediate line -between the two arms. The syntax of \verb|ncdiag| is +is only a static \Lkeyword{armA}, the second one \Lkeyword{armB} is calculated when an angle +\Lkeyword{lineAngle} is defined. This angle is the gradient of the intermediate line +between the two arms. The syntax of \Lcs{ncdiag} is \begin{lstlisting}[style=syntax] \ncdiag[<options>]{<Node A>}{<Node B>} @@ -2875,7 +1956,8 @@ between the two arms. The syntax of \verb|ncdiag| is \begin{tabularx}{\linewidth}{l|X} name & meaning\\\hline -\verb|lineAngle| & angle of the intermediate line segment. Default is 0, which is the same than using \verb|ncdiag| without the \verb|lineAngle| option.\tabularnewline +\verb|lineAngle| & angle of the intermediate line segment. Default is 0, which is the same +than using \Lcs{ncdiag} without the \Lkeyword{lineAngle} option.\tabularnewline \end{tabularx} @@ -2899,8 +1981,8 @@ name & meaning\\\hline \end{LTXexample} -The \verb|ncdiag| macro sets the \verb|armB| dynamically to the calculated value. Any -user setting of \verb|armB| is overwritten by the macro. The \verb|armA| could be set to +The \Lcs{ncdiag} macro sets the \Lkeyword{armB} dynamically to the calculated value. Any +user setting of \Lkeyword{armB} is overwritten by the macro. The \Lkeyword{armA} could be set to a zero length: @@ -2954,10 +2036,10 @@ a zero length: %-------------------------------------------------------------------------------------- \section{\CMD{ncdiagg} and \CMD{pcdiagg}} %-------------------------------------------------------------------------------------- -This is nearly the same as \verb+\ncdiag+ except that -\verb+armB=0+ and the \verb+angleB+ value is computed by the +This is nearly the same as \Lcs{ncdiag} except that +\Lkeyword{armB}=0 and the \Lkeyword{angleB} value is computed by the macro, so that the line ends at the node with an angle like a -\verb+\pcdiagg+ line. The syntax of \verb|ncdiagg|/\verb+pcdiagg+ +\Lcs{pcdiagg} line. The syntax of \Lcs{ncdiagg}/\Lcs{pcdiagg} is \begin{lstlisting}[style=syntax] @@ -3445,8 +2527,29 @@ starting from the first one. \clearpage %-------------------------------------------------------------------------------------- -\part{\texttt{pst-plot}} +\part{\nxLPack{pst-plot}} %-------------------------------------------------------------------------------------- +\section{New syntax} +There is now a new optional argument for \Lcs{psplot} and \Lcs{parametricplot} to pass +additional \PS commands into the code. This makes the use of \Lcs{pstVerb} in most cases superfluous. +\begin{BDef} +\Lcs{psplot}\OptArgs\Largb{x0}\Largb{x1}\OptArg{PS commands}\Largb{function}\\ +\Lcs{parametricplot}\OptArgs\Largb{t0}\Largb{t1}\OptArg{PS commands}\Largb{x(t) y(t)} +\end{BDef} + + +\begin{LTXexample}[pos=t,wide] +\begin{pspicture}(0,-0.5)(12,5) + \psaxes[Dx=100,dx=1,Dy=0.00075,dy=1]{->}(0,0)(12,5) + \psplot[linecolor=red, plotstyle=curve,linewidth=2pt,plotpoints=200]{0}{11}% + [ /const1 3.3 10 8 neg exp mul def /s 10 def /const2 6.04 10 6 neg exp mul def ]% + { const1 x 100 mul dup mul mul Euler const2 neg x 100 mul dup mul mul exp mul 2000 mul} +\end{pspicture} +\end{LTXexample} + + + + \section{ New options} %-------------------------------------------------------------------------------------- @@ -3464,7 +2567,7 @@ is possible. The following examples show how it can be used. The option \verb+tickstyle=full|top|bottom+ no longer works in the usual way. Only the additional value \texttt{inner} is valid for -\verb+pstricks-add+, because everything can be set by the +\LPack{pstricks-add}, because everything can be set by the \verb+ticksize+ option. When using the \verb+comma+ or \verb+trigLabels+ option, the macros \verb+\pshlabel+ and \verb+\psvlabel+ shouldn't be redefined, because the package does @@ -3489,68 +2592,69 @@ redefinition, then do it for \CMD{pst@@hlabel} and \endfirsthead \rowcolor{white}\textrm{\bfseries Name} & \textrm{\bfseries Type} & \textrm{\bfseries Default}\\\hline \endhead -labels & <all|x|y|none> & all\\%ok -xlabelPos & <bottom,axis,top>& bottom\\ -ylabelPos & <left,axis,right>& left\\ -xlabelFactor & <anything> & \{\textbackslash\@ empty\}\\ -ylabelFactor & <anything> & \{\textbackslash\@ empty\}\\ -labelFontSize & <fontsize macro> & \{\} \\ -trigLabels & false|true & false\\ -trigLabelBase & <number> & 0\\ -algebraic & false|true & false\\ %ok -comma & false|true & false\\ %ok -xAxis & false|true & true\\%ok -yAxis & false|true & true\\%ok -xyAxes & false|true & true\\%ok -xDecimals & <number> or empty & \{\}\\%ok -yDecimals & <number> or empty & \{\}\\%ok -xyDecimals & <number> or empty & \{\}\\%ok -%xLabel & <anything> & \{\}\\%ok -%yLabel & <anything> & \{\}\\%ok -%xyLabel & <anything> & \{\}\\%ok -ticks & <all|x|y|none> & all\\%ok -tickstyle & full|top|bottom|inner & full\\%ok -subticks & <number> & 0\\ -xsubticks & <number> & 0\\ -ysubticks & <number> & 0\\ -ticksize & <length [length]> & -4pt 4pt\\ -subticksize & <number> & 0.75\\ -tickwidth & <length> & 0.5\verb+\pslinewidth+\\ -subtickwidth & <length> & 0.25\verb+\pslinewidth+\\ -tickcolor & <color> & black\\ -xtickcolor & <color> & black\\ -ytickcolor & <color> & black\\ -subtickcolor & <color> & darkgray\\ -xsubtickcolor & <color> & darkgray\\ -ysubtickcolor & <color> & darkgray\\ -ticklinestyle & solid | dashed | dotted | none & solid\\ -subticklinestyle & solid | dashed | dotted | none & solid\\ -xlogBase & <number> or empty & \{\}\\ -ylogBase & <number> or empty & \{\}\\ -xylogBase & <number> or empty & \{\}\\ -logLines & <none|x|y|all> & none\\ -ignoreLines & <number> & 0\\ -nStep & <number> & 1\\ -nStart & <number> & 0\\ -nEnd & <number> or empty & \{\}\\ -xStep & <number> & 0\\ -yStep & <number> & 0\\ -xStart & <number> or empty & \{\}\\ -yStart & <number> or empty & \{\}\\ -xEnd & <number> or empty & \{\}\\ -yEnd & <number> or empty & \{\}\\ -plotNo & <number> & 1\\ -plotNoMax & <number> & 1\\ -xAxisLabel & <anything> & \{\textbackslash\@ empty\}\\ -yAxisLabel & <anything> & \{\textbackslash\@ empty\}\\ -xAxisLabelPos & <(x,y)> or empty & \{\textbackslash\@ empty\}\\ -yAxisLabelPos & <(x,y)> or empty & \{\textbackslash\@ empty\}\\ -llx & <length> & 0pt\\ -lly & <length> & 0pt\\ -urx & <length> & 0pt\\ -ury & <length> & 0pt\\ -polarplot & false|true & false\\ -ChangeOrder & false|true & false\\ +\Lkeyword{labels} & <\Lkeyval{all}|\Lkeyval{x}|\Lkeyval{y}|\Lkeyval{none}> & all\\%ok +\Lkeyword{xlabelPos} & <\Lkeyval{bottom},\Lkeyval{axis},\Lkeyval{top}>& \Lkeyval{bottom}\\ +\Lkeyword{ylabelPos} & <\Lkeyval{left},\Lkeyval{axis},\Lkeyval{right}>& left\\ +\Lkeyword{xlabelFactor} & <anything> & \{\textbackslash\@ empty\}\\ +\Lkeyword{ylabelFactor} & <anything> & \{\textbackslash\@ empty\}\\ +\Lkeyword{labelFontSize} & <fontsize macro> & \{\} \\ +\Lkeyword{trigLabels} & false|true & false\\ +\Lkeyword{trigLabelBase} & <number> & 0\\ +\Lkeyword{algebraic} & false|true & false\\ %ok +\Lkeyword{comma} & false|true & false\\ %ok +\Lkeyword{xAxis} & false|true & true\\%ok +\Lkeyword{yAxis} & false|true & true\\%ok +\Lkeyword{xyAxes} & false|true & true\\%ok +\Lkeyword{xDecimals} & <number> or empty & \{\}\\%ok +\Lkeyword{yDecimals} & <number> or empty & \{\}\\%ok +\Lkeyword{xyDecimals} & <number> or empty & \{\}\\%ok +%\Lkeyword{xLabel} & <anything> & \{\}\\%ok +%\Lkeyword{yLabel} & <anything> & \{\}\\%ok +%\Lkeyword{xyLabel} & <anything> & \{\}\\%ok +\Lkeyword{ticks} & <all|x|y|none> & all\\%ok +\Lkeyword{tickstyle} & \Lkeyval{full}|\Lkeyval{top}|\Lkeyval{bottom}|\Lkeyval{inner} & full\\%ok +\Lkeyword{subticks} & <number> & 0\\ +\Lkeyword{xsubticks} & <number> & 0\\ +\Lkeyword{ysubticks} & <number> & 0\\ +\Lkeyword{ticksize} & <length [length]> & -4pt 4pt\\ +\Lkeyword{subticksize} & <number> & 0.75\\ +\Lkeyword{tickwidth} & <length> & 0.5\verb+\pslinewidth+\\ +\Lkeyword{subtickwidth} & <length> & 0.25\verb+\pslinewidth+\\ +\Lkeyword{tickcolor} & <color> & black\\ +\Lkeyword{xtickcolor} & <color> & black\\ +\Lkeyword{ytickcolor} & <color> & black\\ +\Lkeyword{subtickcolor} & <color> & darkgray\\ +\Lkeyword{xsubtickcolor} & <color> & darkgray\\ +\Lkeyword{ysubtickcolor} & <color> & darkgray\\ +\Lkeyword{ticklinestyle} & \Lkeyval{solid} | \Lkeyval{dashed} | \Lkeyval{dotted} | \Lkeyval{none} & solid\\ +\Lkeyword{subticklinestyle} & solid | dashed | dotted | none & solid\\ +\Lkeyword{xlogBase} & <number> or empty & \{\}\\ +\Lkeyword{ylogBase} & <number> or empty & \{\}\\ +\Lkeyword{xylogBase} & <number> or empty & \{\}\\ +\Lkeyword{logLines} & <none|x|y|all> & none\\ +\Lkeyword{yMaxValue} & <real> & -1\\ +\Lkeyword{ignoreLines} & <number> & 0\\ +\Lkeyword{nStep} & <number> & 1\\ +\Lkeyword{nStart} & <number> & 0\\ +\Lkeyword{nEnd} & <number> or empty & \{\}\\ +\Lkeyword{xStep} & <number> & 0\\ +\Lkeyword{yStep} & <number> & 0\\ +\Lkeyword{xStart} & <number> or empty & \{\}\\ +\Lkeyword{yStart} & <number> or empty & \{\}\\ +\Lkeyword{xEnd} & <number> or empty & \{\}\\ +\Lkeyword{yEnd} & <number> or empty & \{\}\\ +\Lkeyword{plotNo} & <number> & 1\\ +\Lkeyword{plotNoMax} & <number> & 1\\ +\Lkeyword{xAxisLabel} & <anything> & \{\textbackslash\@ empty\}\\ +\Lkeyword{yAxisLabel} & <anything> & \{\textbackslash\@ empty\}\\ +\Lkeyword{xAxisLabelPos} & <(x,y)> or empty & \{\textbackslash\@ empty\}\\ +\Lkeyword{yAxisLabelPos} & <(x,y)> or empty & \{\textbackslash\@ empty\}\\ +\Lkeyword{llx} & <length> & 0pt\\ +\Lkeyword{lly} & <length> & 0pt\\ +\Lkeyword{urx} & <length> & 0pt\\ +\Lkeyword{ury} & <length> & 0pt\\ +\Lkeyword{polarplot} & false|true & false\\ +\Lkeyword{ChangeOrder} & false|true & false\\ \end{longtable} } @@ -3739,8 +2843,8 @@ options allow you to define the additional part of the value, but it must be set in math mode when using math operators! \resetOptions -\begin{LTXexample} -\readdata{\data}{demo1.dat} +\begin{LTXexample}[pos=t] +\readdata{\data}{demo1.data} \pstScalePoints(1,0.000001){}{}% (x,y){additional x operator}{y op} \psset{llx=-1cm,lly=-1cm} \psgraph[ylabelFactor=\cdot 10^6,Dx=5,Dy=100](0,0)(25,750){8cm}{5cm} @@ -3750,7 +2854,6 @@ it must be set in math mode when using math operators! \end{LTXexample} -\clearpage %-------------------------------------------------------------------------------------- \subsection{\texttt{comma}} %-------------------------------------------------------------------------------------- @@ -3975,9 +3078,9 @@ value to $2\pi$, a.s.o. The best way seems to be to set the $x$-unit to -\verb+\pstRadUnit+. Plotting a function doesn't consider the value -for \verb+trigLabelBase+, it has to be done by the user. The first -example sets the unit locally for the \verb+\psplot+ back to 1cm, +\Lcs{pstRadUnit}. Plotting a function doesn't consider the value +for \Lkeyword{trigLabelBase}, it has to be done by the user. The first +example sets the unit locally for the \Lcs{psplot} back to 1cm, which is needed, because we use this unit on the PostScript side. \begin{minipage}{0.4\fullWidth} @@ -4196,8 +3299,8 @@ Single ticks can be set with the two macros \begin{LTXexample}[width=.5\linewidth] \begin{psgraph}[Dx=2,Dy=2](0,0)(-4,-2.2)(4,2.2){.5\textwidth}{!} - \psxTick[linecolor=red](1.5){$x_0$} - \psyTick[linecolor=blue](1.7){$y_0$} + \psxTick[linecolor=red](1.5){x_0} + \psyTick[linecolor=blue](1.7){y_0} \end{psgraph} \end{LTXexample} @@ -4232,7 +3335,7 @@ only valid for the axes style \texttt{frame}. With this new option the recent \verb+tickstyle+ option of \verb+pst-plot+ is obsolete and no longer supported by -\verb+pstricks-add+. +\LPack{pstricks-add}. Syntax: \begin{lstlisting}[style=syntax] @@ -4379,8 +3482,8 @@ xsubticklinestyle=solid|dashed|dotted|none ysubticklinestyle=solid|dashed|dotted|none \end{lstlisting} -\verb+ticklinestyle+ and \verb+subticklinestyle+ set both values -for the x and y axis. The value \verb+none+ doesn't really makes +\Lkeyword{ticklinestyle} and \Lkeyword{subticklinestyle} set both values +for the x and y axis. The value \Lkeyval{none} doesn't really makes sense, because it is the same as \verb+[sub]ticklines=0+ \begin{LTXexample}[preset=\centering,pos=t] @@ -4395,15 +3498,15 @@ sense, because it is the same as \verb+[sub]ticklines=0+ %-------------------------------------------------------------------------------------- -\subsection{\texttt{loglines}} +\subsection{\texttt{logLines}} %-------------------------------------------------------------------------------------- Syntax: -\begin{lstlisting}[style=syntax] -loglines=all|x|y -\end{lstlisting} +\begin{BDef} +logLines=all|x|y +\end{BDef} -By default the option \texttt{logLines} sets the ticksize to the maximal length for x, y, or both. -It can be changed, when \emph{after} the option \texttt{logLines} the ticksize is set. +By default the option \Lkeyword{logLines} sets the ticksize to the maximal length for x, y, or both. +It can be changed, when \emph{after} the option \Lkeyword{logLines} the ticksize is set. \begin{LTXexample}[pos=t] \pspicture(-1,-1)(5,5) @@ -4433,12 +3536,12 @@ It can be changed, when \emph{after} the option \texttt{logLines} the ticksize i %-------------------------------------------------------------------------------------- \subsection{\texttt{xylogBase}, \texttt{xlogBase} and \texttt{ylogBase}} %-------------------------------------------------------------------------------------- -There are additional options \verb|xylogBase | xlogBase | -ylogBase| to get one or both axes with logarithmic labels. For an +There are additional options \Lkeyword{xylogBase}, \Lkeyword{xlogBase}, +\Lkeyword{ylogBase} to get one or both axes with \Index{logarithmic label}s. For an interval of [$10^{-3} ... 10^2$] choose a \verb|pstricks| interval of [-3,2]. \verb|pstricks| takes $0$ as the origin of this axes, which is wrong if we want to have a logarithmic axes. With the -options \verb|Oy| and \verb|Ox| we can set the origin to $-3$, so +options \Lkeyword{Oy} and \Lkeyword{Ox} we can set the origin to $-3$, so that the first label gets $10^{-3}$. If this is not done by the user then \verb|pstricks-add| does it by default. An alternative is to set these parameters to empty values \verb|Ox={},Oy={}|, in @@ -4468,7 +3571,7 @@ $y=\log x$ and is shown in the following example. %-------------------------------------------------------------------------------------------- \subsubsection{\texttt{ylogBase}} %-------------------------------------------------------------------------------------------- -The values for the \texttt{psaxes} y-coordinate are now the +The values for the \Lcs{psaxes} y-coordinate are now the exponents to the base $10$ and for the right function to the base $e$: $10^{-3} \ldots 10^1$ which corresponds to the given y-interval $-3\ldots 1.5$, where only integers as exponents are @@ -4495,7 +3598,7 @@ with an drawing interval of $1.001\ldots 6$. \begin{LTXexample}[width=7cm] \begin{pspicture}(-0.5,-3.5)(6.5,1.5) \psplot[linewidth=2pt,plotpoints=100,linecolor=red]% - {1.04}{6}{/ln {log 0.4343 div} def x ln ln} % log(x) + {1.04}{6}{x ln ln}[ /ln {log 0.4343 div} def ] % log(x) \psaxes[ylogBase=e,Oy=-3]{->}(0,-3)(6.5,1.5) \uput[-90](6.5,-3){x} \uput[0](0,1.5){y} @@ -4554,6 +3657,7 @@ with an drawing interval of $1.001\ldots 6$. \subsubsection{\texttt{xlogBase}} %-------------------------------------------------------------------------------------- Now we have to use the easy math function $y=x$ because the x axis is still $\log x$. +\xLkeyword{xlogBase} \medskip \begin{LTXexample}[width=7cm] @@ -4616,7 +3720,7 @@ Now we have to use the easy math function $y=x$ because the x axis is still $\lo %------------------------------------------------------------------------------------ \subsubsection{No logstyle (\texttt{xylogBase=\{\}})} %------------------------------------------------------------------------------------ -This is only a demonstration that the default option \verb|logBase={}| still works ... :-) +This is only a demonstration that the default option \xLkeyword{xylogBase}=\{\} still works ... :-) \medskip \begin{LTXexample}[width=7cm] @@ -4782,8 +3886,8 @@ This is only a demonstration that the default option \verb|logBase={}| still wor % from the package \texttt{pst-eqdf}, written by Dominique Rodriguez.} } %-------------------------------------------------------------------------------------- -By default the function in \verb+\psplot+ has to be described in -Reversed Polish Notation. The option \verb+algebraic+ allows you +By default the function in \Lcs{psplot} has to be described in +Reversed Polish Notation. The option \Lkeyword{algebraic} allows you to do this in the common algebraic notation. E.g.: \begin{tabular}{l|l} @@ -4794,7 +3898,7 @@ RPN & algebraic\\\hline \verb+t cos t sin+ & \verb+cos(t)|sin(t)+ \end{tabular} -Setting the option \verb$algebraic$ to \verb$true$, allow the user +Setting the option \Lkeyword{algebraic} to \verb+true+, allow the user to describe all expression to be written in the classical algebraic notation (infix notation). The four arithmetic operations are obviously defined \verb$+-*/$, and also the @@ -4817,10 +3921,10 @@ is done from left to right. The following functions are defined : \medskip These options can be used with \textbf{all} plot macros. -{\bfseries Using the option \verb+algebraic+ implies that all +{\bfseries Using the option \Lkeyword{algebraic} implies that all angles have to be in radians! } -For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ character: +For the \Lcs{parametricplot} the two parts must be divided by the \Lnotation{|} character: \begin{LTXexample}[width=2cm] \begin{pspicture}(-0.5,-0.5)(0.5,0.5) @@ -4834,7 +3938,7 @@ For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ cha \psset{lly=-0.5cm} \psgraph[trigLabels,dx=\psPi,dy=0.5,Dy=0.5]{->}(0,0)(-10,-1)(10,1){\linewidth}{6cm} \psset{algebraic,plotpoints=1000} - \psplot[linecolor=yellow,linewidth=2pt]{-10}{10}{0.75*sin(x)*cos(x/2)}% + \psplot[linecolor=yellow,linewidth=2pt]{-10}{10}{0.75*sin(x)*cos(x/2)} \psplot[linecolor=red,showpoints=true,plotpoints=101]{-10}{10}{0.75*sin(x)*cos(x/2)} \endpsgraph %\end{LTXexample} @@ -4844,7 +3948,7 @@ For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ cha \psset{lly=-0.5cm} \psgraph[trigLabels,dx=\psPi,dy=0.5,Dy=0.5]{->}(0,0)(-10,-1)(10,1){\linewidth}{6cm} \psset{algebraic,plotpoints=1000} - \psplot[linecolor=yellow,linewidth=2pt]{-10}{10}{0.75*sin(x)*cos(x/2)}% + \psplot[linecolor=yellow,linewidth=2pt]{-10}{10}{0.75*sin(x)*cos(x/2)} \psplot[linecolor=red,showpoints=true,plotpoints=101]{-10}{10}{0.75*sin(x)*cos(x/2)} \endpsgraph \end{lstlisting} @@ -4856,7 +3960,7 @@ For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ cha \psset{lly=-0.5cm} \psgraph(0,-5)(18,3){15cm}{5cm} \psset{algebraic,plotpoints=501} - \psplot[linecolor=yellow, linewidth=4\pslinewidth]{0.01}{18}{ln(x)}% + \psplot[linecolor=yellow, linewidth=4\pslinewidth]{0.01}{18}{ln(x)} \psplot[linecolor=red]{0.01}{18}{ln(x)} \psplot[linecolor=yellow,linewidth=4\pslinewidth]{0}{18}{3*cos(x)*2.71^(-x/10)} \psplot[linecolor=blue,showpoints=true,plotpoints=51]{0}{18}{3*cos(x)*2.71^(-x/10)} @@ -4870,7 +3974,7 @@ For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ cha \psset{lly=-0.5cm} \psgraph(0,-5)(18,3){15cm}{5cm} \psset{algebraic,plotpoints=501} - \psplot[linecolor=yellow, linewidth=4\pslinewidth]{0.01}{18}{ln(x)}% + \psplot[linecolor=yellow, linewidth=4\pslinewidth]{0.01}{18}{ln(x)} \psplot[linecolor=red]{0.01}{18}{ln(x)} \psplot[linecolor=yellow,linewidth=4\pslinewidth]{0}{18}{3*cos(x)*2.71^(-x/10)} \psplot[linecolor=blue,showpoints=true,plotpoints=51]{0}{18}{3*cos(x)*2.71^(-x/10)} @@ -4884,7 +3988,9 @@ For the \verb+\parametricplot+ the two parts must be divided by the \verb+|+ cha \subsubsection{Using the \texttt{Sum} function} %-------------------------------------------------------------------------------------- -Syntax: \verb+Sum(<index name>,<start>,<step>,<end>,<function>)+ +\begin{BDef} +\Lcs{Sum}\Largr{<index name>,<start>,<step>,<end>,<function>} +\end{BDef} Let's plot the first development of cosine with polynomials: $\displaystyle\sum_{n=0}^{+\infty}\frac{(-1)^nx^{2n}}{n!}$. @@ -4924,9 +4030,11 @@ $\displaystyle\sum_{n=0}^{+\infty}\frac{(-1)^nx^{2n}}{n!}$. %-------------------------------------------------------------------------------------- \subsubsection{Using the \texttt{IfTE} function} %-------------------------------------------------------------------------------------- -Syntax: \verb+IfTE(<condition>,<true part>,<false part>)+ +\begin{BDef} +\Lps{IfTE}\Largr{<condition>,<true part>,<false part>} +\end{BDef} -Nesting of several \verb+IfTE+ is possible and seen in the +Nesting of several \Lps{IfTE} is possible and seen in the following examples. A classic example is a piece-wise linear function. @@ -4953,9 +4061,9 @@ function. When you program a piece-wise defined function you must take care that a plotting point must be put at each point where the -description changes. Use \verb+showpoints=true+ to see what's +description changes. Use \Lkeyword{showpoints}=true to see what's going on when there is a problem. You are on the safe side when -you choose a big number for \verb+plotpoints+. +you choose a big number for \Lkeyword{plotpoints}. \clearpage @@ -4999,7 +4107,7 @@ you choose a big number for \verb+plotpoints+. \subsection{Plot style \texttt{bar} and option \texttt{barwidth}} %-------------------------------------------------------------------------------------- This option allows you to draw bars for the data records. The -width of the bars is controlled by the option \verb+barwidth+, +width of the bars is controlled by the option \Lkeyword{barwidth}, which is set by default to value of \verb+0.25cm+, which is the total width. @@ -5072,6 +4180,45 @@ total width. %------------------------------------------------------------------------------------ +\subsection{New options \nxLkeyword{yMaxValue}} +%------------------------------------------------------------------------------------ +With the new optional argument \Lkeyword{yMaxValue} one can control the behaviour +of discontinued functions, like the tangent function. If \Lkeyword{yMaxValue} is set +to a negative value, then the internal if clause is disabled, the function is plotted +in the usual way as known from \LPack{pst-plot}. + + +\psset{unit=1cm} + +\begin{LTXexample}[preset=\centering,pos=t] +\begin{pspicture}(-6.5,-7)(6.5,7.5) +\multido{\rA=-4.71239+\psPiH}{7}{% + \psline[linecolor=black!20,linestyle=dashed](\rA,-6.5)(\rA,6.5)} +\psaxes[trigLabelBase=2,dx=\psPiH, + xunit=\psPi,trigLabels]{->}(0,0)(-1.7,-6.5)(1.77,6.5)[$x$,0][$y$,-90] +\psset{algebraic,plotpoints=200,plotstyle=line} +\psclip{\psframe[linestyle=none](-4.55,-6.5)(5.55,6.5)} + \psplot[yMaxValue=10,linewidth=1.6pt,linecolor=red]{-4.55}{4.55}{(x)/(sin(2*x))} +\endpsclip +\psplot[linestyle=dashed,linecolor=blue!30]{-4.8}{4.8}{x} +\psplot[linestyle=dashed,linecolor=blue!30]{-4.8}{4.8}{-x} +\rput(0,0.5){$\times$} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[preset=\centering,pos=t] +\begin{pspicture}(-6.5,-7)(6.5,7.5) +\psaxes[trigLabelBase=2,dx=\psPiH, + xunit=\psPi,trigLabels]{->}(0,0)(-1.7,-6.5)(1.77,6.5)[$x$,0][$y$,90] +\psset{algebraic} +\psplot[yMaxValue=6,linewidth=1.6pt,plotpoints=2000, + linecolor=red]{-4.55}{4.55}{tan(x)} +\end{pspicture} +\end{LTXexample} + +\psset{unit=1cm} + +%------------------------------------------------------------------------------------ \subsection{New options for \CMD{readdata}} %------------------------------------------------------------------------------------ @@ -5081,28 +4228,28 @@ which could be annoying when you have some text lines at top of your data files or when there are more than 10000 records to read. -\verb|pstricks-add| defines two additional keys \verb|ignoreLines| -and \verb|nStep|, which allows you to ignore preceding lines, e.g. -\verb|ignoreLines=2|, or to read only a selected part of the data +\verb|pstricks-add| defines two additional keys \Lkeyword{ignoreLines} +and \Lkeyword{nStep}, which allows you to ignore preceding lines, e.g. +\Lkeyword{ignoreLines}=2, or to read only a selected part of the data records, e.g. \verb|nStep=10|, only every 10\textsuperscript{th} record is saved. \begin{lstlisting} -\readdata[ignoreLines=2]{\dataA}{stressrawdata.dat} -\readdata[nStep=10]{\dataA}{stressrawdata.dat} +\readdata[ignoreLines=2]{\dataA}{stressrawdata.data} +\readdata[nStep=10]{\dataA}{stressrawdata.data} \end{lstlisting} -The default value for \verb+ignoreLines+ is $0$ and for \verb+nStep+ is $1$. -the following data file has two text lines which shall be ignored by the \verb+\readdata+ macro: +The default value for \Lkeyword{ignoreLines} is $0$ and for \Lkeyword{nStep} is $1$. +the following data file has two text lines which shall be ignored by the \Lcs{readdata} macro: \begin{LTXexample}[width=4cm] -\begin{filecontents*}{pstricks-add-data9.dat} +\begin{filecontents*}{pstricks-add-data9.data} some nonsense in this line ���time forcex forcey 0 0.2 1 1 2 4 \end{filecontents*} -\readdata[ignoreLines=2]{\data}{pstricks-add-data9.dat} +\readdata[ignoreLines=2]{\data}{pstricks-add-data9.data} \pspicture(2,4) \listplot[showpoints=true]{\data} \psaxes{->}(2,4) @@ -5113,8 +4260,10 @@ some nonsense in this line ���time forcex forcey %-------------------------------------------------------------------------------------- \subsection{New options for \texttt{\textbackslash listplot}} %-------------------------------------------------------------------------------------- -By default the plot macros \verb|\dataplot|, \verb|\fileplot| and \verb|\listplot| plot every -data record. The package \verb|pst-plot-add| defines additional keys \verb|nStep, nStart, nEnd| and \verb|xStep, xStart, xEnd|, which allows +By default the plot macros \Lcs{dataplot}, \Lcs{fileplot} and \Lcs{listplot} plot every +data record. The package \verb|pst-plot-add| defines additional keys +\Lkeyword{nStep}, \Lkeyword{nStart}, \Lkeyword{nEnd}, and \Lkeyword{xStep}, \Lkeyword{xStart}, +\Lkeyword{xEnd}, which allows to plot only a selected part of the data records, e.g. \verb|nStep=10|. These "`n"' options mark the number of the record to be plot ($0,1,2,...$) and the "`x"' ones the x-values of the data records. @@ -5122,36 +4271,36 @@ options mark the number of the record to be plot ($0,1,2,...$) and the "`x"' one \begin{center} \begin{tabular}{l|l} Name & Default setting\\\hline -\verb|nStart| & \verb|1|\\ -\verb|nEnd| & \verb|{}|\\ -\verb|nStep| & \verb|1|\\ -\verb|xStart| & \verb|{}|\\ -\verb|xEnd| & \verb|{}|\\ -\verb|yStart| & \verb|{}|\\ -\verb|yEnd| & \verb|{}|\\ -\verb|xStep| & \verb|0|\\ -\verb|plotNo| & \verb|1|\\ -\verb|plotNoMax| & \verb|1|\\ -\verb|ChangeOrder| & \verb|false|\\ -(\verb+plotstyle+)& \verb+line+ +\Lkeyword{nStart} & \verb|1|\\ +\Lkeyword{nEnd} & \verb|{}|\\ +\Lkeyword{nStep} & \verb|1|\\ +\Lkeyword{xStart} & \verb|{}|\\ +\Lkeyword{xEnd} & \verb|{}|\\ +\Lkeyword{yStart} & \verb|{}|\\ +\Lkeyword{yEnd} & \verb|{}|\\ +\Lkeyword{xStep} & \verb|0|\\ +\Lkeyword{plotNo} & \verb|1|\\ +\Lkeyword{plotNoMax} & \verb|1|\\ +\Lkeyword{ChangeOrder} & \false\\ +(\Lkeyword{plotstyle})& \Lkeyval{line} \end{tabular} \end{center} These new options are only available -for the \verb|\listplot| macro, which is not a real limitation, because all data records can be read -from a file with the \verb|\readdata| macro (see example files or \cite{dtk02.2:jackson.voss:plot-funktionen}): +for the \Lcs{listplot} macro, which is not a real limitation, because all data records can be read +from a file with the \Lcs{readdata} macro (see example files or \cite{dtk02.2:jackson.voss:plot-funktionen}): \begin{lstlisting}[style=syntax] -\readdata[nStep=10]{\data}{/home/voss/data/data1.dat} +\readdata[nStep=10]{\data}{/home/voss/data/data1.data} \end{lstlisting} -The use \verb|nStep| and \verb|xStep| options only make real sense -when also using the option \verb|plotstyle=dots|. Otherwise the +The use \Lkeyword{nStep} and \Lkeyword{xStep} options only make real sense +when also using the option \Lkeyset{plotstyle=dots}. Otherwise the coordinates are connected by a line as usual. Also the -\verb|xStep| option needs increasing x values. Note that -\verb+nStep+ can be used for \verb+\readdata+ and for -\verb+\listplot+. If used in both macros then the effect is -multiplied, e.g. \verb+\readdata+ with \verb+nStep=5+ and -\verb+\listplot+ with \verb+nStep=10+ means, that only every +\Lkeyword{xStep} option needs increasing x values. Note that +\Lkeyword{nStep} can be used for \Lcs{readdata} and for +\Lcs{listplot}. If used in both macros then the effect is +multiplied, e.g. \Lcs{readdata} with \Lkeyword{nStep}=5 and +\Lcs{listplot} with \Lkeyword{nStep}=10 means, that only every 50\textsuperscript{th} data record is read and plotted. When both, \verb|x/yStart/End| are defined then the values are also compared with @@ -5162,12 +4311,12 @@ both values. \subsubsection{Example for \texttt{nStep/xStep}} %-------------------------------------------------------------------------------------- -The datafile \verb|data.dat| contains $1000$ data records. The thin blue line is the plot -of all records with the plotstyle option \verb|curve|. +The datafile \verb|data.data| contains $1000$ data records. The thin blue line is the plot +of all records with the plotstyle option \Lkeyval{curve}. \resetOptions \begin{LTXexample}[preset=\centering,pos=t] -\readdata{\data}{data.dat} +\readdata{\data}{data.data} \psset{xunit=12.5cm,yunit=0.2mm} \begin{pspicture}(-0.080,-30)(1,270) \pstScalePoints(1,1){1000 div}{1000 div} @@ -5186,7 +4335,7 @@ of all records with the plotstyle option \verb|curve|. %-------------------------------------------------------------------------------------- \begin{LTXexample}[preset=\centering,pos=t] -\readdata{\data}{data.dat} +\readdata{\data}{data.data} \psset{xunit=12.5cm,yunit=0.2mm} \begin{pspicture}(-0.080,-30)(1,270) \pstScalePoints(1,1){1000 div}{1000 div} @@ -5204,7 +4353,7 @@ of all records with the plotstyle option \verb|curve|. %-------------------------------------------------------------------------------------- \begin{LTXexample}[preset=\centering,pos=t] -\readdata{\data}{data.dat} +\readdata{\data}{data.data} \psset{xunit=12.5cm,yunit=0.2mm} \begin{pspicture}(-0.080,-30)(1,270) \pstScalePoints(1,1){1000 div}{1000 div} @@ -5224,7 +4373,7 @@ of all records with the plotstyle option \verb|curve|. %-------------------------------------------------------------------------------------- \begin{LTXexample}[preset=\centering,pos=t] -\readdata{\data}{data.dat} +\readdata{\data}{data.data} \psset{xunit=12.5cm,yunit=0.2mm} \begin{pspicture}(-0.080,-30)(1,270) \pstScalePoints(1,1){1000 div}{1000 div} @@ -5242,15 +4391,15 @@ of all records with the plotstyle option \verb|curve|. %-------------------------------------------------------------------------------------- This example shows the use of the same plot with different units -and different \verb|xStart| value. The blue curve is the original +and different \Lkeyword{xStart} value. The blue curve is the original plot of the data records. To show the important part of the curve -there is another one plotted with a greater \verb|yunit| and a -start value of \verb|xStart=0.35|. This makes it possible to have +there is another one plotted with a greater \Lkeyword{yunit} and a +start value of \Lkeyword{xStart}=0.35. This makes it possible to have a kind of zoom to the original graphic. \begin{center} \psset{xunit=10cm, yunit=0.01cm} -\readdata{\data}{data3.dat} +\readdata{\data}{data3.data} \begin{pspicture}(-0.1,-100)(1.5,700.0) \psaxes[Dx=0.25,Dy=100,dy=100\psyunit,ticksize=-4pt 0,% labelFontSize={\scriptstyle}]{->}(0,0)(0,-100)(1.4,520) @@ -5276,7 +4425,7 @@ a kind of zoom to the original graphic. \begin{lstlisting} \psset{xunit=10cm, yunit=0.01cm} -\readdata{\data}{data3.dat} +\readdata{\data}{data3.data} \begin{pspicture}(-0.1,-100)(1.5,700.0) \psaxes[Dx=0.25,Dy=100,dy=100\psyunit,ticksize=-4pt 0,% labelFontSize={\scriptstyle}]{->}(0,0)(0,-100)(1.4,520) @@ -5307,7 +4456,7 @@ a kind of zoom to the original graphic. %-------------------------------------------------------------------------------------- \begin{LTXexample}[preset=\centering,pos=t] -\readdata{\data}{data.dat} +\readdata{\data}{data.data} \psset{xunit=12.5cm,yunit=0.2mm} \begin{pspicture}(-0.080,-30)(1,270) \pstScalePoints(1,1){1000 div}{1000 div} @@ -5333,13 +4482,13 @@ x y1 y2 y3 y4 ... yMax ... \end{lstlisting} -you can select the y value which should be plotted. The option \verb+plotNo+ marks the plotted -value (default $1$) and the option \verb+plotNoMax+ tells \verb+pst-plot+ how many $y$ values are -present. There are no real restrictions in the maximum number for \verb+plotNoMax+. +you can select the y value which should be plotted. The option \Lkeyword{plotNo} marks the plotted +value (default $1$) and the option \Lkeyword{plotNoMax} tells \LPack{pst-plot} how many $y$ values are +present. There are no real restrictions in the maximum number for \Lkeyword{plotNoMax}. We have the following data file: \begin{lstlisting}[style=syntax] -[% file data.dat +[% file data.data 0 0 3.375 0.0625 10 5.375 7.1875 4.5 20 7.1875 8.375 6.25 @@ -5360,7 +4509,7 @@ We have the following data file: without any modification to the data file: \begin{LTXexample}[preset=\centering,pos=t] -\readdata\Data{dataMul.dat} +\readdata\Data{dataMul.data} \psset{xunit=0.1cm, yunit=0.5cm,lly=-0.5cm} \begin{pspicture}(0,-7.5)(150,10) \psaxes[Dx=10,Dy=2.5]{->}(0,0)(0,-7.5)(150,7.5)[$\mathbf{x}$,-90][$\mathbf{y}$,0] @@ -5378,12 +4527,12 @@ without any modification to the data file: \subsubsection{Example for \texttt{changeOrder}} %-------------------------------------------------------------------------------------- It is only possible to fill the region between two listplots with -\verb+\pscustom+ if one of them has the values in reverse order. +\Lcs{pscustom} if one of them has the values in reverse order. Otherwise we do not get a closed path. With the option -\verb+ChangeOrder+ the values are used in reverse order: +\Lkeyword{ChangeOrder} the values are used in reverse order: \begin{LTXexample}[pos=t,preset=\centering] -\begin{filecontents*}{test.dat} +\begin{filecontents*}{test.data} 0 3 8 2 4 7 5 5 5.5 @@ -5392,7 +4541,7 @@ Otherwise we do not get a closed path. With the option \end{filecontents*} \psset{lly=-.5cm} \begin{psgraph}[axesstyle=frame,ticklinestyle=dotted,ticksize=0 10](0,0)(10,10){4in}{2in}% - \readdata{\data}{test.dat}% + \readdata{\data}{test.data}% \pscustom[fillstyle=solid,fillcolor=blue!40]{% \listplot[plotNo=2,plotNoMax=2]{\data}% \listplot[plotNo=1,plotNoMax=2,ChangeOrder]{\data}} @@ -5404,19 +4553,19 @@ Otherwise we do not get a closed path. With the option %-------------------------------------------------------------------------------------- \subsubsection{Example for \texttt{plotstyle}} %-------------------------------------------------------------------------------------- -The \verb+plotstyle+ option is defined in the package \verb+pst-plot+, but its value -\verb+LSM+ (\textbf{L}east \textbf{S}quare \textbf{Method}) is only valid for the -\verb+pstricks-add+ package. Instead of plotting the data records as dots or a line, -the \verb+listplot+ macro calculates the values for a line $y=v\cdot x+u$ which fits +The \Lkeyword{plotstyle} option is defined in the package \LPack{pst-plot}, but its value +\Lkeyval{LSM} (\textbf{L}east \textbf{S}quare \textbf{Method}) is only valid for the +\LPack{pstricks-add} package. Instead of plotting the data records as dots or a line, +the \Lcs{listplot} macro calculates the values for a line $y=v\cdot x+u$ which fits best all data records. \bgroup \centering -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0 1 1 3 2.8 4 3 2.9 2 5 4 4 5 5.5 6 8.2 8 7 \end{filecontents*} \psset{lly=-.5cm} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} \begin{psgraph}[arrows=->](0,0)(0,0)(8,8){.5\textwidth}{!} \listplot[plotstyle=dots]{\data} \listplot[plotstyle=LSM,linecolor=red]{\data} @@ -5425,11 +4574,11 @@ best all data records. \begin{lstlisting} -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0 1 1 3 2.8 4 3 2.9 2 5 4 4 5 5.5 6 8.2 8 7 \end{filecontents*} \psset{lly=-.5cm} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} \begin{psgraph}[arrows=->](0,0)(0,0)(8,8){.5\textwidth}{!} \listplot[plotstyle=dots]{\data} \listplot[§\ON§plotstyle§\OFF§=§\ON§LSM§\OFF§,linecolor=red]{\data} @@ -5439,15 +4588,15 @@ best all data records. The macro looks for the lowest and biggest x-value and draws the line for this interval. It is possible to pass other values to the -macro by setting the \verb+xStart+ and/or \verb+xEnd+ options. +macro by setting the \Lkeyword{xStart} and/or \Lkeyword{xEnd} options. They are preset with an empty value \verb+{}+. \bgroup \centering -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0 1 1 3 2.8 4 3 2.9 2 5 4 4 5 5.5 6 8.2 8 7 \end{filecontents*} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} \psset{lly=-1.75cm} \begin{psgraph}[arrows=->](0,0)(0,0)(8,8){.5\textwidth}{!} \listplot[plotstyle=dots]{\data} @@ -5456,10 +4605,10 @@ They are preset with an empty value \verb+{}+. \egroup \begin{lstlisting} -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0 1 1 3 2.8 4 3 2.9 2 5 4 4 5 5.5 6 8.2 8 7 \end{filecontents*} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} \psset{lly=-1.75cm} \begin{psgraph}[arrows=->](0,0)(0,0)(8,8){.5\textwidth}{!} \listplot[plotstyle=dots]{\data} @@ -5468,26 +4617,26 @@ They are preset with an empty value \verb+{}+. \end{lstlisting} -With \verb+PstDebug=1+ one gets the equation $y=v\cdot x+u$ +With \Lkeyword{PstDebug}=1 one gets the equation $y=v\cdot x+u$ printed, beginning at the position (0|-50pt). This cannot be changed, because it is only for some kind of debugging. Pay -attention for the correct \verb+xStart+- and \verb+xEnd+-values, -when you use the \verb+\pstScalePoints+-Macro. In the following +attention for the correct \Lkeyword{xStart} and \Lkeyword{xEnd} values, +when you use the \Lcs{pstScalePoints} Macro. In the following example we use an x-interval from 0 to 3 to plot the values; first we subtract 0.003 from all x-values and then scale them with -10000. This is not taken into account for the \verb+xStart+- and -\verb+xEnd+-values. +10000. This is not taken into account for the \Lkeyword{xStart} and +\Lkeyword{xEnd} values. \bgroup \centering -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0.003298697 1.397785583 0.003193358 1.615489564 0.003094538 2.044019006 0.003001651 2.259240127 \end{filecontents*} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} \pstScalePoints(10000,1){ 0.003 sub }{} \psset{lly=-1.75cm} \psgraph[arrows=->,Ox=0.0030,Dx=0.0001,dx=\psxunit](0,0)(3.2,3){10cm}{5cm} @@ -5498,13 +4647,13 @@ we subtract 0.003 from all x-values and then scale them with \egroup \begin{lstlisting} -\begin{filecontents*}{LSM.dat} +\begin{filecontents*}{LSM.data} 0.003298697 1.397785583 0.003193358 1.615489564 0.003094538 2.044019006 0.003001651 2.259240127 \end{filecontents*} -\readdata{\data}{LSM.dat} +\readdata{\data}{LSM.data} §\ON§\pstScalePoints§\OFF§(10000,1){ 0.003 sub }{} \psset{lly=-1.75cm} \psgraph[arrows=->,Ox=0.0030,Dx=0.0001,dx=\psxunit](0,0)(3.2,3){10cm}{5cm} @@ -5519,11 +4668,12 @@ we subtract 0.003 from all x-values and then scale them with \section{Polar plots} %-------------------------------------------------------------------------------------- -With the option \verb+polarplot=false|true+ it is possible to use \verb+\psplot+ +With the option \Lkeyword{polarplot}=\false|\true\ it is possible to use \Lcs{psplot} in polar mode: -\begin{lstlisting}[style=syntax] -\psplot[polarplot=true,...]{<start angle>}{<end angle>}{<r(alpha)>} -\end{lstlisting} +\begin{BDef} +\Lcs{psplot}\OptArg{polarplot=true,...}\Largb{<start angle>}\Largb{<end angle>}\% + \OptArg{PS command}\Largb{<r(alpha)>} +\end{BDef} The equation in PostScript code is interpreted as a function $r=f(\alpha)$, e.g. for the circle with radius 1 as $r=\sqrt{\sin^2x+\cos^2x}$: @@ -5594,14 +4744,14 @@ x sin dup mul x cos dup mul add sqrt \section{\CMD{pstScalePoints}} %-------------------------------------------------------------------------------------- The syntax is -\begin{lstlisting}[style=syntax] -\pstScalePoints(xScale,xScale){xPS}{yPS} -\end{lstlisting} +\begin{BDef} +\Lcs{pstScalePoints}\Largr{xScale,xScale}\Largb{xPS}\Largb{yPS} +\end{BDef} \verb+xScale,yScale+ are decimal values used as scaling factors, the \verb+xPs+ and \verb+yPS+ are additional PostScript code applied to the x- and y-values of the data records. This macro is -only valid for the \CMD{listplot} macro! +only valid for the \Lcs{listplot} macro! \resetOptions \begin{LTXexample}[width=6cm] @@ -5619,17 +4769,17 @@ only valid for the \CMD{listplot} macro! \end{LTXexample} \bigskip -\verb+\pstScalePoints(1,0.5){}{3 add}+ means that \textbf{first} the value $3$ is added +\Lcs{pstScalePoints}\Largr{1,0.5}\Largb{}\Largb{3 add} means that \textbf{first} the value $3$ is added to the $y$ values and \textbf{second} this value is scaled with the factor $0.5$. As seen for the blue line for $x=0$ we get $y(0)=(0+3)\cdot 0.5=1.5$. -Changes with \verb+\pstScalePoints+ are always global to all following \verb+\listplot+ +Changes with \Lcs{pstScalePoints} are always global to all following \Lcs{listplot} macros. This is the reason why it is a good idea to reset the values at the end of the -\verb+pspicture+ environment. +\Lenv{pspicture} environment. -\begin{lstlisting}[style=syntax] +\begin{BDef} \pstScalePoints(1,1){}{} -\end{lstlisting} +\end{BDef} \clearpage @@ -5641,26 +4791,26 @@ macros. This is the reason why it is a good idea to reset the values at the end \section[\texttt{psCancel} environment]{\texttt{psCancel} environment\footnotemark} %-------------------------------------------------------------------------------------- \footnotetext{Thanks to by Stefano Baroni} This macro works like -the \CMD{cancel} macro from the package of the same name but it +the \Lcs{cancel} macro from the package of the same name but it allows as argument any contents, not only letters but also a complex graphic. -\begin{lstlisting}[style=syntax] -\psCancel*[line options]{contents}% -\end{lstlisting} +\begin{BDef} +\LcsStar{psCancel}\OptArgs\Largb{contents}% +\end{BDef} All optional arguments for lines and boxes are valid and can be used in the usual way. The star option fills the underlying box rectangle with the linecolor. This can be transparent if -\texttt{opacity} is set to a value less than 1. This can be used +\Lkeyword{opacity} is set to a value less than 1. This can be used in presentation to strike out words, equations, and graphic objects. Lines can also be transparent when the option -\texttt{strokeopacity} is used. +\Lkeyword{strokeopacity} is used. \begingroup \psCancel{A} \psCancel[linecolor=red]{Tikz :-)} \quad \psCancel[linecolor=blue,doubleline=true]{% - \readdata{\data}{demo1.dat} + \readdata{\data}{demo1.data} \psset{shift=*,xAxisLabel=x-Axis,yAxisLabel=y-Axis,llx=-13mm,lly=-7mm, xAxisLabelPos={c,-1},yAxisLabelPos={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5673,7 +4823,7 @@ objects. Lines can also be transparent when the option \psCancel*[linecolor=red!50,opacity=0.5]{\tabular[b]{c}first line\\second line\endtabular} \quad \psCancel*[linecolor=blue!30,opacity=0.5]{% - \readdata{\data}{demo1.dat} + \readdata{\data}{demo1.data} \psset{shift=*,xAxisLabel=x-Axis,yAxisLabel=y-Axis,llx=-15mm,lly=-7mm,urx=1mm, xAxisLabelPos={c,-1},yAxisLabelPos={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5694,7 +4844,7 @@ objects. Lines can also be transparent when the option \begin{lstlisting} \psCancel{A} \psCancel[linecolor=red]{Tikz :-)} \quad \psCancel[linecolor=blue,doubleline=true]{% - \readdata{\data}{demo1.dat} + \readdata{\data}{demo1.data} \psset{shift=*,xAxisLabel=x-Axis,yAxisLabel=y-Axis,llx=-13mm,lly=-7mm, xAxisLabelPos={c,-1},yAxisLabelPos={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5707,7 +4857,7 @@ objects. Lines can also be transparent when the option \psCancel*[linecolor=red!50,opacity=0.5]{\tabular[b]{c}first line\\second line\endtabular} \quad \psCancel*[linecolor=blue!30,opacity=0.5]{% - \readdata{\data}{demo1.dat} + \readdata{\data}{demo1.data} \psset{shift=*,xAxisLabel=x-Axis,yAxisLabel=y-Axis,llx=-15mm,lly=-7mm,urx=1mm, xAxisLabelPos={c,-1},yAxisLabelPos={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5728,20 +4878,19 @@ objects. Lines can also be transparent when the option %-------------------------------------------------------------------------------------- \section{\texttt{psgraph} environment} %-------------------------------------------------------------------------------------- -This new environment does the scaling, it expects as parameter the values (without units!) for the +This new environment \Lenv{psgraph} does the scaling, it expects as parameter the values (without units!) for the coordinate system and the values of the physical width and height (with units!). The syntax is: -\begin{lstlisting}[style=syntax] -\psgraph[<axes options>]{<arrows>}% - (xOrig,yOrig)(xMin,yMin)(xMax,yMax){xLength}{yLength} -... -\endpsgraph - -\begin{psgraph}[<axes options>]{<arrows>}% - (xOrig,yOrig)(xMin,yMin)(xMax,yMax){xLength}{yLength} -... -\end{psgraph} -\end{lstlisting} +\begin{BDef} +\Lcs{psgraph}\OptArgs\Largb{<arrows>}\%\\ +\qquad\Largr{xOrig,yOrig}\Largr{xMin,yMin}\Largr{xMax,yMax}\Largb{xLength}\Largb{yLength}\\ +\ldots\\ +\Lcs{endpsgraph}\\[10pt] +\LBEG{psgraph}\OptArgs\Largb{<arrows>}\%\\ +\qquad\Largr{xOrig,yOrig}\Largr{xMin,yMin}\Largr{xMax,yMax}\Largb{xLength}\Largb{yLength}\\ +\ldots\\ +\LEND{psgraph} +\end{BDef} where the options are valid \textbf{only} for the the \verb+\psaxes+ macro. The first two arguments have the usual \verb+PSTricks+ behaviour. @@ -5757,7 +4906,7 @@ as for the x-axis. %----------------------------------------------------------------------------- \begin{center} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \pstScalePoints(1,0.000001){}{}% (x,y){additional x operator}{y op} \psset{llx=-1cm,lly=-1cm} \begin{psgraph}[axesstyle=frame,xticksize=0 759,yticksize=0 25,% @@ -5768,7 +4917,7 @@ as for the x-axis. \end{center} \begin{lstlisting} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \pstScalePoints(1,0.000001){}{}% (x,y){additional x operator}{y op} \psset{llx=-1cm,lly=-1cm} §\ON§\begin{psgraph}§\OFF§[axesstyle=frame,xticksize=0 759,yticksize=0 25,% @@ -5798,7 +4947,7 @@ In the following example, the y unit gets the same value as the one for the x-ax %----------------------------------------------------------------------------- \begin{center} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \psset{xAxisLabel=x-Axis,yAxisLabel=y-Axis,llx=-.5cm,lly=-1cm,lly=-1cm,ury=0.5cm, xAxisLabelPos={c,-1},yAxisLabelPos={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5809,7 +4958,7 @@ In the following example, the y unit gets the same value as the one for the x-ax \end{center} \begin{lstlisting} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \psset{§\ON§xAxisLabel§\OFF§=x-Axis,§\ON§yAxisLabel§\OFF§=y-Axis,llx=-.5cm,lly=-1cm,ury=0.5cm, §\ON§xAxisLabelPos§\OFF§={c,-1},§\ON§yAxisLabelPos§\OFF§={-7,c}} \pstScalePoints(1,0.00000001){}{} @@ -5822,7 +4971,7 @@ In the following example, the y unit gets the same value as the one for the x-ax %----------------------------------------------------------------------------- \begin{LTXexample}[pos=t,preset=\centering] -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \psset{llx=-0.5cm,lly=-1cm} \pstScalePoints(1,0.000001){}{} \psgraph[arrows=->,Dx=5,dy=200\psyunit,Dy=200,subticks=5,ticksize=-10pt 0, @@ -5834,7 +4983,7 @@ In the following example, the y unit gets the same value as the one for the x-ax %----------------------------------------------------------------------------- \begin{center} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \pstScalePoints(1,0.2){}{log} \psset{lly=-0.75cm} \psgraph[ylogBase=10,Dx=5,Dy=1,subticks=5](0,0)(25,2){12cm}{4cm} @@ -5843,7 +4992,7 @@ In the following example, the y unit gets the same value as the one for the x-ax \end{center} \begin{lstlisting} -\readdata{\data}{demo1.dat} +\readdata{\data}{demo1.data} \pstScalePoints(1,0.2){}{log} \psset{lly=-0.75cm} \psgraph[§\ON§ylogBase§\OFF§=10,Dx=5,Dy=1,subticks=5](0,0)(25,2){12cm}{4cm} @@ -5854,7 +5003,7 @@ In the following example, the y unit gets the same value as the one for the x-ax %----------------------------------------------------------------------------- \begin{LTXexample}[pos=t,preset=\centering] -\readdata{\data}{demo0.dat} +\readdata{\data}{demo0.data} \psset{lly=-0.75cm,ury=0.5cm} \pstScalePoints(1,1){}{log} \begin{psgraph}[arrows=->,Dx=0.5,ylogBase=10,Oy=-1,xsubticks=10,% @@ -5866,7 +5015,7 @@ In the following example, the y unit gets the same value as the one for the x-ax \begin{LTXexample}[pos=t,preset=\centering] \psset{lly=-0.75cm,ury=0.5cm} -\readdata{\data}{demo0.dat} +\readdata{\data}{demo0.data} \pstScalePoints(1,1){}{log} \psgraph[arrows=->,Dx=0.5,ylogBase=10,Oy=-1,subticks=4](0,-3)(3,1){6cm}{3cm} \listplot[linecolor=red,linewidth=2pt,showpoints=true,plotstyle=LineToXAxis]{\data} @@ -5876,8 +5025,8 @@ In the following example, the y unit gets the same value as the one for the x-ax %----------------------------------------------------------------------------- \begin{center} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \pstScalePoints(1,1){1989 sub}{} \psset{llx=-0.5cm,lly=-1cm, xAxisLabel=Year,yAxisLabel=Whatever,% xAxisLabelPos={c,-0.4in},yAxisLabelPos={-0.4in,c}} @@ -5889,8 +5038,8 @@ In the following example, the y unit gets the same value as the one for the x-ax \end{center} \begin{lstlisting} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \pstScalePoints(1,1){1989 sub}{} \psset{llx=-0.5cm,lly=-1cm, §\ON§xAxisLabel§\OFF§=Year,§\ON§yAxisLabel§\OFF§=Whatever,% §\ON§xAxisLabelPos§\OFF§={c,-0.4in},§\ON§yAxisLabelPos§\OFF§={-0.4in,c}} @@ -5904,27 +5053,27 @@ In the following example, the y unit gets the same value as the one for the x-ax %\begin{LTXexample}[pos=t,preset=\centering] \begin{center} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \psset{llx=-0.5cm,lly=-0.75cm,plotstyle=LineToXAxis} \pstScalePoints(1,1){1989 sub}{2 sub} \begin{psgraph}[axesstyle=frame,Dx=2,Ox=1989,Oy=2,subticks=2](0,0)(12,4){6in}{3in} - \listplot[linecolor=red,linewidth=2pt]{\data} - \listplot[linecolor=blue,linewidth=2pt]{\dataII} - \listplot[linecolor=cyan,linewidth=2pt,yunit=0.5]{\dataII} + \listplot[linecolor=red,linewidth=12pt]{\data} + \listplot[linecolor=blue,linewidth=12pt]{\dataII} + \listplot[linecolor=cyan,linewidth=12pt,yunit=0.5]{\dataII} \end{psgraph} \end{center} %\end{LTXexample} \begin{lstlisting} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \psset{llx=-0.5cm,lly=-0.75cm,plotstyle=LineToXAxis} \pstScalePoints(1,1){1989 sub}{2 sub} \begin{psgraph}[axesstyle=frame,Dx=2,Ox=1989,Oy=2,subticks=2](0,0)(12,4){6in}{3in} - \listplot[linecolor=red,linewidth=2pt]{\data} - \listplot[linecolor=blue,linewidth=2pt]{\dataII} - \listplot[linecolor=cyan,linewidth=2pt,yunit=0.5]{\dataII} + \listplot[linecolor=red,linewidth=12pt]{\data} + \listplot[linecolor=blue,linewidth=12pt]{\dataII} + \listplot[linecolor=cyan,linewidth=12pt,yunit=0.5]{\dataII} \end{psgraph} \end{lstlisting} @@ -5971,34 +5120,34 @@ An example with ticks on every side of the frame and filled areas: %------------------------------------------------------------------------------------------- \begin{center} -\begin{tabular}{>{\tt}l>{\tt}ll} +\begin{tabular}{@{} l>{\tt}ll @{}} \textrm{name} & \textrm{default} & meaning\\\hline -xAxisLabel & x & label for the x-axis\\ -yAxisLabel & y & label for the y-axis\\ -xAxisLabelPos & \{\} & where to put the x-label\\ -yAxisLabelPos & \{\} & where to put the y-label\\ -llx & 0pt & trim for the lower left x\\ -lly & 0pt & trim for the lower left y\\ -urx & 0pt & trim for the upper right x\\ -ury & 0pt & trim for the upper right y +\Lkeyword{xAxisLabel} & x & label for the x-axis\\ +\Lkeyword{yAxisLabel} & y & label for the y-axis\\ +\Lkeyword{xAxisLabelPos} & \{\} & where to put the x-label\\ +\Lkeyword{yAxisLabelPos} & \{\} & where to put the y-label\\ +\Lkeyword{llx} & 0pt & trim for the lower left x\\ +\Lkeyword{lly} & 0pt & trim for the lower left y\\ +\Lkeyword{urx} & 0pt & trim for the upper right x\\ +\Lkeyword{ury} & 0pt & trim for the upper right y \end{tabular} \end{center} There is one restriction in using the trim parameters, they must -been set \textbf{before} \verb+psgraph+ is called. They are -redundant when used as parameters of \verb+psgraph+ itself. The -\verb+?AxisLabelPos+ options can use the letter \verb+c+ for -centering an x-axis or y-axis label. The c is a replacement for +been set \textbf{before} \Lcs{psgraph} is called. They are +redundant when used as parameters of \Lcs{psgraph} itself. The +\verb+?AxisLabelPos+ options can use the letter \Lnotation{c} for +centering an x-axis or y-axis label. The \Lnotation{c} is a replacement for the x or y value. When using values with units, the position is always measured from the origin of the coordinate system, which -can be outside the visible \verb+pspicture+ environment +can be outside the visible \Lenv{pspicture} environment \medskip \resetOptions \begin{center} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \psset{llx=-1cm,lly=-1.25cm,urx=0.5cm,ury=0.1in,xAxisLabel=Year,% yAxisLabel=Whatever,xAxisLabelPos={c,-0.4in},% yAxisLabelPos={-0.4in,c}} @@ -6014,8 +5163,8 @@ can be outside the visible \verb+pspicture+ environment \begin{lstlisting} -\readdata{\data}{demo2.dat}% -\readdata{\dataII}{demo3.dat}% +\readdata{\data}{demo2.data}% +\readdata{\dataII}{demo3.data}% \psset{llx=-1cm,lly=-1.25cm,urx=0.5cm,ury=0.1in,xAxisLabel=Year,% yAxisLabel=Whatever,xAxisLabelPos={c,-0.4in},% yAxisLabelPos={-0.4in,c}} @@ -6038,18 +5187,18 @@ can be outside the visible \verb+pspicture+ environment %-------------------------------------------------------------------------------------- Floating point operations in \TeX\ are a real mess, which causes a lot of problems when there are very small or very big units. With -the options of \verb+\pst-plot+ it is possible to choose normal +the options of \LPack{pst-plot} it is possible to choose normal units (whatever this may be ...), and plot the data as usual. \begin{LTXexample}[pos=t] -\begin{filecontents*}{test.dat} +\begin{filecontents*}{test.data} 3.2345 34.5 3.2364 65.4 3.2438 50.2 \end{filecontents*} \psset{lly=-0.5cm,llx=-1cm} -\readdata{\data}{test.dat} +\readdata{\data}{test.data} \pstScalePoints(1,1){3.23 sub 100 mul}{} \begin{psgraph}[Ox=3.23,Dx=0.01,dx=\psxunit,Dy=10](0,0)(3,70){0.8\linewidth}{5cm}% \listplot[showpoints=true,plotstyle=curve]{\data} @@ -6065,30 +5214,32 @@ This example shows some important facts: \item \verb+Dy=10+: increase the y labels by 10 \end{itemize} -Using the internal \verb+\psxunit+ one can have dynamical x-units, +Using the internal \Lcs{psxunit} one can have dynamical x-units, depending on the linewidth of the document. \resetOptions %-------------------------------------------------------------------------------------- -\section{\CMD{psStep}} +\section{\nxLcs{psStep}} %-------------------------------------------------------------------------------------- -\verb+\psStep+ calculates a step function for the upper or lower -sum or the max/min of the Riemann integral definition of a given +\Lcs{psStep} calculates a step function for the upper or lower +sum or the max/min of the \Index{Riemann} integral definition of a given function. The available option is -\verb+StepType=lower|upper|Riemann|infimum|supremum+ or alternative -\verb+StepType=l|u|R|i|s+ +\Lkeyset{StepType=lower}|\Lkeyval{upper}|\Lkeyval{Riemann}|\Lkeyval{infimum}|\Lkeyval{supremum} or alternative +\Lkeyset{StepType=l}|\Lkeyval{u}|\Lkeyval{R}|\Lkeyval{i}|\Lkeyval{s} -with \verb+lower+ as the default setting. The syntax of the function is +with \Lkeyword{lower} as the default setting. The syntax of the function is -\verb+\psStep[options](x1,x2){n}{function}+ +\begin{BDef} +\Lcs{psStep}\OptArgs\Largr(x1,x2)\Largb{n}\Largb{function} +\end{BDef} (x1,x2) is the given interval for the step wise calculated -function, n is the number of the rectangles and \verb+function+ is +function, n is the number of the rectangles and \Larg{function} is the mathematical function in postfix or algebraic notation (with -\verb+algebraic=true+). +\Lkeyset{algebraic=true}). \begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(-0.5,-0.5)(10,3) @@ -6153,15 +5304,15 @@ the mathematical function in postfix or algebraic notation (with %-------------------------------------------------------------------------------------- -\section{\CMD{psplotTangent} and option \texttt{Tnormal}} +\section{\nxLcs{psplotTangent} and option \nxLkeyword{Tnormal}} %-------------------------------------------------------------------------------------- -There is an additional option, named \verb+Derive+ for an +There is an additional option, named \Lkeyword{Derive} for an alternative function (see following example) to calculate the slope of the tangent. This will be in general the first derivative, but can also be any other function. If this option is -different to to the default value \verb+Derive=default+, then this +different to to the default value \Lkeyset{Derive=default}, then this function is taken to calculate the slope. For the other cases, -\verb+pstricks-add+ builds a secant with -0.00005<x<0.00005, +\LPack{pstricks-add} builds a secant with -0.00005<x<0.00005, calculates the slope and takes this for the tangent. This may be problematic in some cases of special functions or $x$ values, then it may be appropriate to use the Derive option. @@ -6171,12 +5322,12 @@ The macro expects three parameters: \begin{description} \item[$x$]: the $x$ value of the function for which the tangent should be calculated \item[$dx$]: the $dx$ to both sides of the $x$ value -\item[$f(x)$]: the function in infix (with option \verb+algebraic+) or the default +\item[$f(x)$]: the function in infix (with option \Lkeyword{algebraic}) or the default postfix (PostScript) notation \end{description} The following examples show the use of the algebraic option together with the Derive option. -Remember that using the \verb+algebraic+ option implies that the angles have to be in the +Remember that using the \Lkeyword{algebraic} option implies that the angles have to be in the radian unit! \begin{center} @@ -6234,7 +5385,7 @@ radian unit! \end{pspicture} \end{lstlisting} -The next example shows the use of the \verb+Derive+ option to draw +The next example shows the use of the \Lkeyword{Derive} option to draw the perpendicular line to the tangent. \begin{LTXexample}[width=8cm,wide] @@ -6248,7 +5399,7 @@ the perpendicular line to the tangent. \end{pspicture} \end{LTXexample} -By setting the optional argument \texttt{Tnormal} one can plot the +By setting the optional argument \Lkeyword{Tnormal} one can plot the normal of the tangent line. It always starts at the given point. %\resetOptions @@ -6265,11 +5416,11 @@ normal of the tangent line. It always starts at the given point. %-------------------------------------------------------------------------------------- -\subsection{A \texttt{polarplot} example} +\subsection{A \nxLkeyword{polarplot} example} %-------------------------------------------------------------------------------------- -Let's work with the classical cardioid : $r=2(1+\cos(\theta))$ and -$\displaystyle \frac{d r}{d\theta}=-2\sin(\theta)$. The Derive +Let's work with the classical \Index{cardioid}: $r=2(1+\cos(\theta))$ and +$\displaystyle \frac{d r}{d\theta}=-2\sin(\theta)$. The \Lkeyword{Derive} option always expects the $\frac{d r}{d\theta}$ value and uses internally the equation for the derivative of implicitly defined functions: @@ -6310,17 +5461,17 @@ where $x=r\cdot\cos\theta$ and $y=r\cdot\sin\theta$ %-------------------------------------------------------------------------------------- -\subsection{A \CMD{parametricplot} example} +\subsection{A \nxLcs{parametricplot} example} %-------------------------------------------------------------------------------------- -Let's work with a Lissajou curve : +Let's work with a \Index{Lissajou curve}: $\displaystyle\left\{\begin{array}{l}x=3.5\cos(2t)\\y=3.5\sin(6t)\end{array}\right.$ whose derivative is : $\displaystyle\left\{\begin{array}{l}x=-7\sin(2t)\\y=21\cos(6t)\end{array}\right.$ The parameter must be the letter $t$ instead of $x$ and when using -the \verb+algebraic+ option you must separate the two equations by -a | (see example). +the \Lkeyword{algebraic} option you must separate the two equations by +a \Lnotation{|} (see example). \begin{LTXexample}[pos=t,wide] \def\Lissa{t dup 2 RadtoDeg mul cos 3.5 mul exch 6 mul RadtoDeg sin 3.5 mul}% @@ -6349,9 +5500,9 @@ a | (see example). \section{Successive derivatives of a function} -The new PostScript function \verb$Derive$ has been added for +The new PostScript function \Lps{Derive} has been added for plotting successive derivatives of a function. It must be used -with the \verb|algebraic| option. This function has two arguments: +with the \Lkeyword{algebraic} option. This function has two arguments: \begin{enumerate} \item a positive integer which defines the order of the derivative; obviously $0$ means the @@ -6400,9 +5551,9 @@ the cosine. \section{Variable step for plotting a curve} \subsection{Theory} -As you know with the \verb$\psplot$ macro, the curve is plotted +As you know with the \Lcs{psplot} macro, the curve is plotted using a piece-wise linear curve. The step is given by the -parameter \texttt{plotpoints}. For each step between $x_i$ and +parameter \Lkeyword{plotpoints}. For each step between $x_i$ and $x_{i+1}$, the area defined between the curve and its approximation (a segment) is majored by this formula : @@ -6424,22 +5575,22 @@ $M_2(f)$ is a majorant of the second derivative of $f$ in the interval $[x_i;x_{ -The parameter \verb$VarStep$ (\verb$false$ by default) activates +The parameter \Lkeyword{VarStep} (\false\ by default) activates the variable step algorithm. It is set to a tolerance defined by -the parameter \verb$VarStepEpsilon$ (\verb+default+ by default, +the parameter \Lkeyword{VarStepEpsilon} (\Lkeyval{default} by default, accept real value). If this parameter is not set by the user, then it is automatically computed using the default first step given by -the parameter \verb+plotpoints+. Then, for each step, $f''(x_n)$ +the parameter \Lkeyword{plotpoints}. Then, for each step, $f''(x_n)$ and $f''(x_{n+1})$ are computed and the smaller is used as $M_2(f)$, and then the step is approximated. This means that the step is constant for second order polynomials. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - \subsection{The cosine} +\subsection{The cosine} - Different value for the tolerance from $0.01$ to $0.000\,1$, a factor $10$ between - each of them. In black, there is the classic \verb+psplot+ behavior, and in - magenta the default variable step behavior. +Different value for the tolerance from $0.01$ to $0.000\,1$, a factor $10$ between +each of them. In black, there is the classic \Lcs{psplot} behavior, and in +magenta the default variable step behavior. \begin{center} \bgroup @@ -6537,10 +5688,10 @@ Impossible to draw, but let's try! -\subsection{A really complex function} +\subsection{A really complecated function} Just appreciate the difference between the normal behavior and the plotting with the -\texttt{varStep} option. The function is : +\Lkeyword{varStep} option. The function is: \[f(x)=x-\frac{x^2}{10}+\ln(x)+\cos(2x)+\sin(x^2)-1\] @@ -6653,7 +5804,11 @@ Just appreciate the difference between the normal behavior and the plotting with -\subsection{Using \CMD{parametricplot}} +\subsection{Using \nxLcs{parametricplot}} + +\begin{BDef} +\Lcs{parametricplot}\OptArgs\Largb{t0}\Largb{t1}\OptArg{PS commands}\Largb{x(t) y(t)} +\end{BDef} \begin{center} \bgroup @@ -7038,7 +6193,8 @@ Just appreciate the difference between the normal behavior and the plotting with \clearpage %-------------------------------------------------------------------------------------- -\section[\CMD{psplotDiffEqn} -- solving diffential equations]{\CMD{psplotDiffEqn} -- solving diffential equations} +\section[\nxLcs{psplotDiffEqn} -- solving diffential equations]% + {\nxLcs{psplotDiffEqn} -- solving diffential equations} %-------------------------------------------------------------------------------------- @@ -7052,9 +6208,9 @@ where $y$ is a function of $x$. We define some vectors $Y=[y, y', \cdots , y^{n}]$, depending on the order $n$. The syntax of the macro is -\begin{lstlisting}[style=syntax] -\psplotDiffEqn[options]{x0}{x1}{y0}{f(x,y,y',...)} -\end{lstlisting} +\begin{BDef} +\Lcs{psplotDiffEqn}\OptArgs\Largb{x0}\Largb{x1}\Largb{y0}\Largb{f(x,y,y',...)} +\end{BDef} \begin{itemize}\setlength\itemsep{0pt}\setlength\parsep{0pt}\setlength\parskip{0pt} \item \verb+options+: the \verb+\psplotDiffEqn+ specific options and all other of PSTricks, which @@ -7071,15 +6227,15 @@ The new options are: \begin{itemize}\setlength\itemsep{0pt}\setlength\parsep{0pt}\setlength\parskip{0pt} -\item \param{method}: integration method (\verb+euler+ for order 1 euler method, \verb+rk4+ for +\item \Lkeyword{method}: integration method (\verb+euler+ for order 1 euler method, \verb+rk4+ for 4\textsuperscript{th} order Runge-Kutta method); -\item \param{whichabs}: select the abscissa for plotting the graph, by default it is +\item \Lkeyword{whichabs}: select the abscissa for plotting the graph, by default it is $x$, but you can specify a number which represent a position in the vector $y$; -\item \param{whichord}: same as precedent for the ordinate, by default $y(0)$; -\item \param{plotfuncx}: describe a ps function for the abscissa, parameter - \param{whichabs} becomes useless; -\item \param{plotfuncy}: idem for the ordinate; -\item \param{buildvector}: boolean parameter for specifying the input-output of the +\item \Lkeyword{whichord}: same as precedent for the ordinate, by default $y(0)$; +\item \Lkeyword{plotfuncx}: describe a ps function for the abscissa, parameter + \Lkeyword{whichabs} becomes useless; +\item \Lkeyword{plotfuncy}: idem for the ordinate; +\item \Lkeyword{buildvector}: boolean parameter for specifying the input-output of the $f$ description: \begin{description} \item[\texttt{true}] (default): $y$ is put on the stack element by element, $y'$ @@ -7088,7 +6244,7 @@ The new options are: in the same way; \end{description} -\item \param{algebraic}: algebraic description for $f$, \param{buildvector} +\item \Lkeyword{algebraic}: algebraic description for $f$, \Lkeyword{buildvector} parameter is useless when activating this option. \end{itemize} @@ -7097,9 +6253,9 @@ The new options are: \subsection{Variable step for differential equations} A new algorithm has been added for adjusting the step according to the variations of -the curve. The parameter \verb+method+ has a new possible value : \verb+varrkiv+ to -activate the \textsc{Runge-Kutta} method with variable step, then the parameter -\verb+varsteptol+ (real value; \verb+.01+ by default) can control the tolerance of +the curve. The parameter \Lkeyword{method} has a new possible value : \Lkeyword{varrkiv} to +activate the \Index{Runge-Kutta} method with variable step, then the parameter +\Lkeyword{varsteptol} (real value; \verb+.01+ by default) can control the tolerance of the algortihm. \begin{center} @@ -7107,7 +6263,7 @@ the algortihm. \def\Funct{neg}\def\FunctAlg{-y[0]} \psset{xunit=1.5, yunit=8, showpoints=true} \begin{pspicture}[showgrid=true](0,0)(10,1.2) - \psplot[linewidth=6\pslinewidth, linecolor=green, showpoints=false]{0}{10}{2.71828182846 x neg exp} + \psplot[linewidth=6\pslinewidth, linecolor=green, showpoints=false]{0}{10}{Euler x neg exp} \psplotDiffEqn[linecolor=magenta, method=varrkiv, varsteptol=.1, plotpoints=2]{0}{10}{1}{\Funct} \rput(0,.0){\psplotDiffEqn[linecolor=blue, method=varrkiv, varsteptol=.01, plotpoints=2]{0}{10}{1}{\Funct}} \rput(0,.1){\psplotDiffEqn[linecolor=Orange, method=varrkiv, varsteptol=.001, plotpoints=2]{0}{10}{1}{\Funct}} @@ -7133,7 +6289,7 @@ the algortihm. \def\Funct{neg}\def\FunctAlg{-y[0]} \psset{xunit=1.5, yunit=8, showpoints=true} \begin{pspicture}[showgrid=true](0,0)(10,1.2) - \psplot[linewidth=6\pslinewidth, linecolor=green, showpoints=false]{0}{10}{2.71828182846 x neg exp} + \psplot[linewidth=6\pslinewidth, linecolor=green, showpoints=false]{0}{10}{Euler x neg exp} \psplotDiffEqn[linecolor=magenta, method=varrkiv, varsteptol=.1, plotpoints=2]{0}{10}{1}{\Funct} \rput(0,.0){\psplotDiffEqn[linecolor=blue, method=varrkiv, varsteptol=.01, plotpoints=2]{0}{10}{1}{\Funct}} \rput(0,.1){\psplotDiffEqn[linecolor=Orange, method=varrkiv, varsteptol=.001, plotpoints=2]{0}{10}{1}{\Funct}} @@ -7338,7 +6494,7 @@ following example the masses of the stars are 1 and 20. &3 index -20 mul&calcul de y''2=-20y''1\\ \hline \end{tabular} - \caption{\PostScript source code for the gravitational interaction}\label{intgravcode} + \caption{\PS source code for the gravitational interaction}\label{intgravcode} \end{table} \begin{table}[!htbp] @@ -7437,7 +6593,7 @@ stars} \egroup %-------------------------------------------------------------------------------------- For the initial value $y(0)=1$ we have the solution $y(x)=e^x$. $y$ is always -on the stack, so we have to do nothing. Using the \verb+algebraic+ option, we write it +on the stack, so we have to do nothing. Using the \Lkeyword{algebraic} option, we write it as \verb$y[0]$. The following example shows different solutions depending to the number of plotpoints with $y_0=1$: @@ -7615,7 +6771,7 @@ For $y(-1)=\frac{1}{e}$ we get $y(x)=e^{-x^2}$. \subsubsection{Spiral of Cornu} %-------------------------------------------------------------------------------------- -The integrals of Fresnel : +The integrals of \Index{Fresnel}: \begin{align} x & =\int^t_0\cos\frac{\pi t^2}{2}\mathrm{d}t \\ y & =\int^t_0\sin\frac{\pi t^2}{2}\mathrm{d}t \\ \intertext{with} @@ -7648,9 +6804,14 @@ The integrals of Fresnel : \subsubsection{Lotka-Volterra} %-------------------------------------------------------------------------------------- -The Lotka-Volterra model describes interactions between two species in an ecosystem, a predator and a prey. This represents our first multi-species model. Since we are considering two species, the model will involve two equations, one which describes how the prey population changes and the second which describes how the predator population changes. +The Lotka-Volterra model describes interactions between two species in an ecosystem, a +predator and a prey. This represents our first multi-species model. Since we are considering +two species, the model will involve two equations, one which describes how the prey +population changes and the second which describes how the predator population changes. -For concreteness let us assume that the prey in our model are rabbits, and that the predators are foxes. If we let $R(t)$ and $F(t)$ represent the number of rabbits and foxes, respectively, that are alive at time t, then the Lotka-Volterra model is: +For concreteness let us assume that the prey in our model are rabbits, and that the +predators are foxes. If we let $R(t)$ and $F(t)$ represent the number of rabbits and +foxes, respectively, that are alive at time t, then the Lotka-Volterra model is: \begin{align} \dot R &= a\cdot R - b\cdot R\cdot F\\ @@ -7665,7 +6826,12 @@ where the parameters are defined by: \item[e] is the efficiency of turning predated rabbits into foxes. \end{description} -The Stella model representing the Lotka-Volterra model will be slightly more complex than the single species models we've dealt with before. The main difference is that our model will have two stocks (reservoirs), one for each species. Each species will have its own birth and death rates. In addition, the Lotka-Volterra model involves four parameters rather than two. All told, the Stella representation of the Lotka-Volterra model will use two stocks, four flows, four converters and many connectors. +The Stella model representing the \Index{Lotka-Volterra} model will be slightly more complex than the +single species models we've dealt with before. The main difference is that our model will have +two stocks (reservoirs), one for each species. Each species will have its own birth and death +rates. In addition, the Lotka-Volterra model involves four parameters rather than two. All told, +the Stella representation of the Lotka-Volterra model will use two stocks, four flows, four +converters and many connectors. \bgroup \def\InitCond{ 0 10 10}%% xa ya xl @@ -7713,7 +6879,6 @@ The Stella model representing the Lotka-Volterra model will be slightly more com \end{lstlisting} -\clearpage %-------------------------------------------------------------------------------------- \subsubsection{$y''=y$} %-------------------------------------------------------------------------------------- @@ -7816,7 +6981,7 @@ trigonometrical functions. \subsubsection{The mechanical pendulum: $y''=-\frac{g}{l}\sin(y)$}% $ %-------------------------------------------------------------------------------------- -For small oscillations $\sin(y)\simeq y$: +For small \Index{oscillation}s $\sin(y)\simeq y$: \[ y(x)=y_0\cos\left(\sqrt{\frac{g}{l}}x\right) \] @@ -7871,19 +7036,6 @@ For $y_0=5$ and $y'_0=0$ the solution is: \mbox{ avec } \omega=\frac{\sqrt{127}}{8} \] -\iffalse -La fonction $f$ est d�rite par le code PostScript suivant : - -\begin{lstlisting}[style=syntax] -dup %% y y' y' -3 1 roll %% y' y y' --4 div %% y' y y'/-4 -exch %% y' y'/-4 y -2 mul %% y' y'/-4 2y -sub %% y' y'/-4-2y -\end{lstlisting} - -\fi \begin{center} \bgroup \psset{xunit=.6,yunit=0.8,plotpoints=500} @@ -7918,95 +7070,8 @@ sub %% y' y'/-4-2y \end{pspicture} \end{lstlisting} -\iffalse - -\newpage -%-------------------------------------------------------------------------------------- -\subsubsection{Gravitation: two stars and more} -%-------------------------------------------------------------------------------------- - -\iffalse -L'exemple le plus complexe dans l'�riture de $f$, mais aussi dans l'�uilibrage de -la simulation\footnote{n'h�itez pas �modifier des param�res, ajouter des astres, - et vous verrez que le syst�e solaire est miraculeux : il est stable !}. $f$ est -g��ique : elle peut traiter un nombre d'astres quelconques chacun ayant sa propre -masse. Dans cette section on va en faire interagir quatre. Cela donne pour le moteur -d'affichage un syst�e de 16 �uations du premier ordre �r�oudre, et le r�ultat -est remarquable. - -\fi - x1 y1 x'1 y'1 x2 y2 x'2 y'2 x3 y3 x'3 y'3 x4 y4 x'4 y'4 - \def\InitCond{ 1 1 0 0 -1 -1 -2 2 3 3 2.86 -2.86 5.5 -3.5 -2.1 -2.1} - \def\tMAX{10} - \newcommand{\MunMdeux}{40} - \newcommand{\MdeuxMtrois}{40} - \psset{unit=1, showpoints=false, plotpoints=400}%%plotpoints=375} - \newcommand{\Test}{ - %% masses des astres - /Weigth [ 40 1 1 2 ] def - /NbAstor Weigth length def - /ABVect { 3 -1 roll exch sub 3 1 roll sub exch } def - %% calculs des distances entre masses - 1 1 NbAstor 1 sub { - dup /i exch def 1 add 1 NbAstor { - /j exch def - y i 1 sub 4 mul get y j 1 sub 4 mul get sub dup mul - y i 1 sub 4 mul 1 add get y j 1 sub 4 mul 1 add get sub dup mul add - } for - } for - NbAstor dup 1 sub mul 2 div cvi array astore /ro2 exch def - %% calculs des forces - 1 1 NbAstor { - /i exch def - y i 1 sub 4 mul 4 getinterval aload pop 4 2 roll - /xf 0 def /yf 0 def - 1 1 NbAstor { - dup i eq - { pop } - { /j exch def - 2 copy y j 1 sub 4 mul 2 getinterval aload pop ABVect - Weigth j 1 sub get - ro2 i j 2 copy lt { exch } if dup - dup 1 sub dup NbAstor mul 3 1 roll mul 2 div sub 3 1 roll sub add 1 sub - cvi get dup sqrt mul div exch 1 index mul 3 1 roll mul exch - yf add /yf exch def xf add /xf exch def } ifelse - } for pop pop xf neg yf neg - } for - NbAstor 4 mul array astore - } - -\begin{LTXexample}[pos=t,preset=\centering] -\begin{pspicture}(-9,-6.25)(6,6) - \psgrid[subgriddiv=0,gridcolor=lightgray](-9,-6)(6,6) - \psset{buildvector=true,method=rk4,linewidth=1.5pt} - \psplotDiffEqn[whichabs=0,whichord=1,linecolor=blue]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[whichabs=4,whichord=5,linecolor=red]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[whichabs=4,whichord=5,linecolor=Orange,method=adams]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[whichabs=8,whichord=9,linecolor=magenta]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[whichabs=12,whichord=13,linecolor=green]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[whichabs=12,whichord=13,linecolor=yellow,method=adams]{0}{\tMAX}{\InitCond}{\Test} -\end{pspicture} -\end{LTXexample} - - -\begin{LTXexample}[pos=t,preset=\centering] -\begin{pspicture}(-10,-7.25)(5,5) - \psgrid[subgriddiv=0,gridcolor=lightgray](-10,-7)(5,5) - \psset{buildvector=true,method=rk4,linewidth=1.5pt} - \psplotDiffEqn[linecolor=red,plotfuncx=y dup 4 get exch 0 get sub , - plotfuncy=dup 5 get exch 1 get sub ]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[linecolor=magenta,plotfuncx=y dup 8 get exch 0 get sub , - plotfuncy=dup 9 get exch 1 get sub ]{0}{\tMAX}{\InitCond}{\Test} - \psplotDiffEqn[linecolor=green,plotfuncx=y dup 12 get exch 0 get sub , - plotfuncy=dup 13 get exch 1 get sub ]{0}{\tMAX}{\InitCond}{\Test} -\end{pspicture} -\end{LTXexample} - -\fi - - %-------------------------------------------------------------------------------------- -\section{\CMD{psBoxplot}} +\section{\nxLcs{psBoxplot}} %-------------------------------------------------------------------------------------- A box-and-whisker plot (often called simply a box plot) is a histogram-like method of @@ -8017,11 +7082,12 @@ that are within 3/2 times the interquartile range of $Q_1$ and $Q_3$). Then, for more than 3/2 times the interquartile range from the end of a box, is a dot. The only special optional arguments, beside all other which are valid for drawing lines -and filling areas, are \verb+IQLfactor+, \verb+barwidth+, and \verb+arrowlength+, where the latter is a factor +and filling areas, are \Lkeyword{IQLfactor}, \Lkeyword{barwidth}, and +\Lkeyword{arrowlength}, where the latter is a factor which is multiplied with the barwidth for the line ends. -The \verb+IQLfactor+, preset to 1.5, defines the area for the outliers. +The \Lkeyword{IQLfactor}, preset to 1.5, defines the area for the outliers. -\begin{LTXexample}[pos=t,preset=\centering] +%\begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(-1,-1)(12,14) \psset{yunit=0.1,fillstyle=solid} \savedata{\data}[100 90 120 115 120 110 100 110 100 90 100 100 120 120 120] @@ -8044,30 +7110,82 @@ The \verb+IQLfactor+, preset to 1.5, defines the area for the outliers. \rput(11,25){2008} \psaxes[dy=1cm,Dy=10](0,0)(12,130) \end{pspicture} -\end{LTXexample} +%\end{LTXexample} + +\begin{lstlisting} +\begin{pspicture}(-1,-1)(12,14) +\psset{yunit=0.1,fillstyle=solid} +\savedata{\data}[100 90 120 115 120 110 100 110 100 90 100 100 120 120 120] +\rput(1,0){\psBoxplot[fillcolor=red!30]{\data}} +\rput(1,105){2001} +\savedata{\data}[90 120 115 116 115 110 90 130 120 120 120 85 100 130 130] +\rput(3,0){\psBoxplot[arrowlength=0.5,fillcolor=blue!30]{\data}} +\rput(3,107){2008} +\savedata{\data}[35 70 90 60 100 60 60 80 80 60 50 55 90 70 70] +\rput(5,0){\psBoxplot[barwidth=40pt,arrowlength=1.2,fillcolor=red!30]{\data}} +\rput(5,65){2001} +\savedata{\data}[60 65 60 75 75 60 50 90 95 60 65 45 45 60 90] +\rput(7,0){\psBoxplot[barwidth=40pt,fillcolor=blue!30]{\data}} +\rput(7,65){2008} +\savedata{\data}[20 20 25 20 15 20 20 25 30 20 20 20 30 30 30] +\rput(9,0){\psBoxplot[fillcolor=red!30]{\data}} +\rput(9,22){2001} +\savedata{\data}[20 30 20 35 35 20 20 60 50 20 35 15 30 20 40] +\rput(11,0){\psBoxplot[fillcolor=blue!30,linestyle=dashed]{\data}} +\rput(11,25){2008} +\psaxes[dy=1cm,Dy=10](0,0)(12,130) +\end{pspicture} +\end{lstlisting} -The next example uses an external file for the data, hich must first be read by the -macro \verb+\readdata+. + +The next example uses an external file for the data, which must first be read by the +macro \Lcs{readdata}. The next one creates a horizontal boxplot by rotating +the output with $-90$ degrees. \begin{filecontents}{boxplot.data} 2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32 \end{filecontents} -\begin{LTXexample}[width=5cm] -\begin{pspicture}(-1,-1)(4,10) -\psset{yunit=0.25,fillstyle=solid} + +%\begin{LTXexample}[pos=t] \readdata{\data}{boxplot.data} +\begin{pspicture}(-1,-1)(2,10) +\psset{yunit=0.25,fillstyle=solid} +\savedata{\data}[2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32] \rput(1,0){\psBoxplot[fillcolor=blue!30]{\data}} -\psaxes[dy=1cm,Dy=4](0,0)(4,35) +\psaxes[dy=1cm,Dy=4](0,0)(2,35) \end{pspicture} -\end{LTXexample} +% +\begin{pspicture}(-1,-1)(11,2) +\psset{xunit=0.25,fillstyle=solid} +\savedata{\data}[2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32] +\rput{-90}(0,1){\psBoxplot[yunit=0.25,fillcolor=blue!30]{\data}} +\psaxes[dx=1cm,Dx=4](0,0)(35,2) +\end{pspicture} +%\end{LTXexample} +\begin{lstlisting} +\readdata{\data}{boxplot.data} +\begin{pspicture}(-1,-1)(2,10) +\psset{yunit=0.25,fillstyle=solid} +\savedata{\data}[2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32] +\rput(1,0){\psBoxplot[fillcolor=blue!30]{\data}} +\psaxes[dy=1cm,Dy=4](0,0)(2,35) +\end{pspicture} +% +\begin{pspicture}(-1,-1)(11,2) +\psset{xunit=0.25,fillstyle=solid} +\savedata{\data}[2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32] +\rput{-90}(0,1){\psBoxplot[yunit=0.25,fillcolor=blue!30]{\data}} +\psaxes[dx=1cm,Dx=4](0,0)(35,2) +\end{pspicture} +\end{lstlisting} %-------------------------------------------------------------------------------------- -\section{\CMD{psMatrixPlot}} +\section{\nxLcs{psMatrixPlot}} %-------------------------------------------------------------------------------------- -\begin{filecontents}{matrix.dat} +\begin{filecontents}{matrix.data} /dotmatrix [ % 0 1 1 0 0 0 0 1 1 1 0 1 1 0 1 1 1 0 1 0 @@ -8084,7 +7202,7 @@ macro \verb+\readdata+. This macro allows you to visualize a matrix. The datafile must be -defined as a PostScript matrix named \verb+/dotmatrix+: +defined as a PostScript matrix named \Lps{dotmatrix}: \begin{lstlisting}[style=syntax] /dotmatrix [ % <------------ important line 0 1 1 0 0 0 0 1 1 1 @@ -8102,15 +7220,16 @@ defined as a PostScript matrix named \verb+/dotmatrix+: Only the value 0 is important, in which case nothing happens, and for all other cases a dot is printed. The syntax of the macro is: -\begin{lstlisting}[style=syntax] - \psMatrixPlot[options]{rows}{columns}{data file} -\end{lstlisting} -The matrix is scanned line by line from the the first one to the +\begin{BDef} +\Lcs{psMatrixPlot}\OptArgs\Largb{rows}\Largb{columns}\Largb{data file} +\end{BDef} + +The \Index{matrix} is scanned line by line from the the first one to the last. In general it appears as a bottom-to-top version of the above listed matrix, the first row $0\,1\,1\,0\,0\,0\,0\,1\,1\,1$ is the first plotted line ($y=1$). With the option -\verb+ChangeOrder=true+ it looks exactly like the above view. +\Lkeyword{ChangeOrder}=\true\ it looks exactly like the above view. \bgroup \begin{center} @@ -8118,8 +7237,8 @@ is the first plotted line ($y=1$). With the option \begin{pspicture}(-0.5,-0.75)(11,11) \psaxes{->}(11,11) \psMatrixPlot[dotsize=1.1cm,dotstyle=square*,linecolor=magenta]% - {10}{10}{matrix.dat} - \psMatrixPlot[dotsize=.5cm,dotstyle=o,ChangeOrder]{10}{10}{matrix.dat} + {10}{10}{matrix.data} + \psMatrixPlot[dotsize=.5cm,dotstyle=o,ChangeOrder]{10}{10}{matrix.data} \end{pspicture} %\end{LTXexample} @@ -8127,30 +7246,30 @@ is the first plotted line ($y=1$). With the option \begin{pspicture}(-0.5,-0.75)(11,11) \psaxes{->}(11,11) \psMatrixPlot[dotsize=1.1cm,dotstyle=square*,linecolor=magenta]% - {10}{10}{matrix.dat} - \psMatrixPlot[dotsize=.5cm,dotstyle=o,ChangeOrder]{10}{10}{matrix.dat} + {10}{10}{matrix.data} + \psMatrixPlot[dotsize=.5cm,dotstyle=o,ChangeOrder]{10}{10}{matrix.data} \end{pspicture} \end{lstlisting} \begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(-0.5,-0.75)(11,11) \psaxes{->}(11,11) - \psMatrixPlot[dotscale=3,dotstyle=*,linecolor=blue]{10}{8}{matrix.dat} + \psMatrixPlot[dotscale=3,dotstyle=*,linecolor=blue]{10}{8}{matrix.data} \end{pspicture} \end{LTXexample} \end{center} \egroup %-------------------------------------------------------------------------------------- -\section{\CMD{psforeach}} +\section{\nxLcs{psforeach}} %-------------------------------------------------------------------------------------- -The macro \CMD{psforeach} allows a loop with an individual +The macro \Lcs{psforeach} allows a loop with an individual increment. -\begin{lstlisting}[style=syntax] -\psforeach{variable}{value list}{action} -\end{lstlisting} +\begin{BDef} +\Lcs{psforeach}\Largb{variable}\Largb{value list}\Largb{action} +\end{BDef} \begin{LTXexample} \begin{pspicture}[showgrid=true](5,5) @@ -8166,9 +7285,9 @@ increment. Sometimes it is difficult to know what options, which are changed inside a long document, are different to the default ones. With -this macro all options belonging to \verb+pst-plot+ can be reset. -This refers to all options of the packages \verb+pstricks+, -\verb+pst-plot+ and \verb+pst-node+. +this macro all options belonging to \LPack{pst-plot} can be reset. +This refers to all options of the packages \LPack{pstricks}, +\LPack{pst-plot} and \LPack{pst-node}. \appendix @@ -8178,33 +7297,33 @@ This refers to all options of the packages \verb+pstricks+, \section{PostScript} %-------------------------------------------------------------------------------------- -PostScript uses the stack system and the LIFO system, "'Last In, First Out"`. +\Index{PostScript} uses the stack system and the LIFO system, "'Last In, First Out"`. \newlength{\Li}\settowidth{\Li}{Function} \begin{table}[htbp] \begin{center}{\ttfamily \begin{tabular}{|l|r@{ $\rightarrow$ }l|}\hline \multirow{2}{\Li}{\normalfont Function}&\multicolumn{2}{c|}{\normalfont Meaning}\\ - &\normalfont on stack before & \normalfont after\\\hline\hline - add&$x\quad y$&$x+y$\\\hline - sub&$x\quad y$&$x-y$\\\hline - mul&$x\quad y$&$x\times y$\\\hline - div&$x\quad y$&$x\div y$\\\hline - sqrt&$x$&$\sqrt{x}$\\\hline - abs&$x$&$|x|$\\\hline - neg&$x$&$-x$\\\hline - cos&$x$&$\cos(x)$ ($x$ in degrees)\\\hline - sin&$x$&$\sin(x)$ ($x$ in degrees)\\\hline - tan&$x$&$\tan(x)$ ($x$ in degrees)\\\hline - atan&$y\quad x$&$\angle{(\vec{Ox};\vec{OM})}$ (in degrees of $M(x,y)$)\\\hline - ln&$x$&$\ln(x)$\\\hline - log&$x$&$\log(x)$\\\hline - array&$n$&\normalfont$v$ (of dimension $n$)\\\hline - aload&$v$&$x_1\quad x_2\quad \cdots\quad x_n\quad v$\\\hline - astore&$x_1\quad x_2\quad \cdots\quad x_n\quad v$&$v$\\\hline - pop&$x$&\\\hline - dup&$x\quad x$&\\\hline - roll&$x_1\quad x_2\quad \cdots\quad x_n\quad n p$&\\\hline + &\normalfont on stack before & \normalfont after\\\hline + \Lps{add} & $x\quad y$&$x+y$\\ + \Lps{sub} & $x\quad y$&$x-y$\\ + \Lps{mul} & $x\quad y$&$x\times y$\\ + \Lps{div} & $x\quad y$&$x\div y$\\ + \Lps{sqrt} & $x$&$\sqrt{x}$\\ + \Lps{abs} & $x$&$|x|$\\ + \Lps{neg} & $x$&$-x$\\ + \Lps{cos} & $x$&$\cos(x)$ ($x$ in degrees)\\ + \Lps{sin} & $x$&$\sin(x)$ ($x$ in degrees)\\ + \Lps{tan} & $x$&$\tan(x)$ ($x$ in degrees)\\ + \Lps{atan} & $y\quad x$&$\angle{(\vec{Ox};\vec{OM})}$ (in degrees of $M(x,y)$)\\ + \Lps{ln} & $x$&$\ln(x)$\\ + \Lps{log} & $x$&$\log(x)$\\ + \Lps{array} & $n$&\normalfont$v$ (of dimension $n$)\\ + \Lps{aload} & $v$&$x_1\quad x_2\quad \cdots\quad x_n\quad v$\\ + \Lps{astore} & $x_1\quad x_2\quad \cdots\quad x_n\quad v$ & $[v]$\\ + \Lps{pop} & $x$ & --\\ + \Lps{dup} & $x$ & $x\quad x$ \\ +% \Lps{roll} & $x_1\quad x_2\quad \cdots\quad x_n\quad n p$ &\\\hline \end{tabular}} \caption{Some primitive PostScript macros}\label{tab:primpost} \end{center} @@ -8217,27 +7336,6 @@ PostScript uses the stack system and the LIFO system, "'Last In, First Out"`. \xkvview{family=pstricks-add,columns={key,type,default}} -%-------------------------------------------------------------------------------------- -\section{Credits} -%-------------------------------------------------------------------------------------- -{Hendri Adriaens | } -{Stefano Baroni | } -{Martin Chicoine | } -{Gerry Coombes | } -{Ulrich Dirr | } -{Christophe Fourey | } -{Hubert G\"a\ss lein |} -{Denis Girou | } -{Peter Hutnick | } -{Christophe Jorssen | } -{Uwe Kern | } -{Manuel Luque | } -{Jens-Uwe Morawski |} -{Tobias N\"ahring |} -{Rolf Niepraschk |} -{Alan Ristow |} -{Arnaud Schmittbuhl |} -{Timothy Van Zandt} @@ -8248,16 +7346,9 @@ PostScript uses the stack system and the LIFO system, "'Last In, First Out"`. \bibliography{pstricks-add-doc} \egroup -%-------------------------------------------------------------------------------------- -\section{Change log} -%-------------------------------------------------------------------------------------- - -See file Changes +\printindex -%\clearpage -%\section{The code} -%\lstinputlisting{pstricks-add.tex} \end{document} |